orcli 0.1.0__tar.gz → 0.1.2__tar.gz

{orcli-0.1.0 → orcli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orcli
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python client for interacting with OpenRefine
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -11,12 +11,14 @@ Requires-Dist: pytest; extra == "test"
 Dynamic: license-file
 
 
-# refine-client
+# orcli -- open-refine client
 
 A Python client library for interacting with [OpenRefine](https://openrefine.org/) via its REST API.
 
 For simple project creation, data transformation, metadata management and export operations.
 
+Find the [orcli package](https://pypi.org/project/orcli/) on PyPI.
+
 ## Features
 
   - Create and delete projects from local files.
@@ -35,25 +37,25 @@ Requires Python 3.10+ and a running OpenRefine server instance.
 
 ### Quick Start
 
-1. Clone the repository:
+1. Download:
+
+Clone the repository (see below).
 
 ```bash
 git clone https://github.com/rkraasch/refine-client.git
 cd refine-client
 ```
 
-2. Install dependencies:
+Or download from [orcli from PyPI](https://pypi.org/project/orcli/). (see below).
 
 ```bash
-python -m venv .venv
-source [.venv/bin/activate](.venv/bin/activate)  # Linux and Mac.
-# .venv\Scripts\activate   # Windows.
-pip install -r requirements.txt
-python -m pip list
-deactivate
+python -m venv ./venv
+./venv/bin/python -m pip install --upgrade pip
+./venv/bin/python -m pip install orcli
+./venv/bin/python -c "from orcli import Refine; print(Refine)"
 ```
 
-3. Optionally run tests:
+2. Optionally run tests:
 
 [Download](https://openrefine.org/download) and run OpenRefine, then run the tests as shown below.
 
@@ -63,10 +65,10 @@ python -m pytest tests/ -v
 This creates temporary test projects in OpenRefine which should be cleaned up automatically.
 If a project prefixed `pytest_refine-client-integration_` remains visible in the Open project tab (under [#open-project](http://127.0.0.1:3333/#open-project)), something went wrong.
 
-4. Basic Usage:
+3. Basic usage:
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 # Initialize the client
 refine = Refine(base_url="http://127.0.0.1:3333")
@@ -93,7 +95,9 @@ refine.export_data("output_file.tsv", fmt="tsv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-5. Access Project Metadata:
+## Examples
+
+### Example 1: Access Project Metadata
 
 ```python
 # Set metadata
@@ -108,7 +112,7 @@ for pid, metadata in projects.items():
 project_id = refine.get_project_id_by_name("Project Name")
 ```
 
-6. Do Batch Operations:
+### Example 2: Do Batch Operations
 
 ```python
 # Apply multiple operations
@@ -122,12 +126,10 @@ refine.apply_operations(operations, project_id)
 refine.apply_operations_from_file("operations.json", project_id, wait=True)
 ```
 
-## Examples
-
-### Example 1: Data Pipeline
+### Example 3: Data Pipeline
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine(verbose=True)
 
@@ -149,11 +151,11 @@ refine.export_data("processed_data.csv", fmt="csv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-### Example 2: Batch Processing
+### Example 4: Batch Processing
 
 ```python
 import os
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine()
 
@@ -198,7 +200,7 @@ Parameters:
 
 ## Configuration
 
-### Logging
+Logging:
 
 ```python
 # Verbose mode
@@ -208,7 +210,7 @@ refine = Refine(verbose=True)
 refine = Refine(silent=True)
 ```
 
-### Custom Server
+Custom server:
 
 ```python
 refine = Refine(base_url="http://example.com:3333")

{orcli-0.1.0 → orcli-0.1.2}/README.md

@@ -1,10 +1,12 @@
 
-# refine-client
+# orcli -- open-refine client
 
 A Python client library for interacting with [OpenRefine](https://openrefine.org/) via its REST API.
 
 For simple project creation, data transformation, metadata management and export operations.
 
+Find the [orcli package](https://pypi.org/project/orcli/) on PyPI.
+
 ## Features
 
   - Create and delete projects from local files.
@@ -23,25 +25,25 @@ Requires Python 3.10+ and a running OpenRefine server instance.
 
 ### Quick Start
 
-1. Clone the repository:
+1. Download:
+
+Clone the repository (see below).
 
 ```bash
 git clone https://github.com/rkraasch/refine-client.git
 cd refine-client
 ```
 
-2. Install dependencies:
+Or download from [orcli from PyPI](https://pypi.org/project/orcli/). (see below).
 
 ```bash
-python -m venv .venv
-source [.venv/bin/activate](.venv/bin/activate)  # Linux and Mac.
-# .venv\Scripts\activate   # Windows.
-pip install -r requirements.txt
-python -m pip list
-deactivate
+python -m venv ./venv
+./venv/bin/python -m pip install --upgrade pip
+./venv/bin/python -m pip install orcli
+./venv/bin/python -c "from orcli import Refine; print(Refine)"
 ```
 
-3. Optionally run tests:
+2. Optionally run tests:
 
 [Download](https://openrefine.org/download) and run OpenRefine, then run the tests as shown below.
 
@@ -51,10 +53,10 @@ python -m pytest tests/ -v
 This creates temporary test projects in OpenRefine which should be cleaned up automatically.
 If a project prefixed `pytest_refine-client-integration_` remains visible in the Open project tab (under [#open-project](http://127.0.0.1:3333/#open-project)), something went wrong.
 
-4. Basic Usage:
+3. Basic usage:
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 # Initialize the client
 refine = Refine(base_url="http://127.0.0.1:3333")
@@ -81,7 +83,9 @@ refine.export_data("output_file.tsv", fmt="tsv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-5. Access Project Metadata:
+## Examples
+
+### Example 1: Access Project Metadata
 
 ```python
 # Set metadata
@@ -96,7 +100,7 @@ for pid, metadata in projects.items():
 project_id = refine.get_project_id_by_name("Project Name")
 ```
 
-6. Do Batch Operations:
+### Example 2: Do Batch Operations
 
 ```python
 # Apply multiple operations
@@ -110,12 +114,10 @@ refine.apply_operations(operations, project_id)
 refine.apply_operations_from_file("operations.json", project_id, wait=True)
 ```
 
-## Examples
-
-### Example 1: Data Pipeline
+### Example 3: Data Pipeline
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine(verbose=True)
 
@@ -137,11 +139,11 @@ refine.export_data("processed_data.csv", fmt="csv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-### Example 2: Batch Processing
+### Example 4: Batch Processing
 
 ```python
 import os
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine()
 
@@ -186,7 +188,7 @@ Parameters:
 
 ## Configuration
 
-### Logging
+Logging:
 
 ```python
 # Verbose mode
@@ -196,7 +198,7 @@ refine = Refine(verbose=True)
 refine = Refine(silent=True)
 ```
 
-### Custom Server
+Custom server:
 
 ```python
 refine = Refine(base_url="http://example.com:3333")

{orcli-0.1.0 → orcli-0.1.2}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "orcli"
-version = "0.1.0"
+version = "0.1.2"
 description = "A Python client for interacting with OpenRefine"
 readme = "README.md"
 requires-python = ">=3.9"

{orcli-0.1.0 → orcli-0.1.2}/src/orcli/client.py

@@ -2,21 +2,17 @@
 # client.py
 # (c) 2025 RK, Lic. CC-0
 
-import json, time, logging, requests
+import json, time, requests
 from pathlib import Path
 from urllib.parse import urlparse, parse_qs
+import logging
 
 logger = logging.getLogger(__name__)
-# Library logger setup – no default handlers, safe for reuse
-if not logger.hasHandlers():
-    null_handler = logging.NullHandler()
-    logger.addHandler(null_handler)
+logger.addHandler(logging.NullHandler())
 
 class Refine:
     """Client interface for interacting with an OpenRefine server through its REST API."""
-
     DEFAULT_BASE_URL = "http://127.0.0.1:3333"
-
     def __init__(self, base_url: str | None = None, verbose: bool = False, silent: bool = False) -> None:
         self.base_url: str = (base_url or self.DEFAULT_BASE_URL).rstrip("/")
         self.session = requests.Session()
@@ -24,19 +20,6 @@ class Refine:
         self.project_id: str | None = None
         self.silent: bool = silent
         self.verbose: bool = verbose
-        logger.setLevel(logging.INFO)
-        if silent:
-            logger.setLevel(logging.ERROR)
-        elif verbose:
-            logger.setLevel(logging.DEBUG)
-            logger.debug("Verbose logging enabled.")
-        stream_handler = logging.StreamHandler()
-        stream_handler.setLevel(logging.DEBUG)
-        formatter = logging.Formatter(
-            "%(asctime)s - %(levelname)s - %(name)s - %(message)s"
-        )
-        stream_handler.setFormatter(formatter)
-        logger.addHandler(stream_handler)
         try:
             response = self.session.get(f"{self.base_url}")
             response.raise_for_status()
@@ -45,7 +28,6 @@ class Refine:
             logger.error(f"Failed to connect to OpenRefine server at {self.base_url}: {e}")
             raise ConnectionError(f"Could not connect to OpenRefine server at {self.base_url}") from e
 
-
     def _get_csrf_token(self) -> str:
         """Fetch CSRF token from server and cache it."""
         if not self.csrf_token:
@@ -261,7 +243,4 @@ class Refine:
 
 if __name__ == "__main__":
     refine = Refine(verbose=True)
-    # Example usage:
-    # project_id = refine.create_project("data.csv", "My Project")
-    # refine.apply_operations_from_file("operations.json", project_id, wait=True)
-    # refine.export_data("output.tsv", "tsv", project_id)
+

{orcli-0.1.0 → orcli-0.1.2}/src/orcli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orcli
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python client for interacting with OpenRefine
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -11,12 +11,14 @@ Requires-Dist: pytest; extra == "test"
 Dynamic: license-file
 
 
-# refine-client
+# orcli -- open-refine client
 
 A Python client library for interacting with [OpenRefine](https://openrefine.org/) via its REST API.
 
 For simple project creation, data transformation, metadata management and export operations.
 
+Find the [orcli package](https://pypi.org/project/orcli/) on PyPI.
+
 ## Features
 
   - Create and delete projects from local files.
@@ -35,25 +37,25 @@ Requires Python 3.10+ and a running OpenRefine server instance.
 
 ### Quick Start
 
-1. Clone the repository:
+1. Download:
+
+Clone the repository (see below).
 
 ```bash
 git clone https://github.com/rkraasch/refine-client.git
 cd refine-client
 ```
 
-2. Install dependencies:
+Or download from [orcli from PyPI](https://pypi.org/project/orcli/). (see below).
 
 ```bash
-python -m venv .venv
-source [.venv/bin/activate](.venv/bin/activate)  # Linux and Mac.
-# .venv\Scripts\activate   # Windows.
-pip install -r requirements.txt
-python -m pip list
-deactivate
+python -m venv ./venv
+./venv/bin/python -m pip install --upgrade pip
+./venv/bin/python -m pip install orcli
+./venv/bin/python -c "from orcli import Refine; print(Refine)"
 ```
 
-3. Optionally run tests:
+2. Optionally run tests:
 
 [Download](https://openrefine.org/download) and run OpenRefine, then run the tests as shown below.
 
@@ -63,10 +65,10 @@ python -m pytest tests/ -v
 This creates temporary test projects in OpenRefine which should be cleaned up automatically.
 If a project prefixed `pytest_refine-client-integration_` remains visible in the Open project tab (under [#open-project](http://127.0.0.1:3333/#open-project)), something went wrong.
 
-4. Basic Usage:
+3. Basic usage:
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 # Initialize the client
 refine = Refine(base_url="http://127.0.0.1:3333")
@@ -93,7 +95,9 @@ refine.export_data("output_file.tsv", fmt="tsv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-5. Access Project Metadata:
+## Examples
+
+### Example 1: Access Project Metadata
 
 ```python
 # Set metadata
@@ -108,7 +112,7 @@ for pid, metadata in projects.items():
 project_id = refine.get_project_id_by_name("Project Name")
 ```
 
-6. Do Batch Operations:
+### Example 2: Do Batch Operations
 
 ```python
 # Apply multiple operations
@@ -122,12 +126,10 @@ refine.apply_operations(operations, project_id)
 refine.apply_operations_from_file("operations.json", project_id, wait=True)
 ```
 
-## Examples
-
-### Example 1: Data Pipeline
+### Example 3: Data Pipeline
 
 ```python
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine(verbose=True)
 
@@ -149,11 +151,11 @@ refine.export_data("processed_data.csv", fmt="csv", project_id=project_id)
 refine.delete_project(project_id)
 ```
 
-### Example 2: Batch Processing
+### Example 4: Batch Processing
 
 ```python
 import os
-from refine_client import Refine
+from orcli import Refine
 
 refine = Refine()
 
@@ -198,7 +200,7 @@ Parameters:
 
 ## Configuration
 
-### Logging
+Logging:
 
 ```python
 # Verbose mode
@@ -208,7 +210,7 @@ refine = Refine(verbose=True)
 refine = Refine(silent=True)
 ```
 
-### Custom Server
+Custom server:
 
 ```python
 refine = Refine(base_url="http://example.com:3333")