summaryrefslogtreecommitdiff
path: root/README.rst
blob: 758815d9ab19423b274d27189ef9b1180a9559b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Pecan
=====

A WSGI object-dispatching web framework, designed to be lean and fast with few
dependencies.

.. image:: https://pypip.in/v/pecan/badge.png
    :target: https://crate.io/packages/pecan/
    :alt: Latest PyPI version

Installing
----------

::

    $ pip install pecan

...or, for the latest (unstable) tip::

    $ git clone https://github.com/stackforge/pecan.git
    $ cd pecan && python setup.py install

Running Tests
-------------

::

    $ python setup.py test

...or, to run all tests across all supported environments::

    $ pip install tox && tox

Viewing Documentation
---------------------
`Available online <http://pecan.readthedocs.org>`_, or to build manually::

    $ cd docs && make html
    $ open docs/build/html/index.html

...or::

    $ cd docs && make man
    $ man docs/build/man/pecan.1

Contributing
------------
For information on contributing to Pecan, please read our `Contributing
Guidelines <https://github.com/stackforge/pecan/blob/master/CONTRIBUTING.rst>`_.

Bugs should be filed on Launchpad, not GitHub:

https://bugs.launchpad.net/pecan

Additional Help/Support
-----------------------
Most Pecan interaction is done via the `pecan-dev Mailing List
<https://groups.google.com/forum/#!forum/pecan-dev>`_ and the #pecanpy channel
on `FreeNode <http://freenode.net/>`_ IRC.