# Copyright (c) Meta Platforms, Inc. and affiliates. # All rights reserved. # # This source code is licensed under the terms described in the LICENSE file in # the root directory of this source tree. # Copyright (c) Meta Platforms, Inc. and affiliates. # All rights reserved. # # This source code is licensed under the terms described found in the # LICENSE file in the root directory of this source tree. from datetime import datetime from pathlib import Path import fire import yaml from llama_models import schema_utils # We do some monkey-patching to ensure our definitions only use the minimal # (json_schema_type, webmethod) definitions from the llama_models package. For # generation though, we need the full definitions and implementations from the # (json-strong-typing) package. from .strong_typing.schema import json_schema_type, register_schema schema_utils.json_schema_type = json_schema_type schema_utils.register_schema = register_schema from llama_stack.apis.version import LLAMA_STACK_API_VERSION # noqa: E402 from llama_stack.distribution.stack import LlamaStack # noqa: E402 from .pyopenapi.options import Options # noqa: E402 from .pyopenapi.specification import Info, Server # noqa: E402 from .pyopenapi.utility import Specification # noqa: E402 def main(output_dir: str): output_dir = Path(output_dir) if not output_dir.exists(): raise ValueError(f"Directory {output_dir} does not exist") now = str(datetime.now()) print( "Converting the spec to YAML (openapi.yaml) and HTML (openapi.html) at " + now ) print("") spec = Specification( LlamaStack, Options( server=Server(url="http://any-hosted-llama-stack.com"), info=Info( title="Llama Stack Specification", version=LLAMA_STACK_API_VERSION, description="""This is the specification of the Llama Stack that provides a set of endpoints and their corresponding interfaces that are tailored to best leverage Llama Models.""", ), ), ) with open(output_dir / "llama-stack-spec.yaml", "w", encoding="utf-8") as fp: yaml.dump(spec.get_json(), fp, allow_unicode=True) with open(output_dir / "llama-stack-spec.html", "w") as fp: spec.write_html(fp, pretty_print=True) if __name__ == "__main__": fire.Fire(main)