rara-tools 0.0.8__tar.gz → 0.0.10__tar.gz

{rara_tools-0.0.8/rara_tools.egg-info → rara_tools-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: rara-tools
-Version: 0.0.8
+Version: 0.0.10
 Summary: Tools to support Kata's work.
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -14,6 +14,7 @@ Requires-Dist: elasticsearch==8.*
 Requires-Dist: elasticsearch_dsl==8.*
 Requires-Dist: minio==7.*
 Requires-Dist: requests
+Requires-Dist: iso639-lang
 Provides-Extra: testing
 Requires-Dist: pytest>=8.0; extra == "testing"
 Requires-Dist: pytest-order; extra == "testing"
@@ -28,25 +29,28 @@ Requires-Dist: pytest-order; extra == "testing"
 
 ---
 
-## ✨ Features  
+## ✨ Features
 
 - Elasticsearch index & document operations
 - S3 file management operations
 - Task reporting to Core API
+- Converting SIERRA API responses to Pymarc compatible JSON
+
 ---
 
-## ⚡ Quick Start  
+## ⚡ 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:  
+   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:  
+   Example usage to download a folder from S3:
 
    ```python
    from rara_tools.s3 import S3Files
@@ -77,22 +81,25 @@ Follow the steps below to install the `rara-tools` package, either via `pip` or
    Create or activate a Python environment using Python **3.10** or above.
 
 2. **Install the Package**  
-   Run the following command:  
+    Run the following command:
+
    ```bash
    pip install rara-tools
    ```
-</details>
+
+   </details>
 
 ---
 
 ### Local Installation
 
-Follow these steps to install the `rara-tools` package locally:  
+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:  
+   Clone the repository and navigate into it:
+
    ```bash
    git clone <repository-url>
    cd <repository-directory>
@@ -100,25 +107,29 @@ Follow these steps to install the `rara-tools` package locally:
 
 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:  
+   Install the `build` package to enable local builds:
+
    ```bash
    pip install build
    ```
 
 4. **Build the Package**  
-   Run the following command inside the repository:  
+   Run the following command inside the repository:
+
    ```bash
    python -m build
    ```
 
 5. **Install the Package**  
-   Install the built package locally:  
+   Install the built package locally:
+
    ```bash
    pip install .
    ```
@@ -131,13 +142,13 @@ Follow these steps to install the `rara-tools` package locally:
 
 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:  
+   Clone the repository and navigate into it:
+
    ```bash
    git clone <repository-url>
    cd <repository-directory>
@@ -147,25 +158,29 @@ Follow these steps to test the `rara-tools` package.
    Create or activate a Python environment using Python 3.10 or above.
 
 3. **Install Build Package**  
-   Install the `build` package:  
+   Install the `build` package:
+
    ```bash
    pip install build
    ```
 
 4. **Build the Package**  
-   Build the package inside the repository:  
+   Build the package inside the repository:
+
    ```bash
    python -m build
    ```
 
 5. **Install with Testing Dependencies**  
-   Install the package along with its 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:  
+   Run the test suite from the repository root:
+
    ```bash
    python -m pytest -v tests
    ```

{rara_tools-0.0.8 → rara_tools-0.0.10}/README.md

@@ -8,25 +8,28 @@
 
 ---
 
-## ✨ Features  
+## ✨ Features
 
 - Elasticsearch index & document operations
 - S3 file management operations
 - Task reporting to Core API
+- Converting SIERRA API responses to Pymarc compatible JSON
+
 ---
 
-## ⚡ Quick Start  
+## ⚡ 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:  
+   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:  
+   Example usage to download a folder from S3:
 
    ```python
    from rara_tools.s3 import S3Files
@@ -57,22 +60,25 @@ Follow the steps below to install the `rara-tools` package, either via `pip` or
    Create or activate a Python environment using Python **3.10** or above.
 
 2. **Install the Package**  
-   Run the following command:  
+    Run the following command:
+
    ```bash
    pip install rara-tools
    ```
-</details>
+
+   </details>
 
 ---
 
 ### Local Installation
 
-Follow these steps to install the `rara-tools` package locally:  
+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:  
+   Clone the repository and navigate into it:
+
    ```bash
    git clone <repository-url>
    cd <repository-directory>
@@ -80,25 +86,29 @@ Follow these steps to install the `rara-tools` package locally:
 
 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:  
+   Install the `build` package to enable local builds:
+
    ```bash
    pip install build
    ```
 
 4. **Build the Package**  
-   Run the following command inside the repository:  
+   Run the following command inside the repository:
+
    ```bash
    python -m build
    ```
 
 5. **Install the Package**  
-   Install the built package locally:  
+   Install the built package locally:
+
    ```bash
    pip install .
    ```
@@ -111,13 +121,13 @@ Follow these steps to install the `rara-tools` package locally:
 
 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:  
+   Clone the repository and navigate into it:
+
    ```bash
    git clone <repository-url>
    cd <repository-directory>
@@ -127,25 +137,29 @@ Follow these steps to test the `rara-tools` package.
    Create or activate a Python environment using Python 3.10 or above.
 
 3. **Install Build Package**  
-   Install the `build` package:  
+   Install the `build` package:
+
    ```bash
    pip install build
    ```
 
 4. **Build the Package**  
-   Build the package inside the repository:  
+   Build the package inside the repository:
+
    ```bash
    python -m build
    ```
 
 5. **Install with Testing Dependencies**  
-   Install the package along with its 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:  
+   Run the test suite from the repository root:
+
    ```bash
    python -m pytest -v tests
    ```

rara_tools-0.0.10/VERSION

@@ -0,0 +1 @@
+0.0.10

rara_tools-0.0.10/rara_tools/converters.py

@@ -0,0 +1,41 @@
+from .exceptions import SierraResponseConverterException
+
+
+class SierraResponseConverter:
+    """  Takes a JSON response from the Sierra API (https://tester.ester.ee/iii/sierra-api/swagger/index.html)
+    and converts it to MARC-in-JSON format.
+    
+    """
+    
+    def __init__(self, response: dict):
+        if not isinstance(response, dict):
+            raise SierraResponseConverterException("Please provide a valid JSON response.")
+        self.response = response
+        
+    def _map_field_data(self, field):
+        tag = field.get("tag")
+        if not tag:
+            raise SierraResponseConverterException("Field is missing a valid 'tag'.")
+        data = field.get("data", {})
+        return {tag: data}
+        
+    def _convert_response(self):
+        response = self.response
+        
+        entries = response.get("entries")
+        if not entries:
+            raise SierraResponseConverterException("No entries found in the response.")
+        
+        try:
+            fields = [self._map_field_data(f) for e in entries for f in e["marc"]["fields"]]
+        except KeyError as e:
+            raise SierraResponseConverterException(f"Missing expected MARC fields in the response: {e}")
+        
+        return {"fields": fields}
+            
+    def convert(self):
+        """Runner method, converts the response to MARC-in-JSON format with error handling."""
+        try:
+            return self._convert_response()
+        except Exception as e:
+            raise SierraResponseConverterException(f"An unexpected error occurred during conversion: {e}")

{rara_tools-0.0.8 → rara_tools-0.0.10}/rara_tools/decorators.py

@@ -1,12 +1,12 @@
 import functools
+from typing import Any, Callable
+
 from elasticsearch import AuthenticationException
 from elasticsearch import ConnectionError as ElasticsearchConnectionError
 from elasticsearch import ConnectionTimeout, NotFoundError, RequestError
-from typing import Any, Callable
 
 from .exceptions import ElasticsearchException
 
-
 ELASTIC_NOT_FOUND_MESSAGE = 'Could not find specified data from Elasticsearch!'
 ELASTIC_REQUEST_ERROR_MESSAGE = 'Error executing Elasticsearch query! Bad query?'
 ELASTIC_CONNECTION_TIMEOUT_MESSAGE = 'Connection to Elasticsearch took too long, please try again later!'
@@ -39,4 +39,4 @@ def _elastic_connection(func: Callable) -> Callable:
 			raise ElasticsearchException(ELASTIC_CONNECTION_ERROR_MESSAGE) from exception
 		except Exception as exception:
 			raise ElasticsearchException(ELASTIC_UNKNOWN_ERROR_MESSAGE) from exception
-	return wrapper
+	return wrapper