updating latest version with up to date documentation

This commit is contained in:
2020-01-14 00:59:48 +00:00
parent f0e00d8f2a
commit f202bca28f
21 changed files with 414 additions and 67 deletions

View File

@@ -1,21 +1,66 @@
.. include:: ../global.rst
Config :modname:`panaetius`
-------------------------------------
*********
panaetius
*********
.. automodule:: panaetius
:members:
:undoc-members:
:show-inheritance:
API
===
Submodules
----------
The following is availble by importing the module:
.. toctree::
.. code-block:: python
panaetius.config
panaetius.config_inst
panaetius.db
panaetius.header
panaetius.library
panaetius.logging
import panaetius
panaetius.CONFIG
----------------
:obj:`panaetius.CONFIG` provides an instance of :class:`panaetius.config.Config`
panaetius.set_config()
-----------------------
Conveniently provides :func:`panaetius.library.set_config`
Use in your module/script with:
.. code-block:: python
panaetius.set_config(panaetius.CONFIG, 'aws.secret_key', str, mask=True)
panaetius.CONFIG.aws_secret_key
-------------------------------
Conveniently provides access to all attributes that have been declared with :func:`panaetius.library.set_config`:
.. code-block:: python
my_secret_key = panaetius.CONFIG.aws_secret_key
panaetius.logger
-----------------
:obj:`panaetius.logger` provides a logger instance already formatted with a nice json output.
.. code-block:: python
panaetius.logger.info('some logging message')
This gives a logger output of:
.. code-block:: json
{
"time": "2020-01-13 23:07:17,913",
"file_name": "test.py",
"module": "test",
"function":"<module>",
"line_number": "33",
"logging_level":"INFO",
"message": "some logging message"
}