OpenAPI: support optional attributes and Array<> syntax in inline sch…

[ayushman1210]

Description
This PR addresses two limitations in the inline YAML schema parser used for @request and @response tags, as described in the issue

1. Optional Attributes (? suffix): Inline schemas now support marked optional attributes using the ? suffix (e.g., name?: String).

• Attributes without the suffix are now automatically added to the required array in the generated OpenAPI specification.
• Attributes with the suffix are treated as non-required and are excluded from the required list

2.Array<> Syntax Support: Added support for the Array syntax inside inline schemas to provide a consistent alternative to the unary array [Type] syntax.

• Example: { errors: Array } now correctly generates an array of strings

Changes
File --> lib/rage/openapi/parsers/yaml.rb

• Updated __parse to handle key stripping and required array generation.
• Updated type_to_spec to recognize and parse the Array<...> string format.

File --> spec/openapi/parsers/yaml_spec.rb

• Added new test cases for optional/required attribute mixing and nested Array<> usage.
• Updated existing expectations to include the required property where applicable.

Verification

1. Added new RSpec tests covering mixed attribute optionality and varied Array<> types (String, Integer, Hash).
2. Verified that all existing tests pass with the adjusted requirements.
3. Manual verification of the parser logic with a standalone test script.

Fixes #227

[ayushman1210]

Hi @rsamoilov please review this pr when you have some free time and let me know if anything else needed
thanks !!

[rsamoilov]

Hy @ayushman1210

Left one small comment. Otherwise, looks good 👍

[rsamoilov]

Hi @ayushman1210

This looks good. The only thing is that this doesn't seem to support enums. For example, the [IN_PROGRESS, COMPLETED] expression creates an enum, but Array<IN_PROGRESS, COMPLETED> is not parsed correctly.

[ayushman1210]

hi @rsamoilov i have updated the pr please review it thanks !!

[rsamoilov]

Hi @ayushman1210

I can still see the error - for the @response { id: Integer, is_admin: String, active?: Boolean, status: Array<in_progress, completed> } response tag, I get the following OpenAPI schema:

{ "status":{"type":"string","enum":["Array<in_progress"]},"completed>":{"type":"string","enum":[null]}},"required":["id","is_admin","status","completed>"]

Do you think it would be easier to preprocess YAML responses and just substitute Array<...> to [...] before the actual parsing?