gergely
/
flask-logging-extras
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update README 

With all the fancy badges and a correct documentation URL (and as a fully
valid RST document)
This commit is contained in:
Gergely Polonkai 2017-01-16 12:42:09 +01:00
parent 0da075f683
commit dbe822a02c
1 changed files with 29 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.rst
View File

@ -1,25 +1,42 @@
Flask-Logging-Extras Flask-Logging-Extras
==================== ====================
[travis button] [coveralls button] [pypi button] [documentation button] .. image:: https://travis-ci.org/gergelypolonkai/flask-logging-extras.svg?branch=master
:target: https://travis-ci.org/gergelypolonkai/flask-logging-extras
.. image:: https://codecov.io/gh/gergelypolonkai/flask-logging-extras/branch/master/graph/badge.svg
:target: https://codecov.io/gh/gergelypolonkai/flask-logging-extras
.. image:: https://badge.fury.io/py/Flask-Logging-Extras.svg
:target: https://badge.fury.io/py/Flask-Logging-Extras
.. image:: https://readthedocs.org/projects/flask-logging-extras/badge/?version=latest
:target: http://flask-logging-extras.readthedocs.io/en/latest/?badge=latest
Flask-Logging-Extras adds additional logging features for Flask applications. Flask-Logging-Extras adds additional logging features for Flask applications.
The only feature implemented now is adding extra arguments to the format The only feature implemented now is adding extra arguments to the format
string, like this: string, like this (this example adds the category keyword to the logs:
.. code-block:: python .. code-block:: python
fmt = '[%(asctime)s] [%(levelname)s] [%(category)s] %(message' fmt = '[%(asctime)s] [%(levelname)s] [%(category)s] %(message'
# Initialize log handlers as usual, like creating a FileHandler, and # Initialize log handlers as usual, like creating a FileHandler, and
# assign fmt to it as a format string # assign fmt to it as a format string
app.config['FLASK_LOGGING_EXTRAS_KEYWORDS'] = {'category': '<unset>'}
app.logger.init_app(app)
current_app.logger.info('this is the message, as usual', current_app.logger.info('this is the message, as usual',
category='fancy-category') category='fancy-category')
### Installation Installation
------------
pip will be available (hopefully) soon. The easiest way to start using the package is with pip:
.. code-block:: sh
$ pip install Flask-Logging-Extras
If you prefer to install from source, you can clone this repo and run If you prefer to install from source, you can clone this repo and run
@ -30,8 +47,8 @@ If you prefer to install from source, you can clone this repo and run
Usage Usage
----- -----
[View the documentation online] (http://flask-jwt-extended.readthedocs.io/en/latest/) `View the documentation online
<http://flask-logging-extras.readthedocs.io/>`_
Testing and Code Coverage Testing and Code Coverage
------------------------- -------------------------
@ -48,15 +65,18 @@ your local machine, you can simply invoke it with the `tox` command.
Generating Documentation Generating Documentation
------------------------ ------------------------
You can generate a local copy of the documentation. First, make sure you have You can generate a local copy of the documentation. First, make sure you
the flask sphinx theme available. You can get it with have the flask sphinx theme available. You can get it (and all possible
documentation requirements) with
.. code-block:: sh .. code-block:: sh
$ pip install Flask-Sphinx-Themes
$ pip install -r docs-requirements.txt
Then in the `docs/` directory, run Then in the `docs/` directory, run
.. code-block:: sh .. code-block:: sh
$ make clean && make html $ make clean && make html
License License