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

rdf4j_python-0.1.5.dist-info/METADATA

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: rdf4j-python
+Version: 0.1.5
+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: pyoxigraph>=0.4.10
+Provides-Extra: sparqlwrapper
+Requires-Dist: sparqlwrapper>=2.0.0; extra == "sparqlwrapper"
+Dynamic: license-file
+
+# rdf4j-python
+
+**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
+
+## Installation
+
+### Prerequisites
+
+- Python 3.10 or higher
+- RDF4J Server (for remote repositories) or embedded usage
+
+### Install from PyPI
+
+```bash
+pip install rdf4j-python
+```
+
+### Install with Optional Dependencies
+
+```bash
+# Include SPARQLWrapper integration
+pip install rdf4j-python[sparqlwrapper]
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/odysa/rdf4j-python.git
+cd rdf4j-python
+uv sync --group dev
+```
+
+## Usage
+
+### Quick Start
+
+```python
+import asyncio
+from rdf4j_python import AsyncRdf4j
+from rdf4j_python.model.repository_config import RepositoryConfig, MemoryStoreConfig, SailRepositoryConfig
+from rdf4j_python.model.term import IRI, Literal
+
+async def main():
+    # Connect to RDF4J server
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        # Create an in-memory repository
+        config = RepositoryConfig(
+            repo_id="my-repo",
+            title="My Repository",
+            impl=SailRepositoryConfig(sail_impl=MemoryStoreConfig(persist=False))
+        )
+        repo = await db.create_repository(config=config)
+        
+        # Add some data
+        await repo.add_statement(
+            IRI("http://example.com/person/alice"),
+            IRI("http://xmlns.com/foaf/0.1/name"),
+            Literal("Alice")
+        )
+        
+        # Query the data
+        results = await repo.query("SELECT * WHERE { ?s ?p ?o }")
+        for result in results:
+            print(f"Subject: {result['s']}, Predicate: {result['p']}, Object: {result['o']}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### Working with Multiple Graphs
+
+```python
+from rdf4j_python.model.term import Quad
+
+async def multi_graph_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        repo = await db.get_repository("my-repo")
+        
+        # Add data to specific graphs
+        statements = [
+            Quad(
+                IRI("http://example.com/person/bob"),
+                IRI("http://xmlns.com/foaf/0.1/name"),
+                Literal("Bob"),
+                IRI("http://example.com/graph/people")
+            ),
+            Quad(
+                IRI("http://example.com/person/bob"),
+                IRI("http://xmlns.com/foaf/0.1/age"),
+                Literal("30", datatype=IRI("http://www.w3.org/2001/XMLSchema#integer")),
+                IRI("http://example.com/graph/demographics")
+            )
+        ]
+        await repo.add_statements(statements)
+        
+        # Query specific graph
+        graph_query = """
+        SELECT * WHERE {
+            GRAPH <http://example.com/graph/people> {
+                ?person ?property ?value
+            }
+        }
+        """
+        results = await repo.query(graph_query)
+```
+
+### Advanced Repository Configuration
+
+Here's a more comprehensive example showing repository creation with different configurations:
+
+```python
+async def advanced_example():
+    async with AsyncRdf4j("http://localhost:19780/rdf4j-server") as db:
+        # Memory store with persistence
+        persistent_config = RepositoryConfig(
+            repo_id="persistent-repo",
+            title="Persistent Memory Store",
+            impl=SailRepositoryConfig(sail_impl=MemoryStoreConfig(persist=True))
+        )
+        
+        # Create and populate repository
+        repo = await db.create_repository(config=persistent_config)
+        
+        # Bulk data operations
+        data = [
+            (IRI("http://example.com/alice"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Alice")),
+            (IRI("http://example.com/alice"), IRI("http://xmlns.com/foaf/0.1/email"), Literal("alice@example.com")),
+            (IRI("http://example.com/bob"), IRI("http://xmlns.com/foaf/0.1/name"), Literal("Bob")),
+        ]
+        
+        statements = [
+            Quad(subj, pred, obj, IRI("http://example.com/default"))
+            for subj, pred, obj in data
+        ]
+        await repo.add_statements(statements)
+        
+        # Complex SPARQL query
+        query = """
+        PREFIX foaf: <http://xmlns.com/foaf/0.1/>
+        SELECT ?name ?email WHERE {
+            ?person foaf:name ?name .
+            OPTIONAL { ?person foaf:email ?email }
+        }
+        ORDER BY ?name
+        """
+        results = await repo.query(query)
+```
+
+For more detailed examples, see the [examples](examples/) directory.
+
+## Development
+
+### Setting up Development Environment
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/odysa/rdf4j-python.git
+   cd rdf4j-python
+   ```
+
+2. **Install development dependencies**:
+   ```bash
+   uv sync --group dev
+   ```
+
+3. **Start RDF4J Server** (for integration tests):
+   ```bash
+   # Using Docker
+   docker run -p 19780:8080 eclipse/rdf4j:latest
+   ```
+
+4. **Run tests**:
+   ```bash
+   pytest tests/
+   ```
+
+5. **Run linting**:
+   ```bash
+   ruff check .
+   ruff format .
+   ```
+
+### Project Structure
+
+```
+rdf4j_python/
+├── _driver/          # Core async driver implementation
+├── model/            # Data models and configurations
+├── exception/        # Custom exceptions
+└── utils/           # Utility functions
+
+examples/            # Usage examples
+tests/              # Test suite
+docs/               # Documentation
+```
+
+### 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
+
+### Running Examples
+
+```bash
+# Make sure RDF4J server is running on localhost:19780
+python examples/complete_workflow.py
+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.
+
+```
+Copyright (c) 2025, Chengxu Bian
+All rights reserved.
+```
+
+---
+
+**Questions or Issues?** Please feel free to [open an issue](https://github.com/odysa/rdf4j-python/issues) on GitHub.
+
+**⭐ Star this repo** if you find it useful!

{rdf4j_python-0.1.3.dist-info → rdf4j_python-0.1.5.dist-info}/RECORD

@@ -1,23 +1,23 @@
 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/_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=LkeLwLhp_lSYhrJVY98LHv9V4jkxF0U5RWQiZmVI9zw,4435
-rdf4j_python/_driver/_async_repository.py,sha256=E6DfW05LFh5KY2X081tW9gg1ksr7DyiM90_j29v71VQ,14212
+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=Uawni9kTjUpH3gCXQxh026NJaGVaJxDd5M-A5U9Ho_4,56654
+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.3.dist-info/licenses/LICENSE,sha256=sGjA7CzoCG1LVlkh0ZB76ZdgWHVpUFegLU41YYDkGIA,1499
-rdf4j_python-0.1.3.dist-info/METADATA,sha256=Qo5X3u9Mw5r3ABzTmHzlUEEfO01DEsFm_BL2tyfWmAU,2857
-rdf4j_python-0.1.3.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-rdf4j_python-0.1.3.dist-info/top_level.txt,sha256=Lf2K8d8WcEkmvo5giLGuZ3gl20rNEwMssyAFBeVzbCs,13
-rdf4j_python-0.1.3.dist-info/RECORD,,
+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,,

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

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

rdf4j_python-0.1.3.dist-info/METADATA

@@ -1,77 +0,0 @@
-Metadata-Version: 2.4
-Name: rdf4j-python
-Version: 0.1.3
-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: pyoxigraph>=0.4.10
-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.