| Name | rara-tools JSON |
| Version |
0.0.9
JSON |
| download |
| home_page | None |
| Summary | Tools to support Kata's work. |
| upload_time | 2025-02-13 14:38:39 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# RaRa Tools
**`rara-tools`** is a Python library containing various generic tools used by components of Kata.
---
## ✨ Features
- Elasticsearch index & document operations
- S3 file management operations
- Task reporting to Core API
- Converting SIERRA API responses to Pymarc compatible JSON
---
## ⚡ Quick Start
Get started with `rara-tools` in just a few steps:
1. **Install the Package**
Ensure you're using Python 3.10 or above, then run:
```bash
pip install rara-tools
```
2. **Import and Use**
Example usage to download a folder from S3:
```python
from rara_tools.s3 import S3Files
s3 = S3Files(
url="your-s3-address",
access_key = "xxx",
secret_key = "yyy",
bucket = "my-sad-bucket"
)
s3.download("my-folder-in-s3")
```
---
## ⚙️ Installation Guide
Follow the steps below to install the `rara-tools` package, either via `pip` or locally.
---
### Installation via `pip`
<details><summary>Click to expand</summary>
1. **Set Up Your Python Environment**
Create or activate a Python environment using Python **3.10** or above.
2. **Install the Package**
Run the following command:
```bash
pip install rara-tools
```
</details>
---
### Local Installation
Follow these steps to install the `rara-tools` package locally:
<details><summary>Click to expand</summary>
1. **Clone the Repository**
Clone the repository and navigate into it:
```bash
git clone <repository-url>
cd <repository-directory>
```
2. **Set Up Python Environment**
Create or activate a Python environment using Python 3.10 or above. E.g:
```bash
conda create -n py310 python==3.10
conda activate py310
```
3. **Install Build Package**
Install the `build` package to enable local builds:
```bash
pip install build
```
4. **Build the Package**
Run the following command inside the repository:
```bash
python -m build
```
5. **Install the Package**
Install the built package locally:
```bash
pip install .
```
</details>
---
## 🚀 Testing Guide
Follow these steps to test the `rara-tools` package.
### How to Test
<details><summary>Click to expand</summary>
1. **Clone the Repository**
Clone the repository and navigate into it:
```bash
git clone <repository-url>
cd <repository-directory>
```
2. **Set Up Python Environment**
Create or activate a Python environment using Python 3.10 or above.
3. **Install Build Package**
Install the `build` package:
```bash
pip install build
```
4. **Build the Package**
Build the package inside the repository:
```bash
python -m build
```
5. **Install with Testing Dependencies**
Install the package along with its testing dependencies:
```bash
pip install .[testing]
```
6. **Run Tests**
Run the test suite from the repository root:
```bash
python -m pytest -v tests
```
---
</details>
Raw data
{
"_id": null,
"home_page": null,
"name": "rara-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2b/32/faa229add9e7c36aacd8d38a54f17b683f504231d531b38f9b14bd8a6c52/rara_tools-0.0.9.tar.gz",
"platform": null,
"description": "# RaRa Tools\n\n\n\n\n\n**`rara-tools`** is a Python library containing various generic tools used by components of Kata.\n\n---\n\n## \u2728 Features\n\n- Elasticsearch index & document operations\n- S3 file management operations\n- Task reporting to Core API\n- Converting SIERRA API responses to Pymarc compatible JSON\n\n---\n\n## \u26a1 Quick Start\n\nGet started with `rara-tools` in just a few steps:\n\n1. **Install the Package** \n Ensure you're using Python 3.10 or above, then run:\n\n ```bash\n pip install rara-tools\n ```\n\n2. **Import and Use** \n Example usage to download a folder from S3:\n\n ```python\n from rara_tools.s3 import S3Files\n\n s3 = S3Files(\n url=\"your-s3-address\",\n access_key = \"xxx\",\n secret_key = \"yyy\",\n bucket = \"my-sad-bucket\"\n )\n\n s3.download(\"my-folder-in-s3\")\n ```\n\n---\n\n## \u2699\ufe0f Installation Guide\n\nFollow the steps below to install the `rara-tools` package, either via `pip` or locally.\n\n---\n\n### Installation via `pip`\n\n<details><summary>Click to expand</summary>\n\n1. **Set Up Your Python Environment** \n Create or activate a Python environment using Python **3.10** or above.\n\n2. **Install the Package** \n Run the following command:\n\n ```bash\n pip install rara-tools\n ```\n\n </details>\n\n---\n\n### Local Installation\n\nFollow these steps to install the `rara-tools` package locally:\n\n<details><summary>Click to expand</summary>\n\n1. **Clone the Repository** \n Clone the repository and navigate into it:\n\n ```bash\n git clone <repository-url>\n cd <repository-directory>\n ```\n\n2. **Set Up Python Environment** \n Create or activate a Python environment using Python 3.10 or above. E.g:\n\n ```bash\n conda create -n py310 python==3.10\n conda activate py310\n ```\n\n3. **Install Build Package** \n Install the `build` package to enable local builds:\n\n ```bash\n pip install build\n ```\n\n4. **Build the Package** \n Run the following command inside the repository:\n\n ```bash\n python -m build\n ```\n\n5. **Install the Package** \n Install the built package locally:\n\n ```bash\n pip install .\n ```\n\n</details>\n\n---\n\n## \ud83d\ude80 Testing Guide\n\nFollow these steps to test the `rara-tools` package.\n\n### How to Test\n\n<details><summary>Click to expand</summary>\n\n1. **Clone the Repository** \n Clone the repository and navigate into it:\n\n ```bash\n git clone <repository-url>\n cd <repository-directory>\n ```\n\n2. **Set Up Python Environment** \n Create or activate a Python environment using Python 3.10 or above.\n\n3. **Install Build Package** \n Install the `build` package:\n\n ```bash\n pip install build\n ```\n\n4. **Build the Package** \n Build the package inside the repository:\n\n ```bash\n python -m build\n ```\n\n5. **Install with Testing Dependencies** \n Install the package along with its testing dependencies:\n\n ```bash\n pip install .[testing]\n ```\n\n6. **Run Tests** \n Run the test suite from the repository root:\n\n ```bash\n python -m pytest -v tests\n ```\n\n---\n\n</details>\n",
"bugtrack_url": null,
"license": null,
"summary": "Tools to support Kata's work.",
"version": "0.0.9",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d09d78af35699d8be77dccc14f98baa7a8a6f2cdd7c5d247d027cc2e600e1ab8",
"md5": "140da3df010dabb0400925f19ffe9c48",
"sha256": "62a769927dc23c4707cb27615163bd1d2b0c5cccbf780ff2dce38c1a7c23ff8d"
},
"downloads": -1,
"filename": "rara_tools-0.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "140da3df010dabb0400925f19ffe9c48",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 22034,
"upload_time": "2025-02-13T14:38:37",
"upload_time_iso_8601": "2025-02-13T14:38:37.874879Z",
"url": "https://files.pythonhosted.org/packages/d0/9d/78af35699d8be77dccc14f98baa7a8a6f2cdd7c5d247d027cc2e600e1ab8/rara_tools-0.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2b32faa229add9e7c36aacd8d38a54f17b683f504231d531b38f9b14bd8a6c52",
"md5": "f5ecce93d02ce600b29cfba1395849f4",
"sha256": "653e6f9e1b8ceeee3a5c579417bf50cb801244f3525f3b50169453352da7a03e"
},
"downloads": -1,
"filename": "rara_tools-0.0.9.tar.gz",
"has_sig": false,
"md5_digest": "f5ecce93d02ce600b29cfba1395849f4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 25176,
"upload_time": "2025-02-13T14:38:39",
"upload_time_iso_8601": "2025-02-13T14:38:39.515143Z",
"url": "https://files.pythonhosted.org/packages/2b/32/faa229add9e7c36aacd8d38a54f17b683f504231d531b38f9b14bd8a6c52/rara_tools-0.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-13 14:38:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "rara-tools"
}
