Metadata-Version: 2.1
Name: flask-url-mapping
Version: 0.6
Summary: Django-style url handling for Flask
Home-page: https://github.com/jboegeholz/flaskurls
Author: Joern Boegeholz
Author-email: boegeholz.joern@gmail.com
License: MIT
Download-URL: https://github.com/jboegeholz/flaskurls/archive/0.2.tar.gz
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: Flask
Requires-Dist: Flask-Login

# flask_url_mapping
Django-style url handling for Flask

Inspired by [https://stackoverflow.com/questions/31680048/django-styled-flask-url-pattern-for-large-application]
this package is an attempt to generalize the concept of Django-like url-view / endpoint-mapping.

You can install it via 
```
pip install flask-url-mapping
```

Centerpiece is an urls.py which contains the mapping.
```
urls = [
    ("/", views.index),                             #1
    ("/login", views.login, ["GET", "POST"]),       #2
    ("/home", "home.urls")                          #3
    ("/admin", views.admin, ["GET"], "admin_role"), #4
]
```
There are four ways to map routes to endpoints
1.  route to endpoint, http method default is GET
2.  route to endpoint with array of http methods
3.  route to component see Components
4.  route to endpoint with array of http methods and required role


After declaring your url mapping You can register the urls to the flask app via `register_urls`


## A sample setup without permissions
* wsgi.py
```
from flask import Flask
from flask_url_mapping import register_urls
from urls import urls
app = Flask(__name__)

if __name__ == '__main__':
    flask_urls = FlaskUrls(app)
    flask_urls.register_urls(urls)
    app.run()
```
* urls.py
```
from views import *
urls = [
    ("/", hello_world, ["GET"])
]
```
* views.py
```
def hello_world():
    return 'Hello World!'    
```
## A sample setup with permissions
When adding a role to a route endpoint mapping your project has to use flask_login

## Components
A component is a subfolder which contains at least an urls.py and an views.py
When this folder also contains a templates directory, it will be automatically added to the jinja2 search path for html templates

## Travis-CI
[![Build Status](https://travis-ci.org/jboegeholz/flaskurls.svg?branch=master)](https://travis-ci.org/jboegeholz/flaskurls)

