multiminio

Name	multiminio JSON
Version	1.0.2 JSON
	download
home_page	https://github.com/asuiu/multiminio
Summary	MultiMinio: provides failover and health-checking for applications using multiple Minio object storage instances, ensuring uninterrupted access and resilience.
upload_time	2023-09-24 09:06:08
maintainer
docs_url	None
author	Andrei Suiu
requires_python	>=3.8,<4.0.0
license	MIT
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

# MultiMinio: High-Availability Minio/S3 Client Wrapper

# MultiMinio

MultiMinio is a Python library designed to provide a high-availability wrapper around multiple Minio client instances. By orchestrating the behavior of multiple
Minio clients, MultiMinio ensures resilience and failover, enhancing the reliability of your data storage operations.

This library acts as a wrapper around multiple Minio client instances, offering seamless failover and health-check capabilities.

If one Minio instance becomes unreachable or is detected as unhealthy, the MultiMinio automatically reroutes requests to the next available Minio client,
ensuring uninterrupted access to your object storage.

With its built-in health check mechanism, configurable timeouts, and logging features, MultiMinio ensures optimal performance and reliability for
mission-critical applications leveraging Minio's storage capabilities.

## Features

- **Multiple Minio Clients:** Manage and utilize multiple Minio client instances simultaneously.
- **Health Checks:** Automated health checks for the Minio instances to determine their availability.
- **Resilience Mechanisms:**
- **Fallback:** Currently, MultiMinio supports the Fallback resilience mechanism, ensuring requests are directed to healthy Minio instances when others are
unavailable. This assumes that Minio instances are synchronized in an Eventually Consistent manner.
- **Future Implementations:** In upcoming versions, MultiMinio will introduce RoundRobin and Random load balancing techniques, adding more flexibility and
options for directing traffic among Minio instances.
- **Customizable Settings:** Configure health check intervals, timeouts, and other parameters to suit your needs.

## Installation

