Metadata-Version: 1.0
Name: django-model-blocks
Version: 0.8.1
Summary: Simple filters and tags for generic Django model template partials
Home-page: https://github.com/mjumbewu/django-model-blocks/
Author: Mjumbe Wawatu Ukweli
Author-email: mjumbewu@kwawatu.com
License: UNKNOWN
Download-URL: https://github.com/mjumbewu/django-model-blocks/downloads
Description: ====================
        Django Model Blocks
        ====================
        
        The ``model_blocks`` app provides you with automatically generated, stylable
        generic Django templates. It fills a gap left by ``admin`` and ``databrowse`` by
        providing filters and tags that allow your to painlessly create templates with 
        the following properties:
        
        * Automatically generated read-only views
        * Can conform to whatever URL structure you want
        * Can be placed as blocks on to your existing templates
        * Integrate well with the rest of your project
        
        Add this to the top of any template::
        
            {% load model_blocks %}
        
        And drop the filter anywhere you have a model instance (e.g., DetailViews)::
        
            {{ object|as_detail_block }}
        
        Quick Reference
        ---------------
        
        Installing
        ~~~~~~~~~~
        
        You can install the ``model_blocks`` app from PyPI::
        
            $ pip install django-model-blocks
        
        Settings
        ~~~~~~~~
        
        Modify your ``INSTALLED_APPS`` setting to include::
        
            ...
            model_blocks,
            ...
        
        If you plan on overriding any of ``model_blocks``'s default templates, remember
        that ``app_directories.Loader`` searches apps in the order they are specified
        in ``INSTALLED_APPS``.
        
        Usage
        ~~~~~
        
        Near the top of any template you want to use model blocks, or in a base 
        template, include the following line::
        
            {% load model_blocks %}
        
        Then, where you want to drop a generic model template, use::
        
            {{ object|as_detail_block }}
        
        Or::
        
            {{ object_list|as_list_block }}
        
        By default, the title on an object detail block will be the unicode
        representation of the object, and the title on a list will be the name of the
        model appended with `' List'`. To change the title, pass in a parameter::
        
            {{ object|as_detail_block:"My Special Object" }}
        
        Help Out
        --------
        
        Found a bug? File an issue at `Github
        <https://github.com/mjumbewu/django-model-blocks>`. Have an improvement? Fork
        it and add it, or if you can’t code it, contact us to do it.
        
        Development
        ~~~~~~~~~~~
        
        Download the code and then::
        
            $ pip install -r requirements.txt
            
        Running Tests
        ~~~~~~~~~~~~~
        
        Even simple packages need tests::
        
            $ python tests.py --with-coverage --cover-package=model_block
        
        Run it before and after you make any changes.  Try to not let that number drop.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Utilities
