Metadata-Version: 2.0
Name: kobin
Version: 0.1.4
Summary: A Minimal WSGI Framework to develop your web application comfortably
Home-page: https://github.com/kobinpy/kobin
Author: Masashi Shibata <contact@c-bata.link>
Author-email: contact@c-bata.link
License: MIT License
Keywords: web framework wsgi
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only

=====
Kobin
=====

.. image:: https://travis-ci.org/kobinpy/kobin.svg?branch=master
   :target: https://travis-ci.org/kobinpy/kobin

.. image:: https://badge.fury.io/py/kobin.svg
   :target: https://badge.fury.io/py/kobin

.. image:: https://coveralls.io/repos/github/kobinpy/kobin/badge.svg?branch=master
   :target: https://coveralls.io/github/kobinpy/kobin?branch=master

.. image:: https://codeclimate.com/github/c-bata/kobin/badges/gpa.svg
   :target: https://codeclimate.com/github/kobinpy/kobin
   :alt: Code Climate

.. image:: https://readthedocs.org/projects/kobin/badge/?version=latest
   :target: http://kobin.readthedocs.org/en/latest/?badge=latest
   :alt: Documentation Status


A Minimal WSGI Framework to develop your web application comfortably.
**This library is a pre-release. Expect missing docs and breaking API changes.**

Kobin has following features.

- Decorator based Routing System exploited Type Hints.
- WSGI request and response Wrapper.
- Provide type annotations from stub files.
- and other convenient utilities...

And Kobin has **NO** following features:

- *WSGI Server Adapters*: Please use WSGICLI or Gunicorn CLI.
- *Serving static contents*: Please use WSGICLI and Nginx.
- *Template Engine*: But Kobin provides template adapter for Jinja2.

Requirements
============

Supported python versions are python 3.6 or later.
And Kobin has no required dependencies other than the Python Standard Libraries.

The following packages are optional:

* wsgicli - Command Line Interface for developing WSGI application.
* jinja2 - Jinja2 is a full featured template engine for Python.

Resources
=========

* `Documentation (English) <https://kobin.readthedocs.org/en/latest/>`_
* `Documentation (Japanese) <https://kobin.readthedocs.org/ja/latest/>`_
* `Github <https://github.com/kobinpy/kobin>`_
* `PyPI <https://pypi.python.org/pypi/kobin>`_
* `Kobin Example <https://github.com/kobinpy/kobin-example>`_


Kobin's documentation is not yet complete very much.
If you want to know the best practices in Kobin,
Please check  `Kobin Example <https://github.com/kobinpy/kobin-example>`_ .

.. image:: docs/source/_static/kobin-example.gif
   :alt: Kobin Example Demo Animation
   :align: center

License
=======

This software is licensed under the MIT License (See `LICENSE <./LICENSE>`_ ).


CHANGES
=======

0.1.4 (2017-01-01)
------------------

Happy New Year! This is a first release in 2017.
We hope kobin helps your web development.

* Enhancement coverage.
* Add some refactoring changes.
* Set Cookie encryption using `config['SECRET_KEY']` .


0.1.3 (2016-12-30)
------------------

* End of support python3.5
* Add accept_best_match function
* Refactor config object.
* Modify after request hook


0.1.2 (2016-12-18)
------------------

* Support cookie encrypting.
* Add BaseResponse class.

0.1.1 (2016-12-17)
------------------

* Response class can return bytes.
* Fix stub files.

0.1.0 (2016-12-07)
------------------

* Add before_request / after_request hook
* Update docs.

0.0.7 (2016-12-05)
------------------

* headers property in Request object.
* raw_body property in Request object.
* Remove jinja2 from install_requires.
* Update docs.

0.0.6 (2016-12-04)
------------------

* Integrating wsgicli.
* Alter sphinx theme.
* Update documentations.
* View functions must return Response or its child class.
* Make Request object to No thread local
* Add Response, JSONResponse, TemplateResponse, RedirectResponse.
* Refactor error handling.
* Add stub files (`.pyi`).
* Python3.6 testing in travis-ci.org.
* Add API documentation.

0.0.5 (2016-11-28)
------------------

* Replace regex router with new style router.
* Correspond reverse routing.
* Remove serving static file. Please use wsgi-static-middleware.
* Remove server adapter.
* Support only Jinja2.
* Refactoring.

0.0.4 (2016-02-28)
------------------

* Expect the types of routing arguments from type hints.
* Implement template adapter for jinja2.
* Server for static files such as css, images, and so on.
* Manage configuration class.
* Support gunicorn.
* Error handling.
* Fix several bugs.

0.0.3 (2016-02-08)
------------------

* Request and Response object.
* tox and Travis-CI Integration.

0.0.2 (2015-12-03)
------------------

* Publish on PyPI.

0.0.0 (2015-09-14)
------------------

* Create this project.


