From 14e7f95d724072937317d13196c8206e3eb57566 Mon Sep 17 00:00:00 2001 From: Jack Grahl Date: Tue, 15 May 2018 18:57:11 +0000 Subject: [PATCH 1/4] Update README. --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index ab8a42e..d841a40 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,24 @@ -Flask-Autodoc +Flask-Selfdoc ============= -Flask-Autodoc is a Flask extension that automatically creates documentation for your endpoints based on the routes, function arguments and docstrings. +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. -[![Build](https://api.travis-ci.org/acoomans/flask-autodoc.png)](https://travis-ci.org/acoomans/flask-autodoc) -[![Pypi version](http://img.shields.io/pypi/v/flask-autodoc.svg)](https://pypi.python.org/pypi/Flask-Autodoc) -[![Pypi license](http://img.shields.io/pypi/l/flask-autodoc.svg)](https://pypi.python.org/pypi/Flask-Autodoc) +[![Build](https://api.travis-ci.org/jwg4/flask-autodoc.png)](https://travis-ci.org/jwg4/flask-autodoc) +[![Pypi version](http://img.shields.io/pypi/v/flask-autodoc.svg)](https://pypi.python.org/pypi/Flask-Selfdoc) +[![Pypi license](http://img.shields.io/pypi/l/flask-selfdoc.svg)](https://pypi.python.org/pypi/Flask-Selfdoc) ![Python 2](http://img.shields.io/badge/python-2-blue.svg) ![Python 3](http://img.shields.io/badge/python-3-blue.svg) ## Requirements -Flask-Autodoc is compatible with Python versions 2 and 3; and it depends only on Flask. +Flask-Selfdoc is compatible with Python versions 2 and 3; and it depends only on Flask. ## Install -To install Flask-Autodoc, run pip: +To install Flask-Selfdoc, run pip: - pip install flask-autodoc + pip install flask-selfdoc or clone this directory and run setup: @@ -26,15 +26,15 @@ or clone this directory and run setup: ## Usage -Start using Flask-Autodoc by importing it and initializing it: +Start using Flask-Selfdoc by importing it and initializing it: from flask import Flask - from flask.ext.autodoc import Autodoc + from flask.ext.selfdoc import Autodoc app = Flask(__name__) auto = Autodoc(app) -by default, Flask-Autodoc will only document the routes explicitly decorated with _doc_: +by default, Flask-Selfdoc will only document the routes explicitly decorated with _doc_: @app.route('/user/') @auto.doc() From a733eeb3d9617e55c9bddfd1fd89e48c96f47c70 Mon Sep 17 00:00:00 2001 From: Jack Grahl Date: Tue, 15 May 2018 19:05:42 +0000 Subject: [PATCH 2/4] Change autodoc to selfdoc, in module names and everywhere else. --- MANIFEST.in | 2 +- examples/custom/blog.py | 2 +- examples/factory/blog/doc.py | 2 +- examples/simple/blog.py | 2 +- {flask_autodoc => flask_selfdoc}/__init__.py | 0 {flask_autodoc => flask_selfdoc}/autodoc.py | 0 {flask_autodoc => flask_selfdoc}/templates/autodoc_default.html | 0 tests/test_autodoc.py | 2 +- 8 files changed, 5 insertions(+), 5 deletions(-) rename {flask_autodoc => flask_selfdoc}/__init__.py (100%) rename {flask_autodoc => flask_selfdoc}/autodoc.py (100%) rename {flask_autodoc => flask_selfdoc}/templates/autodoc_default.html (100%) diff --git a/MANIFEST.in b/MANIFEST.in index d03edc7..c2ccd5e 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,2 +1,2 @@ include README.md -include flask_autodoc/templates/autodoc_default.html +include flask_selfdoc/templates/autodoc_default.html diff --git a/examples/custom/blog.py b/examples/custom/blog.py index f32436c..130777c 100644 --- a/examples/custom/blog.py +++ b/examples/custom/blog.py @@ -2,7 +2,7 @@ from json import dumps from flask import Flask, redirect, request -from flask.ext.autodoc import Autodoc +from flask.ext.selfdoc import Autodoc app = Flask(__name__) diff --git a/examples/factory/blog/doc.py b/examples/factory/blog/doc.py index 17307a6..209431b 100644 --- a/examples/factory/blog/doc.py +++ b/examples/factory/blog/doc.py @@ -1,5 +1,5 @@ from flask import Blueprint -from flask.ext.autodoc import Autodoc +from flask.ext.selfdoc import Autodoc doc = Blueprint('doc', __name__, url_prefix='/doc') diff --git a/examples/simple/blog.py b/examples/simple/blog.py index 52ca75c..58262e3 100644 --- a/examples/simple/blog.py +++ b/examples/simple/blog.py @@ -1,7 +1,7 @@ from json import dumps from flask import Flask, redirect, request -from flask.ext.autodoc import Autodoc +from flask.ext.selfdoc import Autodoc app = Flask(__name__) diff --git a/flask_autodoc/__init__.py b/flask_selfdoc/__init__.py similarity index 100% rename from flask_autodoc/__init__.py rename to flask_selfdoc/__init__.py diff --git a/flask_autodoc/autodoc.py b/flask_selfdoc/autodoc.py similarity index 100% rename from flask_autodoc/autodoc.py rename to flask_selfdoc/autodoc.py diff --git a/flask_autodoc/templates/autodoc_default.html b/flask_selfdoc/templates/autodoc_default.html similarity index 100% rename from flask_autodoc/templates/autodoc_default.html rename to flask_selfdoc/templates/autodoc_default.html diff --git a/tests/test_autodoc.py b/tests/test_autodoc.py index e839c2f..b94692c 100644 --- a/tests/test_autodoc.py +++ b/tests/test_autodoc.py @@ -5,7 +5,7 @@ import os from flask import Flask -from flask.ext.autodoc import Autodoc +from flask.ext.selfdoc import Autodoc class TestAutodoc(unittest.TestCase): From 67bbbe76769f758ef7fa880a17d67bd9b6b797d5 Mon Sep 17 00:00:00 2001 From: Jack Grahl Date: Tue, 15 May 2018 19:10:27 +0000 Subject: [PATCH 3/4] Update in one more place. --- flask_selfdoc/__init__.py | 2 +- setup.py | 15 +++++++-------- 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/flask_selfdoc/__init__.py b/flask_selfdoc/__init__.py index 89e047e..dc7a64c 100644 --- a/flask_selfdoc/__init__.py +++ b/flask_selfdoc/__init__.py @@ -1,3 +1,3 @@ __author__ = 'arnaud' -from flask.ext.autodoc.autodoc import Autodoc +from flask.ext.selfdoc.autodoc import Autodoc diff --git a/setup.py b/setup.py index 066e351..f603f3c 100644 --- a/setup.py +++ b/setup.py @@ -1,8 +1,8 @@ """ -Flask-Autodoc +Flask-Selfdoc ------------- -Flask autodoc automatically creates an online documentation for your flask app. +Flask selfdoc automatically creates an online documentation for your flask app. """ from setuptools import setup @@ -13,19 +13,18 @@ def readme(): setup( - name='Flask-Autodoc', - version='0.1.2', - url='http://github.com/acoomans/flask-autodoc', + name='Flask-Selfdoc', + version='0.2', + url='http://github.com/jwg4/flask-selfdoc', license='MIT', author='Arnaud Coomans', - author_email='arnaud.coomans@gmail.com', description='Documentation generator for flask', long_description=readme(), # py_modules=['flask_autodoc'], # if you would be using a package instead use packages instead # of py_modules: - packages=['flask_autodoc'], - package_data={'flask_autodoc': ['templates/autodoc_default.html']}, + packages=['flask_selfdoc'], + package_data={'flask_selfdoc': ['templates/autodoc_default.html']}, zip_safe=False, include_package_data=True, platforms='any', From f0477a4fe1634d6d5f4734a092580221ef1a4a4e Mon Sep 17 00:00:00 2001 From: Jack Grahl Date: Tue, 15 May 2018 19:41:47 +0000 Subject: [PATCH 4/4] Pin the requirements to an old version of Flask. Flask 1.0 does not support the flask.ext imports that this project currently uses. --- requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index e3e9a71..4a5cb4c 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1 +1 @@ -Flask +Flask==0.12