Metadata-Version: 2.1
Name: python-chamelboots
Version: 0.0.19
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.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Text Processing
Requires-Python: >=3.6
Requires-Dist: lxml (>=4.4.1Chhameleon>=3.6.2)
Requires-Dist: Faker

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


Version v0.0.19.
----------------


This is a proof of concept package. It came out of working with the `Nikolo static site generator`_.

While it's more convenient to write pages and posts with Markdown or reStructuredText_, sometimes HTML is more precise, especially regarding custom `Bootstrap components`_. The issue is that writing HTML by hand is tedious and error-prone. Template libraries do help, but they introduce their own clumsy syntax into HTML. Except at least one: Chameleon_.

Then there is the issue of learning the `template attribute language`_ (TAL) in Chameleon templates.. Fortunately, TAL only has 10 statements. 

This library address the issue of building validated Chameleon templates that when rendered produce validated HTML programmatically_.

The specification is to easily create Chameleon templates to output HTML using strings and Python code.

See working—and constantly changing—examples at `this blog post`_ and `at this blog post`_ .

Reiterating over these posts helps me strategize ways of making the creation of HTML using Python more efficient.




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

.. _`Nikolo static site generator`: https://getnikola.com/
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _`Bootstrap components`: https://getbootstrap.com/docs/4.3/components/alerts/
.. _Chameleon: https://chameleon.readthedocs.io/en/latest/
.. _`template attribute language`: https://chameleon.readthedocs.io/en/latest/reference.html#basics-tal
.. _programmatically: https://english.stackexchange.com/a/12246/159162
.. _`this blog post`: https://zip.apps.selfip.com/posts/create-html-with-strings-and-dictionaries-in-python/
.. _`Python Packages index`: https://pypi.org/
.. _`at this blog post`: https://zip.apps.selfip.com/posts/create-table-of-all-bootstrap-classes/


Changelog
=========

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

* First release on PyPI.


