muffin 0.1.4
pip install muffin==0.1.4
Newer version available (1.1.4)
Released:
web framework based on Asyncio stack
Navigation
Unverified details
These details have not been verified by PyPIProject links
Meta
- License: BSD License (MIT)
- Author: Kirill Klenov
- Tags asyncio , aiohttp , web
Classifiers
- Development Status
- Intended Audience
- License
- Natural Language
- Operating System
- Programming Language
- Topic
Project description
.. image:: https://raw.github.com/klen/muffin/develop/logo.png
:height: 100px
:width: 100px
The Muffin
##########
.. _badges:
.. image:: http://img.shields.io/travis/klen/muffin.svg?style=flat-square
:target: http://travis-ci.org/klen/muffin
:alt: Build Status
.. image:: http://img.shields.io/pypi/v/muffin.svg?style=flat-square
:target: https://pypi.python.org/pypi/muffin
.. image:: http://img.shields.io/pypi/dm/muffin.svg?style=flat-square
:target: https://pypi.python.org/pypi/muffin
.. image:: http://img.shields.io/gratipay/klen.svg?style=flat-square
:target: https://www.gratipay.com/klen/
:alt: Donate
.. _description:
The Muffin -- A web framework based on Asyncio_ stack ``(early beta)``
Muffin is a fast, simple and asyncronous web-framework for Python_ 3.
Example "Hello User" with the Muffin:
.. code-block:: python
import muffin
app = muffin.Application('example')
@app.register('/', '/hello/{name}')
def hello(request):
name = request.match_info.get('name', 'anonymous')
return 'Hello %s!' % name
Save the script as `example.py` and run it: ::
$ muffin example run
Open http://fuf.me:5000, http://fuf.me:5000/hello/username in your browser. Enjoy!
.. _contents:
.. contents::
.. _plugins:
Plugins
=======
The list of Muffin plugins:
* `Muffin-Admin <https://github.com/klen/muffin-admin>`_ -- Basic Admin interface
* `Muffin-Babel <https://github.com/klen/muffin-babel>`_ -- Localization support
* `Muffin-DebugToolbar <https://github.com/klen/muffin-debugtoolbar>`_ -- Debug Toolbar
* `Muffin-Jade <https://github.com/klen/muffin-jade>`_ -- Jade templates
* `Muffin-Jinja2 <https://github.com/klen/muffin-jinja2>`_ -- Jinja2 templates
* `Muffin-Metrics <https://github.com/klen/muffin-metrics>`_ -- Send metrics to Graphite/Statsd
* `Muffin-Mongo <https://github.com/klen/muffin-mongo>`_ -- MongoDB (pymongo) support
* `Muffin-OAuth <https://github.com/klen/muffin-oauth>`_ -- OAuth client
* `Muffin-Peewee <https://github.com/klen/muffin-peewee>`_ -- Peewee support (SQL, ORM)
* `Muffin-REST <https://github.com/klen/muffin-rest>`_ -- Helpers for building REST API
* `Muffin-Redis <https://github.com/klen/muffin-redis>`_ -- Redis support
* `Muffin-Sentry <https://github.com/klen/muffin-sentry>`_ -- Sentry integration
* `Muffin-Session <https://github.com/klen/muffin-session>`_ -- User session (auth)
.. _requirements:
Requirements
=============
- python >= 3.3
.. _installation:
Benchmarks
==========
You could find some tests here: http://klen.github.io/py-frameworks-bench/
Installation
=============
**The Muffin** should be installed using pip: ::
pip install muffin
.. _usage:
Usage
=====
See more in the example application sources. The application is deployed on Heroku:
https://muffin-py.herokuapp.com
Run example server locally: ::
$ make -C example run
And open http://fuf.me:5000 in your browser.
Configuration
-------------
Muffin gets configuration options from python files. By default the package
tries to load a configuration from `config` module (config.py).
There are few ways to redifine configuration module:
* Set configuration module in your app initialization:
.. code-block:: python
app = muffin.Application('myapp', CONFIG='config.debug')
* Set environment variable `MUFFIN_CONFIG`: ::
$ MUFFIN_CONFIG=settings_local muffin example run
Also you can define any options while initializing your application:
.. code-block:: python
app = muffin.Application('myapp', DEBUG=True, ANY_OPTION='Here', ONE_MORE='Yes')
Base application options
^^^^^^^^^^^^^^^^^^^^^^^^
Base Muffin options and default values:
.. code-block:: python
# Configuration module
'CONFIG': 'config'
# Enable debug mode
'DEBUG': False
# Logging options
'LOG_LEVEL': 'WARNING'
'LOG_FORMAT': '%(asctime)s [%(process)d] [%(levelname)s] %(message)s'
'LOG_DATE_FORMAT': '[%Y-%m-%d %H:%M:%S %z]'
# List of enabled plugins
'PLUGINS': []
# Setup static files in development
'STATIC_PREFIX': '/static'
'STATIC_FOLDERS': ['static']
Configuring logging
^^^^^^^^^^^^^^^^^^^
You can define your logging configurations with `Python dictConfig format <https://docs.python.org/3.4/library/logging.config.html#configuration-dictionary-schema>`_ and place in `LOGGING` conf: ::
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'default': {
'format': '%(asctime)s %(levelname)s %(name)s %(message)s'
},
},
'handlers': {
'logfile': {
'level': 'DEBUG',
'class': 'logging.handlers.RotatingFileHandler',
'filename': 'my_log.log',
'maxBytes': 50 * 1024 * 1024,
'backupCount': 10
},
},
'loggers': {
'': {
'handlers': ['logfile'],
'level': 'ERROR'
},
'project': {
'level': 'INFO',
'propagate': True,
},
}
}
To use just get logger with `logging.getLogger()`: ::
import logging
logger = logging.getLogger('project')
CLI integration
---------------
Run in your shell: ::
$ muffin path.to.your.module:app_object_name --help
Write a custom command
^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: python
@app.manage.command
def hello(name, upper=False):
""" Write command help text here.
:param name: Write your name
:param upper: Use uppercase
"""
greetings = 'Hello %s!' % name
if upper:
greetings = greetings.upper()
print(greetings)
::
$ muffin example hello --help
Write command help text here.
positional arguments:
name Write your name
optional arguments:
-h, --help show this help message and exit
--upper Enable use uppercase
--no-upper Disable use uppercase
$ muffin example hello mike --upper
HELLO MIKE!
.. _testing:
Testing
========
Setup tests
-----------
Set module path to your Muffin Application in pytest configuration file or use
command line option ``--muffin-app``.
Example: ::
$ py.test -xs --muffin-app example
Testing application
-------------------
See examples:
.. code-block:: python
import pytest
@pytest.mark.async
def test_async_code():
from aiohttp import request
response = yield from request('GET', 'http://google.com')
text = yield from response.text()
assert 'html' in text
def test_app(app):
""" Get your app in your tests as fixture. """
assert app.name == 'my app name'
assert app.cfg.MYOPTION == 'develop'
def test_view(client):
""" Make HTTP request to your application. """
response = client.get('/my-handler')
assert 'mydata' in response.text
.. _deployment:
Deployment
==========
Use ``muffin`` command. By example: ::
$ muffin example run --workers=4
See ``muffin {APP} run --help`` for more info.
.. _bugtracker:
Bug tracker
===========
If you have any suggestions, bug reports or
annoyances please report them to the issue tracker
at https://github.com/klen/muffin/issues
.. _contributing:
Contributing
============
Development of The Muffin happens at: https://github.com/klen/muffin
Contributors
=============
* `Kirill Klenov <https://github.com/klen`_
* `Diego Garcia <https://github.com/drgarcia1986>`_
.. _license:
License
=======
Licensed under a MIT license (See LICENSE)
.. _links:
.. _klen: https://github.com/klen
.. _Asyncio: https://docs.python.org/3/library/asyncio.html
.. _Python: http://python.org
:height: 100px
:width: 100px
The Muffin
##########
.. _badges:
.. image:: http://img.shields.io/travis/klen/muffin.svg?style=flat-square
:target: http://travis-ci.org/klen/muffin
:alt: Build Status
.. image:: http://img.shields.io/pypi/v/muffin.svg?style=flat-square
:target: https://pypi.python.org/pypi/muffin
.. image:: http://img.shields.io/pypi/dm/muffin.svg?style=flat-square
:target: https://pypi.python.org/pypi/muffin
.. image:: http://img.shields.io/gratipay/klen.svg?style=flat-square
:target: https://www.gratipay.com/klen/
:alt: Donate
.. _description:
The Muffin -- A web framework based on Asyncio_ stack ``(early beta)``
Muffin is a fast, simple and asyncronous web-framework for Python_ 3.
Example "Hello User" with the Muffin:
.. code-block:: python
import muffin
app = muffin.Application('example')
@app.register('/', '/hello/{name}')
def hello(request):
name = request.match_info.get('name', 'anonymous')
return 'Hello %s!' % name
Save the script as `example.py` and run it: ::
$ muffin example run
Open http://fuf.me:5000, http://fuf.me:5000/hello/username in your browser. Enjoy!
.. _contents:
.. contents::
.. _plugins:
Plugins
=======
The list of Muffin plugins:
* `Muffin-Admin <https://github.com/klen/muffin-admin>`_ -- Basic Admin interface
* `Muffin-Babel <https://github.com/klen/muffin-babel>`_ -- Localization support
* `Muffin-DebugToolbar <https://github.com/klen/muffin-debugtoolbar>`_ -- Debug Toolbar
* `Muffin-Jade <https://github.com/klen/muffin-jade>`_ -- Jade templates
* `Muffin-Jinja2 <https://github.com/klen/muffin-jinja2>`_ -- Jinja2 templates
* `Muffin-Metrics <https://github.com/klen/muffin-metrics>`_ -- Send metrics to Graphite/Statsd
* `Muffin-Mongo <https://github.com/klen/muffin-mongo>`_ -- MongoDB (pymongo) support
* `Muffin-OAuth <https://github.com/klen/muffin-oauth>`_ -- OAuth client
* `Muffin-Peewee <https://github.com/klen/muffin-peewee>`_ -- Peewee support (SQL, ORM)
* `Muffin-REST <https://github.com/klen/muffin-rest>`_ -- Helpers for building REST API
* `Muffin-Redis <https://github.com/klen/muffin-redis>`_ -- Redis support
* `Muffin-Sentry <https://github.com/klen/muffin-sentry>`_ -- Sentry integration
* `Muffin-Session <https://github.com/klen/muffin-session>`_ -- User session (auth)
.. _requirements:
Requirements
=============
- python >= 3.3
.. _installation:
Benchmarks
==========
You could find some tests here: http://klen.github.io/py-frameworks-bench/
Installation
=============
**The Muffin** should be installed using pip: ::
pip install muffin
.. _usage:
Usage
=====
See more in the example application sources. The application is deployed on Heroku:
https://muffin-py.herokuapp.com
Run example server locally: ::
$ make -C example run
And open http://fuf.me:5000 in your browser.
Configuration
-------------
Muffin gets configuration options from python files. By default the package
tries to load a configuration from `config` module (config.py).
There are few ways to redifine configuration module:
* Set configuration module in your app initialization:
.. code-block:: python
app = muffin.Application('myapp', CONFIG='config.debug')
* Set environment variable `MUFFIN_CONFIG`: ::
$ MUFFIN_CONFIG=settings_local muffin example run
Also you can define any options while initializing your application:
.. code-block:: python
app = muffin.Application('myapp', DEBUG=True, ANY_OPTION='Here', ONE_MORE='Yes')
Base application options
^^^^^^^^^^^^^^^^^^^^^^^^
Base Muffin options and default values:
.. code-block:: python
# Configuration module
'CONFIG': 'config'
# Enable debug mode
'DEBUG': False
# Logging options
'LOG_LEVEL': 'WARNING'
'LOG_FORMAT': '%(asctime)s [%(process)d] [%(levelname)s] %(message)s'
'LOG_DATE_FORMAT': '[%Y-%m-%d %H:%M:%S %z]'
# List of enabled plugins
'PLUGINS': []
# Setup static files in development
'STATIC_PREFIX': '/static'
'STATIC_FOLDERS': ['static']
Configuring logging
^^^^^^^^^^^^^^^^^^^
You can define your logging configurations with `Python dictConfig format <https://docs.python.org/3.4/library/logging.config.html#configuration-dictionary-schema>`_ and place in `LOGGING` conf: ::
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'default': {
'format': '%(asctime)s %(levelname)s %(name)s %(message)s'
},
},
'handlers': {
'logfile': {
'level': 'DEBUG',
'class': 'logging.handlers.RotatingFileHandler',
'filename': 'my_log.log',
'maxBytes': 50 * 1024 * 1024,
'backupCount': 10
},
},
'loggers': {
'': {
'handlers': ['logfile'],
'level': 'ERROR'
},
'project': {
'level': 'INFO',
'propagate': True,
},
}
}
To use just get logger with `logging.getLogger()`: ::
import logging
logger = logging.getLogger('project')
CLI integration
---------------
Run in your shell: ::
$ muffin path.to.your.module:app_object_name --help
Write a custom command
^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: python
@app.manage.command
def hello(name, upper=False):
""" Write command help text here.
:param name: Write your name
:param upper: Use uppercase
"""
greetings = 'Hello %s!' % name
if upper:
greetings = greetings.upper()
print(greetings)
::
$ muffin example hello --help
Write command help text here.
positional arguments:
name Write your name
optional arguments:
-h, --help show this help message and exit
--upper Enable use uppercase
--no-upper Disable use uppercase
$ muffin example hello mike --upper
HELLO MIKE!
.. _testing:
Testing
========
Setup tests
-----------
Set module path to your Muffin Application in pytest configuration file or use
command line option ``--muffin-app``.
Example: ::
$ py.test -xs --muffin-app example
Testing application
-------------------
See examples:
.. code-block:: python
import pytest
@pytest.mark.async
def test_async_code():
from aiohttp import request
response = yield from request('GET', 'http://google.com')
text = yield from response.text()
assert 'html' in text
def test_app(app):
""" Get your app in your tests as fixture. """
assert app.name == 'my app name'
assert app.cfg.MYOPTION == 'develop'
def test_view(client):
""" Make HTTP request to your application. """
response = client.get('/my-handler')
assert 'mydata' in response.text
.. _deployment:
Deployment
==========
Use ``muffin`` command. By example: ::
$ muffin example run --workers=4
See ``muffin {APP} run --help`` for more info.
.. _bugtracker:
Bug tracker
===========
If you have any suggestions, bug reports or
annoyances please report them to the issue tracker
at https://github.com/klen/muffin/issues
.. _contributing:
Contributing
============
Development of The Muffin happens at: https://github.com/klen/muffin
Contributors
=============
* `Kirill Klenov <https://github.com/klen`_
* `Diego Garcia <https://github.com/drgarcia1986>`_
.. _license:
License
=======
Licensed under a MIT license (See LICENSE)
.. _links:
.. _klen: https://github.com/klen
.. _Asyncio: https://docs.python.org/3/library/asyncio.html
.. _Python: http://python.org
Project details
Unverified details
These details have not been verified by PyPIProject links
Meta
- License: BSD License (MIT)
- Author: Kirill Klenov
- Tags asyncio , aiohttp , web
Classifiers
- Development Status
- Intended Audience
- License
- Natural Language
- Operating System
- Programming Language
- Topic
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file muffin-0.1.4.tar.gz
.
File metadata
- Download URL: muffin-0.1.4.tar.gz
- Upload date:
- Size: 17.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
5b6eb12f414b6dff74f6ba6fdf51498b16784f66f0ad40a9975bb0dc7f529f1d
|
|
MD5 |
c258e235246f464acc81dc1d15036943
|
|
BLAKE2b-256 |
2201b3ee9a3ec53e6ecb34300d789e7d53ccfbefd2e98847b3e92343c5d53123
|
File details
Details for the file muffin-0.1.4-py3-none-any.whl
.
File metadata
- Download URL: muffin-0.1.4-py3-none-any.whl
- Upload date:
- Size: 23.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
136f623a4322a268a9869c53aaf62ce841608ec0ec677210e265474034f16b2a
|
|
MD5 |
e305343d86cee0163e040b98e7af07a9
|
|
BLAKE2b-256 |
bb60bce258feba50d5f24218fa401dd8b71f6fdd93d8170d5f6b19eaf57e7753
|