Office365-REST-Python-Client 2.5.5__py3-none-any.whl → 2.5.6__py3-none-any.whl

office365/sharepoint/eventreceivers/definition.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
@@ -7,24 +9,18 @@ class EventReceiverDefinition(Entity):
 
     @property
     def receiver_assembly(self):
-        """Specifies the strong name of the assembly that is used for the event receiver.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Specifies the strong name of the assembly that is used for the event receiver."""
         return self.properties.get("ReceiverAssembly", None)
 
     @property
     def receiver_class(self):
-        """Specifies the strong name of the assembly that is used for the event receiver.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Specifies the strong name of the assembly that is used for the event receiver."""
         return self.properties.get("ReceiverClass", None)
 
     @property
     def receiver_url(self):
-        """Gets the URL of the receiver for the event.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the URL of the receiver for the event."""
         return self.properties.get("ReceiverUrl", None)

office365/sharepoint/features/collection.py

@@ -36,8 +36,7 @@ class FeatureCollection(EntityCollection[Feature]):
                 self.context.add_query(_create_query())
 
         if verify_if_activated:
-            feature = self.get_by_id(feature_id)
-            self.context.load(feature, after_loaded=_create_if_not_activated)
+            self.get_by_id(feature_id).get().after_execute(_create_if_not_activated)
         else:
             self.context.add_query(_create_query())
 

office365/sharepoint/features/definitions/definition.py

@@ -1,12 +1,15 @@
+from typing import Optional
+
 from office365.sharepoint.entity import Entity
 
 
 class FeatureDefinition(Entity):
     """Contains the base definition of a feature, including its name, ID, scope, and version."""
 
+    def __str__(self):
+        return self.display_name or self.entity_type_name
+
     @property
     def display_name(self):
-        """
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
         return self.properties.get("DisplayName", None)

office365/sharepoint/fields/calculated.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
@@ -11,26 +13,18 @@ class FieldCalculated(Field):
 
     @property
     def currency_locale_id(self):
-        """
-        Gets the locale ID that is used for currency on the Web site.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the locale ID that is used for currency on the Web site."""
         return self.properties.get("CurrencyLocaleId", None)
 
     @property
     def formula(self):
-        """
-        Specifies the formula for the field
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Specifies the formula for the field"""
         return self.properties.get("Formula", None)
 
     @formula.setter
     def formula(self, val):
-        """Sets a value that specifies the Formula.
-
-        :type val: str
-        """
+        # type: (str) -> None
+        """Sets a value that specifies the Formula."""
         self.set_property("Formula", val)

office365/sharepoint/fields/collection.py

@@ -1,3 +1,5 @@
+from typing import TYPE_CHECKING, Optional
+
 from office365.runtime.paths.service_operation import ServiceOperationPath
 from office365.runtime.queries.create_entity import CreateEntityQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -7,12 +9,20 @@ from office365.sharepoint.fields.creation_information import FieldCreationInform
 from office365.sharepoint.fields.date_time import FieldDateTime
 from office365.sharepoint.fields.field import Field
 from office365.sharepoint.fields.geolocation import FieldGeolocation
+from office365.sharepoint.fields.number import FieldNumber
+from office365.sharepoint.fields.text import FieldText
 from office365.sharepoint.fields.type import FieldType
+from office365.sharepoint.fields.url import FieldUrl
 from office365.sharepoint.fields.xmlSchemaFieldCreationInformation import (
     XmlSchemaFieldCreationInformation,
 )
 from office365.sharepoint.taxonomy.field import TaxonomyField
 from office365.sharepoint.taxonomy.sets.set import TermSet
+from office365.sharepoint.taxonomy.stores.store import TermStore
+
+if TYPE_CHECKING:
+    from office365.sharepoint.lists.list import List
+    from office365.sharepoint.webs.web import Web
 
 
 class FieldCollection(EntityCollection[Field]):
@@ -39,6 +49,7 @@ class FieldCollection(EntityCollection[Field]):
         return return_type
 
     def add_datetime(self, title, description=None):
+        # type: (str, Optional[str]) -> FieldDateTime
         """
         Creates DateTime field
         :param str title: Specifies the display name of the field
@@ -50,10 +61,11 @@ class FieldCollection(EntityCollection[Field]):
                 description=description,
                 field_type_kind=FieldType.DateTime,
             )
-        )  # type: FieldDateTime
+        )
         return return_type
 
     def add_geolocation_field(self, title, description=None):
