Metadata-Version: 2.1
Name: unicef-djangolib
Version: 0.6
Summary: Django package that handles exporting of data
Home-page: https://github.com/unicef/unicef-djangolib
Author: UNICEF
Author-email: dev@unicef.org
License: Apache 2 License
Platform: any
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Provides-Extra: test
License-File: LICENSE

Djangolib
=========


Installation
------------

.. code-block:: bash

    pip install unicef-djangolib


Setup
-----

Add ``unicef_djangolib`` to ``INSTALLED_APPS`` in settings

.. code-block:: bash

    INSTALLED_APPS = [
        ...
        'unicef_djangolib',
    ]

Configure the html elements for display:

.. code-block:: bash

    NAME = os.environ.get('NAME', 'default_name')
    VERSION = os.environ.get('VERSION', 'default_version')
    BACKGROUND_COLOR = os.environ.get('HEADER_BG_COLOR', '#42515A')
    HEADER_RIGHT_LOGO = os.environ.get('HEADER_RIGHT_LOGO', "/static/images/default_right.svg")
    HEADER_LEFT_LOGO = os.environ.get('HEADER_LEFT_LOGO', "/static/images/default_left.svg")
    FOOTER_LOGO = os.environ.get('FOOTER_LOGO', "/static/images/default_footer_logo.png")

Usage
-----

TODO

Contributing
------------

Environment Setup
~~~~~~~~~~~~~~~~~

To install the necessary libraries

.. code-block:: bash

    $ make install


Coding Standards
~~~~~~~~~~~~~~~~

See `PEP 8 Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008/>`_ for complete details on the coding standards.

To run checks on the code to ensure code is in compliance

.. code-block:: bash

    $ make lint


Testing
~~~~~~~

Testing is important and tests are located in `tests/` directory and can be run with;

.. code-block:: bash

    $ make test

Coverage report is viewable in `build/coverage` directory, and can be generated with;


Project Links
~~~~~~~~~~~~~

 - Continuous Integration - https://circleci.com/gh/unicef/unicef-djangolib/tree/develop
 - Source Code - https://github.com/unicef/unicef-djangolib



Links
-----

+--------------------+----------------+--------------+--------------------+
| Stable             |                | |master-cov| |                    |
+--------------------+----------------+--------------+--------------------+
| Development        |                | |dev-cov|    |                    |
+--------------------+----------------+--------------+--------------------+
| Source Code        |https://github.com/unicef/unicef-djangolib          |
+--------------------+----------------+-----------------------------------+
| Issue tracker      |https://github.com/unicef/unicef-djangolib/issues   |
+--------------------+----------------+-----------------------------------+


.. |master-cov| image:: https://circleci.com/gh/unicef/unicef-djangolib/tree/master.svg?style=svg
                    :target: https://circleci.com/gh/unicef/unicef-djangolib/tree/master


.. |dev-cov| image:: https://circleci.com/gh/unicef/unicef-djangolib/tree/develop.svg?style=svg
                    :target: https://circleci.com/gh/unicef/unicef-djangolib/tree/develop


Compatibility Matrix
--------------------

.. image:: https://travis-matrix-badges.herokuapp.com/repos/unicef/unicef-djangolib/branches/develop


