Metadata-Version: 1.2
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
Description: ========
        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.
        
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
