Metadata-Version: 2.1
Name: upsonic
Version: 0.11.3
Summary: Magic Cloud Layer
Home-page: https://github.com/Upsonic/Upsonic
Author: Upsonic
Author-email: onur.atakan.ulusoy@upsonic.co
License: MIT
Description: # Upsonic | [![Tests](https://github.com/Upsonic/Upsonic/actions/workflows/tests.yml/badge.svg)](https://github.com/Upsonic/Upsonic/actions/workflows/tests.yml) | [![codecov](https://codecov.io/gh/Upsonic/Upsonic/branch/master/graph/badge.svg?token=0VC6JJNX9Z)](https://codecov.io/gh/Upsonic/Upsonic) | [![After Deploy Test Every 15 Minute](https://github.com/Upsonic/Upsonic/actions/workflows/after_deploy_test.yml/badge.svg)](https://github.com/Upsonic/Upsonic/actions/workflows/after_deploy_test.yml)
        
        The Upsonic is a Flexible, secure and scalable database and your python cloud that supports multiple data formats. It comes with built-in features for compressing and encrypting data, and is compatible with all operating systems. With easy-to-use commands, the Upsonic is an excellent choice for developers seeking an efficient and reliable storage solution for their data.
        
        [Website](https://upsonic.co/) | [Discord](https://discord.gg/) | [Twitter](https://twitter.com/upsonicco)
        
        
        
        
        ## Installation
        You can install Upsonic by pip3:
        
        ```console
        pip3 install upsonic
        ```
        
        
        
        ## 🎉 Upsonic Cloud is published ! | [![Cloud Test Every - 15 Minute](https://github.com/Upsonic/Upsonic/actions/workflows/cloud_test.yml/badge.svg)](https://github.com/Upsonic/Upsonic/actions/workflows/cloud_test.yml) | [Go to Docs](https://Upsonic.github.io/Upsonic/upsonic_cloud.html)
        Upsonic Cloud: the ultimate, free cloud database for all Python developers. Experience reliability, efficiency, and top-notch security in one powerful solution. Start your seamless development journey with Upsonic Cloud today!
        
        - "Save your Python Things to the Cloud: Code Unrestricted, Scale Limitless with Upsonic Cloud!"
        
        ![Upsonic Cloud](https://github.com/Upsonic/Upsonic/assets/41792982/a45e58cf-3403-4cd5-a9b5-dc9b84e4746c)
        
        
        
        ### Creating Your Free Cloud Key
        ```console
        Upsonic cloud_key
        ```
        
        ### Using Your Cloud | Setting
        
        ```python
        from upsonic import Upsonic_Cloud
        cloud = Upsonic_Cloud("YOUR_CLOUD_KEY")
        
        @cloud.active
        def get_address():
            return "Hello World I am from Upsonic Cloud"
        ```
        
        ### Using Your Cloud | Getting
        
        ```python
        from upsonic import Upsonic_Cloud
        cloud = Upsonic_Cloud("YOUR_CLOUD_KEY")
        
        
        print(cloud.get("get_address")())
        ```
        
        ## Demo
        
        ```python
        from upsonic import Upsonic
        
        # Creating databases
        db = Upsonic("My_New_DB")
        
        
        # Flexible
        db.set("Key", "String")
        db.set("Key", 123)
        db.set("Key", 123.213)
        db.set("Key", Object())
        db.set("Key", ["Alist"])
        db.set("Key", {"a": "dict"})
        db.set("Key", (1,"Atuple"))
        db.set("Key", file="onur.jpg")
        db.set("Key", file="onur.anytype")
        
        
        # Secure
        db.set("Key", "String",        encryption_key="my_encryption_key")
        db.set("Key", 123,             encryption_key="my_encryption_key")
        db.set("Key", 123.213,         encryption_key="my_encryption_key")
        db.set("Key", Object(),        encryption_key="my_encryption_key")
        db.set("Key", ["Alist"],       encryption_key="my_encryption_key")
        db.set("Key", {"a": "dict"},   encryption_key="my_encryption_key")
        db.set("Key", (1,"Atuple"),    encryption_key="my_encryption_key")
        db.set("Key", file="onur.jpg", encryption_key="my_encryption_key")
        
        
        
        # Scalable
        db.get("Key") #Instant, no waiting and no searching
        
        
        ```
        
        ## Features
        
        - **Flexibility**: Save data in any format, including objects and files, providing great flexibility and adaptability to different use cases and data structures.
        - **Compressing**: Compress data to minimize storage space while enabling faster data retrieval and processing.
        - **Encryption**: Keep sensitive information secure and private with the included encryption feature.
        - **Scalability**: Offers stable processing times of set, get, and delete commands, regardless of the dataset's size.
        - **Fault Tolerance**: By the design of the Upsonic, it is fully fault-tolerant because each datas are designed to be independent of each other on the disk.
        - **Memory Friendly**: The Upsonic is designed to use as little memory as possible. It only loads the data you want to access into memory.
        - **Cross-Platform Compatibility**: Compatible with all operating systems, making it easier to integrate into any project.
        - **Transactional and Asynchronous Operations**: Perform multiple operations in a single transaction or perform operations asynchronously for improved performance.
        
        
        ```mermaid
        graph TD;
            A[Upsonic];
        
            A --> P[CLI];
            O --> N[Interfaces];
            P --> N[Interfaces];
            Q --> N[Interfaces];
            R --> N[Interfaces];
        
            N --> J[Functions];
        
        
            J --> B[Features];
            B --> C[Multi-threaded Writing];
            B --> D[Compression];
            B --> E[Encryption];
            B --> F[Scalability];
            B --> G[Fault Tolerance];
            B --> H[Memory Friendly];
            B --> I[Cross-Platform Compatibility];
        
        
        ```
        
        ## Documentation
        You can find the documentation [here](https://Upsonic.github.io/Upsonic/).
        
        
        ## Contributing
        Contributions to Upsonic are welcome! If you have any suggestions or find a bug, please open an issue on the GitHub repository. If you want to contribute code, please fork the repository and create a pull request.
        
        ## License
        Upsonic is released under the MIT License.
        
        <h2 align="center">
            Contributors
        </h2>
        <p align="center">
            Thank you for your contribution!
        </p>
        <p align="center">
            <a href="https://github.com/Upsonic/Upsonic/graphs/contributors">
              <img src="https://contrib.rocks/image?repo=Upsonic/Upsonic" />
            </a>
        </p>
        <p align="center">
            and <a href="https://sweep.dev/">Sweep !</a>
        </p>
        
Platform: UNKNOWN
Requires-Python: >= 3
Description-Content-Type: text/markdown
