Is any converter supported officially?

[gh640]

In the Quickstart page, any converter of routing is not included in "Converter types":

https://flask.palletsprojects.com/en/2.3.x/quickstart/#variable-rules

Converter types:

========== ==========================================
string (default) accepts any text without a slash
int accepts positive integers
float accepts positive floating point values
path like string but also accepts slashes
uuid accepts UUID strings
========== ==========================================

flask/docs/quickstart.rst

Line 208 in cb82568

``uuid`` accepts UUID strings

In the API page, any converter is in the available converters:

https://flask.palletsprojects.com/en/2.3.x/api/#url-route-registrations

The following converters are available:

=========== ===============================================
string accepts any text without a slash (the default)
int accepts integers
float like int but for floating point values
path like the default but also accepts slashes
any matches one of the items provided
uuid accepts UUID strings
=========== ===============================================

flask/docs/api.rst

Lines 567 to 568 in cb82568

	`any` matches one of the items provided
	`uuid` accepts UUID strings

Also, any is in "Built-in Converters" in Werkzeug documentation:

https://werkzeug.palletsprojects.com/en/2.3.x/routing/#built-in-converters

class werkzeug.routing.AnyConverter(map, *items)
Matches one of the items provided. Items can either be Python identifiers or strings:

Rule('/<any(about, help, imprint, class, "foo,bar"):page_name>')

---

It looks like any converter in Quickstart was removed in the following commit.

2592f92

---

any converter is useful for me but I have no idea if I should use it or not. Any reason it was removed from Quickstart? Thanks.

[RonnyPfannschmidt]

Follow up note, should get the name one-of to make it more clear what's the intent?

[davidism]

Yes it's supported by Werkzeug. It looks like the PR that removed it was trying to make the quickstart page less verbose and more focused on basic use cases.

[gh640]

@davidism

Thanks for the answer.

I was unaware that there was any converter and I found it via Stack Overflow this time. Currently it's not very clear if the converters listed on the Quickstart page are a subset or all of them and I had to follow the following links to find out all the supported converters:

https://flask.palletsprojects.com/en/2.3.x/quickstart/#variable-rules
↓
route()
https://flask.palletsprojects.com/en/2.3.x/api/#flask.Flask.route
↓
add_url_rule()
https://flask.palletsprojects.com/en/2.3.x/api/#flask.Flask.add_url_rule
↓
URL Route Registrations
https://flask.palletsprojects.com/en/2.3.x/api/#url-route-registrations

For example, I think it would be easier to newbies like me to add a note to the Quickstart page that explains that the converter list on the Quickstart page is only a subset of the list and that all converters can be found at https://flask.palletsprojects.com/en/2.3.x/api/#url-route-registrations .

(Moreover, it may be better to direct people who want to know how to use the converters with parameters to the Werkzeug's documentation.)

Anyway, my question has been answered. Thanks!