Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 160 lines (119 sloc) 6.532 kb
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
1 Pyjs
4345ffc readme formatting
Lex Berezhny authored
2 =======
04ee480 first svn add of trunk
lkcl authored
3
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
4 Pyjs is a port of Google Web Toolkit to Python, and thus enables
9eadcac 0.6 release
lkcl authored
5 the development of Rich Media AJAX applications in Python, with no
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
6 need for special browser plugins. Pyjs contains a stand-alone
9eadcac 0.6 release
lkcl authored
7 python-to-javascript compiler, and also a Widget Set API that looks
8 very similar to Desktop Widget Set APIs (such as PyQT4 or PyGTK2).
04ee480 first svn add of trunk
lkcl authored
9
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
10 Pyjs also contains a Desktop Widget Set version, running as pure
df8f84b update README to 0.8
Luke Leighton authored
11 python, with four useable Desktop ports available. Using web browser
95aa627 updating README
lkcl authored
12 technology startlingly provides an alternative to traditional
13 Widget sets, such as PyQT4 and PyGTK2, with the advantage of having
14 full support for HTML, CSS, Plugins and other web-related features
15 already built-in. For the windows port, this can save users and
16 developers around 30mb of downloads, as MSHTML is preinstalled on
17 the Windows Operating System, as part of IE.
6da96ab add section about pyjd at top of README
lkcl authored
18
77bab1e readme changes
Lex Berezhny authored
19 For more information and documentation, see:
04ee480 first svn add of trunk
lkcl authored
20
4345ffc readme formatting
Lex Berezhny authored
21 * http://pyjs.org
77bab1e readme changes
Lex Berezhny authored
22 * https://github.com/pyjs/pyjs/wiki
9eadcac 0.6 release
lkcl authored
23
77bab1e readme changes
Lex Berezhny authored
24 For issue tracking:
25
26 * https://github.com/pyjs/pyjs/issues
27
28 Mailing list:
29
30 * https://groups.google.com/group/pyjs-users
31
32 IRC:
33
34 :Server: irc.freenode.net
35 :Channel: #pyjs
8d3b7c8 update readme
lkcl authored
36
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
37 Pyjs-Desktop
4345ffc readme formatting
Lex Berezhny authored
38 ===============
4b58185 mention pyjamas desktop
lkcl authored
39
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
40 Pyjs runs your python application in a Web Browser (as javascript).
41 Pyjs-Desktop runs exactly the same python application on the
95aa627 updating README
lkcl authored
42 Desktop (as pure python).
4b58185 mention pyjamas desktop
lkcl authored
43
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
44 Release 0.6 of Pyjs incorporated Pyjs-Desktop directly into
45 the Pyjs Distribution. To use Pyjs-Desktop there are three choices,
9eadcac 0.6 release
lkcl authored
46 with more planned [MacOSX PyObjC; KDE's PyKHTML].
85db82c update README and INSTALL.txt
lkcl authored
47
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
48 All ports of Pyjs-Desktop will require a JSON library to be
9fb44d4 preparing for 0.7~pre1 release
lkcl authored
49 installed: as there are plenty already, it is counter-productive
8c7cbc5 update to 0.8.1 alpha
Luke Leighton authored
50 to write yet another one. simplejson is recommended if the version of
51 python is 2.5 or less. Python 2.6 and above come with a json library
52 installed by default.
9fb44d4 preparing for 0.7~pre1 release
lkcl authored
53
4345ffc readme formatting
Lex Berezhny authored
54 1. XULRunner
85db82c update README and INSTALL.txt
lkcl authored
55
8195c9a readme formatting
Lex Berezhny authored
56 install hulahop and python-xpcom. hulahop, from OLPC SugarLabs,
57 is distributed with both Debian and Ubuntu; python-xpcom is part
58 of XULRunner and is also distributed with both Debian and Ubuntu.
59 Other users should investigate the installation instructions for
60 python-xpcom and hulahop for the operating system of their choice
61 on the appropriate web sites.
62
63 Sadly, modifications made by the Mozilla team to the xulrunner API
64 have not propagated through to python-xpcom due to lack of attention
65 and support by the Mozilla team. Older versions of XULRunner must be
66 used: versions 1.9.0 or 1.9.1 are known to be suitable, as is version
67 9.0. Versions 10 and above are known to segfault. The Mozilla
68 Foundation is NOT paying attention to the stability of xulrunner for
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
69 embedded purposes: many applications (not just pyjs-desktop) are
8195c9a readme formatting
Lex Berezhny authored
70 now being left without working, stable code.
df8f84b update README to 0.8
Luke Leighton authored
71
4345ffc readme formatting
Lex Berezhny authored
72 2. PyWebKitGtk
85db82c update README and INSTALL.txt
lkcl authored
73
8195c9a readme formatting
Lex Berezhny authored
74 There are two versions of PyWebKitGTK: please do not use the older
75 version which has been "taken over" by the Webkit team: the Webkit
76 team have decided that full support of and direct-equivalent
77 interoperability with the full W3C HTML specifications is not important.
85db82c update README and INSTALL.txt
lkcl authored
78
8195c9a readme formatting
Lex Berezhny authored
79 The version of pywebkitgtk at http://www.gnu.org/software/pythonwebkit
80 provides full and direct python-equivalent interoperability for all functions
8d86e60 replaced all instances of pyjamas with pyjs
Lex Berezhny authored
81 for which access through javascript has been provided: thus, Pyjs
8195c9a readme formatting
Lex Berezhny authored
82 Desktop will function correctly.
85db82c update README and INSTALL.txt
lkcl authored
83
8195c9a readme formatting
Lex Berezhny authored
84 PyWebkitGtk must be explicitly enabled. create a $HOME/.pyjd/pyjdrc file
85 containing the following two lines:
85db82c update README and INSTALL.txt
lkcl authored
86
8195c9a readme formatting
Lex Berezhny authored
87 [gui]
88 engine=pywebkitgtk
df8f84b update README to 0.8
Luke Leighton authored
89
4345ffc readme formatting
Lex Berezhny authored
90 3. PyWebkitDFB
df8f84b update README to 0.8
Luke Leighton authored
91
8195c9a readme formatting
Lex Berezhny authored
92 This is an experimental but minimally functional engine that is extremely
93 quick to start up. The build dependencies are also drastically smaller than
94 any of the other web browser engines (which indirectly contributes to the
95 fast startup time).
df8f84b update README to 0.8
Luke Leighton authored
96
8195c9a readme formatting
Lex Berezhny authored
97 HTML5 is fully supported, with the exception of Video and Canvas; also
98 missing at present is support for Frames. Despite the present limitations,
99 PyWebkitDFB is highly suited to embedded systems, as well as being useable
100 as an excellent and ultra-quick general-purpose web browser engine.
df8f84b update README to 0.8
Luke Leighton authored
101
8195c9a readme formatting
Lex Berezhny authored
102 PyWebkitDFB must be explicitly enabled. create a $HOME/.pyjd/pyjdrc file
103 containing the following two lines:
df8f84b update README to 0.8
Luke Leighton authored
104
8195c9a readme formatting
Lex Berezhny authored
105 [gui]
106 engine=pywebkitdfb
df8f84b update README to 0.8
Luke Leighton authored
107
4345ffc readme formatting
Lex Berezhny authored
108 4. MSHTML
a2644a5 update for a 0.6~pre3 release
lkcl authored
109
8195c9a readme formatting
Lex Berezhny authored
110 For Windows users, all that's required, other than installing python
111 and Internet Explorer, is one further tiny package: Win32 "comtypes".
a2644a5 update for a 0.6~pre3 release
lkcl authored
112
8195c9a readme formatting
Lex Berezhny authored
113 Win32 "comtypes" can be downloaded here:
114 * http://sourceforge.net/projects/comtypes/
a2644a5 update for a 0.6~pre3 release
lkcl authored
115
8195c9a readme formatting
Lex Berezhny authored
116 Unlike the other ports, which can comprise a whopping great bundle
117 of anything up to 30mb in size, the MSHTML port literally requires
118 nothing more than comtypes, thanks to the far-sighted design of the
119 MSHTML Trident Engine and its extensive COM interface.
9eadcac 0.6 release
lkcl authored
120
4345ffc readme formatting
Lex Berezhny authored
121 5. PyQt4
f9b835b add thomas hennings PyQT4 Pyjamas Desktop engine
Luke Kenneth Casson Leighton authored
122
8195c9a readme formatting
Lex Berezhny authored
123 Kindly contributed by Thomas Henning, the PyQT4 port requires a current
124 PyQt-snapshot with Qt 4.6 (which includes QWebElement, a DOM-like API for
125 WebKit).
f9b835b add thomas hennings PyQT4 Pyjamas Desktop engine
Luke Kenneth Casson Leighton authored
126
8195c9a readme formatting
Lex Berezhny authored
127 The PyQt4 engine is highly experimental, and requires a configuration file
128 to explicitly enable it. create a $HOME/.pyjd/pyjdrc file containing the
129 following two lines:
f9b835b add thomas hennings PyQT4 Pyjamas Desktop engine
Luke Kenneth Casson Leighton authored
130
8195c9a readme formatting
Lex Berezhny authored
131 [gui]
132 engine=pyqt4
f9b835b add thomas hennings PyQT4 Pyjamas Desktop engine
Luke Kenneth Casson Leighton authored
133
8195c9a readme formatting
Lex Berezhny authored
134 Sadly, the PyQT4 port serves more as a demonstration of how never to access
135 web browser DOM functionality from python (ever). The reason is simple:
136 to access all but about 1% of the available DOM functionality, javascript
137 code snippets must be created on-the-fly and executed, and all incoming and
138 outgoing data must be dynamically translated between python and javascript
139 (as Qt4 objects).
df8f84b update README to 0.8
Luke Leighton authored
140
8195c9a readme formatting
Lex Berezhny authored
141 Aside from providing truly dreadful performance, this technical approach
142 should have you either in hysterics, throwing up or requiring counselling,
143 depending on your resilience and constitution. All is not lost: if funding
144 is made available, the PythonWebkit project can, with very little actual
145 coding required, be ported to Qt4, as the GNU PythonWebkit Project has been
146 designed to provide python access to DOM functionality, independent of the
147 actual GUI display engine being used.
df8f84b update README to 0.8
Luke Leighton authored
148
4345ffc readme formatting
Lex Berezhny authored
149 6. PyKDE
df8f84b update README to 0.8
Luke Leighton authored
150
8195c9a readme formatting
Lex Berezhny authored
151 The PyKDE engine has been done as a "thank you" to the KDE Team, without
152 whom Webkit would not exist. Sadly, though, for technical reasons, the PyKDE
153 engine requires that the entire KHTML Part be compiled with c++ "rtti" enabled,
154 and the majority of GNU/Linux Distributions explicitly disable RTTI due to
155 it having an impact on performance.
4345ffc readme formatting
Lex Berezhny authored
156
8195c9a readme formatting
Lex Berezhny authored
157 If this is ever fixed, then out of sheer nostalgia and bloody-mindedness, the
158 PyKDE engine will have continued support, even though the KHTML engine is only
159 DOM TR2 compliant (at present).
Something went wrong with that request. Please try again.