earthengine-api 1.5.24__py3-none-any.whl → 1.6.0__py3-none-any.whl

ee/dictionary.py

@@ -1,7 +1,7 @@
 """A wrapper for dictionaries."""
 from __future__ import annotations
 
-from typing import Any, Optional, Union
+from typing import Any, Union
 
 from ee import _arg_types
 from ee import _utils
@@ -26,14 +26,14 @@ _StringListType = Union[Any, computedobject.ComputedObject]
 class Dictionary(computedobject.ComputedObject):
   """An object to represent dictionaries."""
 
-  _dictionary: Optional[dict[Any, Any]]
+  _dictionary: dict[Any, Any] | None
 
   _initialized = False
 
   # Tell pytype to not complain about dynamic attributes.
   _HAS_DYNAMIC_ATTRIBUTES = True
 
-  def __init__(self, arg: Optional[_arg_types.Dictionary] = None):
+  def __init__(self, arg: _arg_types.Dictionary | None = None):
     """Construct a dictionary.
 
     Args:
@@ -91,7 +91,7 @@ class Dictionary(computedobject.ComputedObject):
   def combine(
       self,
       second: _arg_types.Dictionary,
-      overwrite: Optional[_arg_types.Bool] = None,
+      overwrite: _arg_types.Bool | None = None,
   ) -> Dictionary:
     """Combines two dictionaries.
 
@@ -140,7 +140,7 @@ class Dictionary(computedobject.ComputedObject):
       self,
       key: _EeKeyType,
       # pylint: disable-next=invalid-name
-      defaultValue: Optional[_arg_types.Any] = None,
+      defaultValue: _arg_types.Any | None = None,
   ) -> computedobject.ComputedObject:
     """Extracts a named value from a dictionary.
 
@@ -237,7 +237,7 @@ class Dictionary(computedobject.ComputedObject):
       self,
       selectors: _arg_types.Any,
       # pylint: disable-next=invalid-name
-      ignoreMissing: Optional[_arg_types.Bool] = None,
+      ignoreMissing: _arg_types.Bool | None = None,
   ) -> Dictionary:
     """Returns a dictionary with the specified keys removed.
 
@@ -278,7 +278,7 @@ class Dictionary(computedobject.ComputedObject):
       self,
       selectors: _arg_types.Any,
       # pylint: disable-next=invalid-name
-      ignoreMissing: Optional[_arg_types.Bool] = None,
+      ignoreMissing: _arg_types.Bool | None = None,
   ) -> Dictionary:
     """Returns a dictionary with only the specified keys.
 
@@ -315,8 +315,8 @@ class Dictionary(computedobject.ComputedObject):
 
   def toArray(
       self,
-      keys: Optional[_EeKeyListType] = None,
-      axis: Optional[_arg_types.Integer] = None,
+      keys: _EeKeyListType | None = None,
+      axis: _arg_types.Integer | None = None,
   ) -> ee_array.Array:
     """Returns numeric values of a dictionary as an array.
 
@@ -335,7 +335,7 @@ class Dictionary(computedobject.ComputedObject):
         self.name() + '.toArray', self, keys, axis
     )
 
-  def toImage(self, names: Optional[_arg_types.Any] = None) -> image.Image:
+  def toImage(self, names: _arg_types.Any | None = None) -> image.Image:
     """Creates an image of constants from values in a dictionary.
 
     The bands of the image are ordered and named according to the names
@@ -351,7 +351,7 @@ class Dictionary(computedobject.ComputedObject):
 
     return apifunction.ApiFunction.call_(self.name() + '.toImage', self, names)
 
-  def values(self, keys: Optional[_EeKeyListType] = None) -> ee_list.List:
+  def values(self, keys: _EeKeyListType | None = None) -> ee_list.List:
     """Returns the values of a dictionary as a list.
 
     If no keys are specified, all values are returned in the natural ordering of

ee/ee_array.py

@@ -1,7 +1,7 @@
 """A wrapper for Arrays."""
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from ee import _arg_types
 from ee import apifunction
@@ -37,7 +37,7 @@ class Array(computedobject.ComputedObject):
       self,
       values: _arg_types.Array,
       # pylint: disable-next=invalid-name
-      pixelType: Optional[_arg_types.String] = None,
+      pixelType: _arg_types.String | None = None,
   ):
     """Creates an Array wrapper.
 
@@ -92,7 +92,7 @@ class Array(computedobject.ComputedObject):
   def accum(
       self,
       axis: _arg_types.Integer,
-      reducer: Optional[_arg_types.Reducer] = None,
+      reducer: _arg_types.Reducer | None = None,
   ) -> Array:
     """Accumulates elements of an array along the given axis.
 
