rdf4j-python 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

rdf4j_python/model/term.py

@@ -0,0 +1,14 @@
+from typing import Optional, Tuple, TypeAlias
+
+from rdflib import URIRef as _URIRef
+from rdflib.term import IdentifiedNode, Node
+
+IRI: TypeAlias = _URIRef
+
+
+Subject: TypeAlias = Node
+Predicate: TypeAlias = Node
+Object: TypeAlias = Node
+Context: TypeAlias = Optional[IdentifiedNode]
+
+RDFStatement: TypeAlias = Tuple[Subject, Predicate, Object, Context]

rdf4j_python/model/vocabulary.py

@@ -0,0 +1,6 @@
+from rdf4j_python.model import Namespace
+
+# Common namespaces
+RDF = Namespace("rdf", "http://www.w3.org/1999/02/22-rdf-syntax-ns#")
+RDFS = Namespace("rdfs", "http://www.w3.org/2000/01/rdf-schema#")
+EXAMPLE = Namespace("ex", "http://example.org/")

rdf4j_python/utils/__init__.py

@@ -0,0 +1,3 @@
+"""
+RDF4J Python Utils Module
+"""

rdf4j_python/utils/const.py

@@ -12,11 +12,11 @@ class Rdf4jContentType(str, Enum):
     RDF_XML = "application/rdf+xml"
     RDF_JSON = "application/rdf+json"
     LD_JSON = "application/ld+json"
-    NTRIPLES = "text/plain"
+    NTRIPLES = "application/n-triples"
     TURTLE = "text/turtle"
-    N3 = "text/rdf+n3"
-    NQUADS = "text/x-nquads"
-    TRIG = "application/x-trig"
+    N3 = "text/n3"
+    NQUADS = "application/n-quads"
+    TRIG = "application/trig"
     TRIX = "application/trix"
     BINARY_RDF = "application/x-binary-rdf"
 

rdf4j_python/utils/helpers.py

@@ -0,0 +1,22 @@
+from typing import Iterable
+
+from rdf4j_python.model.term import RDFStatement
+
+
+def serialize_statements(statements: Iterable[RDFStatement]) -> str:
+    """Serializes statements to RDF data.
+
+    Args:
+        statements (Iterable[RDFStatement]): RDF statements.
+
+    Returns:
+        str: Serialized RDF data.
+    """
+    lines = []
+    for subj, pred, obj, ctx in statements:
+        parts = [subj.n3(), pred.n3(), obj.n3()]
+        if ctx:
+            parts.append(ctx.n3())
+        parts.append(".")
+        lines.append(" ".join(parts))
+    return "\n".join(lines) + "\n"

