ApiDeclaration Class Reference

Inheritance diagram for ApiDeclaration:

Collaboration diagram for ApiDeclaration:

Public Member Functions
def	__init__ (self)
def	load (self, api_decl_json, processor, context)
def	load_file (self, api_declaration_file, processor)
Public Member Functions inherited from Stringify
def	__repr__ (self)

Data Fields
	api_version
	apis
	author
	base_path
	copyright
	has_websocket
	models
	requires_modules
	resource_path
	swagger_version

Static Public Attributes
list	required_fields

Detailed Description

Model class for an API Declaration.

See https://github.com/wordnik/swagger-core/wiki/API-Declaration

Definition at line 586 of file swagger_model.py.

Constructor & Destructor Documentation

__init__()

def __init__

(

self

)

Definition at line 597 of file swagger_model.py.

    def __init__(self):
        self.swagger_version = None
        self.author = None
        self.copyright = None
        self.api_version = None
        self.base_path = None
        self.resource_path = None
        self.apis = []
        self.models = []

Member Function Documentation

load()

def load	(		self,
			api_decl_json,
			processor,
			context
	)

Loads a resource from a single Swagger resource.json file.

Definition at line 633 of file swagger_model.py.

References ApiDeclaration.api_version, ApiDeclaration.author, ApiDeclaration.base_path, ApiDeclaration.copyright, Parameter.required_fields, ErrorResponse.required_fields, Operation.required_fields, Api.required_fields, Property.required_fields, Model.required_fields, ApiDeclaration.required_fields, ApiDeclaration.resource_path, ParsingContext.swagger_version, ApiDeclaration.swagger_version, and swagger_model.validate_required_fields().

Referenced by ApiDeclaration.load_file(), and ResourceListing.load_file().

    def load(self, api_decl_json, processor, context):
        """Loads a resource from a single Swagger resource.json file.
        """
        # If the version doesn't match, all bets are off.
        self.swagger_version = api_decl_json.get('swaggerVersion')
        context = context.next(version=self.swagger_version)
        if not self.swagger_version in SWAGGER_VERSIONS:
            raise SwaggerError(
                "Unsupported Swagger version %s" % self.swagger_version, context)

        validate_required_fields(api_decl_json, self.required_fields, context)

        self.author = api_decl_json.get('_author')
        self.copyright = api_decl_json.get('_copyright')
        self.api_version = api_decl_json.get('apiVersion')
        self.base_path = api_decl_json.get('basePath')
        self.resource_path = api_decl_json.get('resourcePath')
        self.requires_modules = api_decl_json.get('requiresModules') or []
        api_json = api_decl_json.get('apis') or []
        self.apis = [
            Api().load(j, processor, context) for j in api_json]
        paths = set()
        for api in self.apis:
            if api.path in paths:
                raise SwaggerError("API with duplicated path: %s" % api.path, context)
            paths.add(api.path)
        self.has_websocket = any(api.has_websocket for api in self.apis)
        models = api_decl_json.get('models').items() or []
        self.models = [Model().load(id, json, processor, context)
                       for (id, json) in models]
        self.models = sorted(self.models, key=lambda m: m.id)
        # Now link all base/extended types
        model_dict = dict((m.id, m) for m in self.models)
        for m in self.models:
            def link_subtype(name):
                res = model_dict.get(name)
                if not res:
                    raise SwaggerError("%s has non-existing subtype %s",
                                       m.id, name)
                res.set_extends_type(m)
                return res;
            if m.subtypes:
                m.set_subtype_types([
                    link_subtype(subtype) for subtype in m.subtypes])
        return self

load_file()

def load_file	(		self,
			api_declaration_file,
			processor
	)

Definition at line 607 of file swagger_model.py.

References ApiDeclaration.__load_file(), ast_speech_engine.load, Parameter.load(), ast_sorcery_wizard.load, ErrorResponse.load(), SwaggerType.load(), ast_module_info.load, Operation.load(), Api.load(), Property.load(), Model.load(), ApiDeclaration.load(), replace(), and ApiDeclaration.resource_path.

    def load_file(self, api_declaration_file, processor):
        context = ParsingContext(None, [api_declaration_file])
        try:
            return self.__load_file(api_declaration_file, processor, context)
        except SwaggerError:
            raise
        except Exception as e:
            print("Error: ", traceback.format_exc(), file=sys.stderr)
            raise SwaggerError(
                "Error loading %s" % api_declaration_file, context, e)

Field Documentation

api_version

api_version

Definition at line 601 of file swagger_model.py.

Referenced by ApiDeclaration.load(), and ResourceListing.load().

apis

apis

Definition at line 604 of file swagger_model.py.

Referenced by ResourceListing.load().

author

author

Definition at line 599 of file swagger_model.py.

Referenced by ApiDeclaration.load().

base_path

base_path

Definition at line 602 of file swagger_model.py.

Referenced by ApiDeclaration.load(), and ResourceListing.load().

copyright

copyright

Definition at line 600 of file swagger_model.py.

Referenced by ApiDeclaration.load().

has_websocket

has_websocket

Definition at line 659 of file swagger_model.py.

models

models

Definition at line 605 of file swagger_model.py.

required_fields

list required_fields

static

Initial value:

=  [
        'swaggerVersion', '_author', '_copyright', 'apiVersion', 'basePath',
        'resourcePath', 'apis', 'models'
    ]

Definition at line 592 of file swagger_model.py.

Referenced by ApiDeclaration.load(), ResourceApi.load(), and ResourceListing.load().

requires_modules

requires_modules

Definition at line 650 of file swagger_model.py.

resource_path

resource_path

Definition at line 603 of file swagger_model.py.

Referenced by ApiDeclaration.load(), and ApiDeclaration.load_file().

swagger_version

swagger_version

Definition at line 598 of file swagger_model.py.

Referenced by ApiDeclaration.load(), and ResourceListing.load().

---

The documentation for this class was generated from the following file:

• swagger_model.py