earthengine-api 1.7.8rc0__py3-none-any.whl → 1.7.9__py3-none-any.whl

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

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

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

@@ -1,5 +1,5 @@
-earthengine_api-1.7.8rc0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-ee/__init__.py,sha256=DK4eecWVgntWOe7i-m_vrJsApEBn21Tktb0_v9Q-UO0,16762
+earthengine_api-1.7.9.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+ee/__init__.py,sha256=egVqpmJfMrMKvX_gT-jVCpbVrq4erXjuDEDLD-5oRLM,16759
 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
@@ -87,13 +87,13 @@ ee/tests/errormargin_test.py,sha256=YEBzvBFsD756nicZBcjnPFAXy06jZNKiSSAa2hAzN-M,
 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/function_test.py,sha256=0hv7H-Q21vdDvqHNH_3NvFj_nPEWM2Fh7CD0wgjXE2M,3131
+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=_SJmee7orPot26vbxKEZcNZ6OsrNrxv3ToInWYLNZLM,150917
-ee/tests/imagecollection_test.py,sha256=qosRZXCbhwFuy8qR7DbA-FMl4ktW7Y2cUJHeXLcszpg,38444
-ee/tests/join_test.py,sha256=pFILq3qM27rO64WYbBC1A_Gs8_pabRv68X7MU_EM_cw,7630
+ee/tests/image_test.py,sha256=bhu_GLQy0jRJORVNHnpShOHzg-ZptE3XG3r_APiJ4n4,152371
+ee/tests/imagecollection_test.py,sha256=M2WdkCPx-w7wWFGw9q2XHRAXo7rCMAqIZknjhldlPs4,41535
+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
 ee/tests/oauth_test.py,sha256=8hldNiR3AYtQkWA4vwwSAO6jDIsh_fww7b_cOI9MJjo,9202
@@ -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.8rc0.dist-info/METADATA,sha256=AclNvSHk6s2ueWnRMQeTyo9YP4f5YKZm2P1FqfIIxc8,2198
-earthengine_api-1.7.8rc0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-earthengine_api-1.7.8rc0.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
-earthengine_api-1.7.8rc0.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
-earthengine_api-1.7.8rc0.dist-info/RECORD,,
+earthengine_api-1.7.9.dist-info/METADATA,sha256=lebc7nR6BBje0swYH-S9jec7wr2Tc0skwu1bnyfWwWE,2195
+earthengine_api-1.7.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+earthengine_api-1.7.9.dist-info/entry_points.txt,sha256=-Ax4SCU-S474r8OD2LIxata6PRmkZoDrppQ4fP_exNc,50
+earthengine_api-1.7.9.dist-info/top_level.txt,sha256=go5zOwCgm5lIS3yTR-Vsxp1gNI4qdS-MP5eY-7zMxVY,3
+earthengine_api-1.7.9.dist-info/RECORD,,

ee/__init__.py

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

ee/tests/function_test.py

@@ -34,6 +34,11 @@ Args:
 
 class FunctionTest(unittest.TestCase):
 
+  def test_get_signature_not_implemented(self):
+    message = 'Function subclasses must implement getSignature()'
+    with self.assertRaisesRegex(NotImplementedError, message):
+      ee.Function().getSignature()
+
   def test_name_args(self):
     """Verifies that Functions can convert positional to named arguments."""
     self.assertEqual({}, TEST_FUNC.nameArgs([]))
@@ -43,6 +48,13 @@ class FunctionTest(unittest.TestCase):
 
     self.assertRaisesRegex(ee.EEException, 'Too many', TEST_FUNC.nameArgs,
                            [1, 2, 3])
+    self.assertRaisesRegex(
+        ee.EEException,
+        'Argument a specified as both positional and keyword',
+        TEST_FUNC.nameArgs,
+        [1],
+        {'a': 2},
+    )
 
   def test_promote_args(self):
     """Verifies that Functions can promote and verify their arguments."""

ee/tests/image_test.py

@@ -97,6 +97,20 @@ class ImageTest(apitestcase.ApiTestCase):
         'value': 'foo'
     }, from_variable.encode(None))
 
+  def test_constructor_invalid_version(self):
+    with self.assertRaisesRegex(
+        ee_exception.EEException,
+        r'If version is specified, the arg to Image\(\) must be a string',
+    ):
+      ee.Image(123, version=456)
+
+  def test_constructor_unrecognized_type(self):
+    with self.assertRaisesRegex(
+        ee_exception.EEException,
+        'Unrecognized argument type to convert to an Image:',
+    ):
+      ee.Image({'some': 'dict'})
+
   def test_image_signatures(self):
     """Verifies that the API functions are added to ee.Image."""
     self.assertTrue(hasattr(ee.Image(1), 'addBands'))
@@ -629,6 +643,19 @@ class CloudThumbnailAndExportImageTest(apitestcase.ApiTestCase):
       )
       self.assertEqual({}, params)
 
+  def test_prepare_for_export_with_crs_and_crsTransform(self):
+    with apitestcase.UsingCloudApi():
+      image, params = self._base_image.prepare_for_export(
+          {'crs': 'ABCD', 'crsTransform': '1,2,3,4,5,6'}
+      )
+      self.assertImageEqual(
+          self._base_image.reproject(
+              crs='ABCD', crsTransform=[1, 2, 3, 4, 5, 6]
+          ),
+          image,
+      )
+      self.assertEqual({}, params)
+
   def test_prepare_for_export_invalid_crs_and_transform(self):
     with apitestcase.UsingCloudApi():
       with self.assertRaises(ee_exception.EEException):
