allow query strings as part of a path template.

[jakeoneill64]

No description provided.

[char0n]

Hi @jakeoneill64,

This library has been foundational in formalizing path templating in OpenAPI specification. Please read following links:

• adds ABNF for path templating OAI/OpenAPI-Specification#4244
• Formally define (ABNF) 3.x URL templating behavior OAI/OpenAPI-Specification#3256

Long story short, grammar from this library (with minor changes) have been adopted by OpenAPI and will be officially released as OpenAPI 3.2 - https://github.com/OAI/OpenAPI-Specification/blob/v3.2-dev/src/oas.md#path-templating. Notice that ? and query-string MUST NOT be part of the ABNF. This applies to OpenAPI 2.0, 3.0 and 3.1 as well.

As stipulated above, ? question mark and query-string must not be part of the ABNF grammar, they MUST be handled by Parameter Object with in: query & required: true fixed fields.

Here is an excerpt from OpenAPI 3.2 spec which verifies this:

The value for these path parameters MUST NOT contain any unescaped "generic syntax" characters described by RFC3986: forward slashes (/), question marks (?), or hashes (#). See URL Percent-Encoding for additional guidance on escaping characters.

I'll close this PR as it's something that will go against what we've already established in OpenAPI.

Thank you!