{"categories":[{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/17"}],"enrichment":{"capability":"Extracts Swagger 2.0 API specifications from Flask applications by parsing YAML docstrings in view functions and MethodView classes.","skillfed_tags":["api-documentation","swagger-spec","abandoned"],"use_cases":["Generate Swagger 2.0 documentation from existing Flask endpoints without writing separate spec files","Serve API specs to Swagger UI for interactive API exploration and testing","Export Flask API contracts for client code generation or third-party integrations","Document MethodView-based REST APIs by embedding operation details in docstrings","Build minimal API documentation endpoints that reflect your current Flask routes"],"what_it_does":"flask-swagger is a documentation extraction tool that reads YAML docstrings embedded in Flask view functions and MethodView methods, then generates a Swagger 2.0 specification object. It parses the YAML following a convention where content before `---` becomes the endpoint summary and description, and content after becomes the Operation object (parameters, responses, schemas, tags). The tool supports inline schema definitions with an `id` field that get collected into a definitions section, and handles nested schemas within properties.\n\nYou use it by calling the `swagger()` function on your Flask app to generate a spec dictionary, which you then expose via a Flask route (typically `/spec`) and serve to Swagger UI or other documentation consumers. The spec returned is minimal\u2014you're expected to augment it with metadata like API title and version. The package depends only on Flask and PyYAML, making installation straightforward, but it has been unmaintained since 2019 and is unlikely to receive updates for newer Swagger or Flask versions.","worth_installing":"No\u2014unless you are maintaining legacy code already using this package. The project is abandoned (last release 2019, last commit 2021) with no active maintenance. For new projects, use actively maintained alternatives like Flask-RESTX, Flasgger, or Connexion that support modern OpenAPI 3.0 specs and receive regular updates. The low install friction and permissive license do not offset the risk of relying on unmaintained code."},"id":"flask-swagger","links":{"html":"https://skillfed.io/packages/flask-swagger","md":"https://skillfed.io/packages/flask-swagger.md","pypi":"https://pypi.org/project/flask-swagger/"},"maintenance":{"status":"abandoned"},"meta":{"latest_release":"2019-03-26","license_spdx":null,"license_treatment":"permissive","name":"flask-swagger","python_support":"unspecified","summary":"Extract swagger specs from your flask project"},"popularity":{"monthly_downloads":151808,"position":10920,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.2.14"}