Metadata-Version: 1.1
Name: django-app-namespace-template-loader
Version: 0.2
Summary: Template loader allowing you to both extend and override a template at the same time. 
Home-page: https://github.com/Fantomas42/django-app-namespace-template-loader
Author: Fantomas42
Author-email: fantomas42@gmail.com
License: BSD License
Description: ====================================
        Django App Namespace Template Loader
        ====================================
        
        |travis-develop| |coverage-develop|
        
        Provides a template loader that allows you to load a template from a
        specific application. This allows you to both **extend** and **override** a
        template at the same time.
        
        The default Django loaders require you to copy the entire template you want
        to override, even if you only want to override one small block.
        
        This is the issue that this package tries to resolve.
        
        Examples:
        ---------
        
        You want to change the titles of the admin site, you would originally
        created this template: ::
        
            $ cat my-project/templates/admin/base_site.html
            {% extends "admin/base.html" %}
            {% load i18n %}
        
            {% block title %}{{ title }} | My Project{% endblock %}
        
            {% block branding %}
            <h1 id="site-name">My Project</h1>
            {% endblock %}
        
            {% block nav-global %}{% endblock %}
        
        Extend and override version with a namespace: ::
        
            $ cat my-project/templates/admin/base_site.html
            {% extends "admin:admin/base_site.html" %}
        
            {% block title %}{{ title }} - My Project{% endblock %}
        
            {% block branding %}
            <h1 id="site-name">My Project</h1>
            {% endblock %}
        
        Note that in this version the block ``nav-global`` does not have to be
        present because of the inheritance.
        
        Shorter version without namespace: ::
        
            $ cat my-project/templates/admin/base_site.html
            {% extends ":admin/base_site.html" %}
        
            {% block title %}{{ title }} - My Project{% endblock %}
        
            {% block branding %}
            <h1 id="site-name">My Project</h1>
            {% endblock %}
        
        If we do not specify the application namespace, the first matching template
        will be used. This is useful when several applications provide the same
        templates but with different features.
        
        Example of multiple empty namespaces: ::
        
            $ cat my-project/application/templates/application/template.html
            {% block content%}
            <p>Application</p>
            {% endblock content%}
        
            $ cat my-project/application_extension/templates/application/template.html
            {% extends ":application/template.html" %}
            {% block content%}
            {{ block.super }}
            <p>Application extension</p>
            {% endblock content%}
        
            $ cat my-project/templates/application/template.html
            {% extends ":application/template.html" %}
            {% block content%}
            {{ block.super }}
            <p>Application project</p>
            {% endblock content%}
        
        Will render: ::
        
            <p>Application</p>
            <p>Application extension</p>
            <p>Application project</p>
        
        Installation
        ------------
        
        Add ``app_namespace.Loader`` to the ``TEMPLATE_LOADERS`` setting of your
        project. ::
        
            TEMPLATE_LOADERS = [
              'app_namespace.Loader',
              ... # Other template loaders
            ]
        
        Known limitations
        =================
        
        ``app_namespace.Loader`` can not work properly if you use it in conjunction
        with ``django.template.loaders.cached.Loader`` and inheritance based on
        empty namespaces.
        
        Notes
        -----
        
        Based originally on: http://djangosnippets.org/snippets/1376/
        
        Requires: Django >= 1.4
        
        Tested with Python 2.6, 2.7, 3.2, 3.3.
        
        .. |travis-develop| image:: https://travis-ci.org/Fantomas42/django-app-namespace-template-loader.png?branch=develop
           :alt: Build Status - develop branch
           :target: http://travis-ci.org/Fantomas42/django-app-namespace-template-loader
        .. |coverage-develop| image:: https://coveralls.io/repos/Fantomas42/django-app-namespace-template-loader/badge.png?branch=develop
           :alt: Coverage of the code
           :target: https://coveralls.io/r/Fantomas42/django-app-namespace-template-loader
        
Keywords: django,template,loader
Platform: any
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
