Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 88 lines (60 sloc) 3.108 kB
5c75746 added sandbox install info
bernddorn authored
1 ==================
2 Installing Pyjamas
3 ==================
4
85db82c update README and INSTALL.txt
lkcl authored
5 BEFORE PROCEEDING READ THE FOLLOWING WARNING.
6
7 DO NOT install the pyjamas libraries into /usr/share/python-support,
8 /usr/lib/python2.N/site-packages or ANY location where the "standard"
9 python interpreter could possibly pick them up. The pyjamas libraries
10 have nothing to do with python libraries when used by the compiler,
11 and contain replacements for sys.py, time.py and other modules that
12 are critical to pyjamas. It goes without saying that if you overwrite
13 the standard python modules with the pyjamas equivalents, you will run into
14 massive problems. Don't do it.
15
789a975 get XMLHttpRequest event handling working in MSHTML
lkcl authored
16 Dependencies
17 ============
18
19 For pyjamas javascript compilation, you need python 2 - that's it.
20
21 For Pyjamas Desktop, you will need:
22
23 * Win32 comtypes, or python-hulahop and python-xpcom, or a patched
24 version of pywebkitgtk and webkit-gobject: see
25 http://github.com/lkcl/webkit/16401.master
26
27 These are for the MSHTML, XULrunner and Webkit ports of Pyjamas
28 Desktop, respectively.
29
30 * python-jsonrpc which can be downloaded from http://json-rpc.org
31 if you wish to use JSONRPC.
32
d0c1c2b add warning about use of setup.py
lkcl authored
33 Developer Sandbox Setup
34 =======================
35
36 In this directory run:
37
38 python bootstrap.py
39
85db82c update README and INSTALL.txt
lkcl authored
40 The files ``pyjd/__init__.py``, ``./bin/pyjsbuild`` and ``./bin/pyjscompile``
41 will be created, custom-tailored with hard-coded paths specific to the exact
42 absolute location that the bootstrap.py command is run from. In this way, you
d0c1c2b add warning about use of setup.py
lkcl authored
43 will be able to install, test and use multiple versions of Pyjamas, without
44 cross-interference.
45
46 As they contain hard-coded paths, these custom-tailored commands CANNOT
47 be "moved around". If you move the pyjamas installation, re-run bootstrap.py
48 to recreate the commands, with suitable hard-coded paths.
49
50 To build pyjamas apps see ``./bin/pyjsbuild --help``
51
52
5c75746 added sandbox install info
bernddorn authored
53 System Installation
54 ===================
55
2d62650 goodbye bootstrap.py, goodbye zope buildout, hello simple python scri…
lkcl authored
56 If you are installing pyjamas system-wide, for use by MORE THAN ONE
57 developer of the same multi-user system, run the following command.
d0c1c2b add warning about use of setup.py
lkcl authored
58 Otherwise DO NOT run setup.py, see bootstrap.py. If you are using Windows,
59 you are out of luck and should entirely avoid using setup.py.
60
61 First, you must use bootstrap.py to create suitable ./bin/pyjsbuild
62 and ./bin/pyjscompile commands. For example:
c3d4f69 mention python setup.py install
lkcl authored
63
d0c1c2b add warning about use of setup.py
lkcl authored
64 python boostrap.py /usr/bin /usr/share/pyjamas
65
85db82c update README and INSTALL.txt
lkcl authored
66 After ./pyjd/__init__.py, ./bin/pyjsbuild and ./bin/pyjscompile have been
67 created, they can now be installed system-wide, along with the libraries.
d0c1c2b add warning about use of setup.py
lkcl authored
68
69 python run_bootstrap_first_then_setup.py install
c3d4f69 mention python setup.py install
lkcl authored
70
2d62650 goodbye bootstrap.py, goodbye zope buildout, hello simple python scri…
lkcl authored
71 You *may* need to specify --install-data={pickasuitablelocation}
d0c1c2b add warning about use of setup.py
lkcl authored
72 and you *may* need to specify the same location to the bootstrap.py
73 command (prior to running run_bootstrap_first_then_setup.py)
74
85db82c update README and INSTALL.txt
lkcl authored
75 python bootstrap.py /usr/bin {pickasuitablelocation}
2d62650 goodbye bootstrap.py, goodbye zope buildout, hello simple python scri…
lkcl authored
76
c3d4f69 mention python setup.py install
lkcl authored
77 The commands pyjscompile and pyjsbuild will be installed;
78 the boilerplate web templates, the pyjamas "builtin" libraries
79 and the UI Widget libraries will be installed as data libraries
80 which pyjscompile and pyjsbuild will know about. The default
81 path is:
82
83 {sys.prefix}/share/pyjamas
84
85 You can over-ride this default location with the PYJSPREFIX
86 environment variable.
5c75746 added sandbox install info
bernddorn authored
87
Something went wrong with that request. Please try again.