+        # type: (str, Optional[str]) -> FieldGeolocation
         """
         Creates Geolocation field
 
@@ -66,13 +78,29 @@ class FieldCollection(EntityCollection[Field]):
                 description=description,
                 field_type_kind=FieldType.Geolocation,
             )
-        )  # type: FieldGeolocation
+        )
+        return return_type
+
+    def add_number(self, title, description=None):
+        # type: (str, Optional[str]) -> FieldNumber
+        """
+        Creates Number field
+        :param str title: Specifies the display name of the field
+        :param str or None description: Specifies the description of the field
+        """
+        return_type = self.add(
+            FieldCreationInformation(
+                title=title,
+                description=description,
+                field_type_kind=FieldType.Number,
+            )
+        )
         return return_type
 
     def add_url_field(self, title, description=None):
+        # type: (str, Optional[str]) -> FieldUrl
         """
         Creates Url field
-
         :param str title: Specifies the display name of the field
         :param str or None description:
         """
@@ -124,8 +152,6 @@ class FieldCollection(EntityCollection[Field]):
                     return_type=return_type,
                 )
 
-        from office365.sharepoint.lists.list import List
-
         if isinstance(lookup_list, List):
 
             def _lookup_list_loaded():
@@ -158,11 +184,10 @@ class FieldCollection(EntityCollection[Field]):
         return self.add_field(FieldCreationInformation(title, FieldType.User))
 
     def add_text_field(self, title):
+        # type: (str) -> FieldText
         """
         Creates a Text field
-
         :param str title: specifies the display name of the field
-        :rtype: office365.sharepoint.fields.text.FieldText
         """
         return self.add_field(FieldCreationInformation(title, FieldType.Text))
 
@@ -245,6 +270,7 @@ class FieldCollection(EntityCollection[Field]):
         else:
 
             def _term_store_loaded(term_store):
+                # type: (TermStore) -> None
                 TaxonomyField.create(
                     self,
                     name,
@@ -254,9 +280,10 @@ class FieldCollection(EntityCollection[Field]):
                     return_type=return_type,
                 )
 
-            self.context.load(
-                self.context.taxonomy.term_store, after_loaded=_term_store_loaded
+            self.context.load(self.context.taxonomy.term_store).after_query_execute(
+                _term_store_loaded
             )
+
         return return_type
 
     def create_field_as_xml(self, schema_xml, return_type=None):
@@ -287,7 +314,7 @@ class FieldCollection(EntityCollection[Field]):
         )
 
     def get_by_internal_name_or_title(self, value):
-        """Returns the first field (2) in the collection based on the internal name or the title specified
+        """Returns the first field in the collection based on the internal name or the title specified
         by the parameter.
 
         :param str value:  The title or internal name to look up the field (2) by.
@@ -309,3 +336,8 @@ class FieldCollection(EntityCollection[Field]):
             self.context,
             ServiceOperationPath("getByTitle", [title], self.resource_path),
         )
+
+    @property
+    def parent(self):
+        # type: () -> Web|List
+        return self._parent

office365/sharepoint/fields/computed.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
@@ -10,9 +12,6 @@ class FieldComputed(Field):
 
     @property
     def enable_lookup(self):
-        """
-        Specifies whether a lookup field can reference the field (2).
-
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """Specifies whether a lookup field can reference the field."""
         return self.properties.get("EnableLookup", None)

office365/sharepoint/fields/currency.py

@@ -1,24 +1,20 @@
+from typing import Optional
+
 from office365.sharepoint.fields.number import FieldNumber
 
 
 class FieldCurrency(FieldNumber):
-    """Specifies a field (2) that contains currency values. To set properties, call the Update method
+    """Specifies a field that contains currency values. To set properties, call the Update method
     (section 3.2.5.43.2.1.5)."""
 
     @property
     def currency_locale_id(self):
-        """
-        Gets the language code identifier (LCID) used to format the value of the field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the language code identifier (LCID) used to format the value of the field."""
         return self.properties.get("CurrencyLocaleId", None)
 
     @currency_locale_id.setter
     def currency_locale_id(self, value):
-        """
-        Sets the language code identifier (LCID) used to format the value of the field.
-
-        :type value: int
-        """
+        # type: (int) -> None
+        """Sets the language code identifier (LCID) used to format the value of the field."""
         self.set_property("CurrencyLocaleId", value)

office365/sharepoint/fields/date_time.py

@@ -9,18 +9,14 @@ class FieldDateTime(Field):
 
     @property
     def datetime_calendar_type(self):
-        """
-        Gets the calendar type of the field
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the calendar type of the field"""
         return self.properties.get("DateTimeCalendarType", None)
 
     @datetime_calendar_type.setter
     def datetime_calendar_type(self, value):
-        """
-        Sets Gets the calendar type of the field
-        :type value: int
-        """
+        # type: (int) -> None
+        """Sets Gets the calendar type of the field"""
         self.set_property("DateTimeCalendarType", value)
 
     @property

office365/sharepoint/fields/field.py

@@ -69,7 +69,6 @@ class Field(Entity):
 
         :type context: office365.sharepoint.client_context.ClientContext
         :type field_parameters: office365.sharepoint.fields.creation_information.FieldCreationInformation
-        :return: Field
         """
         field_type = Field.resolve_field_type(field_parameters.FieldTypeKind)
         field = field_type(context)
