aetos/openapi-first
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: apply GSDFC docstring conformance, add minimal annotations to unannotated params (pydoclint zero); refresh lib/MCP docs

Browse Source
This commit is contained in:
Vishesh 'ironeagle' Bangotra
2026-09-13 16:21:07 +05:30
parent cb231a9c7e
commit 294f3d7a0c
48 changed files with 228 additions and 96 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/mcp/modules/openapi_first.security.json
View File

@@ -2,7 +2,7 @@
"module": "openapi_first.security",
"content": {
"path": "openapi_first.security",
"docstring": "OpenAPI security scheme parsing and auto-generated auth dependencies.\n\nReads `securitySchemes` and per-operation `security` from an OpenAPI spec,\nresolves `{ENV_VAR}` placeholders in `x-` extension fields, and generates\nFastAPI dependencies for token validation (e.g., Bearer JWT introspection).",
"docstring": "# Summary\n\nOpenAPI security scheme parsing and auto-generated auth dependencies.\n\nThis module reads `securitySchemes` and per-operation `security` from an\nOpenAPI spec, resolves `{ENV_VAR}` placeholders in `x-` extension fields,\nand generates FastAPI dependencies for token validation (e.g., Bearer JWT\nintrospection).",
"objects": {
"os": {
"name": "os",
@@ -78,14 +78,14 @@
"name": "parse_security_schemes",
"kind": "function",
"path": "openapi_first.security.parse_security_schemes",
"signature": "<bound method Function.signature of Function('parse_security_schemes', 43, 46)>",
"signature": "<bound method Function.signature of Function('parse_security_schemes', 46, 49)>",
"docstring": "Extract and resolve environment variables in security schemes."
},
"make_security_dependencies": {
"name": "make_security_dependencies",
"kind": "function",
"path": "openapi_first.security.make_security_dependencies",
"signature": "<bound method Function.signature of Function('make_security_dependencies', 113, 150)>",
"signature": "<bound method Function.signature of Function('make_security_dependencies', 116, 153)>",
"docstring": "Build a mapping of ``METHOD:/path`` → list of ``Depends(...)``.\n\nThe effective security for each operation is resolved by:\n\n1. Using the operation-level ``security`` field if present.\n2. Falling back to the top-level ``security`` field.\n3. An empty list means *no auth required* for that operation."
}
}