Metadata-Version: 1.1
Name: django-hosts
Version: 1.0
Summary: Dynamic and static host resolving for Django. Maps hostnames to URLconfs.
Home-page: http://django-hosts.rtfd.org/
Author: Jannis Leidel
Author-email: jannis@leidel.info
License: BSD
Description: django-hosts
        ============
        
        .. image:: https://img.shields.io/pypi/v/django-hosts.svg
           :target: https://pypi.python.org/pypi/django-hosts
        
        .. image:: https://img.shields.io/travis/jezdez/django-hosts.svg
            :target: https://travis-ci.org/jezdez/django-hosts
        
        .. image:: https://img.shields.io/coveralls/jezdez/django-hosts.svg
           :target: https://coveralls.io/r/jezdez/django-hosts
        
        .. image:: https://readthedocs.org/projects/django-hosts/badge/?version=latest&style=plastic
           :target: http://django-hosts.readthedocs.org/en/latest/
        
        
        This Django app routes requests for specific hosts to different URL schemes
        defined in modules called "hostconfs".
        
        For example, if you own ``example.com`` but want to serve specific content
        at ``api.example.com`` and ``beta.example.com``, add the following to a
        ``hosts.py`` file::
        
            from django_hosts import patterns, host
        
            host_patterns = patterns('path.to',
                host(r'api', 'api.urls', name='api'),
                host(r'beta', 'beta.urls', name='beta'),
            )
        
        This causes requests to ``{api,beta}.example.com`` to be routed to their
        corresponding URLconf. You can use your ``urls.py`` as a template for these
        hostconfs.
        
        Patterns are evaluated in order. If no pattern matches, the request is
        processed in the usual way, ie. using the standard ``ROOT_URLCONF``.
        
        The patterns on the left-hand side are regular expressions. For example,
        the following ``ROOT_HOSTCONF`` setting will route ``foo.example.com``
        and ``bar.example.com`` to the same URLconf.
        
        ::
        
            from django_hosts import patterns, host
        
            host_patterns = patterns('',
                host(r'(foo|bar)', 'path.to.urls', name='foo-or-bar'),
            )
        
        .. note:
        
          Remember:
        
          * Patterns are matched against the extreme left of the requested host
        
          * It is implied that all patterns end either with a literal full stop
            (ie. ".") or an end of line metacharacter.
        
          * As with all regular expressions, various metacharacters need quoting.
        
        Installation
        ------------
        
        First, install the app with your favorite package manager, e.g.::
        
            pip install django-hosts
        
        Alternatively, use the `repository on Github`_.
        
        You can find the full docs here: `django-hosts.rtfd.org`_
        
        Then configure your Django site to use the app:
        
        #. Add ``'django_hosts'`` to your ``INSTALLED_APPS`` setting.
        
        #. Add ``'django_hosts.middleware.HostsRequestMiddleware'`` to the **beginning** of your
           ``MIDDLEWARE_CLASSES`` setting.
        
        #. Add ``'django_hosts.middleware.HostsResponseMiddleware'`` to the **end** of your
           ``MIDDLEWARE_CLASSES`` setting.
        
        #. Create a new module containing your default host patterns,
           e.g. in the ``hosts.py`` file next to your ``urls.py``.
        
        #. Set the ``ROOT_HOSTCONF`` setting to the dotted Python
           import path of the module containing your host patterns, e.g.::
        
               ROOT_HOSTCONF = 'mysite.hosts'
        
        #. Set the ``DEFAULT_HOST`` setting to the **name** of the host pattern you
           want to refer to as the default pattern. It'll be used if no other
           pattern matches or you don't give a name to the ``host_url`` template
           tag.
        
        .. _`repository on Github`: https://github.com/jezdez/django-hosts
        .. _`django-hosts.rtfd.org`: http://django-hosts.readthedocs.org/
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
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: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