@@ -124,19 +123,14 @@ class Field(Entity):
 
     @property
     def id(self):
-        """
-        Gets a value that specifies the field identifier.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets a value that specifies the field identifier."""
         return self.properties.get("Id", None)
 
     @property
     def auto_indexed(self):
-        """
-        Gets a Boolean value that specifies whether the field is auto-indexed.
-        :rtype: str or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a Boolean value that specifies whether the field is auto-indexed."""
         return self.properties.get("AutoIndexed", None)
 
     @property
@@ -200,17 +194,13 @@ class Field(Entity):
     @property
     def internal_name(self):
         # type: () -> Optional[str]
-        """
-        Gets a value that specifies the field internal name.
-        """
+        """Gets a value that specifies the field internal name."""
         return self.properties.get("InternalName", None)
 
     @property
     def can_be_deleted(self):
         # type: () -> Optional[bool]
-        """
-        Gets a value that specifies whether the field can be deleted
-        """
+        """Gets a value that specifies whether the field can be deleted"""
         return self.properties.get("CanBeDeleted", None)
 
     @property

office365/sharepoint/fields/lookup.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
@@ -6,38 +8,38 @@ class FieldLookup(Field):
 
     @property
     def allow_multiple_values(self):
-        """Gets a value that specifies whether the lookup field allows multiple values.
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a value that specifies whether the lookup field allows multiple values."""
         return self.properties.get("AllowMultipleValues", None)
 
     @allow_multiple_values.setter
     def allow_multiple_values(self, value):
+        # type: (bool) -> None
         """Sets a value that specifies whether the lookup field allows multiple values."""
         self.set_property("AllowMultipleValues", value)
 
     @property
     def lookup_web_id(self):
-        """Gets the ID of the Web site that contains the list that is the source of this field's value.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the ID of the Web site that contains the list that is the source of this field's value."""
         return self.properties.get("LookupWebId", None)
 
     @lookup_web_id.setter
     def lookup_web_id(self, val):
-        """Sets the ID of the Web site that contains the list that is the source of this field's value.
-        :rtype: str or None
-        """
+        # type: (str) -> None
+        """Sets the ID of the Web site that contains the list that is the source of this field's value."""
         self.set_property("LookupWebId", val, True)
 
     @property
     def lookup_list(self):
+        # type: () -> Optional[str]
         """Gets value that specifies the list identifier of the list that contains the field to use as the lookup
         values."""
         return self.properties.get("LookupList", None)
 
     @lookup_list.setter
     def lookup_list(self, val):
+        # type: (str) -> None
         """Sets a value that specifies the list identifier of the list that contains the field to use as
         the lookup values."""
         self.set_property("LookupList", val, True)

office365/sharepoint/fields/multi_choice.py

@@ -1,32 +1,28 @@
+from typing import Optional
+
 from office365.runtime.types.collections import StringCollection
 from office365.sharepoint.fields.field import Field
 
 
 class FieldMultiChoice(Field):
-    """Specifies a field (2) that contains one or more values from a set of specified values."""
+    """Specifies a field that contains one or more values from a set of specified values."""
 
     @property
     def fill_in_choice(self):
+        # type: () -> Optional[bool]
         """
-        Specifies whether the field (2) can accept values other than those specified in
+        Specifies whether the field can accept values other than those specified in
         Microsoft.Sharepoint.Client.FieldMultiChoice.Choices, as specified in section 3.2.5.51.1.1.2.
-
-        :rtype: bool or None
         """
         return self.properties.get("FillInChoice", None)
 
     @property
     def mappings(self):
-        """
-        Specifies the internal values corresponding to Choices.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Specifies the internal values corresponding to Choices."""
         return self.properties.get("Mappings", None)
 
     @property
     def choices(self):
-        """
-        Specifies values that are available for selection in the field
-        """
+        """Specifies values that are available for selection in the field"""
         return self.properties.get("Choices", StringCollection())

office365/sharepoint/fields/multi_line_text.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
@@ -8,30 +10,24 @@ class FieldMultiLineText(Field):
 
     @property
     def allow_hyperlink(self):