@@ -261,7 +261,7 @@ class Array(computedobject.ComputedObject):
 
   @staticmethod
   def cat(
-      arrays: _arg_types.List, axis: Optional[_arg_types.Integer] = None
+      arrays: _arg_types.List, axis: _arg_types.Integer | None = None
   ) -> Array:
     """Returns an Array that is the concatenation of the given arrays.
 
@@ -748,8 +748,8 @@ class Array(computedobject.ComputedObject):
 
   def matrixTranspose(
       self,
-      axis1: Optional[_arg_types.Integer] = None,
-      axis2: Optional[_arg_types.Integer] = None,
+      axis1: _arg_types.Integer | None = None,
+      axis2: _arg_types.Integer | None = None,
   ) -> Array:
     """Transposes two dimensions of an array.
 
@@ -843,7 +843,7 @@ class Array(computedobject.ComputedObject):
     return apifunction.ApiFunction.call_(self.name() + '.or', self, right)
 
   def pad(
-      self, lengths: _arg_types.Any, pad: Optional[_arg_types.Number] = None
+      self, lengths: _arg_types.Any, pad: _arg_types.Number | None = None
   ) -> Array:
     """Pad an array to a given length.
 
@@ -896,7 +896,7 @@ class Array(computedobject.ComputedObject):
       reducer: _arg_types.Reducer,
       axes: _arg_types.Any,
       # pylint: disable-next=invalid-name
-      fieldAxis: Optional[_arg_types.Integer] = None,
+      fieldAxis: _arg_types.Integer | None = None,
   ) -> Array:
     """Returns the result of applying the reducer on the array.
 
@@ -934,8 +934,8 @@ class Array(computedobject.ComputedObject):
 
   def repeat(
       self,
-      axis: Optional[_arg_types.Integer] = None,
-      copies: Optional[_arg_types.Integer] = None,
+      axis: _arg_types.Integer | None = None,
+      copies: _arg_types.Integer | None = None,
   ) -> Array:
     """Repeats the array along the given axis.
 
@@ -1019,10 +1019,10 @@ class Array(computedobject.ComputedObject):
 
   def slice(
       self,
-      axis: Optional[_arg_types.Integer] = None,
-      start: Optional[_arg_types.Integer] = None,
-      end: Optional[_arg_types.Integer] = None,
-      step: Optional[_arg_types.Integer] = None,
+      axis: _arg_types.Integer | None = None,
+      start: _arg_types.Integer | None = None,
+      end: _arg_types.Integer | None = None,
+      step: _arg_types.Integer | None = None,
   ) -> Array:
     """Returns the result of slicing the array along the given axis.
 
@@ -1059,7 +1059,7 @@ class Array(computedobject.ComputedObject):
         self.name() + '.slice', self, axis, start, end, step
     )
 
-  def sort(self, keys: Optional[_arg_types.Any] = None) -> Array:
+  def sort(self, keys: _arg_types.Any | None = None) -> Array:
     """Sorts elements of the array along one axis.
 
     Args:
@@ -1172,8 +1172,8 @@ class Array(computedobject.ComputedObject):
 
   def transpose(
       self,
-      axis1: Optional[_arg_types.Integer] = None,
-      axis2: Optional[_arg_types.Integer] = None,
+      axis1: _arg_types.Integer | None = None,
+      axis2: _arg_types.Integer | None = None,
   ) -> Array:
     """Transposes two dimensions of an array.
 

ee/ee_date.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 
 import datetime
 import math
-from typing import Any, Optional, Union
+from typing import Any, Union
 
 from ee import _arg_types
 from ee import _utils
@@ -31,7 +31,7 @@ class Date(computedobject.ComputedObject):
 
   @_utils.accept_opt_prefix('opt_tz')
   def __init__(
-      self, date: Union[_DateType], tz: Optional[_arg_types.String] = None
+      self, date: _DateType, tz: _arg_types.String | None = None
   ):
     """Construct a date.
 
@@ -108,8 +108,8 @@ class Date(computedobject.ComputedObject):
       delta: _arg_types.Number,
       unit: _arg_types.String,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
-  ) -> 'Date':
+      timeZone: _arg_types.String | None = None,
+  ) -> Date:
     """Create a new Date by adding the specified units to the given Date.
 
     Args:
