|
1 | | -Flask-Autodoc |
| 1 | +Flask-Selfdoc |
2 | 2 | ============= |
3 | 3 |
|
4 | | -Flask-Autodoc is a Flask extension that automatically creates documentation for your endpoints based on the routes, function arguments and docstrings. |
| 4 | +Flask-Selfdoc is a Flask extension that automatically creates documentation for your endpoints based on the routes, function arguments and docstrings. It was forked from Flask-Autodoc, written by Arnaud Coomans, and is completely compatible as a replacement for that extension. |
5 | 5 |
|
6 | | -[](https://travis-ci.org/acoomans/flask-autodoc) |
7 | | -[](https://pypi.python.org/pypi/Flask-Autodoc) |
8 | | -[](https://pypi.python.org/pypi/Flask-Autodoc) |
| 6 | +[](https://travis-ci.org/jwg4/flask-autodoc) |
| 7 | +[](https://pypi.python.org/pypi/Flask-Selfdoc) |
| 8 | +[](https://pypi.python.org/pypi/Flask-Selfdoc) |
9 | 9 |  |
10 | 10 |  |
11 | 11 |
|
12 | 12 |
|
13 | 13 | ## Requirements |
14 | 14 |
|
15 | | -Flask-Autodoc is compatible with Python versions 2 and 3; and it depends only on Flask. |
| 15 | +Flask-Selfdoc is compatible with Python versions 2 and 3; and it depends only on Flask. |
16 | 16 |
|
17 | 17 | ## Install |
18 | 18 |
|
19 | | -To install Flask-Autodoc, run pip: |
| 19 | +To install Flask-Selfdoc, run pip: |
20 | 20 |
|
21 | | - pip install flask-autodoc |
| 21 | + pip install flask-selfdoc |
22 | 22 |
|
23 | 23 | or clone this directory and run setup: |
24 | 24 |
|
25 | 25 | python setup.py install |
26 | 26 |
|
27 | 27 | ## Usage |
28 | 28 |
|
29 | | -Start using Flask-Autodoc by importing it and initializing it: |
| 29 | +Start using Flask-Selfdoc by importing it and initializing it: |
30 | 30 |
|
31 | 31 | from flask import Flask |
32 | | - from flask.ext.autodoc import Autodoc |
| 32 | + from flask.ext.selfdoc import Autodoc |
33 | 33 |
|
34 | 34 | app = Flask(__name__) |
35 | 35 | auto = Autodoc(app) |
36 | 36 |
|
37 | | -by default, Flask-Autodoc will only document the routes explicitly decorated with _doc_: |
| 37 | +by default, Flask-Selfdoc will only document the routes explicitly decorated with _doc_: |
38 | 38 |
|
39 | 39 | @app.route('/user/<int:id>') |
40 | 40 | @auto.doc() |
|
0 commit comments