rdf4j_python-0.1.2.dist-info/METADATA

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: rdf4j-python
+Version: 0.1.2
+Summary: The Python client for RDF4J
+Author-email: Chengxu Bian <cbian564@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: rdflib>=7.1.4
+Dynamic: license-file
+
+# 🐍 rdf4j-python
+
+**A Pythonic interface to the powerful Java-based [Eclipse RDF4J](https://rdf4j.org/) framework.**
+
+> ⚠️ **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!
+
+✅ **Supports both asynchronous (`async/await`) and synchronous programming styles.**
+
+## 🌐 Overview
+
+`rdf4j-python` bridges the gap between Python applications and the [Eclipse RDF4J](https://rdf4j.org/) framework, enabling seamless interaction with RDF4J repositories directly from Python. This integration allows developers to leverage RDF4J's robust capabilities for managing RDF data and executing SPARQL queries without leaving the Python ecosystem.
+
+## 🚀 Features
+
+- **Seamless Integration**: Interact with RDF4J repositories using Pythonic constructs.
+- **SPARQL Support**: Execute SPARQL queries and updates effortlessly.
+- **Repository Management**: Create, access, and manage RDF4J repositories programmatically.
+- **Data Handling**: Add and retrieve RDF triples with ease.
+- **Format Flexibility**: Support for various RDF serialization formats.
+
+## 📦 Installation
+
+Install via pip:
+
+```bash
+pip install rdf4j-python
+```
+
+## 🧪 Usage (Async)
+
+Here's a basic example of how to use `rdf4j-python` to create an in-memory sail repository
+
+```python
+async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+    repo_config = (
+        RepositoryConfig.Builder()
+        .repo_id("example-repo")
+        .title("Example Repository")
+        .sail_repository_impl(
+            MemoryStoreConfig.Builder().persist(False).build(),
+        )
+        .build()
+    )
+    repo = await db.create_repository(config=repo_config)
+    await repo.add_statement(
+        IRI("http://example.com/subject"),
+        IRI("http://example.com/predicate"),
+        Literal("test_object"),
+    )
+    await repo.get_statements(subject=IRI("http://example.com/subject"))
+```
+
+For more detailed examples, refer to the [examples](https://github.com/odysa/rdf4j-python/tree/main/examples) directory.
+
+## 🤝 Contributing
+
+We welcome contributions and feedback! If you'd like to help improve this project:
+
+- Fork the repo and submit a pull request
+- Open an issue for bugs, feature ideas, or discussions
+- ⭐ Star the repo if you find it useful!
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](https://github.com/odysa/rdf4j-python/blob/main/LICENSE) file for details.

rdf4j_python-0.1.2.dist-info/RECORD

@@ -0,0 +1,25 @@
+rdf4j_python/__init__.py,sha256=E8gojaWuLHo2AfNn5HBc5cF7K8_dK2jOBcZaH_qoZs4,347
+rdf4j_python/_client/__init__.py,sha256=L5q5RTHXCNyHp2WNP4xTemGXNntUW4RF_QJPoCWciUQ,98
+rdf4j_python/_client/_client.py,sha256=JfHFudRDVkzmb_jWx1u2meqqFONImBQHuaoYkb4mWPc,7390
+rdf4j_python/_driver/__init__.py,sha256=au0r15mQBVaJkqBknw9CoVswe7_rPPFs1wFWI_ttdy4,224
+rdf4j_python/_driver/_async_named_graph.py,sha256=zpYr6x_9aI2wHH0Pj71LlCKkHFFanz7G77Tz5azXlg4,2642
+rdf4j_python/_driver/_async_rdf4j_db.py,sha256=u6r4A4_CTp4JMEswl0I5rMjsuWnMkQV_TJrvF6u9R94,4403
+rdf4j_python/_driver/_async_repository.py,sha256=NKM9IFLTNMepVCx_UeWc7h0BTxHMKfDnUcThz97pVCs,14075
+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=eUvfFEPgDsbq37eIpd_dlvjpQPGuRwkKWNfqa0c2QwM,231
+rdf4j_python/model/_base_model.py,sha256=PyhvLhaseKaFuRU70xord8EgIfO88-UVcllkuRobE14,1780
+rdf4j_python/model/_dataset.py,sha256=-nYTm8Fz1CGsLL2ykmtGEJ9Jv4u8FC2Dgl_31LeoGhM,1065
+rdf4j_python/model/_namespace.py,sha256=yaH-MjMFsUfCFadlo25MgHf9zaRbk-wkn_BgtmemVo4,3259
+rdf4j_python/model/_repository_info.py,sha256=zSL3o_QWL06xYbnpFtXIg-PqFiRbwDFPb1aiy2JufYQ,1668
+rdf4j_python/model/repository_config.py,sha256=WPXJAbZ2pM594Uh_r3zI6N1fqObSsk74ArVZTTdqPks,55012
+rdf4j_python/model/term.py,sha256=FkK8-HG6h79dAYO_qiTYTxvu8t-d5zVY5FtgJrW997o,352
+rdf4j_python/model/vocabulary.py,sha256=R9k9dzDPwRBEgwjIF6sNZh3hL41R7GZ1eSJKb8w7IaY,247
+rdf4j_python/utils/__init__.py,sha256=LAyzkmO5QOIjJogQE1m4Eszwb2cCU8ytKRfhjAGoraw,34
+rdf4j_python/utils/const.py,sha256=HKH9ZGe7m_dvMx1RwT6zhu2HUkvwOX2Y4e8vQFs3uE8,849
+rdf4j_python/utils/helpers.py,sha256=xnMB_imsybGQ2GiHvXK4wEpcs4ADiqZ4ez0yop_ko8E,577
+rdf4j_python-0.1.2.dist-info/licenses/LICENSE,sha256=sGjA7CzoCG1LVlkh0ZB76ZdgWHVpUFegLU41YYDkGIA,1499
+rdf4j_python-0.1.2.dist-info/METADATA,sha256=7V13OG7A4fxFPLcwbIUjsqUCVDwC1dlqXE5YSHw7PbU,2852
+rdf4j_python-0.1.2.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+rdf4j_python-0.1.2.dist-info/top_level.txt,sha256=Lf2K8d8WcEkmvo5giLGuZ3gl20rNEwMssyAFBeVzbCs,13
+rdf4j_python-0.1.2.dist-info/RECORD,,

{rdf4j_python-0.1.0.dist-info → rdf4j_python-0.1.2.dist-info}/WHEEL

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

rdf4j_python-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Chengxu Bian
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

rdf4j_python-0.1.0.dist-info/METADATA

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: rdf4j-python
-Version: 0.1.0
-Summary: The Python client for RDF4J
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: rdflib>=7.1.4

rdf4j_python-0.1.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-rdf4j_python/__init__.py,sha256=-Ux0t15UPMS7zpvvedvR2xs8wtY5k_TiY74YdExI2PY,203
-rdf4j_python/_client/__init__.py,sha256=L5q5RTHXCNyHp2WNP4xTemGXNntUW4RF_QJPoCWciUQ,98
-rdf4j_python/_client/_client.py,sha256=gBuw0tfV18SXUmoh4JgJcaa-RwxkGejm2LnQwYlbmIo,3105
-rdf4j_python/_driver/__init__.py,sha256=ryxQ9zig30THoIFcFvSYouof7OEvoeaven15gzQqUZY,147
-rdf4j_python/_driver/_async_rdf4j_db.py,sha256=nUYXhZ2ku8ibRfPjveEv246P86-eXYiRS_u2-uRP-0U,3361
-rdf4j_python/_driver/_async_repository.py,sha256=xTaR8RJdnQFZ4s43KXRm7rr9YNQO8_Me2S6CGjSRYIk,2132
-rdf4j_python/exception/repo_exception.py,sha256=-PMWkw1ieOeSCHt1jHwIFHQsrXJn3KGsBWIn58-833w,102
-rdf4j_python/model/_base_model.py,sha256=YOcgb83NfObDlrj7-d8f3yg1ZJGzkKs4blI7wOYb4LA,812
-rdf4j_python/model/repository.py,sha256=LLKJnCer9dRDs-aS_Fyn3vKfmmRbmWguLuJlxvCWTro,1368
-rdf4j_python/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rdf4j_python/utils/const.py,sha256=awf0oGwDs54K02v2GPl2vTgUvrjG0YbX6cAUfXFMsug,838
-rdf4j_python-0.1.0.dist-info/METADATA,sha256=HNAT_i0qrKvFotzwclMSoIA8R7Ct9MHEB1DF7fAco-Y,215
-rdf4j_python-0.1.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-rdf4j_python-0.1.0.dist-info/top_level.txt,sha256=Lf2K8d8WcEkmvo5giLGuZ3gl20rNEwMssyAFBeVzbCs,13
-rdf4j_python-0.1.0.dist-info/RECORD,,