~ubuntu-branches/ubuntu/vivid/gpodder/vivid-proposed

« back to all changes in this revision

Viewing changes to README

  • Committer: Package Import Robot
  • Author(s): tony mancill
  • Date: 2013-04-12 22:07:02 UTC
  • mfrom: (5.2.27 sid)
  • Revision ID: package-import@ubuntu.com-20130412220702-mux8v9r8zt2jin0x
Tags: 3.5.1-1
* New upstream release.
* d/control: declare versioned dependency on python-gtk2 (>= 2.16)

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
 
9
9
  ............................................................................
10
10
 
11
 
             Copyright  2005-2012 Thomas Perl and the gPodder Team
 
11
             Copyright  2005-2013 Thomas Perl and the gPodder Team
12
12
 
13
13
 
14
14
 [ LICENSE ]
33
33
    - Python 2.6 or newer              http://python.org/
34
34
    - "sqlite3" Python module          (usually included with Python)
35
35
    - Feedparser 5.1.2 or newer        http://code.google.com/p/feedparser/
36
 
    - mygpoclient 1.4 or newer         http://thp.io/2010/mygpoclient/
 
36
    - mygpoclient 1.7 or newer         http://thp.io/2010/mygpoclient/
37
37
    - Python D-Bus bindings
38
38
 
39
39
    gPodder might still work with Python 2.5, but you may need to
50
50
 
51
51
 [ GTK UI - ADDITIONAL DEPENDENCIES ]
52
52
 
53
 
    - PyGTK 2.12 or newer              http://pygtk.org/
 
53
    - PyGTK 2.16 or newer              http://pygtk.org/
54
54
 
55
55
 
56
56
 [ QML UI - ADDITIONAL DEPENDENCIES ]
59
59
    - PySide 1.0.8 or newer            http://www.pyside.org/
60
60
    - Qt Mobility 1.2 or newer         http://qt.gitorious.org/qt-mobility
61
61
    - Qt Quick Components              http://qt.gitorious.org/qt-components
 
62
    - Sailfish Silica Components       https://sailfishos.org/sailfish-silica/
62
63
 
63
64
    The QML UI depends on the QtMultimediaKit QML bindings for playing
64
65
    back audio (libdeclarative-multimedia in Debian) and on the WebKit QML
74
75
    elements to be displayed correctly. Alternatively, you can use the free
75
76
    "darko" theme from: https://github.com/jpavelek/meego-handset-theme-darko
76
77
 
 
78
    For running gPodder on Sailfish OS using Sailfish Silica Components, you
 
79
    need to have Sailfish Silica installed. Right now, gPodder still depends on
 
80
    qt-components even on Sailfish, but this is going to change soon once a
 
81
    more mature version of Sailfish Silica is out.
 
82
 
77
83
 
78
84
 [ OPTIONAL DEPENDENCIES ]
79
85
 
82
88
    - Flattr integration: python-webkit
83
89
    - Size detection on Windows: PyWin32
84
90
    - Native OS X support: ige-mac-integration
 
91
    - MP3 Player Sync Support: python-eyed3 (< 0.7)
85
92
 
86
93
 
87
94
 [ BUILD DEPENDENCIES ]
103
110
    To set a specific python binary set PYTHON:
104
111
        PYTHON=python2 make unittest
105
112
 
 
113
    Tests in gPodder are written in two different ways:
 
114
 
 
115
       - doctests (see http://docs.python.org/2/library/doctest.html)
 
116
       - unittests (see http://docs.python.org/2/library/unittest.html)
 
117
 
 
118
    If you want to add doctests, simply write the doctest and make sure that
 
119
    the module appears in "doctest_modules" in src/gpodder/unittests.py. For
 
120
    example, the doctests in src/gpodder/util.py are added as 'util' (the
 
121
    "gpodder" prefix must not be specified there).
 
122
 
 
123
    If you want to add unit tests for a specific module (ex: gpodder.model),
 
124
    you should add the tests as gpodder.test.model, or in other words:
 
125
 
 
126
        The file       src/gpodder/model.py
 
127
        is tested by   src/gpodder/test/model.py
 
128
 
 
129
    After you've added the test, make sure that the module appears in
 
130
    "test_modules" in src/gpodder/unittests.py - for the example above, the
 
131
    unittests in src/gpodder/test/model.py are added as 'model'. For unit
 
132
    tests, coverage reporting happens for the tested module (that's why the
 
133
    test module name should mirror the module to be tested).
 
134
 
106
135
 
107
136
 [ RUNNING AND INSTALLATION ]
108
137
 
250
279
    - IRC channel                      #gpodder on irc.freenode.net
251
280
 
252
281
  ............................................................................
253
 
             Last updated: 2012-02-24 by Thomas Perl <thp.io/about>
 
282
             Last updated: 2013-02-12 by Thomas Perl <thp.io/about>
254
283