/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 17:26:06 UTC
  • mto: This revision was merged to the branch mainline in revision 529.
  • Revision ID: cjwatson@canonical.com-20220808172606-77xzhydq226ohtma
https://launchpad.net/bugs/1831661
Modernize packaging.

There are new dependencies on `importlib_metadata` (for Python < 3.8)
and `packaging`, in order to avoid a self-import in `setup.py`.  People
proxying Loggerhead through Apache should install the
`loggerhead[proxied]` extra; people running it via FastCGI, SCGI, or AJP
should install the `loggerhead[flup]` extra.

The version handling rearrangements make it possible to install
Loggerhead using `pip`.

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
 
- Paste Deploy  (optional, needed when proxying through Apache).
 
20
- PasteDeploy (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:`easy_install`
36
 
#####################################################
 
35
Installing Dependencies Using :command:`pip`
 
36
############################################
 
37
 
 
38
You should normally create and activate a virtual environment first.
37
39
 
38
40
.. code-block:: sh
39
41
 
40
 
   $ easy_install Chameleon
41
 
   $ easy_install Paste
42
 
   $ easy_install PasteDeploy
43
 
   $ easy_install flup
 
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]'
44
48
 
45
49
 
46
50
Running the Standalone Loggerhead Server