earthengine-api 1.7.9rc0__py3-none-any.whl → 1.7.10rc0__py3-none-any.whl

{earthengine_api-1.7.9rc0.dist-info → earthengine_api-1.7.10rc0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: earthengine-api
-Version: 1.7.9rc0
+Version: 1.7.10rc0
 Summary: Earth Engine Python API
 Author-email: Google LLC <noreply@google.com>
 License: Apache-2.0

{earthengine_api-1.7.9rc0.dist-info → earthengine_api-1.7.10rc0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-earthengine_api-1.7.9rc0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-ee/__init__.py,sha256=Wj-KQ4KUWD6Sh9Urx4rxEfmJNrSxKHrsC2cAM4MZ8ks,16762
+earthengine_api-1.7.10rc0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+ee/__init__.py,sha256=VQd47xDwRNdo7ygHuIypAiPnEJUbNJrT6RgNP2O706A,16763
 ee/_arg_types.py,sha256=nrJrnPFnAS8fzMxAGmG3TbUOi_yFVrnSGW5IP8ATzDQ,2662
 ee/_cloud_api_utils.py,sha256=5WPzP5bcBIbjA7yYN-Cwmht_HU-XobbTrZvRiOEn0e0,32890
 ee/_helpers.py,sha256=afDDqoz1WESKE-lzqLtrCbvoQ1yVpfvJIgFcmUjO4L8,4821
@@ -32,12 +32,12 @@ ee/encodable.py,sha256=bZLsuIPNO5_nOBuwnbhuxTRcjTKqFPgL8ox7uy41w6M,1963
 ee/errormargin.py,sha256=x8kAgFeUdXmpc_kv8Vx5qv-fHeJvFU9EBFbSOxhNl8Y,3039
 ee/feature.py,sha256=Qp5Dyl0eM6yjmQSH0D-dc9LEeKMCqlNibYJ9jOhHsaE,30326
 ee/featurecollection.py,sha256=HBLIAS0HogRzTEVHaLn-X9ONfdu5qFvN_6Bb54KYQ28,14400
-ee/filter.py,sha256=GKz3IqeZSrK4X26TjWaw_uOE8KjZgSx1pS1zM07PXfI,35321
+ee/filter.py,sha256=Zu1t4rZItJmEgIzdfwkhyYwGMoFtNJUuTPdX7xMuJoE,34378
 ee/function.py,sha256=X-Mz0AvF_l809NZXK8RM6fa2h-nP7YU2sUFp6hvIbdU,7049
 ee/geometry.py,sha256=D__UeT72DDaJFakmyaPnmfHwxNtDxLJW7Vbze0Hh2Y4,59517
 ee/image.py,sha256=8ErloWEwLZZRHgwf5SHITnMvRAawPZtGC6Kfq-jCTK8,170923
 ee/image_converter.py,sha256=LblcmkWruE0BjItZ7ICv87XZlCCjZeX2HmGxf47HXyo,1469
-ee/imagecollection.py,sha256=5ZUUreU0iY23UC9sd8gh8fLapVZTruV3DGhsjmQF0xg,27102
+ee/imagecollection.py,sha256=-2x37vsl3mOLa2dZUCL0GBaxR265DD_BOuH7NsMFmGU,27107
 ee/join.py,sha256=idnuzRNFvKHRLHV5m9unp_xTsZb-E2kfgUCEYSg64ts,7578
 ee/kernel.py,sha256=eTzJFvW4nbyiFl2dDZ0_cA_o3KqCbBewY-BDp7tCB_M,15002
 ee/mapclient.py,sha256=feCFwL76juFFZPI4uycVxUoFMeEFbPFfIVETkmpvmcY,17491
@@ -86,13 +86,13 @@ ee/tests/encodable_test.py,sha256=tRCtW6HO5-OnjXlxVUEUgoVrEOllvs-Z9pWMXISMYHQ,83
 ee/tests/errormargin_test.py,sha256=YEBzvBFsD756nicZBcjnPFAXy06jZNKiSSAa2hAzN-M,5061
 ee/tests/feature_test.py,sha256=-9wJgY-eJM53ZKYjRcnfWAZXjkF_u8Tn4I1wc209R0U,23336
 ee/tests/featurecollection_test.py,sha256=CXy240UIRCJNY6nZ8wW-u2O9MqFkUX-ZVba9wTr8OTU,39118
-ee/tests/filter_test.py,sha256=d-KQ_zI-r7BAMazKqqHMMzNUZdeC46BZiciMfthKEO8,35033
+ee/tests/filter_test.py,sha256=VB5R4GdHKqzIJrpxlyBrGu5kv0_5lOYjsMu8AWhd8-8,37047
 ee/tests/function_test.py,sha256=60Yl3K6VvOsObW3jhbhWnb9TzBjdQne63wbZWuyQxbY,3524
 ee/tests/geometry_point_test.py,sha256=w9MYTwvw2Co9rIjffFB0ezQ_jZz8nxbdgOcyhqTTmjk,15093
 ee/tests/geometry_test.py,sha256=5cNblTtXg4gg0k1_6go4XL2EldY2StOfD7sQ7Bu0WZU,32424
 ee/tests/image_converter_test.py,sha256=x29StMrzv6jlATtx3XXC7rEo7Cgrcx0XyVoM-ccVuao,1853
-ee/tests/image_test.py,sha256=bhu_GLQy0jRJORVNHnpShOHzg-ZptE3XG3r_APiJ4n4,152371
-ee/tests/imagecollection_test.py,sha256=M2WdkCPx-w7wWFGw9q2XHRAXo7rCMAqIZknjhldlPs4,41535
+ee/tests/image_test.py,sha256=A2vxHBOt0Xo5FQQYWzr9cu2XfL1Lz1dcHTeGIWwIiEU,154615
+ee/tests/imagecollection_test.py,sha256=iYDj8q8VOywBN4rc-8cvDm59dEysrwA9Eq_X-bL_X8k,42691
 ee/tests/join_test.py,sha256=uuMW2tvHVoBXuanhcsJ95cQTfRjJTs5gmaPrzAJZrGM,7860
 ee/tests/kernel_test.py,sha256=-0nZVNSxE1IGs4y60oijISh2Hi1V7NCjrmUnEMDd0nQ,19378
 ee/tests/model_test.py,sha256=dgnWfqR4R4MIUljMBL1TOcztzA-lWEl7cT5f2Y0k2ck,12483
@@ -103,8 +103,8 @@ ee/tests/reducer_test.py,sha256=vqXpgLZ7fPyfZ12srpREgMpfrKYLcFQod3Qn1Niv7VM,3197
 ee/tests/serializer_test.py,sha256=d6IEW_dt-G900IRfQnZftrwjpc1wJ-ouaQQwaLO0FxI,9834
 ee/tests/table_converter_test.py,sha256=t4yIfy40R3U17I_2nVtKm_Q2Tae-UifwZLz8qOmoC9A,5091
 ee/tests/terrain_test.py,sha256=inZ2sy807nDG_HMutzGHaqcTUaLnZQOMdWyf0NrQzV0,4561
-earthengine_api-1.7.9rc0.dist-info/METADATA,sha256=dqnhR0YwRAxz41x1Mn4hGM2dFBoAZOPxgQEr_9hyhy4,2198
-earthengine_api-1.7.9rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-earthengine_api-1.7.9rc0.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
-earthengine_api-1.7.9rc0.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
-earthengine_api-1.7.9rc0.dist-info/RECORD,,
+earthengine_api-1.7.10rc0.dist-info/METADATA,sha256=J-f7WEECoA-LUQ5C8ZtGvmrksKq9OwnzLwyqkelDnxo,2199
+earthengine_api-1.7.10rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+earthengine_api-1.7.10rc0.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
+earthengine_api-1.7.10rc0.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
+earthengine_api-1.7.10rc0.dist-info/RECORD,,

ee/__init__.py

@@ -1,6 +1,6 @@
 """The EE Python library."""
 
-__version__ = '1.7.9rc0'
+__version__ = '1.7.10rc0'
 
 # Using lowercase function naming to match the JavaScript names.
 # pylint: disable=g-bad-name

ee/filter.py

@@ -7,7 +7,6 @@ Example usage:
      .lt('time', value)
 """
 
-# Using lowercase function naming to match the JavaScript names.
 # pylint: disable=g-bad-name
 
 from __future__ import annotations
@@ -70,9 +69,8 @@ class Filter(computedobject.ComputedObject):
       super().__init__(filter_.func, filter_.args, filter_.varName)
       self._filter = (filter_,)
     elif filter_ is None:
-      # A silly call with no arguments left for backward-compatibility.
-      # Encoding such a filter is expected to fail, but it can be composed
-      # by calling the various methods that end up in _append().
+      # A call with no arguments left for backward-compatibility.
+      # Encoding such a filter is expected to fail.
       super().__init__(None, None)
       self._filter = ()
     else:
@@ -102,31 +100,6 @@ class Filter(computedobject.ComputedObject):
     """
     return len(self._filter)
 
-  def _append(self, new_filter: _arg_types.Filter) -> Filter:
-    """Append a predicate to this filter.
-
-    These are implicitly ANDed.
-
-    Args:
-      new_filter: The filter to append to this one. Possible types are:
-          1) another fully constructed Filter,
-          2) a JSON representation of a filter,
-          3) an array of 1 or 2.
-
-    Returns:
-      A new filter that is the combination of both.
-    """
-    if new_filter is None:
-      raise ValueError('new_filter should never be None')
-    prev = list(self._filter)
-    if isinstance(new_filter, Filter):
-      prev.extend(new_filter._filter)  # pylint: disable=protected-access
-    elif isinstance(new_filter, list):
-      prev.extend(new_filter)
-    else:
-      prev.append(new_filter)
-    return Filter(prev)
-
   @staticmethod
   def metadata_(name: str, operator: str, value: _arg_types.Any) -> Filter:
     """Filter on metadata. This is deprecated.

ee/imagecollection.py

@@ -299,7 +299,8 @@ class ImageCollection(collection.Collection[image.Image]):
     request['format'] = params.get('format', valid_formats[0])
     if request['format'] not in valid_formats:
       raise ee_exception.EEException(
-          'Invalid format specified for thumbnail. ' + str(params['format']))
+          f'Invalid format specified for thumbnail: "{request["format"]}"'
+      )
 
     if params and 'framesPerSecond' in params:
       request['framesPerSecond'] = params.get('framesPerSecond')

ee/tests/filter_test.py

@@ -40,6 +40,64 @@ class FilterTest(apitestcase.ApiTestCase):
     copy = ee.Filter(from_static_method)
     self.assertEqual(from_static_method, copy)
 
+  def test_constructor_no_args(self):
+    # This is code to be avoided, but since it has been this way for a long
+    # time, this captures the current behavior.
+    # Please do not use `ee.Filter()` to access static methods like `Or`.
+    # Instead, call them directly on the class, e.g., `ee.Filter.Or(...)`.
+    a_filter = ee.Filter()
+    self.assertEqual(a_filter.predicateCount(), 0)
+
+    self.assertTrue(a_filter.isVariable())
+
+    # Not very intuitive error message.
+    with self.assertRaisesRegex(ee.EEException, 'arguments cannot be used'):
+      a_filter.serialize()
+
+    # Not very intuitive error message.
+    with self.assertRaisesRegex(ee.EEException, 'arguments cannot be used'):
+      str(a_filter)
+
+  def test_empty_list_filter(self):
+    with self.assertRaisesRegex(
+        ee.EEException, 'Empty list specified for ee.Filter().'
+    ):
+      ee.Filter([])
+
+  def test_list_of_filters(self):
+    f1 = ee.Filter.eq('x', 1)
+    f2 = ee.Filter.eq('y', 2)
+    filters = [f1, f2]
+    multi_filter = ee.Filter(filters)
+    self.assertEqual(tuple(filters), multi_filter._filter)
+    self.assertEqual(ee.ApiFunction.lookup('Filter.and'), multi_filter.func)
+    self.assertEqual({'filters': tuple(filters)}, multi_filter.args)
+
+  def test_invalid_argument(self):
+    with self.assertRaisesRegex(
+        ee.EEException, 'Invalid argument specified for ee.Filter().*'
+    ):
+      ee.Filter(123)  # pytype: disable=wrong-arg-types
+
+  def test_predicate_count(self):
+    self.assertEqual(0, ee.Filter().predicateCount())
+    self.assertEqual(1, ee.Filter(ee.Filter.eq('x', 1)).predicateCount())
+    self.assertEqual(1, ee.Filter([ee.Filter.eq('x', 1)]).predicateCount())
+    self.assertEqual(
+        2,
+        ee.Filter(
+            [ee.Filter.eq('x', 1), ee.Filter.eq('y', 2)]
+        ).predicateCount(),
+    )
+    self.assertEqual(
+        3,
+        ee.Filter([
+            ee.Filter.eq('x', 1),
+            ee.Filter.eq('y', 2),
+            ee.Filter.eq('z', 3),
+        ]).predicateCount(),
+    )
+
   def test_metadata(self):
     """Verifies that the metadata_() method works."""
     self.assertEqual(

ee/tests/image_test.py

@@ -148,6 +148,60 @@ class ImageTest(apitestcase.ApiTestCase):
         'srcImg': image2
     }, combined.args['input'].args)
 
+  def test_rgb(self):
+    """Verifies the behavior of ee.Image.rgb()."""
+    r = 1.1
+    g = 2.2
+    b = 3.3
+    expression = ee.Image.rgb(r, g, b)
+    expect = make_expression_graph({
+        'arguments': {
+            'input': {
+                'functionInvocationValue': {
+                    'functionName': 'Image.addBands',
+                    'arguments': {
+                        'dstImg': {
+                            'functionInvocationValue': {
+                                'functionName': 'Image.addBands',
+                                'arguments': {
+                                    'dstImg': {
+                                        'functionInvocationValue': {
+                                            'functionName': 'Image.constant',
+                                            'arguments': {
+                                                'value': {'constantValue': r}
+                                            },
+                                        }
+                                    },
+                                    'srcImg': {
+                                        'functionInvocationValue': {
+                                            'functionName': 'Image.constant',
+                                            'arguments': {
+                                                'value': {'constantValue': g}
+                                            },
+                                        }
+                                    },
+                                },
+                            }
+                        },
+                        'srcImg': {
+                            'functionInvocationValue': {
+                                'functionName': 'Image.constant',
+                                'arguments': {'value': {'constantValue': b}},
+                            }
+                        },
+                    },
+                }
+            },
+            'bandSelectors': {'constantValue': ['.*']},
+            'newNames': {
+                'constantValue': ['vis-red', 'vis-green', 'vis-blue']
+            },
+        },
+        'functionName': 'Image.select',
+    })
+    result = json.loads(expression.serialize())
+    self.assertEqual(expect, result)
+
   def test_select(self):
     """Verifies regression in the behavior of empty ee.Image.select()."""
     image = ee.Image([1, 2]).select()

ee/tests/imagecollection_test.py

@@ -144,13 +144,13 @@ class ImageCollectionTest(apitestcase.ApiTestCase):
 
   def test_filmstrip_thumb_url_invalid_format(self):
     """Verifies correct thumbnailing behavior."""
-    message = r'Invalid format specified for thumbnail\. gif'
+    message = r'Invalid format specified for thumbnail: "gif"'
     with self.assertRaisesRegex(ee.EEException, message):
       ee.ImageCollection(ee.Image(1)).getFilmstripThumbURL({'format': 'gif'})
 
   def test_video_thumb_url_invalid_format(self):
     """Verifies correct thumbnailing behavior."""
-    message = r'Invalid format specified for thumbnail\. png'
+    message = r'Invalid format specified for thumbnail: "png"'
     with self.assertRaisesRegex(ee.EEException, message):
       ee.ImageCollection(ee.Image(1)).getVideoThumbURL({'format': 'png'})
 
@@ -722,7 +722,38 @@ class ImageCollectionTest(apitestcase.ApiTestCase):
     result = json.loads(expression.serialize())
     self.assertEqual(expect, result)
 
-  # fromImages already tested in other tests.
+  def test_from_images(self):
+    images = [ee.Image(1), ee.Image(2)]
+    expect = make_expression_graph({
+        'arguments': {
+            'images': {
+                'arrayValue': {
+                    'values': [
+                        {
+                            'functionInvocationValue': {
+                                'functionName': 'Image.constant',
+                                'arguments': {'value': {'constantValue': 1}},
+                            }
+                        },
+                        {
+                            'functionInvocationValue': {
+                                'functionName': 'Image.constant',
+                                'arguments': {'value': {'constantValue': 2}},
+                            }
+                        },
+                    ]
+                }
+            }
+        },
+        'functionName': 'ImageCollection.fromImages',
+    })
+    expression = ee.ImageCollection.fromImages(images)
+    result = json.loads(expression.serialize())
+    self.assertEqual(expect, result)
+
+    expression = ee.ImageCollection.fromImages(images=images)
+    result = json.loads(expression.serialize())
+    self.assertEqual(expect, result)
 
   def test_geometry(self):
     max_error = 1.1