@@ -147,9 +147,9 @@ class Date(computedobject.ComputedObject):
   def format(
       self,
       # pylint: disable-next=redefined-builtin
-      format: Optional[_arg_types.String] = None,
+      format: _arg_types.String | None = None,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
+      timeZone: _arg_types.String | None = None,
   ) -> ee_string.String:
     """Convert a date to string.
 
@@ -175,8 +175,8 @@ class Date(computedobject.ComputedObject):
       month: _arg_types.Integer,
       day: _arg_types.Integer,
       # pylint: disable=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
-  ) -> 'Date':
+      timeZone: _arg_types.String | None = None,
+  ) -> Date:
     """Returns a Date given year, month, day.
 
     Args:
@@ -194,7 +194,7 @@ class Date(computedobject.ComputedObject):
       self,
       unit: _arg_types.String,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
+      timeZone: _arg_types.String | None = None,
   ) -> ee_number.Number:
     """Returns the specified unit of this date.
 
@@ -215,7 +215,7 @@ class Date(computedobject.ComputedObject):
       self,
       unit: _arg_types.String,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
+      timeZone: _arg_types.String | None = None,
   ) -> ee_number.Number:
     """Returns this date's elapsed fraction of the specified unit.
 
@@ -236,7 +236,7 @@ class Date(computedobject.ComputedObject):
       self,
       unit: _arg_types.String,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
+      timeZone: _arg_types.String | None = None,
   ) -> daterange.DateRange:
     """Returns a DateRange covering the unit that contains this date.
 
@@ -266,7 +266,7 @@ class Date(computedobject.ComputedObject):
       unit: _arg_types.String,
       inUnit: _arg_types.String,  # pylint: disable=invalid-name
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
+      timeZone: _arg_types.String | None = None,
   ) -> ee_number.Number:
     """Returns the specified unit of this date relative to a larger unit.
 
@@ -295,8 +295,8 @@ class Date(computedobject.ComputedObject):
       format: _arg_types.String,  # pylint: disable=redefined-builtin
       date: _arg_types.String,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
-  ) -> 'Date':
+      timeZone: _arg_types.String | None = None,
+  ) -> Date:
     """Parse a date string, given a string describing its format.
 
     Args:
@@ -336,15 +336,15 @@ class Date(computedobject.ComputedObject):
 
   def update(
       self,
-      year: Optional[_arg_types.Integer] = None,
-      month: Optional[_arg_types.Integer] = None,
-      day: Optional[_arg_types.Integer] = None,
-      hour: Optional[_arg_types.Integer] = None,
-      minute: Optional[_arg_types.Integer] = None,
-      second: Optional[_arg_types.Number] = None,
+      year: _arg_types.Integer | None = None,
+      month: _arg_types.Integer | None = None,
+      day: _arg_types.Integer | None = None,
+      hour: _arg_types.Integer | None = None,
+      minute: _arg_types.Integer | None = None,
+      second: _arg_types.Number | None = None,
       # pylint: disable-next=invalid-name
-      timeZone: Optional[_arg_types.String] = None,
-  ) -> 'Date':
+      timeZone: _arg_types.String | None = None,
+  ) -> Date:
     """Create a new Date by setting one or more of the units of the given Date.
 
     If a timeZone is given the new value(s) is interpreted in that zone. Skip or

ee/ee_list.py

@@ -1,7 +1,7 @@
 """A wrapper for lists."""
 from __future__ import annotations
 
-from typing import Any, Optional, Union
+from typing import Any
 
 from ee import _arg_types
 from ee import _utils
@@ -17,16 +17,16 @@ from ee import geometry
 
 class List(computedobject.ComputedObject):
   """An object to represent lists."""
-  _list: Optional[
-      Union[list[Any], tuple[Any, Any]]
-  ]
+  _list: None | (
+      list[Any] | tuple[Any, Any]
+  )
 
   _initialized = False
 
   # Tell pytype to not complain about dynamic attributes.
   _HAS_DYNAMIC_ATTRIBUTES = True
 
-  def __init__(self, arg: Optional[_arg_types.List]):
+  def __init__(self, arg: _arg_types.List | None):
     """Construct a list wrapper.
 
     This constructor accepts the following args:
@@ -64,9 +64,9 @@ class List(computedobject.ComputedObject):
   @staticmethod
   def sequence(
       start: _arg_types.Number,
-      end: Optional[_arg_types.Number] = None,
-      step: Optional[_arg_types.Number] = None,
-      count: Optional[_arg_types.Integer] = None,
+      end: _arg_types.Number | None = None,
+      step: _arg_types.Number | None = None,
+      count: _arg_types.Integer | None = None,
   ) -> List:
     """Returns a List of numbers from start to end (inclusive).
 