-        """
-        Gets a value that specifies whether a hyperlink is allowed as a value of the field.
-        :rtype: bool or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a value that specifies whether a hyperlink is allowed as a value of the field."""
         return self.properties.get("AllowHyperlink", None)
 
     @allow_hyperlink.setter
     def allow_hyperlink(self, val):
-        """
-        Sets a value that specifies whether a hyperlink is allowed as a value of the field.
-        """
+        # type: (bool) -> None
+        """Sets a value that specifies whether a hyperlink is allowed as a value of the field."""
         self.set_property("AllowHyperlink", val)
 
     @property
     def number_of_lines(self):
-        """
-        Gets the number of lines to display in the field.
-        :return:
-        """
+        # type: () -> Optional[int]
+        """Gets the number of lines to display in the field."""
         return self.properties.get("NumberOfLines", None)
 
     @number_of_lines.setter
     def number_of_lines(self, val):
-        """
-        Set the number of lines to display in the field.
-        """
+        # type: (int) -> None
+        """Set the number of lines to display in the field."""
         self.set_property("NumberOfLines", val)

office365/sharepoint/fields/number.py

@@ -1,51 +1,38 @@
+from typing import Optional
+
 from office365.sharepoint.fields.field import Field
 
 
 class FieldNumber(Field):
-    """Specifies a field (2) that contains number values. To set properties, call the Update method
+    """Specifies a field that contains number values. To set properties, call the Update method
     (section 3.2.5.53.2.1.5)."""
 
     @property
     def display_format(self):
-        """
-        Gets the number of decimal places to be used when displaying the field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the number of decimal places to be used when displaying the field."""
         return self.properties.get("DisplayFormat", None)
 
     @property
     def comma_separator(self):
-        """
-        Gets the separator used to format the value of the field.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the separator used to format the value of the field."""
         return self.properties.get("CommaSeparator", None)
 
     @comma_separator.setter
     def comma_separator(self, value):
-        """
-        Sets the separator used to format the value of the field.
-
-        :type value: str
-        """
+        # type: (str) -> None
+        """Sets the separator used to format the value of the field."""
         self.set_property("CommaSeparator", value)
 
     @property
     def show_as_percentage(self):
-        """
-        Gets a Boolean value that specifies whether to render the field as a percentage.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[bool]
+        """Gets a Boolean value that specifies whether to render the field as a percentage."""
         return self.properties.get("ShowAsPercentage", None)
 
     @show_as_percentage.setter
     def show_as_percentage(self, value):
-        """
-        Sets a Boolean value that specifies whether to render the field as a percentage.
-
-        :type value: str
-        """
+        # type: (bool) -> None
+        """Sets a Boolean value that specifies whether to render the field as a percentage."""
         self.set_property("ShowAsPercentage", value)

office365/sharepoint/fields/rating_scale.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.sharepoint.fields.multi_choice import FieldMultiChoice
 
 
@@ -7,11 +9,8 @@ class FieldRatingScale(FieldMultiChoice):
 
     @property
     def grid_start_number(self):
-        """
-        Gets the start number for the rating scale.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets the start number for the rating scale."""
         return self.properties.get("GridStartNumber", None)
 
     @grid_start_number.setter
@@ -25,9 +24,6 @@ class FieldRatingScale(FieldMultiChoice):
 
     @property
     def range_count(self):
-        """
-        Specifies the number of options in the rating scale.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Specifies the number of options in the rating scale."""
         return self.properties.get("RangeCount", None)

office365/sharepoint/fields/related_field.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.sharepoint.entity import Entity
 
@@ -7,35 +9,26 @@ class RelatedField(Entity):
 
     @property
     def field_id(self):
-        """
-        Gets the field id of the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the field id of the corresponding Lookup Field."""
         return self.properties.get("FieldId", None)
 
     @property
     def list_id(self):
-        """
-        Gets the ID of the List containing the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the ID of the List containing the corresponding Lookup Field."""
         return self.properties.get("ListId", None)
 
     @property
     def web_id(self):
-        """
-        Gets the ID of the Web containing the corresponding Lookup Field.
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """Gets the ID of the Web containing the corresponding Lookup Field."""
         return self.properties.get("WebId", None)
 
     @property
     def relationship_delete_behavior(self):
-        """
-        Gets delete behavior of the corresponding Lookup Field.
-
-        :rtype: int or None
-        """
+        # type: () -> Optional[int]
+        """Gets delete behavior of the corresponding Lookup Field."""
         return self.properties.get("RelationshipDeleteBehavior", None)
 
     @property