annotate README4PACKAGERS @ 1669:697effba0310

plugin pipe: rewritten plugin as a jingle application. The current implentation can, in some cases, block the backend, and is experimental only. Improvments are needed in the future.
author Goffi <goffi@goffi.org>
date Wed, 25 Nov 2015 02:04:43 +0100
parents 685fad1c18e4
children 77a010f1f8cb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
1 First of all, thank you for packaging SàT :)
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
2
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
3
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
4 ############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
5 Dependencies
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
6 ############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
7
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
8 SàT requires Python 2.7.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
9 You will find below the list of Python modules the backend and the frontends depend on, as well as additional information.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
10
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
11 ------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
12 Dependencies for SàT's backend
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
13 ------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
14
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
15 dbus
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
16 lxml
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
17 Mutagen
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1443
diff changeset
18 pillow
1038
d732bb68b326 fixes setup with PyCrypto minimal version
souliane <souliane@mailoo.org>
parents: 1028
diff changeset
19 PyCrypto >= 2.6.1
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
20 PyFeed
1443
32d1089df687 add PyOpenSSL to the dependency list
souliane <souliane@mailoo.org>
parents: 1291
diff changeset
21 PyOpenSSL
1054
a32ef03d4af0 installation: added python OTR dependency
Goffi <goffi@goffi.org>
parents: 1038
diff changeset
22 Python OTR
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
23 Twisted Core
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
24 Twisted Mail
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
25 Twisted Web
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
26 Twisted Words
1038
d732bb68b326 fixes setup with PyCrypto minimal version
souliane <souliane@mailoo.org>
parents: 1028
diff changeset
27 Wokkel >= 0.7.1
932
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
28 XDG
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
29 xe
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
30 zope.interface
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
31
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1443
diff changeset
32 Recommended: markdown, html2text, netifaces, miniupnp
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
33
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
34 --------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
35 Dependencies for the Jp frontend
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
36 --------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
37
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
38 PyGI (PyGObject 3)
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
39
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
40 Recommended: progressbar
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
41
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
42 ----------------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
43 Dependencies for the Primitivus frontend
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
44 ----------------------------------------
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
45
1166
6b15a6d184d5 misc (README4PACKAGERS): Urwid minimal version is now 1.2.0
Goffi <goffi@goffi.org>
parents: 1152
diff changeset
46 Urwid >= 1.2.0
1200
0059c2bb9bd7 misc: update versions in README4PACKAGERS + typos
Matteo Cypriani <mcy@lm7.fr>
parents: 1194
diff changeset
47 Urwid-satext >= 0.4.1
0059c2bb9bd7 misc: update versions in README4PACKAGERS + typos
Matteo Cypriani <mcy@lm7.fr>
parents: 1194
diff changeset
48 GObject 2 (not imported directly in Primitivus, but needed for Urwid's main loop)
0059c2bb9bd7 misc: update versions in README4PACKAGERS + typos
Matteo Cypriani <mcy@lm7.fr>
parents: 1194
diff changeset
49 DBus
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
50
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
51 Suggested: Python X Library (for user notifications in a graphical session)
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
52
932
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
53 --------------------------------------
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
54 Dependencies for the Libervia frontend
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
55 --------------------------------------
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
56
940
92e41e7c7e00 misc: precisions about pyjamas in README4PACKAGERS
Goffi <goffi@goffi.org>
parents: 932
diff changeset
57 pyjamas (for building only)
932
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
58 txJSON-RPC
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
59
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
60 Recommended: pyOpenSSL
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
61
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
62
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
63 ##################
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
64 Satellite projects
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
65 ##################
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
66
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
67 Several project have been made around SàT, they are all available at http://repos.goffi.org:
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
68
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
69 - Libervia: the both Ajax and static web frontend.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
70
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
71 - SàT PubSub: a PubSub service which manage experimental features like fine permission tuning.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
72
932
1e0550271546 misc: updated setup.py and README4PACKAGERS
souliane <souliane@mailoo.org>
parents: 899
diff changeset
73 - SàT media: Media needed by the frontends.
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
74
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
75 - Urwid SàText: Widgets for urwid library, designed for SàT but can be useful for other projects. Mandatory for Primitivus.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
76
1200
0059c2bb9bd7 misc: update versions in README4PACKAGERS + typos
Matteo Cypriani <mcy@lm7.fr>
parents: 1194
diff changeset
77 The following ones are not needed in a distribution, because they are in too early a stage of development, or not useful for general purpose:
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
78
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
79 - Bellaciao: a Qt frontend, at an early stage of development.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
80
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
81 - Salut: an XMPP directory, at a very early stage of development.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
82
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
83 - SàT Website: the code of the website.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
84
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
85
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
86 ########
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
87 Licences
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
88 ########
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
89
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
90 We are careful about the licences we use. Our projects are licenced as follow:
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
91
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
92 - Libervia, SàT PubSub, Bellaciao, Salut, SàT Website: AGPL v3+
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
93
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
94 - Urwid SàText: LGPL v3+
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
95
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
96 When an external code is included (portion or library), we indicate the source and the licence, and we are careful to take Libre licences only. If we made a mistake somewhere, please let us know.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
97
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
98 The case of SàT Media is particular are there is a compilation of media from severals sources. SàT Logo was made by Adrien Vigneron and is under CC By-SA. Other works are all under Free licences, licences are specified in the base directory of each package.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
99
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
100
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
101 #####################
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
102 Packages and versions
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
103 #####################
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
104
1291
0db0013c59dd remove remaining references to Wix
souliane <souliane@mailoo.org>
parents: 1200
diff changeset
105 We have packaged Primitivus and Jp with the core backend, as we think theses frontends should be shipped with each SàT distribution.
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
106
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
107 Libervia is distributed as a separate package because of its specificities (it's a huge project by itself, it uses Pyjamas Python => JS Compiler, etc.). But it's part of the same project.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
108
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
109 All the official frontends have the same version number, which is the version of the backend they use.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
110
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
111
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
112 #######
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
113 Updates
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
114 #######
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
115
1152
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
116 There is a SQLite database per user (default in ~/local/share/sat/.sat.db); it is updated automatically if there is a schema change.
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
117
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
118
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
119 ##############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
120 Contrat social
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
121 ##############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
122
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
123 The social contract is an important part of the project, please don't forget to distribute it along with SàT.
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
124
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
125
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
126 #############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
127 Miscellaneous
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
128 #############
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
129
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
130 There is a completion file for Zsh which detects the parameters of Jp. It's available in the misc/ directory (.jp) and must be available in a path included in user's fpath.
1152
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
131
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
132 The translations are global to all the frontends (no translations available in Libervia yet). There are not up-to-date since 0.4 version.
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
133
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
134 The .service file in misc repository is used for auto-launch feature of D-Bus (launching a frontend will automatically launch the backend if it's not already present), setup.py adapt the path once installed. If you put it yourself, be sure that the "Exec=" line link to the sat.sh script.
c8c7755de5d8 misc: README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 1054
diff changeset
135 This file should be in .services dir, usually /usr/share/dbus-1/services/
899
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
136
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
137
7565d3ac0a96 misc: README4PACKAGERS improvments
Matteo Cypriani <mcy@lm7.fr>
parents: 896
diff changeset
138 Thank you again for you help; don't forget to give us your name and contact email so we can credit you, and don't hesitate to contact us if you have any question (on the sat XMPP room at sat@chat.jabberfr.org, or check README for individual contacts).