@@ -104,7 +104,7 @@ class List(computedobject.ComputedObject):
     return 'List'
 
   @_utils.accept_opt_prefix('opt_encoder')
-  def encode(self, encoder: Optional[Any] = None) -> Any:
+  def encode(self, encoder: Any | None = None) -> Any:
     if isinstance(self._list, (list, tuple)):
       assert self._list is not None
       return [encoder(elem) for elem in self._list]
@@ -112,7 +112,7 @@ class List(computedobject.ComputedObject):
       return super().encode(encoder)
 
   @_utils.accept_opt_prefix('opt_encoder')
-  def encode_cloud_value(self, encoder: Optional[Any] = None) -> Any:
+  def encode_cloud_value(self, encoder: Any | None = None) -> Any:
     if isinstance(self._list, (list, tuple)):
       return {'valueReference': encoder(self._list)}
     else:
@@ -557,7 +557,7 @@ class List(computedobject.ComputedObject):
         self.name() + '.set', self, index, element
     )
 
-  def shuffle(self, seed: Optional[_arg_types.Integer] = None) -> List:
+  def shuffle(self, seed: _arg_types.Integer | None = None) -> List:
     """Randomly permute the specified list.
 
     Note that the permutation order will always be the same for any given seed,
@@ -582,8 +582,8 @@ class List(computedobject.ComputedObject):
   def slice(
       self,
       start: _arg_types.Integer,
-      end: Optional[_arg_types.Integer] = None,
-      step: Optional[_arg_types.Integer] = None,
+      end: _arg_types.Integer | None = None,
+      step: _arg_types.Integer | None = None,
   ) -> List:
     """Returns a range of elements from a list.
 
@@ -607,7 +607,7 @@ class List(computedobject.ComputedObject):
         self.name() + '.slice', self, start, end, step
     )
 
-  def sort(self, keys: Optional[_arg_types.List] = None) -> List:
+  def sort(self, keys: _arg_types.List | None = None) -> List:
     """Sorts the list into ascending order.
 
     If the keys argument is provided, then it is sorted first, and the
@@ -627,7 +627,7 @@ class List(computedobject.ComputedObject):
       self,
       start: _arg_types.Integer,
       count: _arg_types.Integer,
-      other: Optional[_arg_types.List] = None,
+      other: _arg_types.List | None = None,
   ) -> List:
     """Removes elements from list and replaces with elements from other.
 

ee/ee_number.py

@@ -1,7 +1,7 @@
 """A wrapper for numbers."""
 from __future__ import annotations
 
-from typing import Any, Optional, Union
+from typing import Any, Union
 
 from ee import _arg_types
 from ee import _cloud_api_utils
@@ -15,7 +15,7 @@ from ee import ee_string
 class Number(computedobject.ComputedObject):
   """An object to represent numbers."""
 
-  _number: Optional[float]
+  _number: float | None
 
   _initialized = False
 
@@ -299,7 +299,7 @@ class Number(computedobject.ComputedObject):
   def expression(
       expression: _arg_types.String,
       # pylint: disable-next=redefined-builtin
-      vars: Optional[_arg_types.Dictionary] = None,
+      vars: _arg_types.Dictionary | None = None,
   ) -> Number:
     """Returns a number from computing a numeric expression.
 
@@ -351,7 +351,7 @@ class Number(computedobject.ComputedObject):
     return apifunction.ApiFunction.call_(self.name() + '.floor', self)
 
   def format(
-      self, pattern: Optional[_arg_types.String] = None
+      self, pattern: _arg_types.String | None = None
   ) -> ee_string.String:
     r"""Convert a number to a string using printf-style formatting.
 
@@ -589,7 +589,7 @@ class Number(computedobject.ComputedObject):
   def parse(
       # pylint: disable=redefined-builtin
       input: _arg_types.String,
-      radix: Optional[_arg_types.Integer] = None,
+      radix: _arg_types.Integer | None = None,
   ) -> Number:
     """Returns a number from a string.
 

ee/ee_string.py

@@ -1,7 +1,7 @@
 """A wrapper for strings."""
 from __future__ import annotations
 
-from typing import Any, Optional, Union
+from typing import Any
 
 from ee import _arg_types
 from ee import _utils
@@ -15,7 +15,7 @@ from ee import ee_number
 class String(computedobject.ComputedObject):
   """An object to represent strings."""
 
-  _string: Optional[str]
+  _string: str | None
 
   _initialized = False
 
@@ -158,7 +158,7 @@ class String(computedobject.ComputedObject):
     return apifunction.ApiFunction.call_(self.name() + '.length', self)
 
   def match(
-      self, regex: _arg_types.String, flags: Optional[_arg_types.String] = None
+      self, regex: _arg_types.String, flags: _arg_types.String | None = None
   ) -> ee_list.List:
     """Matches a string against a regular expression.
 
