Model Class Reference

Inheritance diagram for Model:

Collaboration diagram for Model:

Public Member Functions
def	__init__ (self)
def	all_subtypes (self)
def	discriminator (self)
def	extends (self)
def	extends_lc (self)
def	has_properties (self)
def	has_subtypes (self)
def	load (self, id, model_json, processor, context)
def	properties (self)
def	set_extends_type (self, extends_type)
def	set_subtype_types (self, subtype_types)
Public Member Functions inherited from Stringify
def	__repr__ (self)

Data Fields
	description
	id
	id_lc
	model_json
	notes
	subtypes

Static Public Attributes
list	required_fields = ['description', 'properties']

Detailed Description

Model of a Swagger model.

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

Definition at line 499 of file swagger_model.py.

Constructor & Destructor Documentation

__init__()

def __init__

(

self

)

Definition at line 507 of file swagger_model.py.

    def __init__(self):
        self.id = None
        self.id_lc = None
        self.subtypes = []
        self.__subtype_types = []
        self.notes = None
        self.description = None
        self.__properties = None
        self.__discriminator = None
        self.__extends_type = None
 

Member Function Documentation

all_subtypes()

def all_subtypes

(

self

)

Returns the full list of all subtypes, including sub-subtypes.

Definition at line 585 of file swagger_model.py.

    def all_subtypes(self):
        """Returns the full list of all subtypes, including sub-subtypes.
        """
        res = self.__subtype_types + \
              [subsubtypes for subtype in self.__subtype_types
               for subsubtypes in subtype.all_subtypes()]
        return sorted(res, key=lambda m: m.id)
 

References Model.__subtype_types.

discriminator()

def discriminator

(

self

)

Returns the discriminator, digging through base types if needed.

Definition at line 570 of file swagger_model.py.

    def discriminator(self):
        """Returns the discriminator, digging through base types if needed.
        """
        return self.__discriminator or \
            self.__extends_type and self.__extends_type.discriminator()
 

References Model.__discriminator, Model.__extends_type, and Model.discriminator().

Referenced by Model.discriminator().

extends()

def extends

(

self

)

Definition at line 558 of file swagger_model.py.

    def extends(self):
        return self.__extends_type and self.__extends_type.id
 

References Model.__extends_type.

extends_lc()

def extends_lc

(

self

)

Definition at line 561 of file swagger_model.py.

    def extends_lc(self):
        return self.__extends_type and self.__extends_type.id_lc
 

References Model.__extends_type.

has_properties()

def has_properties

(

self

)

Definition at line 582 of file swagger_model.py.

    def has_properties(self):
        return len(self.properties()) > 0
 

References len(), ast_channel_tech.properties, Model.properties(), and ast_rtp_instance.properties.

has_subtypes()

def has_subtypes

(

self

)

Returns True if type has any subtypes.

Definition at line 593 of file swagger_model.py.

    def has_subtypes(self):
        """Returns True if type has any subtypes.
        """
        return len(self.subtypes) > 0
 
 

References len(), and Model.subtypes.

load()

def load	(		self,
			id,
			model_json,
			processor,
			context
	)

Definition at line 518 of file swagger_model.py.

    def load(self, id, model_json, processor, context):
        context = context.next_stack(model_json, 'id')
        validate_required_fields(model_json, self.required_fields, context)
        # The duplication of the model's id is required by the Swagger spec.
        self.id = model_json.get('id')
        self.id_lc = self.id.lower() 
        if id != self.id:
            raise SwaggerError("Model id doesn't match name", context)
        self.subtypes = model_json.get('subTypes') or []
        if self.subtypes and context.version_less_than("1.2"):
            raise SwaggerError("Type extension support added in Swagger 1.2",
                               context)
        self.description = model_json.get('description')
        props = model_json.get('properties').items() or []
        self.__properties = [
            Property(k).load(j, processor, context) for (k, j) in props]
        self.__properties = sorted(self.__properties, key=lambda p: p.name)
 
        discriminator = model_json.get('discriminator')
 
        if discriminator:
            if context.version_less_than("1.2"):
                raise SwaggerError("Discriminator support added in Swagger 1.2",
                                   context)
 
            discr_props = [p for p in self.__properties if p.name == discriminator]
            if not discr_props:
                raise SwaggerError(
                    "Discriminator '%s' does not name a property of '%s'" % (
                        discriminator, self.id),
                    context)
 
            self.__discriminator = discr_props[0]
 
        self.model_json = json.dumps(model_json,
                                     indent=2, separators=(',', ': '))
 
        processor.process_model(self, context)
        return self
 

