Class OpenAPIParser

modules/apisec/openapi_parser.py:63–293

Parser for OpenAPI/Swagger specifications.

class OpenAPIParser:
    """Parser for OpenAPI/Swagger specifications."""

    def __init__(self):
        self.logger = get_logger("apisec.parser")

    async def parse_url(self, url: str) -> ParsedAPI:
        """Parse OpenAPI spec from URL.

        Args:
            url: URL to OpenAPI JSON/YAML spec

        Returns:
            Parsed API specification
        """
        self.logger.info(f"Fetching OpenAPI spec from {url}")

        async with httpx.AsyncClient(timeout=30.0) as client:
            response = await client.get(url)
            response.raise_for_status()

            content_type = response.headers.get("content-type", "")
            content = response.text

            if "yaml" in content_type or url.endswith((".yaml", ".yml")):
                spec = yaml.safe_load(content)
            else:
                spec = json.loads(content)

        return self._parse_spec(spec, url)

    def parse_file(self, path: str) -> ParsedAPI:
        """Parse OpenAPI spec from file.

        Args:
            path: Path to OpenAPI JSON/YAML file

        Returns:
            Parsed API specification
        """
        file_path = Path(path)
        self.logger.info(f"Parsing OpenAPI spec from {file_path}")

        content = file_path.read_text()

        if file_path.suffix in (".yaml", ".yml"):
            spec = yaml.safe_load(content)
        else:
            spec = json.loads(content)

        return self._parse_spec(spec, str(file_path))

    def parse_string(self, content: str, format: str = "json") -> ParsedAPI:
        """Parse OpenAPI spec from string.

        Args:
            content: OpenAPI spec content
            format: "json" or "yaml"