@@ -179,7 +179,7 @@ class String(computedobject.ComputedObject):
       self,
       regex: _arg_types.String,
       replacement: _arg_types.String,
-      flags: Optional[_arg_types.String] = None,
+      flags: _arg_types.String | None = None,
   ) -> String:
     """Returns a string with some or all matches of a pattern replaced.
 
@@ -210,7 +210,7 @@ class String(computedobject.ComputedObject):
     return apifunction.ApiFunction.call_(self.name() + '.rindex', self, pattern)
 
   def slice(
-      self, start: _arg_types.Integer, end: Optional[_arg_types.Integer] = None
+      self, start: _arg_types.Integer, end: _arg_types.Integer | None = None
   ) -> String:
     """Returns a substring of the given string.
 
@@ -232,7 +232,7 @@ class String(computedobject.ComputedObject):
     )
 
   def split(
-      self, regex: _arg_types.String, flags: Optional[_arg_types.String] = None
+      self, regex: _arg_types.String, flags: _arg_types.String | None = None
   ) -> ee_list.List:
     """Splits a string on a regular expression into a list of strings.
 

ee/ee_types.py

@@ -4,7 +4,7 @@
 # pylint: disable=g-bad-name
 
 import datetime
-from typing import Any, Type
+from typing import Any
 
 from ee import computedobject
 
@@ -23,7 +23,7 @@ def _registerClasses(classes) -> None:
   _registered_classes = classes
 
 
-def classToName(a_class: Type[Any]) -> str:
+def classToName(a_class: type[Any]) -> str:
   """Converts a class to the API-friendly type name.
 
   Args:

ee/element.py

@@ -6,7 +6,7 @@ This class is never intended to be instantiated by the user.
 from __future__ import annotations
 
 import datetime
-from typing import Any, Optional, Union
+from typing import Any
 
 from ee import _arg_types
 from ee import _utils
@@ -29,9 +29,9 @@ class Element(computedobject.ComputedObject):
   @_utils.accept_opt_prefix('opt_varName')
   def __init__(
       self,
-      func: Optional[apifunction.ApiFunction],
-      args: Optional[dict[str, Any]],
-      varName: Optional[str] = None,  # pylint: disable=g-bad-name
+      func: apifunction.ApiFunction | None,
+      args: dict[str, Any] | None,
+      varName: str | None = None,  # pylint: disable=g-bad-name
   ):
     """Constructs a collection by initializing its ComputedObject."""
     super().__init__(func, args, varName)
@@ -58,8 +58,8 @@ class Element(computedobject.ComputedObject):
   def copyProperties(
       self,
       source: _arg_types.Element,
-      properties: Optional[_arg_types.List] = None,
-      exclude: Optional[_arg_types.List] = None,
+      properties: _arg_types.List | None = None,
+      exclude: _arg_types.List | None = None,
   ) -> Element:
     """Copies metadata properties from one element to another.
 
@@ -121,13 +121,13 @@ class Element(computedobject.ComputedObject):
 
   def set(
       self,
-      *args: Union[
-          dict[str, Any],
-          float,
-          str,
-          datetime.datetime,
-          computedobject.ComputedObject,
-      ],
+      *args: (
+          dict[str, Any] |
+          float |
+          str |
+          datetime.datetime |
+          computedobject.ComputedObject
+      ),
   ) -> Element:
     """Overrides one or more metadata properties of an Element.
 
@@ -182,7 +182,7 @@ class Element(computedobject.ComputedObject):
     return self._cast(result)
 
   def toDictionary(
-      self, properties: Optional[_arg_types.List] = None
+      self, properties: _arg_types.List | None = None
   ) -> dictionary.Dictionary:
     """Returns properties from a feature as a dictionary.
 

ee/errormargin.py

@@ -1,7 +1,7 @@
 """A wrapper for ErrorMargins."""
 from __future__ import annotations
 
-from typing import Any, Optional
+from typing import Any
 
 from ee import _arg_types
 from ee import apifunction
@@ -36,8 +36,8 @@ class ErrorMargin(computedobject.ComputedObject):
 
   def __init__(
       self,
-      value: Optional[_arg_types.Number] = None,
-      unit: Optional[_arg_types.String] = None,
+      value: _arg_types.Number | None = None,
+      unit: _arg_types.String | None = None,
   ):
     """Creates a ErrorMargin wrapper.