cloudtoolbox 0.1.0__tar.gz

cloudtoolbox-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Noverde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloudtoolbox-0.1.0/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.1
+Name: cloudtoolbox
+Version: 0.1.0
+Summary: Toolbox for the cloud.
+Author-email: Dotz Developers <devs-dotz@dotz.com>
+Keywords: cloud,tools,utilities,google,gcp,amazon,aws
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: amazon
+Requires-Dist: boto3; extra == "amazon"
+Provides-Extra: google
+Requires-Dist: google-cloud-pubsub; extra == "google"
+Requires-Dist: google-cloud-storage; extra == "google"
+
+# Cloud Toolbox
+
+Decouple your applications from cloud providers with carefully crafted service interfaces.

cloudtoolbox-0.1.0/README.md

@@ -0,0 +1,3 @@
+# Cloud Toolbox
+
+Decouple your applications from cloud providers with carefully crafted service interfaces.

cloudtoolbox-0.1.0/cloud/amazon/s3.py

@@ -0,0 +1,11 @@
+from typing import Any
+
+import boto3
+
+
+class Uploader:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self.client = boto3.client("s3", *args, **kwargs)
+
+    def upload(self, bucket_name: str, destination_filename: str, source_filename: str) -> None:
+        self.client.upload_file(source_filename, bucket_name, destination_filename)

cloudtoolbox-0.1.0/cloud/factory.py

@@ -0,0 +1,29 @@
+from typing import Any, Callable, Type
+
+from cloud.protocols import MessagePublisher, StorageUploader
+
+error_message = "%(class)s does not implement %(protocol)s protocol"
+
+
+def storage_uploader(
+    uploader_class: Type[StorageUploader], *args: Any, **kwargs: Any
+) -> Callable[[], StorageUploader]:
+    error = error_message % {"class": uploader_class.__name__, "protocol": "StorageUploader"}
+    assert issubclass(uploader_class, StorageUploader), error
+
+    def maker() -> StorageUploader:
+        return uploader_class(*args, **kwargs)
+
+    return maker
+
+
+def message_publisher(
+    publisher_class: Type[MessagePublisher], *args: Any, **kwargs: Any
+) -> Callable[[], MessagePublisher]:
+    error = error_message % {"class": publisher_class.__name__, "protocol": "MessagePublisher"}
+    assert issubclass(publisher_class, MessagePublisher), error
+
+    def maker() -> MessagePublisher:
+        return publisher_class(*args, **kwargs)
+
+    return maker

cloudtoolbox-0.1.0/cloud/google/pubsub.py

@@ -0,0 +1,12 @@
+from typing import Any
+
+from google.cloud import pubsub_v1
+
+
+class Publisher:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self.client = pubsub_v1.PublisherClient(*args, **kwargs)
+
+    def publish(self, recipient: str, message: str, **attrs: Any) -> None:
+        future = self.client.publish(recipient, data=message.encode(), **attrs)
+        future.result()

cloudtoolbox-0.1.0/cloud/google/storage.py

@@ -0,0 +1,13 @@
+from typing import Any
+
+from google.cloud import storage
+
+
+class Uploader:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self.client = storage.Client(*args, **kwargs)
+
+    def upload(self, bucket_name: str, destination_filename: str, source_filename: str) -> None:
+        bucket = self.client.bucket(bucket_name)
+        blob = bucket.blob(destination_filename)
+        blob.upload_from_filename(source_filename)

cloudtoolbox-0.1.0/cloud/protocols.py

@@ -0,0 +1,11 @@
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class StorageUploader(Protocol):
+    def upload(self, bucket_name: str, destination_filename: str, source_filename: str) -> None: ...
+
+
+@runtime_checkable
+class MessagePublisher(Protocol):
+    def publish(self, recipient: str, message: str, **attrs: Any) -> None: ...

cloudtoolbox-0.1.0/cloudtoolbox.egg-info/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.1
+Name: cloudtoolbox
+Version: 0.1.0
+Summary: Toolbox for the cloud.
+Author-email: Dotz Developers <devs-dotz@dotz.com>
+Keywords: cloud,tools,utilities,google,gcp,amazon,aws
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: amazon
+Requires-Dist: boto3; extra == "amazon"
+Provides-Extra: google
+Requires-Dist: google-cloud-pubsub; extra == "google"
+Requires-Dist: google-cloud-storage; extra == "google"
+
+# Cloud Toolbox
+
+Decouple your applications from cloud providers with carefully crafted service interfaces.

