A simple router for HTTP applications
Project description
http-router – A simple router for HTTP applications
Requirements
python >= 3.7
Installation
http-router should be installed using pip:
pip install http-router
Usage
from http_router import Router
# Initialize the router
router = Router(trim_last_slash=True)
# Plain path
# ----------
@router.route('/simple')
def simple():
return 'simple'
# Get a binded function and options by the given path
fn, path_params = router('/simple')
print(fn, path_params)
#
# >> <function simple> None
#
assert fn() == 'simple'
# The Router will raise a Router.NotFound for an unknown path
try:
fn, path_params = router('/unknown')
except router.NotFound as exc:
print("%r" % exc)
#
# >> NotFound('/unknown', 'GET')
#
# Multiple paths are supported as well
# ------------------------------------
@router.route('/', '/home')
def index():
return 'index'
print(router('/'))
#
# >> RouteMatch 200 (<function index>, None)
#
print(router('/home'))
#
# >> RouteMatch 200 (<function index>, None)
#
# Bind HTTP Methods
# -----------------
@router.route('/only-post', methods=['POST'])
def only_post():
return 'only-post'
# The Router will raise a Router.MethodNotAllowed for an unsupported method
try:
print(router('/only-post', method='GET'))
except router.MethodNotAllowed as exc:
print("%r" % exc)
#
# >> MethodNotAllowed('/only-post', 'GET')
#
print(router('/only-post', method='POST'))
#
# >> RouteMatch 200 (<function only-post>, None)
#
# Regex Expressions are supported
# -------------------------------
@router.route('/regex(/opt)?')
def optional():
return 'opt'
print(router('/regex', method='POST'))
#
# >> RouteMatch 200 (<function optional>, {})
#
print(router('/regex/opt', method='POST'))
#
# >> RouteMatch 200 (<function optional>, {})
#
# Dynamic routes are here
# -----------------------
@router.route('/order1/{id}')
def order1(id=None):
return 'order-%s' % id
print(router('/order1/42'))
#
# >> RouteMatch 200 (<function order1>, {'id': '42'})
#
# Dynamic routes with regex
# -------------------------
@router.route(r'/order2/{ id:\d{3} }')
def order2(id=None):
return 'order-%s' % id
print(router('/order2/100'))
#
# >> RouteMatch 200 (<function order1>, {'id': '100'})
#
try:
print(router('/order2/03'))
except router.NotFound:
passBug tracker
If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/http-router/issues
Contributing
Development of the project happens at: https://github.com/klen/http-router
License
Licensed under a MIT license.
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 Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
File details
Details for the file http_router-0.8.0-py3-none-any.whl.
File metadata
- Download URL: http_router-0.8.0-py3-none-any.whl
- Upload date:
- Size: 6.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 762ad13657f80ac514a4b47b3831953e1e59330d329c675680bbf8546685847f |
|
| MD5 | 48b9a81947bd87b2ad18b8d3586d7ad8 |
|
| BLAKE2b-256 | 9dcb77f75207aa7501dc9d3ae6cef0d481ce74173f542673a55e779bbe822231 |
