Metadata-Version: 2.1
Name: python-chamelboots
Version: 0.0.28
Summary: An example package. Generated with cookiecutter-pylibrary.
Home-page: https://github.com/dm-wyncode/python-chamelboots
Author: Don Morehouse
Author-email: dm.wyncode@gmail.com
License: BSD-2-Clause
Project-URL: Documentation, https://python-chamelboots.readthedocs.io/
Project-URL: Changelog, https://python-chamelboots.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/dm-wyncode/python-chamelboots/issues
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Text Processing
Requires-Python: >=3.8
Requires-Dist: lxml (>=4.4.1)
Requires-Dist: Chameleon (>=3.6.2)
Requires-Dist: Faker
Requires-Dist: bs4
Requires-Dist: Pillow (>=6.2.1)

========
Overview
========


Version v0.0.28.
----------------


This is a proof of concept package. It came out of my disdain for typing any sort of HTML tag.

I often code inside of `Jupyter notebooks`_. Sometimes I want to display custom HTML inside of those notebooks.

The issue is that writing complex HTML such as a list by hand is tedious and error-prone. Template libraries do help, but they introduce their own clumsy syntax into HTML. And the templates are often very long strings that clutter the notebook. Storing the templates in files takes my mind away from the notebooks. 

Then I discovered the template library Chameleon_ that uses valid HTML as its template. Brilliant!

Though I would still have to type the templates which are HTML tags which takes me back to my original disdain of typing HTML tags.

This library addresses that issue. It also adds some utilities that I use when coding inside notebooks.

`Here is an example`_ where I used chamelboots to insert a link menu into a notebook. The links were references to anchor tags inserted into a very long cell output. It made it easier to navigate the output. *The navigation can even happen during code execution.*

.. image:: ./readme_assets/anchors.gif




Generated with cookiecutter-pylibrary.

* Free software: BSD 2-Clause License

Installation
============

.. code-block:: bash

    pip install chamelboots

You can also install the in-development version with

.. code-block:: bash

    pip install https://github.com/dm-wyncode/python-chamelboots/archive/master.zip


It is still possible to install by cloning this repository, activating a virtual environment, and running the following:

.. code-block:: bash

   python setup.py install 



Documentation
=============


https://python-chamelboots.readthedocs.io/


Development
===========

To run the all tests run::

    tox

Note, to combine the coverage data from all the tox environments run:

.. list-table::
    :widths: 10 90
    :stub-columns: 1

    - - Windows
      - ::

            set PYTEST_ADDOPTS=--cov-append
            tox

    - - Other
      - ::

            PYTEST_ADDOPTS=--cov-append tox

.. _Chameleon: https://chameleon.readthedocs.io/en/latest/
.. _programmatically: https://english.stackexchange.com/a/12246/159162
.. _`Python Packages index`: https://pypi.org/
.. _`Jupyter notebooks`: https://jupyter.org/
.. _`Here is an example`: https://zip.apps.selfip.com/posts/insert-a-menu-and-anchor-tags-in-a-long-jupyter-notebook-output-cell/


Changelog
=========

0.0.0 (2019-11-05)
------------------

* First release on PyPI.