References Model.__discriminator, Model.__properties, dahdi_pvt.description, iax2_peer.description, ast_calendar_tech.description, ast_calendar_event.description, ast_channel_tech.description, ast_codec.description, ast_http_uri.description, ast_tone_zone.description, manager_action.description, ast_module_info.description, ast_switch.description, ast_fax_tech.description, stasis_subscription_change.description, ast_test_info.description, ast_xml_doc_item.description, ast_xmpp_resource.description, ast_value_translation.description, media_variant.description, ast_app.description, Parameter.description, Api.description, Property.description, Model.description, ResourceApi.description, adapter_pvt.id, mbl_pvt.id, adsi_event.id, adsi_soft_key.id, adsi_subscript.id, adsi_state.id, adsi_flag.id, adsi_display.id, adsi_key_cmd.id, id, local_optimization.id, conf_menu_action.id, native_rtp_framehook_data.id, unistim_device.id, Section.id, enum_result_datastore.id, srv_result_datastore.id, audiosocket_instance.id, ast_aoc_charging_association.id, ast_cc_monitor.id, ast_party_caller.id, ast_set_party_caller.id, ast_party_connected_line.id, ast_set_party_connected_line.id, ast_codec.id, ast_aeap_message_type.id, ast_fax_session_details.id, ast_fax_session.id, ast_geoloc_eprofile.id, ast_sip_transport_state.id, ast_sip_endpoint.id, ast_sip_session.id, ast_sip_session_sdp_handler.id, ast_rtp_engine_ice_candidate.id, ast_channel_snapshot_bridge.id, ast_endpoint_snapshot.id, ast_xmpp_message.id, ast_xmpp_buddy.id, aoc_ie_billing.id, sync_payload.id, bridge_sync.id, cel_linkedid.id, dns_HEADER.id, ast_endpoint.id, ast_framehook.id, io_rec.id, category_t.id, ast_state_cb.id, sched_id.id, ast_sorcery_object.id, cache_entry_key.id, stasis_message_type.id, stasis_state_proxy.id, stasis_state.id, stun_trans_id.id, stun_header.id, worker_thread.id, dundi_result_datastore.id, ast_ari_asterisk_get_object_args.id, ast_ari_asterisk_update_object_args.id, ast_ari_asterisk_delete_object_args.id, aeap_user_data.id, aeap_transaction.id, calendar_id.id, corosync_node.id, eprofiles_datastore.id, ast_sip_outbound_publish_state.id, mwi_subscription.id, hep_ctrl.id, internal_state.id, exten_state_subscription.id, unbound_resolver_data.id, smdi_msg_datastore.id, stasis_app_playback.id, app_forwards.id, Model.id, mock_payload.id, test_obj.id, cache_test_data.id, Model.id_lc, Model.load(), Parameter.required_fields, ErrorResponse.required_fields, Operation.required_fields, Api.required_fields, Property.required_fields, Model.required_fields, ApiDeclaration.required_fields, ResourceApi.required_fields, ResourceListing.required_fields, Model.subtypes, and swagger_model.validate_required_fields().

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

properties()

def properties

(

self

)

Definition at line 576 of file swagger_model.py.

    def properties(self):
        base_props = []
        if self.__extends_type:
            base_props = self.__extends_type.properties()
        return base_props + self.__properties
 

References Model.__extends_type, Model.__properties, and Model.properties().

Referenced by Model.has_properties(), and Model.properties().

set_extends_type()

def set_extends_type	(		self,
			extends_type
	)

Definition at line 564 of file swagger_model.py.

    def set_extends_type(self, extends_type):
        self.__extends_type = extends_type
 

References Model.__extends_type.

set_subtype_types()

def set_subtype_types	(		self,
			subtype_types
	)

Definition at line 567 of file swagger_model.py.

    def set_subtype_types(self, subtype_types):
        self.__subtype_types = subtype_types
 

References Model.__subtype_types.

Field Documentation

description

description

Definition at line 513 of file swagger_model.py.

Referenced by Api.load(), ResourceApi.load(), Model.load(), Parameter.load(), and Property.load().

id

id

Definition at line 508 of file swagger_model.py.

Referenced by Section.__cmp__(), Section.__eq__(), Section.__ge__(), Section.__gt__(), Section.__le__(), Section.__lt__(), and Model.load().

id_lc

id_lc

Definition at line 509 of file swagger_model.py.

Referenced by Model.load().

model_json

model_json

Definition at line 552 of file swagger_model.py.

notes

notes

Definition at line 512 of file swagger_model.py.

required_fields

list required_fields = ['description', 'properties']

static

Definition at line 505 of file swagger_model.py.

Referenced by ApiDeclaration.load(), Api.load(), ResourceApi.load(), ErrorResponse.load(), Model.load(), Operation.load(), Parameter.load(), Property.load(), and ResourceListing.load().

subtypes

subtypes

Definition at line 510 of file swagger_model.py.

Referenced by Model.has_subtypes(), and Model.load().

---

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

• swagger_model.py