359

Is it possible to directly declare a flask URL optional parameter?

Currently I'm proceeding the following way:

@user.route('/<userId>')
@user.route('/<userId>/<username>')
def show(userId, username=None):
    pass

How can I directly say that username is optional?

0

11 Answers 11

491

Another way is to write

@user.route('/<user_id>', defaults={'username': None})
@user.route('/<user_id>/<username>')
def show(user_id, username):
    pass

But I guess that you want to write a single route and mark username as optional? If that's the case, I don't think it's possible.

10
  • Any problems using this method when referencing endpoints and url_for ?
    – user427165
    Commented Jun 20, 2013 at 18:05
  • 2
    Not that I know of. Even Flask docs contain similar example (you need to scroll down a bit to see it). Commented Jun 20, 2013 at 20:54
  • 1
    You can try pip install flask_optional_routes. I created a pip for the functionality you are requesting b/c I needed it as well. The code is located at: github.com/sudouser2010/flask_optional_routes. Commented Mar 12, 2018 at 1:57
  • upvoted! if you have multiple tabs on your home page where each one triggers something like /one /two /three /four and you want to load different content on the same page without reloading the page, should you use a single route or multiple routes?
    – PirateApp
    Commented Jul 25, 2018 at 11:00
  • @PirateApp that cannot be achieved with just Flask and is purely a frontend feature
    – qaisjp
    Commented Jul 9, 2019 at 9:26
246

Almost the same as Audrius cooked up some months ago, but you might find it a bit more readable with the defaults in the function head - the way you are used to with python:

@app.route('/<user_id>')
@app.route('/<user_id>/<username>')
def show(user_id, username='Anonymous'):
    return user_id + ':' + username
3
  • 4
    Also, the this works if username is not constant. defaults= freezes the default value in a dictionary.
    – kasperhj
    Commented Oct 27, 2014 at 18:31
  • 3
    Keep in mind there is a big caveat here: if you have multiple positional arguments and not all of them optional, flask won't understand how to build the URL properly. You can get something like /page?arg=foo where it should be /foo/page . @Audrius Kažukauskas answer works in that case, but this doesn't
    – rgargente
    Commented Nov 12, 2019 at 16:08
  • 1
    This also prevents flask redirecting with 308's when you omit the optional URI path param. ie if you use the defaults= approach with your above default value, and then specify as part of the URI the same Anonymous string as the username optional arg, you will get a 308 bouncing you to /<user_id>
    – geudrik
    Commented Jun 6, 2023 at 13:12
90

If you are using Flask-Restful like me, it is also possible this way:

api.add_resource(UserAPI, '/<userId>', '/<userId>/<username>', endpoint = 'user')

a then in your Resource class:

class UserAPI(Resource):

  def get(self, userId, username=None):
    pass
0
36
@user.route('/<userId>/')  # NEED '/' AFTER LINK
@user.route('/<userId>/<username>')
def show(userId, username=None):
    pass

https://flask.palletsprojects.com/en/1.1.x/quickstart/#unique-urls-redirection-behavior

0
16
@app.route('/', defaults={'path': ''})
@app.route('/< path:path >')
def catch_all(path):
    return 'You want path: %s' % path

http://flask.pocoo.org/snippets/57/

2
15
@user.route('/<user_id>', defaults={'username': default_value})
@user.route('/<user_id>/<username>')
def show(user_id, username):
   #
   pass
8

Almost the same as skornos, but with variable declarations for a more explicit answer. It can work with Flask-RESTful extension:

from flask import Flask
from flask_restful import Resource, Api

app = Flask(__name__)
api = Api(app)

class UserAPI(Resource):
    def show(userId, username=None):
    pass

api.add_resource(UserAPI, '/<userId>', '/<userId>/<username>', endpoint='user')

if __name__ == '__main__':
    app.run()

The add_resource method allows pass multiples URLs. Each one will be routed to your Resource.

5

I know this post is really old but I worked on a package that does this called flask_optional_routes. The code is located at: https://github.com/sudouser2010/flask_optional_routes.

from flask import Flask

from flask_optional_routes import OptionalRoutes


app = Flask(__name__)
optional = OptionalRoutes(app)

@optional.routes('/<user_id>/<user_name>?/')
def foobar(user_id, user_name=None):
    return 'it worked!'

if __name__ == "__main__":
    app.run(host='0.0.0.0', port=5000)
0

You can write as you show in example, but than you get build-error.

For fix this:

  1. print app.url_map () in you root .py
  2. you see something like:

<Rule '/<userId>/<username>' (HEAD, POST, OPTIONS, GET) -> user.show_0>

and

<Rule '/<userId>' (HEAD, POST, OPTIONS, GET) -> .show_1>

  1. than in template you can {{ url_for('.show_0', args) }} and {{ url_for('.show_1', args) }}
-8

Since Flask 0.10 you can`t add multiple routes to one endpoint. But you can add fake endpoint

@user.route('/<userId>')
def show(userId):
   return show_with_username(userId)

@user.route('/<userId>/<username>')
def show_with_username(userId,username=None):
   pass
1
  • 7
    What? Using flask 0.10.1 here and I can add multiple routes to one endpoint just fine.
    – jaapz
    Commented Aug 4, 2014 at 9:55
-11

I think you can use Blueprint and that's will make ur code look better and neatly.

example:

from flask import Blueprint

bp = Blueprint(__name__, "example")

@bp.route("/example", methods=["POST"])
def example(self):
   print("example")
1
  • 7
    This does not answer the question.
    – meyer9
    Commented Mar 24, 2017 at 4:32

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.