@@ -637,6 +664,20 @@ class CloudThumbnailAndExportImageTest(apitestcase.ApiTestCase):
         self._base_image.prepare_for_export(
             {'crs': 'ABCD', 'crs_transform': 'x'}
         )
+      with self.assertRaisesRegex(
+          ee_exception.EEException,
+          'Both "crs_transform" and "crsTransform" are specified.',
+      ):
+        self._base_image.prepare_for_export({
+            'crs': 'EPSG:4326',
+            'crs_transform': [1, 2, 3, 4, 5, 6],
+            'crsTransform': [1, 2, 3, 4, 5, 6],
+        })
+
+  def test_prepare_for_export_invalid_dimensions(self):
+    with apitestcase.UsingCloudApi():
+      with self.assertRaisesRegex(ee_exception.EEException, 'Invalid dimensions'):
+        self._base_image.prepare_for_export({'dimensions': [1, 2, 3]})
 
   def test_prepare_for_export_with_polygon(self):
     with apitestcase.UsingCloudApi():

ee/tests/imagecollection_test.py

@@ -84,6 +84,13 @@ class ImageCollectionTest(apitestcase.ApiTestCase):
         ee.ComputedObject(None, {'x': 'y'}))
     self.assertEqual({'x': 'y'}, from_computed_object.args)
 
+  def test_unrecognized_type(self):
+    with self.assertRaisesRegex(
+        ee.EEException,
+        'Unrecognized argument type to convert to an ImageCollection: 123',
+    ):
+      ee.ImageCollection(123)
+
   def test_imperative_functions(self):
     """Verifies that imperative functions return ready values."""
     image_collection = ee.ImageCollection(ee.Image(1))
@@ -135,6 +142,18 @@ class ImageCollectionTest(apitestcase.ApiTestCase):
           collection.serialize(for_cloud_api=True))
       self.assertEqual({}, params)
 
+  def test_filmstrip_thumb_url_invalid_format(self):
+    """Verifies correct thumbnailing behavior."""
+    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'
+    with self.assertRaisesRegex(ee.EEException, message):
+      ee.ImageCollection(ee.Image(1)).getVideoThumbURL({'format': 'png'})
+
   def test_select_opt_params(self):
     result = (
         ee.ImageCollection([])
@@ -143,6 +162,56 @@ class ImageCollectionTest(apitestcase.ApiTestCase):
     )
     self.assertIn('"newNames": {"constantValue": ["name_a", "name_b"]}', result)
 
+  def test_link_collection_all_args(self):
+    image_collection_1 = ee.ImageCollection('a')
+    image_collection_2 = ee.ImageCollection('b')
+    linked_bands = ['b1', 'b2']
+    linked_properties = ['p1', 'p2']
+    match_property_name = 'p3'
+    result = image_collection_1.linkCollection(
+        image_collection_2,
+        linked_bands,
+        linked_properties,
+        match_property_name,
+    )
+    self.assertIsInstance(result, ee.ImageCollection)
+    self.assertEqual(ee.ApiFunction.lookup('Collection.map'), result.func)
+    self.assertEqual(image_collection_1, result.args['collection'])
+    self.assertIsInstance(result.args['baseAlgorithm'], ee.Function)
+
+    serialized = result.serialize()
+    self.assertIn('"functionName": "ImageCollection.load"', serialized)
+    self.assertIn('"id": {"constantValue": "a"}', serialized)
+    self.assertIn('"functionName": "Image.linkCollection"', serialized)
+    self.assertIn('"id": {"constantValue": "b"}', serialized)
+    self.assertIn('"linkedBands": {"constantValue": ["b1", "b2"]}', serialized)
+    self.assertIn(
+        '"linkedProperties": {"constantValue": ["p1", "p2"]}', serialized
+    )
+    self.assertIn('"matchPropertyName": {"constantValue": "p3"}', serialized)
+
+  def test_link_collection_necessary_args(self):
+    image_collection_1 = ee.ImageCollection('a')
+    image_collection_2 = ee.ImageCollection('b')
+    linked_bands = ['b1', 'b2']
+    result = image_collection_1.linkCollection(
+        image_collection_2,
+        linkedBands=linked_bands,
+    )
+    self.assertIsInstance(result, ee.ImageCollection)
+    self.assertEqual(ee.ApiFunction.lookup('Collection.map'), result.func)
+    self.assertEqual(image_collection_1, result.args['collection'])
+    self.assertIsInstance(result.args['baseAlgorithm'], ee.Function)
+
+    serialized = result.serialize()
+    self.assertIn('"functionName": "ImageCollection.load"', serialized)
+    self.assertIn('"id": {"constantValue": "a"}', serialized)
+    self.assertIn('"functionName": "Image.linkCollection"', serialized)
+    self.assertIn('"id": {"constantValue": "b"}', serialized)
+    self.assertIn('"linkedBands": {"constantValue": ["b1", "b2"]}', serialized)
+    self.assertNotIn('"linkedProperties"', serialized)
+    self.assertNotIn('"matchPropertyName"', serialized)
+
   def test_aggregate_array(self):
     property_name = 'property name'
     expect = make_expression_graph({

ee/tests/join_test.py

@@ -28,6 +28,11 @@ class JoinTest(apitestcase.ApiTestCase):
     with self.assertRaisesRegex(TypeError, message):
       ee.Join()  # pytype:disable=missing-parameter
 
+  def test_join_type_error(self):
+    message = r"Join can only be used as a cast to Join\. Found <class 'str'>"
+    with self.assertRaisesRegex(TypeError, message):
+      ee.Join('some string')  # pytype:disable=wrong-arg-types
+
   def test_apply(self):
     expect = make_expression_graph({
         'arguments': {