rdf4j-python 0.1.5__py3-none-any.whl → 0.2.0__py3-none-any.whl

rdf4j_python/exception/__init__.py

@@ -2,4 +2,32 @@
 RDF4J Python Exception Module
 """
 
-from .repo_exception import *  # noqa: F403
+from .repo_exception import (
+    NamespaceException,
+    NetworkError,
+    QueryError,
+    Rdf4jError,
+    RepositoryCreationException,
+    RepositoryDeletionException,
+    RepositoryError,
+    RepositoryInternalException,
+    RepositoryNotFoundException,
+    RepositoryUpdateException,
+    TransactionError,
+    TransactionStateError,
+)
+
+__all__ = [
+    "Rdf4jError",
+    "RepositoryError",
+    "RepositoryCreationException",
+    "RepositoryDeletionException",
+    "RepositoryNotFoundException",
+    "RepositoryInternalException",
+    "RepositoryUpdateException",
+    "NamespaceException",
+    "NetworkError",
+    "QueryError",
+    "TransactionError",
+    "TransactionStateError",
+]

rdf4j_python/exception/repo_exception.py

@@ -1,34 +1,61 @@
-class RepositoryCreationException(Exception):
-    """
-    Exception raised when a repository creation fails.
-    """
+class Rdf4jError(Exception):
+    """Base exception for all RDF4J SDK errors.
 
+    All exceptions raised by the RDF4J Python SDK inherit from this class,
+    allowing users to catch all SDK-related errors with a single except clause.
 
-class RepositoryDeletionException(Exception):
-    """
-    Exception raised when a repository deletion fails.
+    Example:
+        try:
+            await repo.query("SELECT * WHERE { ?s ?p ?o }")
+        except Rdf4jError as e:
+            # Catches any RDF4J SDK error
+            print(f"RDF4J error: {e}")
     """
 
 
