rdf4j-python 0.1.6__tar.gz → 0.2.0__tar.gz

{rdf4j_python-0.1.6/rdf4j_python.egg-info → rdf4j_python-0.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: rdf4j-python
-Version: 0.1.6
+Version: 0.2.0
 Summary: The Python client for RDF4J
 Author-email: Chengxu Bian <cbian564@gmail.com>
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.28.1
@@ -14,28 +14,34 @@ Dynamic: license-file
 
 # rdf4j-python
 
+[![PyPI version](https://badge.fury.io/py/rdf4j-python.svg)](https://badge.fury.io/py/rdf4j-python)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rdf4j-python.svg)](https://pypi.org/project/rdf4j-python/)
+[![CI](https://github.com/odysa/rdf4j-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/odysa/rdf4j-python/actions/workflows/ci.yaml)
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Documentation](https://img.shields.io/badge/docs-sphinx-blue.svg)](https://github.com/odysa/rdf4j-python/tree/main/docs)
+
 **A modern Python client for the Eclipse RDF4J framework, enabling seamless RDF data management and SPARQL operations from Python applications.**
 
 rdf4j-python bridges the gap between Python and the robust [Eclipse RDF4J](https://rdf4j.org/) ecosystem, providing a clean, async-first API for managing RDF repositories, executing SPARQL queries, and handling semantic data with ease.
 
-> ⚠️ **Note:** This project is currently under active development and considered **experimental**. Interfaces may change. Use with caution in production environments—and feel free to help shape its future!
-
 ## Features
 
-- **🚀 Async-First Design**: Native support for async/await with synchronous fallback
-- **🔄 Repository Management**: Create, access, and manage RDF4J repositories programmatically
-- **⚡ SPARQL Support**: Execute SELECT, ASK, CONSTRUCT, and UPDATE queries effortlessly
-- **📊 Flexible Data Handling**: Add, retrieve, and manipulate RDF triples and quads
-- **🎯 Multiple Formats**: Support for various RDF serialization formats (Turtle, N-Triples, JSON-LD, etc.)
-- **🛠️ Repository Types**: Memory stores, native stores, HTTP repositories, and more
-- **🔗 Named Graph Support**: Work with multiple graphs within repositories
-- **⚙️ Inferencing**: Built-in support for RDFS and custom inferencing rules
+- **Async-First Design**: Native support for async/await with synchronous fallback
+- **Repository Management**: Create, access, and manage RDF4J repositories programmatically
+- **SPARQL Support**: Execute SELECT, ASK, CONSTRUCT, and UPDATE queries effortlessly
+- **Transaction Support**: Atomic operations with commit/rollback and isolation levels
+- **Flexible Data Handling**: Add, retrieve, and manipulate RDF triples and quads
+- **File Upload**: Upload RDF files (Turtle, N-Triples, N-Quads, RDF/XML, JSON-LD, TriG, N3) directly to repositories
+- **Multiple Formats**: Support for various RDF serialization formats
+- **Repository Types**: Memory stores, native stores, HTTP repositories, and more
+- **Named Graph Support**: Work with multiple graphs within repositories
+- **Inferencing**: Built-in support for RDFS and custom inferencing rules
 
 ## Installation
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - RDF4J Server (for remote repositories) or embedded usage
 
 ### Install from PyPI
@@ -175,6 +181,55 @@ async def advanced_example():
         results = await repo.query(query)
 ```
 
+### Uploading RDF Files
+
+```python
+import pyoxigraph as og
+
+async def upload_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        repo = await db.get_repository("my-repo")
+
+        # Upload a Turtle file (format auto-detected from extension)
+        await repo.upload_file("data.ttl")
+
+        # Upload to a specific named graph
+        await repo.upload_file("data.ttl", context=IRI("http://example.com/graph"))
+
+        # Upload with explicit format
+        await repo.upload_file("data.txt", rdf_format=og.RdfFormat.N_TRIPLES)
+
+        # Upload with base URI for relative URIs
+        await repo.upload_file("data.ttl", base_uri="http://example.com/")
+```
+
+### Using Transactions
+
+```python
+from rdf4j_python import IsolationLevel
+
+async def transaction_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        repo = await db.get_repository("my-repo")
+
+        # Atomic operations with auto-commit/rollback
+        async with repo.transaction() as txn:
+            await txn.add_statements([
+                Quad(IRI("http://example.com/alice"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Alice")),
+                Quad(IRI("http://example.com/bob"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Bob")),
+            ])
+            await txn.delete_statements([old_quad])
+            # Commits automatically on success, rolls back on exception
+
+        # With specific isolation level
+        async with repo.transaction(IsolationLevel.SERIALIZABLE) as txn:
+            await txn.update("""
+                DELETE { ?s <http://example.com/status> "draft" }
+                INSERT { ?s <http://example.com/status> "published" }
+                WHERE { ?s <http://example.com/status> "draft" }
+            """)
+```
+
 For more detailed examples, see the [examples](examples/) directory.
 
 ## Development
@@ -223,17 +278,17 @@ tests/              # Test suite
 docs/               # Documentation
 ```
 
-### Contributing
+## Contributing
 
 We welcome contributions! Here's how to get involved:
 
-1. **Fork** the repository on GitHub
-2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
-3. **Make** your changes and add tests
-4. **Run** the test suite to ensure everything works
-5. **Commit** your changes (`git commit -m 'Add amazing feature'`)
-6. **Push** to your branch (`git push origin feature/amazing-feature`)
-7. **Open** a Pull Request
+1. Fork the repository on GitHub
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes and add tests
+4. Run the test suite to ensure everything works
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to your branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
 
 ### Running Examples
 
@@ -245,15 +300,14 @@ python examples/query.py
 
 ## License
 
-This project is licensed under the **BSD 3-Clause License**. See the [LICENSE](LICENSE) file for the full license text.
+This project is licensed under the BSD 3-Clause License. See the [LICENSE](LICENSE) file for details.
 
-```
 Copyright (c) 2025, Chengxu Bian
-All rights reserved.
-```
 
----
+## Support
 
-**Questions or Issues?** Please feel free to [open an issue](https://github.com/odysa/rdf4j-python/issues) on GitHub.
+- **Issues & Bug Reports**: [GitHub Issues](https://github.com/odysa/rdf4j-python/issues)
+- **Documentation**: [docs/](https://github.com/odysa/rdf4j-python/tree/main/docs)
+- **Questions**: Feel free to open a discussion or issue
 
-**⭐ Star this repo** if you find it useful!
+If you find this project useful, please consider starring the repository!

{rdf4j_python-0.1.6 → rdf4j_python-0.2.0}/README.md

@@ -1,27 +1,33 @@
 # rdf4j-python
 
+[![PyPI version](https://badge.fury.io/py/rdf4j-python.svg)](https://badge.fury.io/py/rdf4j-python)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rdf4j-python.svg)](https://pypi.org/project/rdf4j-python/)
+[![CI](https://github.com/odysa/rdf4j-python/actions/workflows/ci.yaml/badge.svg)](https://github.com/odysa/rdf4j-python/actions/workflows/ci.yaml)
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Documentation](https://img.shields.io/badge/docs-sphinx-blue.svg)](https://github.com/odysa/rdf4j-python/tree/main/docs)
+
 **A modern Python client for the Eclipse RDF4J framework, enabling seamless RDF data management and SPARQL operations from Python applications.**
 
 rdf4j-python bridges the gap between Python and the robust [Eclipse RDF4J](https://rdf4j.org/) ecosystem, providing a clean, async-first API for managing RDF repositories, executing SPARQL queries, and handling semantic data with ease.
 
-> ⚠️ **Note:** This project is currently under active development and considered **experimental**. Interfaces may change. Use with caution in production environments—and feel free to help shape its future!
-
 ## Features
 
-- **🚀 Async-First Design**: Native support for async/await with synchronous fallback
-- **🔄 Repository Management**: Create, access, and manage RDF4J repositories programmatically
-- **⚡ SPARQL Support**: Execute SELECT, ASK, CONSTRUCT, and UPDATE queries effortlessly
-- **📊 Flexible Data Handling**: Add, retrieve, and manipulate RDF triples and quads
-- **🎯 Multiple Formats**: Support for various RDF serialization formats (Turtle, N-Triples, JSON-LD, etc.)
-- **🛠️ Repository Types**: Memory stores, native stores, HTTP repositories, and more
-- **🔗 Named Graph Support**: Work with multiple graphs within repositories
-- **⚙️ Inferencing**: Built-in support for RDFS and custom inferencing rules
+- **Async-First Design**: Native support for async/await with synchronous fallback
+- **Repository Management**: Create, access, and manage RDF4J repositories programmatically
+- **SPARQL Support**: Execute SELECT, ASK, CONSTRUCT, and UPDATE queries effortlessly
+- **Transaction Support**: Atomic operations with commit/rollback and isolation levels
+- **Flexible Data Handling**: Add, retrieve, and manipulate RDF triples and quads
+- **File Upload**: Upload RDF files (Turtle, N-Triples, N-Quads, RDF/XML, JSON-LD, TriG, N3) directly to repositories
+- **Multiple Formats**: Support for various RDF serialization formats
+- **Repository Types**: Memory stores, native stores, HTTP repositories, and more
+- **Named Graph Support**: Work with multiple graphs within repositories
+- **Inferencing**: Built-in support for RDFS and custom inferencing rules
 
 ## Installation
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - RDF4J Server (for remote repositories) or embedded usage
 
 ### Install from PyPI
@@ -161,6 +167,55 @@ async def advanced_example():
         results = await repo.query(query)
 ```
 
+### Uploading RDF Files
+
+```python
+import pyoxigraph as og
+
+async def upload_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        repo = await db.get_repository("my-repo")
+
+        # Upload a Turtle file (format auto-detected from extension)
+        await repo.upload_file("data.ttl")
+
+        # Upload to a specific named graph
+        await repo.upload_file("data.ttl", context=IRI("http://example.com/graph"))
+
+        # Upload with explicit format
+        await repo.upload_file("data.txt", rdf_format=og.RdfFormat.N_TRIPLES)
+
+        # Upload with base URI for relative URIs
+        await repo.upload_file("data.ttl", base_uri="http://example.com/")
+```
+
+### Using Transactions
+
+```python
+from rdf4j_python import IsolationLevel
+
+async def transaction_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        repo = await db.get_repository("my-repo")
+
+        # Atomic operations with auto-commit/rollback
+        async with repo.transaction() as txn:
+            await txn.add_statements([
+                Quad(IRI("http://example.com/alice"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Alice")),
+                Quad(IRI("http://example.com/bob"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Bob")),
+            ])
+            await txn.delete_statements([old_quad])
+            # Commits automatically on success, rolls back on exception
+
+        # With specific isolation level
+        async with repo.transaction(IsolationLevel.SERIALIZABLE) as txn:
+            await txn.update("""
+                DELETE { ?s <http://example.com/status> "draft" }
+                INSERT { ?s <http://example.com/status> "published" }
+                WHERE { ?s <http://example.com/status> "draft" }
+            """)
+```
+
 For more detailed examples, see the [examples](examples/) directory.
 
 ## Development
@@ -209,17 +264,17 @@ tests/              # Test suite
 docs/               # Documentation
 ```
 
-### Contributing
+## Contributing
 
 We welcome contributions! Here's how to get involved:
 
-1. **Fork** the repository on GitHub
-2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
-3. **Make** your changes and add tests
-4. **Run** the test suite to ensure everything works
-5. **Commit** your changes (`git commit -m 'Add amazing feature'`)
-6. **Push** to your branch (`git push origin feature/amazing-feature`)
-7. **Open** a Pull Request
+1. Fork the repository on GitHub
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes and add tests
+4. Run the test suite to ensure everything works
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to your branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
 
 ### Running Examples
 
@@ -231,15 +286,14 @@ python examples/query.py
 
 ## License
 
-This project is licensed under the **BSD 3-Clause License**. See the [LICENSE](LICENSE) file for the full license text.
+This project is licensed under the BSD 3-Clause License. See the [LICENSE](LICENSE) file for details.
 
-```
 Copyright (c) 2025, Chengxu Bian
-All rights reserved.
-```
 
----
+## Support
 
-**Questions or Issues?** Please feel free to [open an issue](https://github.com/odysa/rdf4j-python/issues) on GitHub.
+- **Issues & Bug Reports**: [GitHub Issues](https://github.com/odysa/rdf4j-python/issues)
+- **Documentation**: [docs/](https://github.com/odysa/rdf4j-python/tree/main/docs)
+- **Questions**: Feel free to open a discussion or issue
 
-**⭐ Star this repo** if you find it useful!
+If you find this project useful, please consider starring the repository!

{rdf4j_python-0.1.6 → rdf4j_python-0.2.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "rdf4j-python"
 authors = [{ name = "Chengxu Bian", email = "cbian564@gmail.com" }]
-version = "0.1.6"
+version = "0.2.0"
 description = "The Python client for RDF4J"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = ["httpx>=0.28.1", "pyoxigraph>=0.4.10"]
 
 [project.optional-dependencies]
@@ -20,6 +20,19 @@ dev = [
 ]
 docs = ["furo>=2024.8.6", "sphinx>=8"]
 
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+branch = "main"
+commit_message = "chore(release): bump version to {version}"
+tag_format = "v{version}"
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = ["build", "chore", "ci", "docs", "feat", "fix", "perf", "refactor", "style", "test"]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]
+
+[tool.semantic_release.changelog]
+changelog_file = "CHANGELOG.md"
 
 [tool.pytest.ini_options]
 log_cli = true

rdf4j_python-0.2.0/rdf4j_python/__init__.py

@@ -0,0 +1,81 @@
+"""
+RDF4J Python is a Python library for interacting with RDF4J repositories.
+"""
+
+from ._driver import (
+    AsyncNamedGraph,
+    AsyncRdf4j,
+    AsyncRdf4JRepository,
+    AsyncTransaction,
+    IsolationLevel,
+    TransactionState,
+)
+from .exception import (
+    NamespaceException,
+    NetworkError,
+    QueryError,
+    Rdf4jError,
+    RepositoryCreationException,
+    RepositoryDeletionException,
+    RepositoryError,
+    RepositoryInternalException,
+    RepositoryNotFoundException,
+    RepositoryUpdateException,
+    TransactionError,
+    TransactionStateError,
+)
+from .model import (
+    IRI,
+    BlankNode,
+    Context,
+    DefaultGraph,
+    Literal,
+    Namespace,
+    Object,
+    Predicate,
+    Quad,
+    QuadResultSet,
+    RepositoryMetadata,
+    Subject,
+    Triple,
+    Variable,
+)
+
+__all__ = [
+    # Main classes
+    "AsyncRdf4j",
+    "AsyncRdf4JRepository",
+    "AsyncNamedGraph",
+    # Transaction
+    "AsyncTransaction",
+    "IsolationLevel",
+    "TransactionState",
+    # Exceptions
+    "Rdf4jError",
+    "RepositoryError",
+    "RepositoryCreationException",
+    "RepositoryDeletionException",
+    "RepositoryNotFoundException",
+    "RepositoryInternalException",
+    "RepositoryUpdateException",
+    "NamespaceException",
+    "NetworkError",
+    "QueryError",
+    "TransactionError",
+    "TransactionStateError",
+    # Model types
+    "Namespace",
+    "RepositoryMetadata",
+    "IRI",
+    "BlankNode",
+    "Literal",
+    "DefaultGraph",
+    "Variable",
+    "Quad",
+    "Triple",
+    "Subject",
+    "Predicate",
+    "Object",
+    "Context",
+    "QuadResultSet",
+]