/loggerhead/trunk

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/loggerhead/trunk

« back to all changes in this revision

Viewing changes to docs/index.rst

  • Committer: Colin Watson
  • Date: 2022-08-08 16:33:50 UTC
  • mto: This revision was merged to the branch mainline in revision 528.
  • Revision ID: cjwatson@canonical.com-20220808163350-xd8ilh0u5m1kiylb
Port from SimpleTAL to Chameleon.

SimpleTAL is a painful dependency, because it has no download files on
PyPI: the only way to depend on it properly is therefore using a direct
URL reference, and as I understand it packages with such references
those can't be uploaded to PyPI.

Porting to Chameleon (Zope's default TAL implementation nowadays) turns
out not to be too difficult.  The main work involved is because it
doesn't support path expressions.  It would be possible to add those
using `z3c.pt`, and I considered that, but that has a significant
dependency tree for packages that don't already use the Zope Toolkit,
and it would have also required extra startup complexity to register
`ITraversable` adapters.  It's easier to convert path expressions to the
equivalent Python expressions, although the process of doing so was
unfortunately quite error-prone.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/index.rst
17
17
 
18
18
- Paste for the server. (You need version 1.2 or newer of Paste).
19
19
 
20
 
- PasteDeploy (optional, needed when proxying through Apache).
 
20
- Paste Deploy  (optional, needed when proxying through Apache).
21
21
 
22
22
- flup (optional, needed to use FastCGI, SCGI or AJP).
23
23
 
32
32
   $ sudo apt-get install python-pastedeploy
33
33
   $ sudo apt-get install python-flup
34
34
 
35
 
Installing Dependencies Using :command:`pip`
36
 
############################################
37
 
 
38
 
You should normally create and activate a virtual environment first.
 
35
Installing Dependencies Using :command:`easy_install`
 
36
#####################################################
39
37
 
40
38
.. code-block:: sh
41
39
 
42
 
   # Basic installation only
43
 
   $ pip install loggerhead
44
 
   # Installation for proxying through Apache
45
 
   $ pip install 'loggerhead[proxied]'
46
 
   # Installation for FastCGI, SCGI or AJP
47
 
   $ pip install 'loggerhead[flup]'
 
40
   $ easy_install Chameleon
 
41
   $ easy_install Paste
 
42
   $ easy_install PasteDeploy
 
43
   $ easy_install flup
48
44
 
49
45
 
50
46
Running the Standalone Loggerhead Server