-class NamespaceException(Exception):
-    """
-    Exception raised when a namespace operation fails.
-    """
+class RepositoryError(Rdf4jError):
+    """Base exception for repository-related errors."""
 
 
-class RepositoryNotFoundException(Exception):
-    """
-    Exception raised when a repository is not found.
-    """
+class RepositoryCreationException(RepositoryError):
+    """Exception raised when a repository creation fails."""
 
 
-class RepositoryInternalException(Exception):
-    """
-    Exception raised when a repository internal error occurs.
-    """
+class RepositoryDeletionException(RepositoryError):
+    """Exception raised when a repository deletion fails."""
 
 
-class RepositoryUpdateException(Exception):
-    """
-    Exception raised when a repository update fails.
+class RepositoryNotFoundException(RepositoryError):
+    """Exception raised when a repository is not found."""
+
+
+class RepositoryInternalException(RepositoryError):
+    """Exception raised when a repository internal error occurs."""
+
+
+class RepositoryUpdateException(RepositoryError):
+    """Exception raised when a repository update fails."""
+
+
+class NamespaceException(Rdf4jError):
+    """Exception raised when a namespace operation fails."""
+
+
+class NetworkError(Rdf4jError):
+    """Exception raised when a network/connection error occurs."""
+
+
+class QueryError(Rdf4jError):
+    """Exception raised when a SPARQL query is invalid or fails."""
+
+
+class TransactionError(Rdf4jError):
+    """Base exception for transaction-related errors."""
+
+
+class TransactionStateError(TransactionError):
+    """Exception raised when a transaction operation is invalid for the current state.
+
+    For example, trying to commit an already committed transaction,
+    or trying to add statements to a closed transaction.
     """

rdf4j_python/model/__init__.py

@@ -4,8 +4,34 @@ RDF4J Python Model Module
 
 from ._namespace import Namespace
 from ._repository_info import RepositoryMetadata
+from .term import (
+    IRI,
+    BlankNode,
+    Context,
+    DefaultGraph,
+    Literal,
+    Object,
+    Predicate,
+    Quad,
+    QuadResultSet,
+    Subject,
+    Triple,
+    Variable,
+)
 
 __all__ = [
     "Namespace",
     "RepositoryMetadata",
+    "IRI",
+    "BlankNode",
+    "Literal",
+    "DefaultGraph",
+    "Variable",
+    "Quad",
+    "Triple",
+    "Subject",
+    "Predicate",
+    "Object",
+    "Context",
+    "QuadResultSet",
 ]

rdf4j_python/model/term.py

@@ -18,3 +18,18 @@ Context: TypeAlias = IRI | BlankNode | DefaultGraph | None
 
 
 QuadResultSet: TypeAlias = og.QuadParser
+
+__all__ = [
+    "IRI",
+    "BlankNode",
+    "Literal",
+    "DefaultGraph",
+    "Variable",
+    "Quad",
+    "Triple",
+    "Subject",
+    "Predicate",
+    "Object",
+    "Context",
+    "QuadResultSet",
+]

{rdf4j_python-0.1.5.dist-info → rdf4j_python-0.2.0.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: rdf4j-python
-Version: 0.1.5
+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.2.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+rdf4j_python/__init__.py,sha256=ddmkZKSc_YLJIRVGAJeqIU0iqvLTFBReLNU2WHwH-kI,1581
+rdf4j_python/_client/__init__.py,sha256=L5q5RTHXCNyHp2WNP4xTemGXNntUW4RF_QJPoCWciUQ,98
+rdf4j_python/_client/_client.py,sha256=BY5G64aY65FFEriRO4E_hbCdV1HzjggTMdWRJyhVjLQ,11023
+rdf4j_python/_driver/__init__.py,sha256=wUFsKlqDedyyBpU-8LxtQP3tBGI12v7l20i_kgM_CM4,377
+rdf4j_python/_driver/_async_named_graph.py,sha256=BqJRpN-JzGpvlSnWY2RrM5TrnIHg6W4PortZ0y-4mgw,2685
+rdf4j_python/_driver/_async_rdf4j_db.py,sha256=h7JAxvNpJcz0aLO00IlUwYZPkm_mWyu5Jj7aQLSz3dY,5791
+rdf4j_python/_driver/_async_repository.py,sha256=-8d0ssNA-Iw-GrOid5s5sSSvNzQ1zRwAnLUmAg7hSEM,24505
+rdf4j_python/_driver/_async_transaction.py,sha256=nEY4t8SAujChAsg410SFwq1hlTrdycbeMjkCA60j4Cs,10574
+rdf4j_python/exception/__init__.py,sha256=R1ebBTPeEjjphPr3kiELttjqnrHr6g3Ktw6FuVdD9vY,724
+rdf4j_python/exception/repo_exception.py,sha256=nlkcR2E3FD3BAfQnZd6YXsYO7zzNiokRbDp90e1oCB8,1777
+rdf4j_python/model/__init__.py,sha256=v3ytMSrL4D4Ej1S2RFprj1xj7BWrUbq_NhbLdyzVIug,548
+rdf4j_python/model/_namespace.py,sha256=6iOvPc2Z6XFY44wmVucQCrjZbFuxdBtoTfDq_bSHJS0,3854
+rdf4j_python/model/_repository_info.py,sha256=fdKwjoQz6_D95Q8uZEuEYhXEUeqElsdBkHRCRRNxjzM,2010
+rdf4j_python/model/repository_config.py,sha256=USaWQ_C8UlnKSnL3coiXFly0TjOvapS6OMy3Nt9eVlg,22482
+rdf4j_python/model/term.py,sha256=BSK5ILBFrG6glb2TIKlTaVpP994V_C-XGQsLUwVRTF4,710
+rdf4j_python/model/vocabulary.py,sha256=Yam0F_YNlO-7wDi2fc0DkAqIKB4ZqCpqq56wKRrFAcw,307
+rdf4j_python/utils/__init__.py,sha256=LAyzkmO5QOIjJogQE1m4Eszwb2cCU8ytKRfhjAGoraw,34
+rdf4j_python/utils/const.py,sha256=HKH9ZGe7m_dvMx1RwT6zhu2HUkvwOX2Y4e8vQFs3uE8,849
+rdf4j_python/utils/helpers.py,sha256=4ubvrx3OV_0Y2_YECNIJhkJUB-JthdCJA8d6Hz_G_kE,506
+rdf4j_python-0.2.0.dist-info/licenses/LICENSE,sha256=sGjA7CzoCG1LVlkh0ZB76ZdgWHVpUFegLU41YYDkGIA,1499
+rdf4j_python-0.2.0.dist-info/METADATA,sha256=2o4BVtidPfxnPh9fMXXs3NnlJH4Jgl3vkquqSMp5ElY,10360
+rdf4j_python-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rdf4j_python-0.2.0.dist-info/top_level.txt,sha256=Lf2K8d8WcEkmvo5giLGuZ3gl20rNEwMssyAFBeVzbCs,13
+rdf4j_python-0.2.0.dist-info/RECORD,,

{rdf4j_python-0.1.5.dist-info → rdf4j_python-0.2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

rdf4j_python-0.1.5.dist-info/RECORD

@@ -1,23 +0,0 @@
-rdf4j_python/__init__.py,sha256=E8gojaWuLHo2AfNn5HBc5cF7K8_dK2jOBcZaH_qoZs4,347
-rdf4j_python/_client/__init__.py,sha256=L5q5RTHXCNyHp2WNP4xTemGXNntUW4RF_QJPoCWciUQ,98
-rdf4j_python/_client/_client.py,sha256=0jlxEdmg9uwoUYhaLJQq0zD21ZlqyoaAL4vkTa5dz3o,8083
-rdf4j_python/_driver/__init__.py,sha256=au0r15mQBVaJkqBknw9CoVswe7_rPPFs1wFWI_ttdy4,224
-rdf4j_python/_driver/_async_named_graph.py,sha256=BqJRpN-JzGpvlSnWY2RrM5TrnIHg6W4PortZ0y-4mgw,2685
-rdf4j_python/_driver/_async_rdf4j_db.py,sha256=POJ2-5EiyFOjX6ykjxbm0RH7yjtU6mXCY2PlVYidLDI,4497
-rdf4j_python/_driver/_async_repository.py,sha256=bNO4m_0u0uNjz14vXlsyzkVYLUy5cpCSNnvEZg4fG3o,15364
-rdf4j_python/exception/__init__.py,sha256=PFdUyIMsHIL5e2P2z33Qr2pwlUAJVI0G5T8114W4-1A,83
-rdf4j_python/exception/repo_exception.py,sha256=WXlfIYzOYfNU8LpwtOct9fAZADR-P3cZx4jAX9v_HaA,704
-rdf4j_python/model/__init__.py,sha256=wHboqZX2bN3AubXvWRwKOWwnrefpeiiB_nnry2Ba_a4,176
-rdf4j_python/model/_namespace.py,sha256=6iOvPc2Z6XFY44wmVucQCrjZbFuxdBtoTfDq_bSHJS0,3854
-rdf4j_python/model/_repository_info.py,sha256=fdKwjoQz6_D95Q8uZEuEYhXEUeqElsdBkHRCRRNxjzM,2010
-rdf4j_python/model/repository_config.py,sha256=USaWQ_C8UlnKSnL3coiXFly0TjOvapS6OMy3Nt9eVlg,22482
-rdf4j_python/model/term.py,sha256=JBxndQESR2KEY6y9s6TqoELUQaegKcIUO0ctR818QaA,508
-rdf4j_python/model/vocabulary.py,sha256=Yam0F_YNlO-7wDi2fc0DkAqIKB4ZqCpqq56wKRrFAcw,307
-rdf4j_python/utils/__init__.py,sha256=LAyzkmO5QOIjJogQE1m4Eszwb2cCU8ytKRfhjAGoraw,34
-rdf4j_python/utils/const.py,sha256=HKH9ZGe7m_dvMx1RwT6zhu2HUkvwOX2Y4e8vQFs3uE8,849
-rdf4j_python/utils/helpers.py,sha256=4ubvrx3OV_0Y2_YECNIJhkJUB-JthdCJA8d6Hz_G_kE,506
-rdf4j_python-0.1.5.dist-info/licenses/LICENSE,sha256=sGjA7CzoCG1LVlkh0ZB76ZdgWHVpUFegLU41YYDkGIA,1499
-rdf4j_python-0.1.5.dist-info/METADATA,sha256=cMzk7E91qtPK_l_8EQJbkDYOsN5twDUotZWcIHNyiIo,7968
-rdf4j_python-0.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rdf4j_python-0.1.5.dist-info/top_level.txt,sha256=Lf2K8d8WcEkmvo5giLGuZ3gl20rNEwMssyAFBeVzbCs,13
-rdf4j_python-0.1.5.dist-info/RECORD,,