Skip to main content

A simple router for HTTP applications

Project description

http-router – A simple router for HTTP applications

Tests Status PYPI Version

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>, {}
#
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('/'))
#
# >> <function index>, {}
#

print(router('/home'))
#
# >> <function index>, {}
#


# 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'))
#
# >> <function only_post>, {}
#


# Regex Expressions are supported
# -------------------------------
@router.route('/regex(/opt)?')
def optional():
    return 'opt'


print(router('/regex', method='POST'))
#
# >> <function optional>, {}
#

print(router('/regex/opt', method='POST'))
#
# >> <function optional>, {}
#


# Dynamic routes are here
# -----------------------
@router.route('/order1/{id}')
def order1(id=None):
    return 'order-%s' % id


print(router('/order1/42'))
#
# >> <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'))
#
# >> <function order2>, {'id': '100'}
#

try:
    print(router('/order2/03'))
except router.NotFound:
    pass

Bug 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.

Project details


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

http_router-0.5.0-py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page