Metadata-Version: 1.1
Name: Tumulus
Version: 0.2.0
Summary: Python HTML Generator for Recyclable Web Elements
Home-page: https://github.com/oksome/Tumulus/
Author: OKso.me
Author-email: @okso.me
License: AGPLv3
Description: tumulus
        =======
        
        Python HTML Generator for Recyclable Web Elements.
        
        Tumulus is an alternative to Templating languages found in many templating engines such as Jinja2, Django, Mako, ...
        Such templating engines make it difficult to separate logical elements of the page, hence discouraging reusability.
        
        The motivation behind Tumulus is to encourage developers to build reusable web components that can then be
        put together to build web pages or applications.
        
        Example
        ---
        
        ```python
        # Importing the basic brick of Tumulus, the tags creator:
        from tumulus.tags import tags as t
        # This module helps to add JS/CSS libraries in page head/footer:
        import tumulus.lib as lib
        
        def bootstrap_button(text):
            '''Returns a Bootstrap formatted button, and adds the CSS of
            Bootstrap to the dependencies of the page.'''
            return t.div(
                # Standard HTML button with 'text' inside:
                t.button(text, class_='btn btn-info'),
                # Injecting Bootstrap's CSS file in the HTML head.
                # This can be done almost anywhere, as it will be included
                # somewhere else, and there is de-duplication.
                lib.css('bootstrap')
                );
        
        def page(title, text):
            return t.html(
                t.head(
                    t.title(title),
                    t.meta(charset='utf-8'),
                ),
                t.body(
                    t.h1(title),
                    t.p(
                        text
                        ),
                    bootstrap_button('Click Here'),
                    ),
                )
        
        print(
            page('Hello World', 'Hello from Tumulus').build()
            )
        ```
        
        Run tests
        ---
        
        Tumulus uses testing intensely, and tries to keep a coverage close from 100%. Testing
        is done using `pytest` and `pytest-cov`.
        
        Run all tests:
        ```bash
        py.test tumulus
        ```
        
        Generate a coverage report:
        ```bash
        py.test --cov tumulus && coverage html
        ```
        
Keywords: html generator template templating engine
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Markup :: HTML 