cloudtoolbox-0.1.0/cloudtoolbox.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+cloud/__init__.py
+cloud/factory.py
+cloud/protocols.py
+cloud/amazon/__init__.py
+cloud/amazon/s3.py
+cloud/google/__init__.py
+cloud/google/pubsub.py
+cloud/google/storage.py
+cloudtoolbox.egg-info/PKG-INFO
+cloudtoolbox.egg-info/SOURCES.txt
+cloudtoolbox.egg-info/dependency_links.txt
+cloudtoolbox.egg-info/requires.txt
+cloudtoolbox.egg-info/top_level.txt
+tests/test_factory.py

cloudtoolbox-0.1.0/cloudtoolbox.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cloudtoolbox-0.1.0/cloudtoolbox.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[amazon]
+boto3
+
+[google]
+google-cloud-pubsub
+google-cloud-storage

cloudtoolbox-0.1.0/cloudtoolbox.egg-info/top_level.txt

@@ -0,0 +1 @@
+cloud

cloudtoolbox-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cloudtoolbox"
+version = "0.1.0"
+description = "Toolbox for the cloud."
+readme = {file = "README.md", content-type = "text/markdown"}
+authors = [
+    {name = "Dotz Developers", email = "devs-dotz@dotz.com"},
+]
+keywords = ["cloud", "tools", "utilities", "google", "gcp", "amazon", "aws"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.optional-dependencies]
+amazon = ["boto3"]
+google = ["google-cloud-pubsub", "google-cloud-storage"]
+
+[tool.ruff]
+exclude = [
+    ".git",
+    ".venv",
+    ".ruff_cache",
+]
+
+line-length = 100
+indent-width = 4
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "C4", "UP","ARG001"]
+ignore = ["E402", "E501", "W191", "B904"]
+fixable = ["ALL"]
+unfixable = []
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

cloudtoolbox-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cloudtoolbox-0.1.0/tests/test_factory.py

@@ -0,0 +1,57 @@
+import unittest
+from unittest import mock
+
+from cloud import factory
+from cloud.amazon import s3
+from cloud.google import pubsub, storage
+from cloud.protocols import MessagePublisher, StorageUploader
+
+
+class NotStorageUploader:
+    def upload_file(self):
+        pass
+
+
+class NotMessagePublisher:
+    def send_message(self):
+        pass
+
+
+class TestStorageUploaderFactory(unittest.TestCase):
+    @mock.patch("google.cloud.storage.Client")
+    def test_google_uploader(self, _):
+        Uploader = factory.storage_uploader(storage.Uploader)
+        uploader = Uploader()
+
+        self.assertIsInstance(uploader, StorageUploader)
+        self.assertIsInstance(uploader, storage.Uploader)
+
+    @mock.patch("boto3.client")
+    def test_amazon_uploader(self, _):
+        Uploader = factory.storage_uploader(s3.Uploader)
+        uploader = Uploader()
+
+        self.assertIsInstance(uploader, StorageUploader)
+        self.assertIsInstance(uploader, s3.Uploader)
+
+    def test_uploader_protocol_validation(self):
+        error = "NotStorageUploader does not implement StorageUploader protocol"
+
+        with self.assertRaisesRegex(AssertionError, error):
+            factory.storage_uploader(NotStorageUploader)  # type: ignore
+
+
+class TestMessagePublisherFactory(unittest.TestCase):
+    @mock.patch("google.cloud.pubsub_v1.PublisherClient")
+    def test_google_publisher(self, _):
+        Publisher = factory.message_publisher(pubsub.Publisher)
+        publisher = Publisher()
+
+        self.assertIsInstance(publisher, MessagePublisher)
+        self.assertIsInstance(publisher, pubsub.Publisher)
+
+    def test_publisher_protocol_validation(self):
+        error = "NotMessagePublisher does not implement MessagePublisher protocol"
+
+        with self.assertRaisesRegex(AssertionError, error):
+            factory.message_publisher(NotMessagePublisher)  # type: ignore