Metadata-Version: 2.1
Name: favico
Version: 0.1.6
Summary: No description has been added so far.
Home-page: https://github.com/romnn/favico
Author: romnn
Author-email: contact@romnn.com
License: MIT
Keywords: favico
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE
License-File: AUTHORS.rst

===============================
favico
===============================

.. image:: https://github.com/romnn/favico/workflows/test/badge.svg
        :target: https://github.com/romnn/favico/actions
        :alt: Build Status

.. image:: https://img.shields.io/pypi/v/favico.svg
        :target: https://pypi.python.org/pypi/favico
        :alt: PyPI version

.. image:: https://img.shields.io/github/license/romnn/favico
        :target: https://github.com/romnn/favico
        :alt: License

.. image:: https://codecov.io/gh/romnn/favico/branch/master/graph/badge.svg
        :target: https://codecov.io/gh/romnn/favico
        :alt: Test Coverage

""""""""

Python library to generate the perfect favicons for every device.

.. code-block:: console

    $ pip install favico

.. code-block:: python

    import favico

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

favico uses `ImageMagick <https://imagemagick.org/index.php>`_ to generate the favicons.

For ubuntu, you can simply install libmagicwand-dev like this:

.. code-block: console

    $ apt-get install libmagickwand-dev 

Usage
------

Using ``favico`` is super easy!
You can either create favicons from an image or from a color:

.. code-block: console

    $ favico color "#f542ec" ./my-favicon-dir
    $ favico image ./path/to/favicon/image.png ./my-favicon-dir

Once you ran the command to test it out, you will see more info on how to
add the favicons to your page (ready to copy paste!)

By default, it is assumed that your website is deployed on the root ``/``.
To template the favicons with another base path, just set the ``--base`` (``-b``) option:

.. code-block: console

    $ favico --base /prod/deployment/subdir color "#f542ec" ./my-favicon-dir
    $ favico --base https://my-webside.com color "#f542ec" ./my-favicon-dir


Development
-----------

For detailed instructions see `CONTRIBUTING <CONTRIBUTING.rst>`_.

Tests
~~~~~~~
You can run tests with

.. code-block:: console

    $ invoke test
    $ invoke test --min-coverage=90     # Fail when code coverage is below 90%
    $ invoke type-check                 # Run mypy type checks

Linting and formatting
~~~~~~~~~~~~~~~~~~~~~~~~
Lint and format the code with

.. code-block:: console

    $ invoke format
    $ invoke lint

All of this happens when you run ``invoke pre-commit``.

Note
-----

This project is still in the alpha stage and should not be considered production ready.


