Sl collateral commands (#242)

* error message against db.nonmethod() and getattr/getitem of async are non-async functions

* command() method for raw POSTs

* with_options as sugar for copy() methods

* format on test

astrapy/idiomatic/collection.py

@@ -123,6 +123,19 @@ def copy(
             caller_version=caller_version or self._astra_db_collection.caller_version,
         )
 
+    def with_options(
+        self,
+        *,
+        name: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Collection:
+        return self.copy(
+            name=name,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
     def to_async(
         self,
         *,
@@ -603,6 +616,19 @@ def copy(
             caller_version=caller_version or self._astra_db_collection.caller_version,
         )
 
+    def with_options(
+        self,
+        *,
+        name: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncCollection:
+        return self.copy(
+            name=name,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
     def to_sync(
         self,
         *,

astrapy/idiomatic/database.py

@@ -134,6 +134,19 @@ def copy(
             api_version=api_version or self._astra_db.api_version,
         )
 
+    def with_options(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> Database:
+        return self.copy(
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
     def to_async(
         self,
         *,
@@ -377,6 +390,19 @@ def copy(
             api_version=api_version or self._astra_db.api_version,
         )
 
+    def with_options(
+        self,
+        *,
+        namespace: Optional[str] = None,
+        caller_name: Optional[str] = None,
+        caller_version: Optional[str] = None,
+    ) -> AsyncDatabase:
+        return self.copy(
+            namespace=namespace,
+            caller_name=caller_name,
+            caller_version=caller_version,
+        )
+
     def to_sync(
         self,
         *,

tests/idiomatic/unit/test_collections_async.py

@@ -50,6 +50,7 @@ async def test_convert_collection_async(
             caller_version="c_v",
         )
         assert col1 == col1.copy()
+        assert col1 == col1.with_options()
         assert col1 == col1.to_sync().to_async()
 
     @pytest.mark.describe("test of Collection rich copy, async")
@@ -89,6 +90,20 @@ async def test_rich_copy_collection_async(
         )
         assert col3 == col1
 
+        assert col1.with_options(name="x") != col1
+        assert (
+            col1.with_options(name="x").with_options(name="id_test_collection") == col1
+        )
+        assert col1.with_options(caller_name="x") != col1
+        assert (
+            col1.with_options(caller_name="x").with_options(caller_name="c_n") == col1
+        )
+        assert col1.with_options(caller_version="x") != col1
+        assert (
+            col1.with_options(caller_version="x").with_options(caller_version="c_v")
+            == col1
+        )
+
     @pytest.mark.describe("test of Collection rich conversions, async")
     async def test_rich_convert_collection_async(
         self,

tests/idiomatic/unit/test_collections_sync.py

@@ -50,6 +50,7 @@ def test_convert_collection_sync(
             caller_version="c_v",
         )
         assert col1 == col1.copy()
+        assert col1 == col1.with_options()
         assert col1 == col1.to_async().to_sync()
 
     @pytest.mark.describe("test of Collection rich copy, sync")
@@ -89,6 +90,20 @@ def test_rich_copy_collection_sync(
         )
         assert col3 == col1
 
+        assert col1.with_options(name="x") != col1
+        assert (
+            col1.with_options(name="x").with_options(name="id_test_collection") == col1
+        )
+        assert col1.with_options(caller_name="x") != col1
+        assert (
+            col1.with_options(caller_name="x").with_options(caller_name="c_n") == col1
+        )
+        assert col1.with_options(caller_version="x") != col1
+        assert (
+            col1.with_options(caller_version="x").with_options(caller_version="c_v")
+            == col1
+        )
+
     @pytest.mark.describe("test of Collection rich conversions, sync")
     def test_rich_convert_collection_sync(
         self,

tests/idiomatic/unit/test_databases_async.py

@@ -52,6 +52,7 @@ async def test_convert_database_async(
             **astra_db_credentials_kwargs,
         )
         assert db1 == db1.copy()
+        assert db1 == db1.with_options()
         assert db1 == db1.to_sync().to_async()
 
     @pytest.mark.describe("test of Database rich copy, async")
@@ -99,6 +100,18 @@ async def test_rich_copy_database_async(
         )
         assert db3 == db1
 
+        assert db1.with_options(namespace="x") != db1
+        assert (
+            db1.with_options(namespace="x").with_options(namespace="namespace") == db1
+        )
+        assert db1.with_options(caller_name="x") != db1
+        assert db1.with_options(caller_name="x").with_options(caller_name="c_n") == db1
+        assert db1.with_options(caller_version="x") != db1
+        assert (
+            db1.with_options(caller_version="x").with_options(caller_version="c_v")
+            == db1
+        )
+
     @pytest.mark.describe("test of Database rich conversions, async")
     async def test_rich_convert_database_async(
         self,

tests/idiomatic/unit/test_databases_sync.py

@@ -52,6 +52,7 @@ def test_convert_database_sync(
             **astra_db_credentials_kwargs,
         )
         assert db1 == db1.copy()
+        assert db1 == db1.with_options()
         assert db1 == db1.to_async().to_sync()
 
     @pytest.mark.describe("test of Database rich copy, sync")
@@ -99,6 +100,18 @@ def test_rich_copy_database_sync(
         )
         assert db3 == db1
 
+        assert db1.with_options(namespace="x") != db1
+        assert (
+            db1.with_options(namespace="x").with_options(namespace="namespace") == db1
+        )
+        assert db1.with_options(caller_name="x") != db1
+        assert db1.with_options(caller_name="x").with_options(caller_name="c_n") == db1
+        assert db1.with_options(caller_version="x") != db1
+        assert (
+            db1.with_options(caller_version="x").with_options(caller_version="c_v")
+            == db1
+        )
+
     @pytest.mark.describe("test of Database rich conversions, sync")
     def test_rich_convert_database_sync(
         self,