fix: deprecate expressions (#141)

geetools/User/__init__.py

@@ -146,3 +146,28 @@ def list(credential_path: str = "") -> list:
         credential_path = Path(credential_path).parent
         files = [f for f in credential_path.glob("credentials*") if f.is_file()]
         return [f.name.replace("credentials", "") or "default" for f in files]
+
+    @staticmethod
+    def rename(new: str, old: str = "", credential_path: str = "") -> None:
+        """Rename a user without changing the credentials.
+
+        Args:
+            new: The new name of the user
+            old: The name of the user to rename
+            credential_path: The path to the folder where the credentials are stored. If not set, it uses the default path
+
+        Example:
+            .. jupyter-execute::
+
+                import ee
+                import geetools
+
+                geetools.user.create("secondary")
+                geetools.User.rename("secondary", "new_default")
+                geetools.User.list()
+        """
+        old = f"credentials{old}"
+        new = f"credentials{new}"
+        credential_path = credential_path or ee.oauth.get_credentials_path()
+        credential_path = Path(credential_path).parent
+        suppress((credential_path / old).rename(credential_path / new))

geetools/__init__.py

@@ -1,39 +1,14 @@
 """A package to use with Google Earth Engine Python API."""
 import ee
 
-# from geetools import (
-# bitreader,
-# cloud_mask,
-# expressions,
-# decision_tree,
-# indices,
-# batch,
-# algorithms,
-# composite,
-# manager,
-# utils,
-# collection,
-# oauth,
-# visualization,
-# classification
-# )
-# from geetools.tools import (
-# ee_list,
-# featurecollection,
-# geometry,
-# image,
-# imagecollection,
-# )
-# from geetools.ui import eprint
-# from geetools.batch import Export, Import, Convert, Download
-# from geetools.oauth import Initialize
-# from geetools.utils import evaluate
 # it needs to be imported first as it's the mother class
 from . import ComputedObject  # noqa: F401
+from . import _deprecated_expressions as expressions  # noqa: F401
 
 # reproduce older structure of the lib (deprecated)
 # will be removed along the deprecation cycle
 from . import _deprecated_filters as filters  # noqa: F401
+from . import _deprecated_oauth as oauth  # noqa: F401
 from . import _deprecated_visualization as visualization  # noqa: F401
 
 # then we extend all the other classes

geetools/_deprecated_expressions.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+"""Expression generator for Google Earth Engine."""
+from deprecated.sphinx import deprecated
+
+
+class Expression:
+    @deprecated(version="1.0.0", reason="Use pure python string instead")
+    @staticmethod
+    def max(a, b):
+        """Generates the expression for max between a and b."""
+        return "({a}>{b})?{a}:{b}".format(a=a, b=b)
+
+    @deprecated(version="1.0.0", reason="Use pure python string instead")
+    @staticmethod
+    def min(a, b):
+        """Generates the expression for min between a and b."""
+        return "({a}>{b})?{b}:{a}".format(a=a, b=b)

geetools/_deprecated_oauth.py

@@ -17,11 +17,10 @@ def delete_local_user(user="", credential_path=""):
     geetools.User.delete(user, credential_path)
 
 
-@deprecated(version="1.0.0", reason="Use geetools.User.delete/create instead")
+@deprecated(version="1.0.0", reason="Use geetools.User.rename instead")
 def rename_current_user(name="", credential_path=""):
     """Rename the current user."""
-    geetools.User.delete(name, credential_path)
-    geetools.User.create(name, credential_path)
+    geetools.User.rename(name, "", credential_path)
 
 
 @deprecated(version="1.0.0", reason="Use geetools.User.set instead")