bifrostsdk 1.0.0__py3-none-any.whl

bifrostsdk-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Ifihanagbara Olusheye
+
+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.

bifrostsdk-1.0.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.1
+Name: bifrostsdk
+Version: 1.0.0
+Summary: Rainbow Bridge for shipping your files to any cloud storage service with the same function calls
+Author-email: ifihan <victoriaolusheye@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Ifihan/byfrost
+Project-URL: Bug Tracker, https://github.com/Ifihan/byfrost/issues
+Project-URL: Documentation, https://github.com/Ifihan/byfrost/blob/main/README.md
+Project-URL: Source Code, https://github.com/Ifihan/byfrost
+Keywords: cloud,storage,gcs,s3,pinata,upload,aws,google-cloud,bifrost
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-cloud-storage>=2.5.0
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: requests-toolbelt>=1.0.0
+
+# Bifrost
+
+Rainbow Bridge for shipping your files to any cloud storage service with the same function calls.
+
+<img src="https://user-images.githubusercontent.com/59074379/226159115-1cfcb221-127f-4574-87ed-b74b4b2c4591.png" width="1000" />
+
+# Table of contents
+
+- [Bifrost](#bifrost)
+- [Problem Statement](#problem-statement)
+  - [Google Cloud Storage using GCS SDK](#google-cloud-storage-using-gcs-sdk)
+  - [Pinata Cloud using Pinata API](#pinata-cloud-using-pinata-api)
+  - [Using Bifrost](#using-bifrost)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Contributing](#contributing)
+- [License](#license)
+- [Changelog](#changelog)
+- [Contributors](#contributors)
+
+# Problem Statement
+
+Many projects need to store files in the cloud and different projects might use different cloud storage providers or, sometimes, multiple cloud providers all at once. Using different SDKs with different implementations for each provider can be tedious and time-consuming. Bifrost aims to simplify the process of working with multiple cloud storage providers by providing a consistent API for all of them.
+
+To gain a better understanding of how Bifrost addresses this issue, let's take you on a ride with Thor by comparing two different code samples for working with Google Cloud Storage and Pinata Cloud in a single project: one using a conventional approach and the other using Bifrost.
+
+## Google Cloud Storage using GCS SDK
+
+Without Bifrost, the process of uploading a file to GCS using the Google Cloud Storage client library for Python would typically involve the following steps:
+
+```py
+# to be added
+```
+
+## Pinata Cloud using Pinata API
+
+...and for Pinata Cloud, the usual way of uploading a file in Python would be something along the following steps:
+
+```py
+# to be added
+```
+
+We can already see the challenges of the conventional methods since they require you to learn to use multiple packages with separate implementation patterns. Now this is why `Bifrost` comes in! With Bifrost, you can mount rainbow bridges to the providers you want and use the same set of functions to upload files through any of these mounted bridges. This makes it much easier to work with multiple providers and streamlines the development process to just one learning curve.
+
+Now, let's see how we can revamp the two samples above into something much more exciting with Bifrost.
+
+## Using Bifrost
+
+```py
+# to be added
+```
+
+The above example clearly demonstrates the speed, simplicity, and ease of use that Bifrost offers. Now you know what it feels like to ride with Thor!
+
+# Installation
+
+```bash
+pip install byfrost
+```
+
+# Usage
+
+If you want to learn more about how Bifrost is creating different methods to make it easier to use different cloud providers, you can follow these links:
+
+- [Google Cloud Storage (GCS)](gcs\doc.md)
+- [Amazon S3](s3\doc.md)
+- [Pinata Cloud](pinata\doc.md)
+
+# Variants
+
+Bifrost also exists in other forms and languages and you are free to start a new variant of bifrost in any other form or language of your choice. For now, below are the know variants of bifrost.
+
+- [x] [Bifrost in Golang](https://github.com/opensaucerer/bifrost)
+- [x] [Bifrost CLI](https://github.com/showbaba/bifrost-cli)
+
+# Contributing
+
+Bifrost is an open source project and we welcome contributions of all kinds. Please read our [contributing guide](./contributing.md) to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes to Bifrost.
+
+# License
+
+Bifrost is [MIT licensed](./LICENSE).
+
+# Changelog
+
+See [changelog](./changelog.md) for more details.
+
+# Contributors
+
+<a href="https://github.com/ifihan/byfrost/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ifihan/byfrost" />
+</a>
+
+Made with [contrib.rocks](https://contrib.rocks).

bifrostsdk-1.0.0.dist-info/RECORD

@@ -0,0 +1,48 @@
+byfrost/__init__.py,sha256=1pr8h2B0pg5L4WpUR4rLdKySURqd8C9jJOOBNpni2bk,1007
+byfrost/__init__.pyi,sha256=DT5W9Btl9rLCx1I1FJTFlxnKiePg7tEXMzDCOJRjD7s,1734
+byfrost/bifrost.py,sha256=VlL9cKEyTbisP0HsSmeJDYRA0QlnpXp_eYFlWhRj0to,5550
+byfrost/bifrost.pyi,sha256=69Bn2JPFpvbJy3vN3NnyN5DdOyoaEqwxOijp_nOrkfk,1145
+byfrost/gcs/__init__.py,sha256=BqwDK2qFtsuETTA7brYvKsrwzn61F7SbRxLCLgcM8gI,61
+byfrost/gcs/__init__.pyi,sha256=30FbMGSTtfO7j8numKz6Y-w9U2Rul_aYt_2MOzhS5t4,62
+byfrost/gcs/gcs.py,sha256=jEcugvz-_R1ZfxJcVDCC_OIQhxK_Vra-6N8NZxQYqh8,7070
+byfrost/gcs/gcs.pyi,sha256=_YmIxcQp8p8iEygdNSuO0amBwbKLGxb2nN3OG84HWYk,2427
+byfrost/pinata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+byfrost/pinata/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+byfrost/pinata/pinata.py,sha256=qB1qAwV15AuA_BPAETdKJ9glTDFoaN7DddWWxZlAUm8,8567
+byfrost/pinata/pinata.pyi,sha256=QrUdAfGcC1P-S7CIMWqo7dhgBIvaImbXElEfTLYN5Xw,2053
+byfrost/s3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+byfrost/s3/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+byfrost/s3/s3.py,sha256=llSDKl5GjVF6zIf8vhjOe-Bld8Avz-rXhNSMM-Arozs,7506
+byfrost/s3/s3.pyi,sha256=jTLGi0xR49NEi1lDDAZhb45tByW90mnic_zH4oWYjVE,2393
+byfrost/shared/__init__.py,sha256=qQKiq7IZkXJb0cxtDEbr9yE3vYEzeAUNwbCTPHnphRU,82
+byfrost/shared/config/__init__.py,sha256=JpD4txuKahBG3NdpybAuOOKlif_Ew8PYdkwnTCQWtsE,554
+byfrost/shared/config/__init__.pyi,sha256=JpD4txuKahBG3NdpybAuOOKlif_Ew8PYdkwnTCQWtsE,554
+byfrost/shared/config/option.py,sha256=i0M1iBnSLghbb6xvQjj9n3pd-FX7ftpxkSHK2H-d0Nc,583
+byfrost/shared/config/provider.py,sha256=cs3uFslpy3mZxy105AUx3hlets4FQhivZULrHB9TDeA,561
+byfrost/shared/config/request.py,sha256=ZbPRXbBMaeMTkOWFXa2LmceWBdJopATjjdqodGiB3BE,599
+byfrost/shared/config/url.py,sha256=o2ewH5U6mSWNXjApCRDt-DIQJj8eKPFMYtx-ZFpYzPI,1055
+byfrost/shared/errors/__init__.py,sha256=NvptpP9r4UceLt3IREmmRrhuIwN2SM26HCmi1IDpZ6o,397
+byfrost/shared/errors/__init__.pyi,sha256=NvptpP9r4UceLt3IREmmRrhuIwN2SM26HCmi1IDpZ6o,397
+byfrost/shared/errors/color.py,sha256=ayOmZ9fN_LDHQ3sMCpzxWASdCq-e0v9-7KCtCtbImmU,266
+byfrost/shared/errors/constant.py,sha256=pKWdffk3Q4PiBYie3KJ1_7BU0E7uZYPgH-PNMN66AfA,1103
+byfrost/shared/errors/interface.py,sha256=yx9dGWvZw9moWENXFxzlvO85fFMHrVNtaLEMY_hiNa0,499
+byfrost/shared/errors/interface.pyi,sha256=qrxY4uwTGvdYVBSWZtEf6YNalF6Y8MIH2vJq9gvKxr0,533
+byfrost/shared/errors/loga.py,sha256=BJ1UQIJhfrRzgDigW8PNWaKUFO3mS6Kjf-YpSAwPRJY,636
+byfrost/shared/errors/loga.pyi,sha256=cJhOaBUS1qDcjtj3QFu87wR1P_YY3KplAdyllJZlUuk,509
+byfrost/shared/request/__init__.py,sha256=shiW_0dDtAqrYG1DPDUorcpw72bCdw-LuF8CmU1Omp8,40
+byfrost/shared/request/__init__.pyi,sha256=shiW_0dDtAqrYG1DPDUorcpw72bCdw-LuF8CmU1Omp8,40
+byfrost/shared/request/builder.py,sha256=QRB46ZCEsHhw8a3oSN-zON2WBH3TOXiVLlG-sF0cG9Q,1607
+byfrost/shared/types/__init__.py,sha256=9YNyE-o_Qrl7h2Ep-Oe3da3EEvxrZW6KfznRw85o6s8,57
+byfrost/shared/types/dataclass/__init__.py,sha256=yRwLB510YdjHbuSy05d5rvi_ymCWQMDHPi-XBwDUts8,157
+byfrost/shared/types/dataclass/__init__.pyi,sha256=yRwLB510YdjHbuSy05d5rvi_ymCWQMDHPi-XBwDUts8,157
+byfrost/shared/types/dataclass/bridge.py,sha256=7mbaBxk0peA-pmbFVceQXDFkf3N1CwdZXWtKtwKQ5mw,5946
+byfrost/shared/types/dataclass/file.py,sha256=j8sS0ylmjNeAtxUgLqLMM4JKEgoSan1QXpaNrcL9KJo,6940
+byfrost/shared/types/typeddict/__init__.py,sha256=hwqGw9bWkCg0rTvh6Grv8aKsXs0-Eg_p73YjDCgtoK8,207
+byfrost/shared/types/typeddict/__init__.pyi,sha256=hwqGw9bWkCg0rTvh6Grv8aKsXs0-Eg_p73YjDCgtoK8,207
+byfrost/shared/types/typeddict/bridge.py,sha256=_8knfRJ1Ga7dia6JX1pTmFf3Tcdpsoql9_olY_mHDvE,3048
+byfrost/shared/types/typeddict/file.py,sha256=_3Cq8lsXFmLGFyevtU0D-Ivn_J-mOIQAiEUELFyi9sM,6408
+bifrostsdk-1.0.0.dist-info/LICENSE,sha256=gukzCu68-M_u6bkG_omJ_C1OkcMiHRwmSJcmvc_QTNQ,1078
+bifrostsdk-1.0.0.dist-info/METADATA,sha256=o4WDm_frxqtTkDG8rPZBNm-wzBet57FuwQDwALCFjAw,5137
+bifrostsdk-1.0.0.dist-info/WHEEL,sha256=pL8R0wFFS65tNSRnaOVrsw9EOkOqxLrlUPenUYnJKNo,91
+bifrostsdk-1.0.0.dist-info/top_level.txt,sha256=iTb_8hhhNCRAjPZzTK2M33AUEoJWwGJY-p1NffHcFk4,8
+bifrostsdk-1.0.0.dist-info/RECORD,,

bifrostsdk-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (74.1.3)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bifrostsdk-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+byfrost

byfrost/__init__.py

@@ -0,0 +1,46 @@
+#!usr/bin/env python3
+
+from .shared.types.dataclass.bridge import BridgeConfig, RainbowBridge
+from .shared.types.dataclass.file import File, MultiFile, Options
+
+from .shared.types.typeddict.bridge import BridgeConfigDict
+from .shared.types.typeddict.file import (
+    OptionsDict,
+    FileDict,
+    MultiFileDict,
+    ParamFileDict,
+    ParamDataDict,
+    ParamDict,
+    UploadedFileDict,
+)
+
+from .shared.errors.constant import (
+    ErrBadRequest,
+    ErrClientError,
+    ErrIncompleteMultiFileUpload,
+    ErrInvalidBucket,
+    ErrInvalidConfig,
+    ErrInvalidCredentials,
+    ErrInvalidProvider,
+    ErrUnauthorized,
+    ErrFileOperationFailed,
+)
+from .shared.errors.interface import BifrostError
+from .shared.config.provider import (
+    GoogleCloudStorage,
+    PinataCloud,
+    SimpleStorageService,
+)
+
+from .shared.config.option import (
+    OptACL,
+    ACLPublicRead,
+    ACLPrivate,
+    OptContentType,
+    OptMetadata,
+    OptPinata,
+)
+
+from .bifrost import new_rainbow_bridge
+
+__name__ = "byfrost"

byfrost/__init__.pyi

@@ -0,0 +1,81 @@
+#!usr/bin/env python3
+
+from .shared.types.dataclass.bridge import BridgeConfig, RainbowBridge
+from .shared.types.dataclass.file import File, MultiFile, Options
+
+from .shared.types.typeddict.bridge import BridgeConfigDict
+from .shared.types.typeddict.file import (
+    OptionsDict,
+    FileDict,
+    MultiFileDict,
+    ParamFileDict,
+    ParamDataDict,
+    ParamDict,
+    UploadedFileDict,
+)
+
+from .shared.errors.constant import (
+    ErrBadRequest,
+    ErrClientError,
+    ErrIncompleteMultiFileUpload,
+    ErrInvalidBucket,
+    ErrInvalidConfig,
+    ErrInvalidCredentials,
+    ErrInvalidProvider,
+    ErrUnauthorized,
+    ErrFileOperationFailed,
+)
+from .shared.errors.interface import BifrostError
+from .shared.config.provider import (
+    GoogleCloudStorage,
+    PinataCloud,
+    SimpleStorageService,
+)
+
+from .shared.config.option import (
+    OptACL,
+    ACLPublicRead,
+    ACLPrivate,
+    OptContentType,
+    OptMetadata,
+    OptPinata,
+)
+
+from .bifrost import new_rainbow_bridge
+
+__name__ = "byfrost"
+__all__ = [
+    "BridgeConfig",
+    "RainbowBridge",
+    "File",
+    "Options",
+    "MultiFile",
+    "BridgeConfigDict",
+    "OptionsDict",
+    "FileDict",
+    "MultiFileDict",
+    "ParamFileDict",
+    "ParamDataDict",
+    "ParamDict",
+    "UploadedFileDict",
+    "ErrBadRequest",
+    "ErrClientError",
+    "ErrIncompleteMultiFileUpload",
+    "ErrInvalidBucket",
+    "ErrInvalidConfig",
+    "ErrInvalidCredentials",
+    "ErrInvalidProvider",
+    "ErrUnauthorized",
+    "ErrFileOperationFailed",
+    "BifrostError",
+    "GoogleCloudStorage",
+    "PinataCloud",
+    "SimpleStorageService",
+    "new_rainbow_bridge",
+    "OptACL",
+    "ACLPublicRead",
+    "ACLPrivate",
+    "OptContentType",
+    "OptMetadata",
+    "OptPinata",
+]

byfrost/bifrost.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+
+# from byfrost.gcs.gcs import GoogleCloudStorage
+from .gcs.gcs import GoogleCloudStorage
+from .s3.s3 import SimpleStorageService
+from .shared.types.dataclass import bridge
+from .shared.errors.interface import BifrostError
+from typing import Tuple, Union
+from .shared.errors import constant as errors
+from .shared.config import provider, url
+from .shared.errors import loga
+from google.cloud import storage
+import requests
+from .pinata.pinata import PinataCloud
+from .shared.request import builder
+import boto3
+
+
+def new_rainbow_bridge(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """Returns a new Rainbow Bridge for shipping files to your specified cloud storage service and an error if one occurs."""
+    if bc is None:
+        return None, BifrostError("config is none", errors.ErrInvalidConfig)
+
+    # verify that the config is derived from BridgeConfig
+    if not isinstance(bc, bridge.BridgeConfig):
+        return None, BifrostError(
+            "invalid config type: {}".format(type(bc)), errors.ErrInvalidConfig
+        )
+
+    # verify that the config dataclass has a valid provider
+    if bc.provider is None or bc.provider == "":
+        return None, BifrostError("no provider specified", errors.ErrInvalidProvider)
+
+    # verify that the provider is valid
+    if bc.provider not in provider.providers:
+        return None, BifrostError(
+            "invalid provider: {}".format(bc.provider), errors.ErrInvalidProvider
+        )
+
+        # verify that the config dataclass has a valid bucket
+    if bc.default_bucket is None or bc.default_bucket == "":
+        # some providers might not require a bucket
+        # just log a warning
+        if bc.enable_debug is True:
+            loga.warn(
+                "WARN: No bucket specified for provider: {}. This might cause errors or require you to specify a bucket for each operation.".format(
+                    bc.provider
+                )
+            )
+
+    # create a new bridge based on the provider
+    if bc.provider == provider.GoogleCloudStorage:
+        return new_google_cloud_storage(bc)
+
+    if bc.provider == provider.PinataCloud:
+        return new_pinata_cloud_storage(bc)
+
+    if bc.provider == provider.SimpleStorageService:
+        return new_simple_storage_service(bc)
+
+    return None, BifrostError(
+        "invalid provider: {}".format(bc.provider), errors.ErrInvalidProvider
+    )
+
+
+def new_google_cloud_storage(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """Returns a new client for Google Cloud Storage."""
+    client: storage.Client = None
+
+    # attempting to authenticate with credentials file
+    if bc.credentials_file is not None and bc.credentials_file != "":
+        try:
+            client = storage.Client.from_service_account_json(bc.credentials_file)
+        except Exception as e:
+            return None, BifrostError(str(e), errors.ErrUnauthorized)
+        return GoogleCloudStorage(bc, client), None
+    else:
+        # attempt to authenticate without credentials file
+        try:
+            client = storage.Client()
+        except Exception as e:
+            return None, BifrostError(str(e), errors.ErrUnauthorized)
+
+        # return a new Google Cloud Storage client (the bifrost version)
+        return GoogleCloudStorage(bc, client), None
+
+
+def new_pinata_cloud_storage(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """new_pinata_cloud_storage returns a new client for Pinata Cloud Storage"""
+    # TODO: add support for API key and API secret
+    client: builder.new_client = None
+
+    # attempting to authenticate with JWT token
+    if bc.pinata_jwt is not None and bc.pinata_jwt != "":
+        try:
+            client = builder.new_client(
+                url.URLPinataAuth, bc.pinata_jwt, bc.default_timeout
+            )
+            pc = PinataCloud(bc, client)
+            error = pc.preflight()
+            if error is not None:
+                return None, error
+        except Exception as e:
+            return None, BifrostError(str(e), errors.ErrUnauthorized)
+        return pc, None
+    return None, BifrostError("pinata JWT is required", errors.ErrUnauthorized)
+
+    # return a new Pinata Cloud client (the bifrost version)
+    return PinataCloud(bc, client), None
+
+
+def new_simple_storage_service(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """new_simple_storage_service returns a new client for Simple Storage Service."""
+    client: boto3.session.resource("s3")
+
+    # attempting to authenticate with access and secret key
+    if (
+        bc.access_key is not None
+        and bc.access_key != ""
+        and bc.secret_key is not None
+        and bc.secret_key != ""
+        and bc.region is not None
+        and bc.region != ""
+    ):
+        try:
+            session = boto3.session.Session(access_key, secret_key, region_name)
+            client = session.resource("s3")
+        except Exception as e:
+            return None, BifrostError(str(e), errors.ErrUnauthorized)
+        return SimpleStorageService(bc, client), None
+    else:
+        # attempt to authenticate without access key and secret key
+        try:
+            session = boto3.session.Session()
+            client = session.resource("s3")
+        except Exception as e:
+            return None, BifrostError(str(e), errors.ErrUnauthorized)
+
+        # return a new Amazon Simple Storage Service client (the bifrost version)
+        return SimpleStorageService(bc, client), None

byfrost/bifrost.pyi

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+
+"""
+Byfrost provides a rainbow bridge for shipping files to any cloud storage service.
+
+It's like bifrost from marvel comics, but for files.
+"""
+
+from .shared.types.dataclass import bridge
+from typing import Tuple
+from .shared.errors.interface import BifrostError
+
+def new_rainbow_bridge(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """
+    new_rainbow_bridge returns a new Rainbow Bridge for shipping files to your specified cloud storage service and an error if one occurs.
+    """
+    ...
+
+def new_google_cloud_storage(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """new_google_cloud_storage returns a new client for Google Cloud Storage."""
+    ...
+
+def new_pinata_cloud_storage(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """new_pinata_cloud_storage returns a new client for Pinata Cloud Storage."""
+
+def new_simple_storage_service(
+    bc: bridge.BridgeConfig,
+) -> Tuple[bridge.RainbowBridge, BifrostError]:
+    """new_simple_storage_service returns a new client for Simple Storage Service."""
+    ...

byfrost/gcs/__init__.py

@@ -0,0 +1,3 @@
+#!usr/bin/env python3
+
+# from .gcs import GoogleCloudStorage

byfrost/gcs/__init__.pyi

@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+
+# from .gcs import GoogleCloudStorage