text: # coding=utf-8
  """
  This code was generated by
  \ / _    _  _|   _  _
   | (_)\/(_)(_|\/| |(/_  v1.0.0
        /       /
  """
  
  from twilio.base import deserialize
  from twilio.base import values
  from twilio.base.instance_context import InstanceContext
  from twilio.base.instance_resource import InstanceResource
  from twilio.base.list_resource import ListResource
  from twilio.base.page import Page
  from twilio.rest.preview.understand.service.field_type import FieldTypeList
  from twilio.rest.preview.understand.service.intent import IntentList
  from twilio.rest.preview.understand.service.model_build import ModelBuildList
  from twilio.rest.preview.understand.service.query import QueryList
  
  
  class ServiceList(ListResource):
      """ PLEASE NOTE that this class contains preview products that are subject
      to change. Use them with caution. If you currently do not have developer
      preview access, please contact help@twilio.com. """
  
      def __init__(self, version):
          """
          Initialize the ServiceList
  
          :param Version version: Version that contains the resource
  
          :returns: twilio.rest.preview.understand.service.ServiceList
          :rtype: twilio.rest.preview.understand.service.ServiceList
          """
          super(ServiceList, self).__init__(version)
  
          # Path Solution
          self._solution = {}
          self._uri = '/Services'.format(**self._solution)
  
      def stream(self, limit=None, page_size=None):
          """
          Streams ServiceInstance records from the API as a generator stream.
          This operation lazily loads records as efficiently as possible until the limit
          is reached.
          The results are returned as a generator, so this operation is memory efficient.
  
          :param int limit: Upper limit for the number of records to return. stream()
                            guarantees to never return more than limit.  Default is no limit
          :param int page_size: Number of records to fetch per request, when not set will use
                                the default value of 50 records.  If no page_size is defined
                                but a limit is defined, stream() will attempt to read the
                                limit with the most efficient page size, i.e. min(limit, 1000)
  
          :returns: Generator that will yield up to limit results
          :rtype: list[twilio.rest.preview.understand.service.ServiceInstance]
          """
          limits = self._version.read_limits(limit, page_size)
  
          page = self.page(page_size=limits['page_size'])
  
          return self._version.stream(page, limits['limit'], limits['page_limit'])
  
      def list(self, limit=None, page_size=None):
          """
          Lists ServiceInstance records from the API as a list.
          Unlike stream(), this operation is eager and will load `limit` records into
          memory before returning.
  
          :param int limit: Upper limit for the number of records to return. list() guarantees
                            never to return more than limit.  Default is no limit
          :param int page_size: Number of records to fetch per request, when not set will use
                                the default value of 50 records.  If no page_size is defined
                                but a limit is defined, list() will attempt to read the limit
                                with the most efficient page size, i.e. min(limit, 1000)
  
          :returns: Generator that will yield up to limit results
          :rtype: list[twilio.rest.preview.understand.service.ServiceInstance]
          """
          return list(self.stream(limit=limit, page_size=page_size))
  
      def page(self, page_token=values.unset, page_number=values.unset,
               page_size=values.unset):
          """
          Retrieve a single page of ServiceInstance records from the API.
          Request is executed immediately
  
          :param str page_token: PageToken provided by the API
          :param int page_number: Page Number, this value is simply for client state
          :param int page_size: Number of records to return, defaults to 50
  
          :returns: Page of ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServicePage
          """
          params = values.of({'PageToken': page_token, 'Page': page_number, 'PageSize': page_size})
  
          response = self._version.page(
              'GET',
              self._uri,
              params=params,
          )
  
          return ServicePage(self._version, response, self._solution)
  
      def get_page(self, target_url):
          """
          Retrieve a specific page of ServiceInstance records from the API.
          Request is executed immediately
  
          :param str target_url: API-generated URL for the requested results page
  
          :returns: Page of ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServicePage
          """
          response = self._version.domain.twilio.request(
              'GET',
              target_url,
          )
  
          return ServicePage(self._version, response, self._solution)
  
      def create(self, friendly_name=values.unset, log_queries=values.unset,
                 ttl=values.unset, unique_name=values.unset):
          """
          Create a new ServiceInstance
  
          :param unicode friendly_name: The friendly_name
          :param bool log_queries: The log_queries
          :param unicode ttl: The ttl
          :param unicode unique_name: The unique_name
  
          :returns: Newly created ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          data = values.of({
              'FriendlyName': friendly_name,
              'LogQueries': log_queries,
              'Ttl': ttl,
              'UniqueName': unique_name,
          })
  
          payload = self._version.create(
              'POST',
              self._uri,
              data=data,
          )
  
          return ServiceInstance(self._version, payload)
  
      def get(self, sid):
          """
          Constructs a ServiceContext
  
          :param sid: The sid
  
          :returns: twilio.rest.preview.understand.service.ServiceContext
          :rtype: twilio.rest.preview.understand.service.ServiceContext
          """
          return ServiceContext(self._version, sid=sid)
  
      def __call__(self, sid):
          """
          Constructs a ServiceContext
  
          :param sid: The sid
  
          :returns: twilio.rest.preview.understand.service.ServiceContext
          :rtype: twilio.rest.preview.understand.service.ServiceContext
          """
          return ServiceContext(self._version, sid=sid)
  
      def __repr__(self):
          """
          Provide a friendly representation
  
          :returns: Machine friendly representation
          :rtype: str
          """
          return '<Twilio.Preview.Understand.ServiceList>'
  
  
  class ServicePage(Page):
      """ PLEASE NOTE that this class contains preview products that are subject
      to change. Use them with caution. If you currently do not have developer
      preview access, please contact help@twilio.com. """
  
      def __init__(self, version, response, solution):
          """
          Initialize the ServicePage
  
          :param Version version: Version that contains the resource
          :param Response response: Response from the API
  
          :returns: twilio.rest.preview.understand.service.ServicePage
          :rtype: twilio.rest.preview.understand.service.ServicePage
          """
          super(ServicePage, self).__init__(version, response)
  
          # Path Solution
          self._solution = solution
  
      def get_instance(self, payload):
          """
          Build an instance of ServiceInstance
  
          :param dict payload: Payload response from the API
  
          :returns: twilio.rest.preview.understand.service.ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          return ServiceInstance(self._version, payload)
  
      def __repr__(self):
          """
          Provide a friendly representation
  
          :returns: Machine friendly representation
          :rtype: str
          """
          return '<Twilio.Preview.Understand.ServicePage>'
  
  
  class ServiceContext(InstanceContext):
      """ PLEASE NOTE that this class contains preview products that are subject
      to change. Use them with caution. If you currently do not have developer
      preview access, please contact help@twilio.com. """
  
      def __init__(self, version, sid):
          """
          Initialize the ServiceContext
  
          :param Version version: Version that contains the resource
          :param sid: The sid
  
          :returns: twilio.rest.preview.understand.service.ServiceContext
          :rtype: twilio.rest.preview.understand.service.ServiceContext
          """
          super(ServiceContext, self).__init__(version)
  
          # Path Solution
          self._solution = {'sid': sid}
          self._uri = '/Services/{sid}'.format(**self._solution)
  
          # Dependents
          self._field_types = None
          self._intents = None
          self._model_builds = None
          self._queries = None
  
      def fetch(self):
          """
          Fetch a ServiceInstance
  
          :returns: Fetched ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          params = values.of({})
  
          payload = self._version.fetch(
              'GET',
              self._uri,
              params=params,
          )
  
          return ServiceInstance(self._version, payload, sid=self._solution['sid'])
  
      def update(self, friendly_name=values.unset, log_queries=values.unset,
                 ttl=values.unset, unique_name=values.unset):
          """
          Update the ServiceInstance
  
          :param unicode friendly_name: The friendly_name
          :param bool log_queries: The log_queries
          :param unicode ttl: The ttl
          :param unicode unique_name: The unique_name
  
          :returns: Updated ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          data = values.of({
              'FriendlyName': friendly_name,
              'LogQueries': log_queries,
              'Ttl': ttl,
              'UniqueName': unique_name,
          })
  
          payload = self._version.update(
              'POST',
              self._uri,
              data=data,
          )
  
          return ServiceInstance(self._version, payload, sid=self._solution['sid'])
  
      def delete(self):
          """
          Deletes the ServiceInstance
  
          :returns: True if delete succeeds, False otherwise
          :rtype: bool
          """
          return self._version.delete('delete', self._uri)
  
      @property
      def field_types(self):
          """
          Access the field_types
  
          :returns: twilio.rest.preview.understand.service.field_type.FieldTypeList
          :rtype: twilio.rest.preview.understand.service.field_type.FieldTypeList
          """
          if self._field_types is None:
              self._field_types = FieldTypeList(self._version, service_sid=self._solution['sid'])
          return self._field_types
  
      @property
      def intents(self):
          """
          Access the intents
  
          :returns: twilio.rest.preview.understand.service.intent.IntentList
          :rtype: twilio.rest.preview.understand.service.intent.IntentList
          """
          if self._intents is None:
              self._intents = IntentList(self._version, service_sid=self._solution['sid'])
          return self._intents
  
      @property
      def model_builds(self):
          """
          Access the model_builds
  
          :returns: twilio.rest.preview.understand.service.model_build.ModelBuildList
          :rtype: twilio.rest.preview.understand.service.model_build.ModelBuildList
          """
          if self._model_builds is None:
              self._model_builds = ModelBuildList(self._version, service_sid=self._solution['sid'])
          return self._model_builds
  
      @property
      def queries(self):
          """
          Access the queries
  
          :returns: twilio.rest.preview.understand.service.query.QueryList
          :rtype: twilio.rest.preview.understand.service.query.QueryList
          """
          if self._queries is None:
              self._queries = QueryList(self._version, service_sid=self._solution['sid'])
          return self._queries
  
      def __repr__(self):
          """
          Provide a friendly representation
  
          :returns: Machine friendly representation
          :rtype: str
          """
          context = ' '.join('{}={}'.format(k, v) for k, v in self._solution.items())
          return '<Twilio.Preview.Understand.ServiceContext {}>'.format(context)
  
  
  class ServiceInstance(InstanceResource):
      """ PLEASE NOTE that this class contains preview products that are subject
      to change. Use them with caution. If you currently do not have developer
      preview access, please contact help@twilio.com. """
  
      def __init__(self, version, payload, sid=None):
          """
          Initialize the ServiceInstance
  
          :returns: twilio.rest.preview.understand.service.ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          super(ServiceInstance, self).__init__(version)
  
          # Marshaled Properties
          self._properties = {
              'account_sid': payload['account_sid'],
              'date_created': deserialize.iso8601_datetime(payload['date_created']),
              'date_updated': deserialize.iso8601_datetime(payload['date_updated']),
              'friendly_name': payload['friendly_name'],
              'latest_model_build_sid': payload['latest_model_build_sid'],
              'links': payload['links'],
              'log_queries': payload['log_queries'],
              'sid': payload['sid'],
              'ttl': deserialize.integer(payload['ttl']),
              'unique_name': payload['unique_name'],
              'url': payload['url'],
          }
  
          # Context
          self._context = None
          self._solution = {'sid': sid or self._properties['sid']}
  
      @property
      def _proxy(self):
          """
          Generate an instance context for the instance, the context is capable of
          performing various actions.  All instance actions are proxied to the context
  
          :returns: ServiceContext for this ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceContext
          """
          if self._context is None:
              self._context = ServiceContext(self._version, sid=self._solution['sid'])
          return self._context
  
      @property
      def account_sid(self):
          """
          :returns: The account_sid
          :rtype: unicode
          """
          return self._properties['account_sid']
  
      @property
      def date_created(self):
          """
          :returns: The date_created
          :rtype: datetime
          """
          return self._properties['date_created']
  
      @property
      def date_updated(self):
          """
          :returns: The date_updated
          :rtype: datetime
          """
          return self._properties['date_updated']
  
      @property
      def friendly_name(self):
          """
          :returns: The friendly_name
          :rtype: unicode
          """
          return self._properties['friendly_name']
  
      @property
      def latest_model_build_sid(self):
          """
          :returns: The latest_model_build_sid
          :rtype: unicode
          """
          return self._properties['latest_model_build_sid']
  
      @property
      def links(self):
          """
          :returns: The links
          :rtype: unicode
          """
          return self._properties['links']
  
      @property
      def log_queries(self):
          """
          :returns: The log_queries
          :rtype: bool
          """
          return self._properties['log_queries']
  
      @property
      def sid(self):
          """
          :returns: The sid
          :rtype: unicode
          """
          return self._properties['sid']
  
      @property
      def ttl(self):
          """
          :returns: The ttl
          :rtype: unicode
          """
          return self._properties['ttl']
  
      @property
      def unique_name(self):
          """
          :returns: The unique_name
          :rtype: unicode
          """
          return self._properties['unique_name']
  
      @property
      def url(self):
          """
          :returns: The url
          :rtype: unicode
          """
          return self._properties['url']
  
      def fetch(self):
          """
          Fetch a ServiceInstance
  
          :returns: Fetched ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          return self._proxy.fetch()
  
      def update(self, friendly_name=values.unset, log_queries=values.unset,
                 ttl=values.unset, unique_name=values.unset):
          """
          Update the ServiceInstance
  
          :param unicode friendly_name: The friendly_name
          :param bool log_queries: The log_queries
          :param unicode ttl: The ttl
          :param unicode unique_name: The unique_name
  
          :returns: Updated ServiceInstance
          :rtype: twilio.rest.preview.understand.service.ServiceInstance
          """
          return self._proxy.update(
              friendly_name=friendly_name,
              log_queries=log_queries,
              ttl=ttl,
              unique_name=unique_name,
          )
  
      def delete(self):
          """
          Deletes the ServiceInstance
  
          :returns: True if delete succeeds, False otherwise
          :rtype: bool
          """
          return self._proxy.delete()
  
      @property
      def field_types(self):
          """
          Access the field_types
  
          :returns: twilio.rest.preview.understand.service.field_type.FieldTypeList
          :rtype: twilio.rest.preview.understand.service.field_type.FieldTypeList
          """
          return self._proxy.field_types
  
      @property
      def intents(self):
          """
          Access the intents
  
          :returns: twilio.rest.preview.understand.service.intent.IntentList
          :rtype: twilio.rest.preview.understand.service.intent.IntentList
          """
          return self._proxy.intents
  
      @property
      def model_builds(self):
          """
          Access the model_builds
  
          :returns: twilio.rest.preview.understand.service.model_build.ModelBuildList
          :rtype: twilio.rest.preview.understand.service.model_build.ModelBuildList
          """
          return self._proxy.model_builds
  
      @property
      def queries(self):
          """
          Access the queries
  
          :returns: twilio.rest.preview.understand.service.query.QueryList
          :rtype: twilio.rest.preview.understand.service.query.QueryList
          """
          return self._proxy.queries
  
      def __repr__(self):
          """
          Provide a friendly representation
  
          :returns: Machine friendly representation
          :rtype: str
          """
          context = ' '.join('{}={}'.format(k, v) for k, v in self._solution.items())
          return '<Twilio.Preview.Understand.ServiceInstance {}>'.format(context)
  