Install MultiMinio directly from PyPi using `pip` (https://pypi.org/project/multiminio/):

```bash
pip install multiminio
```

## Usage

Here's a basic example of how to use MultiMinio with two Minio client instances:

```python
from multiminio import MultiMinio
from minio import Minio

# Create two Minio client instances
client1 = Minio("localhost:9001")
client2 = Minio("localhost:9002")

# Bundle the Minio clients into a MultiMinio instance
minio_client = MultiMinio(clients=[client1, client2])
```

### Configuration

#### Initialization Parameters

- `clients`: List of initialized Minio client instances.
- `fallback_timeout`: Maximum time to wait for a healthy client to become available. Default is 60.0 seconds.
- `health_check_timeout`: Duration to wait for the health check request to complete. Default is 5.0 seconds.
- `health_check_heartbeat`: Interval between health checks. Default is 300.0 seconds.
- `max_try_timeout`: Maximum time to wait for a single request to complete. Default is 60.0 seconds.
- `health_check_interva`l`: Minimum interval between consecutive health checks. Default is 10.0 seconds.

## Contribution

If you'd like to contribute to the development of MultiMinio, please fork the repository and submit a pull request.

- https://github.com/asuiu/multiminio

## License

MultiMinio is licensed under MIT license.

## Author

Andrei Suiu

- mail: [andrei.suiu@gmail.com](mailto:andrei.suiu@gmail.com)
- [LinkedIn](https://www.linkedin.com/in/andrei-suiu/)

## Support

For any queries or issues, please open an issue on the GitHub repository, and we'll address it promptly.

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/asuiu/multiminio",
    "name": "multiminio",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "Andrei Suiu",
    "author_email": "andrei.suiu@gmail.com",
    "download_url": "",
    "platform": null,
    "description": "# MultiMinio: High-Availability Minio/S3 Client Wrapper\n\n# MultiMinio\n\nMultiMinio is a Python library designed to provide a high-availability wrapper around multiple Minio client instances. By orchestrating the behavior of multiple\nMinio clients, MultiMinio ensures resilience and failover, enhancing the reliability of your data storage operations.\n\nThis library acts as a wrapper around multiple Minio client instances, offering seamless failover and health-check capabilities.\n\nIf one Minio instance becomes unreachable or is detected as unhealthy, the MultiMinio automatically reroutes requests to the next available Minio client,\nensuring uninterrupted access to your object storage.\n\nWith its built-in health check mechanism, configurable timeouts, and logging features, MultiMinio ensures optimal performance and reliability for\nmission-critical applications leveraging Minio's storage capabilities.\n\n## Features\n\n- **Multiple Minio Clients:** Manage and utilize multiple Minio client instances simultaneously.\n- **Health Checks:** Automated health checks for the Minio instances to determine their availability.\n- **Resilience Mechanisms:**\n- **Fallback:** Currently, MultiMinio supports the Fallback resilience mechanism, ensuring requests are directed to healthy Minio instances when others are\n  unavailable. This assumes that Minio instances are synchronized in an Eventually Consistent manner.\n- **Future Implementations:** In upcoming versions, MultiMinio will introduce RoundRobin and Random load balancing techniques, adding more flexibility and\n  options for directing traffic among Minio instances.\n- **Customizable Settings:** Configure health check intervals, timeouts, and other parameters to suit your needs.\n\n## Installation\n\nInstall MultiMinio directly from PyPi using `pip` (https://pypi.org/project/multiminio/):\n\n```bash\npip install multiminio\n```\n\n## Usage\n\nHere's a basic example of how to use MultiMinio with two Minio client instances:\n\n```python\nfrom multiminio import MultiMinio\nfrom minio import Minio\n\n# Create two Minio client instances\nclient1 = Minio(\"localhost:9001\")\nclient2 = Minio(\"localhost:9002\")\n\n# Bundle the Minio clients into a MultiMinio instance\nminio_client = MultiMinio(clients=[client1, client2])\n```\n\n### Configuration\n\n#### Initialization Parameters\n\n- `clients`: List of initialized Minio client instances.\n- `fallback_timeout`: Maximum time to wait for a healthy client to become available. Default is 60.0 seconds.\n- `health_check_timeout`: Duration to wait for the health check request to complete. Default is 5.0 seconds.\n- `health_check_heartbeat`: Interval between health checks. Default is 300.0 seconds.\n- `max_try_timeout`: Maximum time to wait for a single request to complete. Default is 60.0 seconds.\n- `health_check_interva`l`: Minimum interval between consecutive health checks. Default is 10.0 seconds.\n\n## Contribution\n\nIf you'd like to contribute to the development of MultiMinio, please fork the repository and submit a pull request.\n\n- https://github.com/asuiu/multiminio\n\n## License\n\nMultiMinio is licensed under MIT license.\n\n## Author\n\nAndrei Suiu\n\n- mail: [andrei.suiu@gmail.com](mailto:andrei.suiu@gmail.com)\n- [LinkedIn](https://www.linkedin.com/in/andrei-suiu/)\n\n## Support\n\nFor any queries or issues, please open an issue on the GitHub repository, and we'll address it promptly.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MultiMinio: provides failover and health-checking for applications using multiple Minio object storage instances, ensuring uninterrupted access and resilience.",
    "version": "1.0.2",
    "project_urls": {
        "Homepage": "https://github.com/asuiu/multiminio",
        "Repository": "https://github.com/asuiu/multiminio"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f48a45b63f9dafd8532a42c8d9bab10338c0f21e630fdd1980d4ecbe536ee529",
                "md5": "ee82590e8ed37e2b558e354eda93d2f9",
                "sha256": "39cc4c4518c83dd8065e7ceb9155cf5895367296027cae2a4dc5d172109c4c8b"
            },
            "downloads": -1,
            "filename": "multiminio-1.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ee82590e8ed37e2b558e354eda93d2f9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0.0",
            "size": 6625,
            "upload_time": "2023-09-24T09:06:08",
            "upload_time_iso_8601": "2023-09-24T09:06:08.427934Z",
            "url": "https://files.pythonhosted.org/packages/f4/8a/45b63f9dafd8532a42c8d9bab10338c0f21e630fdd1980d4ecbe536ee529/multiminio-1.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-24 09:06:08",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "asuiu",
    "github_project": "multiminio",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "multiminio"
}

Andrei Suiu