https://github.com/witchard/grole

A simple python (3.5+) asyncio based web framework
https://github.com/witchard/grole

asyncio framework python web webframework

Last synced: 5 months ago
JSON representation

A simple python (3.5+) asyncio based web framework

• Host: GitHub
• URL: https://github.com/witchard/grole
• Owner: witchard
• License: mit
• Created: 2017-09-09T20:56:43.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2020-12-20T09:16:07.000Z (over 5 years ago)
• Last Synced: 2025-02-01T11:11:05.570Z (about 1 year ago)
• Topics: asyncio, framework, python, web, webframework
• Language: Python
• Homepage: http://grole.readthedocs.io/
• Size: 47.9 KB
• Stars: 5
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
Grole

=====

.. image:: https://img.shields.io/github/license/witchard/grole.svg

    :target: https://witchard.mit-license.org

.. image:: https://img.shields.io/pypi/v/grole.svg

    :target: https://pypi.python.org/pypi/grole

.. image:: https://img.shields.io/pypi/pyversions/grole.svg

    :target: https://pypi.python.org/pypi/grole

.. image:: https://readthedocs.org/projects/grole/badge/?version=latest

    :target: https://grole.readthedocs.io

.. image:: https://img.shields.io/travis/witchard/grole.svg

    :target: https://travis-ci.org/witchard/grole

.. image:: https://img.shields.io/coveralls/witchard/grole.svg

    :target: https://coveralls.io/github/witchard/grole

Grole is a python (3.5+) nano web framework based on asyncio. It's goals are to be simple, embedable (single file and standard library only) and easy to use. The authors intention is that it should support standing up quick and dirty web based APIs.

It's loosely based on bottle and flask, but unlike them does not require a WSGI capable server to handle more than one request at once. Sanic is similar, but it does not meet the embedable use-case.

A grole is a multi-spouted drinking vessel (https://en.wikipedia.org/wiki/Grole), which harks to this modules bottle/flask routes but with the ability to serve multiple drinkers at once!

Documentation

-------------

See the doc folder, or visit https://grole.readthedocs.io.

Example

-------

.. code-block:: python

    from grole import Grole

    app = Grole()

    @app.route('/(.*)?')

    def index(env, req):

        name = req.match.group(1) or 'World'

        return 'Hello, {}!'.format(name)

    app.run()

Run this script and then point your browser at http://localhost:1234/.

Grole also has an inbuilt simple file server which will serve all the files in a directory. Just run `grole.py` or `python -m grole`.

Install

-------

Either download `grole.py` directly from github and place in your project folder, or `pip3 install grole`.

License

-------

MIT.