ddd-nginx 0.1.7
DDD nginx framework for python

DDD Nginx Framework
===================

|Build Status| |Pypi Status| |Coveralls Status|

Installation
------------

From source code:

::

    python setup.py install

From pypi:

::

    pip install ddd-base

Usage
-----

::

    from ddd_nginx.nginx import Nginx
    from ddd_nginx.map import Map, MapKeyParis, MapDefinition
    from ddd_nginx.server import Server
    from ddd_nginx.location import Location, ReverseProxyStrategy
    from ddd_nginx.upstream import Upstream


    nginx = Nginx(host="oneapi.cc")
    nginx.namespace = "api"

    a_map = Map(MapDefinition(key="$http_apikey", value="$api_client_name"))
    a_map.append(MapKeyParis("7B5zIqmRGXmrJTFmKa99vcit", "client_one"))
    a_map.append(MapKeyParis("QzVV6y1EmQFbbxOfRCwyJs35", "client_two"))
    a_map.append(MapKeyParis("mGcjH8Fv6U9y3BVF9H3Ypb9T", "client_six"))

    a_upstream = Upstream(name="warehouse_inventory")
    a_upstream.append("10.0.0.1:80")
    a_upstream.append("10.0.0.2:80")
    a_upstream.append("10.0.0.3:80")

    b_upstream = Upstream(name="warehouse_pricing")
    b_upstream.append("10.0.0.1:80")
    b_upstream.append("10.0.0.2:80")
    b_upstream.append("10.0.0.3:80")

    a_location = Location(
        name="/api/warehouse/inventory",
        proxy=ReverseProxyStrategy('rewrite', '^ /_warehouse last')
    )
    a_location.set_var("$upstream", "warehouse_inventory")
    b_location = Location(
        name="/api/warehouse/pricing",
        proxy=ReverseProxyStrategy('rewrite', '^ /_warehouse last')
    )
    b_location.set_var("$upstream", "warehouse_pricing")
    c_location = Location(
        name="= /_warehouse",
        proxy=ReverseProxyStrategy('proxy_pass', 'http://$upstream$request_uri'),
        scope="internal"
    )
    c_location.set_var("$api_name", "Warehouse")

    a_server = Server(name=nginx.namespace)
    a_server.set_var("$api_name", "-")

    nginx.append(a_map)
    nginx.append(a_upstream)
    nginx.append(b_upstream)
    nginx.append(a_location)
    nginx.append(b_location)
    nginx.append(c_location)
    nginx.append(a_server)

    root_dir = "./dumps_dir"
    nginx.dumps(root_dir)



License
-------

This software is licensed under the `MIT license <http://en.wikipedia.org/wiki/MIT_License>`_

See `License file <https://github.com/sunwei/ddd-base/blob/master/LICENSE>`_

.. |Build Status| image:: https://travis-ci.com/sunwei/ddd-nginx.svg?branch=master
   :target: https://travis-ci.com/sunwei/ddd-nginx
.. |Pypi Status| image:: https://badge.fury.io/py/ddd-nginx.svg
   :target: https://badge.fury.io/py/ddd-nginx
.. |Coveralls Status| image:: https://coveralls.io/repos/github/sunwei/ddd-nginx/badge.svg?branch=master
   :target: https://coveralls.io/github/sunwei/ddd-nginx?branch=master

Changelog
=========

0.1.7
-----

- Https by default

0.1.6
-----

- Add magic dump

0.1.2
-----

- Template exposed

0.1.1
-----

- Add server to support tls or not

0.1.0
-----

- Provide all in one configure file

0.0.8
-----

- Include template files

0.0.7
-----

- Include jinja2 templates

0.0.6
-----

- Add json error page configuration file

0.0.5
-----

- Add coverage

0.0.4
-----

- Clear dependency

0.0.3
-----

- Dumps nginx to files

0.0.2
-----

- Render conf with template

0.0.1
-----

- Initial public release