rdf-construct 0.2.1__tar.gz → 0.4.0__tar.gz

{rdf_construct-0.2.1 → rdf_construct-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdf-construct
-Version: 0.2.1
+Version: 0.4.0
 Summary: Semantic RDF manipulation toolkit - order, serialize, and diff RDF ontologies
 License-Expression: MIT
 License-File: LICENSE
@@ -10,7 +10,7 @@ Author-email: 23141680+aigora-de@users.noreply.github.com
 Maintainer: Dave Dyke
 Maintainer-email: 23141680+aigora-de@users.noreply.github.com
 Requires-Python: >=3.10
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Information Technology
@@ -50,16 +50,22 @@ Description-Content-Type: text/markdown
 ## Features
 
 - **Semantic Ordering**: Serialise RDF/Turtle with intelligent ordering instead of alphabetical chaos
+- **Ontology Description**: Quick orientation to unfamiliar ontologies with profile detection
 - **Documentation Generation**: Create navigable HTML, Markdown, or JSON documentation from ontologies
 - **UML Generation**: Create PlantUML class diagrams from RDF ontologies
 - **PUML2RDF**: Convert PlantUML diagrams to RDF/OWL ontologies (diagram-first design)
 - **SHACL Generation**: Generate SHACL validation shapes from OWL definitions
 - **Semantic Diff**: Compare ontology versions and identify meaningful changes
+- **Ontology Merging**: Combine multiple ontologies with conflict detection and data migration
+- **Ontology Splitting**: Split monolithic ontologies into modules with dependency tracking
+- **Ontology Refactoring**: Rename URIs and deprecate entities with OWL annotations
+- **Multi-Language Support**: Extract, translate, and merge translations for internationalised ontologies
 - **Ontology Linting**: Check quality with 11 configurable rules
 - **Competency Question Testing**: Validate ontologies against SPARQL-based tests
 - **Ontology Statistics**: Comprehensive metrics with comparison mode
 - **Flexible Styling**: Configure colours, layouts, and visual themes for diagrams
 - **Profile-Based**: Define multiple strategies in YAML configuration
+- **Multi-Format Input**: Supports Turtle, RDF/XML, JSON-LD, N-Triples
 - **Deterministic**: Same input + profile = same output, always
 
 ## Why?
@@ -89,6 +95,19 @@ pip install -e .
 poetry install
 ```
 
+### Describe an Ontology
+
+```bash
+# Quick orientation to an unfamiliar ontology
+rdf-construct describe ontology.ttl
+
+# Brief summary (metadata + metrics + profile)
+rdf-construct describe ontology.ttl --brief
+
+# JSON output for scripting
+rdf-construct describe ontology.ttl --format json
+```
+
 ### Compare Ontology Versions
 
 ```bash
@@ -177,20 +196,80 @@ rdf-construct stats ontology.ttl
 rdf-construct stats v1.ttl v2.ttl --compare --format markdown
 ```
 
+### Merge Ontologies
+
+```bash
+# Basic merge
+rdf-construct merge core.ttl extension.ttl -o merged.ttl
+
+# With priorities (higher wins conflicts)
+rdf-construct merge core.ttl extension.ttl -o merged.ttl -p 1 -p 2
+
+# Generate conflict report
+rdf-construct merge core.ttl extension.ttl -o merged.ttl --report conflicts.md
+```
+
+### Split Ontologies
+```bash
+# Split by namespace (auto-detect modules)
+rdf-construct split large.ttl -o modules/ --by-namespace
+
+# Split with configuration file
+rdf-construct split large.ttl -o modules/ -c split.yml
+
+# Preview what would be created
+rdf-construct split large.ttl -o modules/ --by-namespace --dry-run
+```
+
+### Refactor Ontologies
+```bash
+# Fix a typo
+rdf-construct refactor rename ontology.ttl \
+    --from "ex:Buiding" --to "ex:Building" -o fixed.ttl
+
+# Bulk namespace change
+rdf-construct refactor rename ontology.ttl \
+    --from-namespace "http://old/" --to-namespace "http://new/" -o migrated.ttl
+
+# Deprecate an entity with replacement
+rdf-construct refactor deprecate ontology.ttl \
+    --entity "ex:LegacyClass" --replaced-by "ex:NewClass" \
+    --message "Use NewClass instead." -o updated.ttl
+
+# Preview changes
+rdf-construct refactor rename ontology.ttl --from "ex:Old" --to "ex:New" --dry-run
+```
+
+### Multi-Language Translations
+```bash
+# Extract strings for German translation
+rdf-construct localise extract ontology.ttl --language de -o translations/de.yml
+
+# Merge completed translations
+rdf-construct localise merge ontology.ttl translations/de.yml -o localised.ttl
+
+# Check translation coverage
+rdf-construct localise report ontology.ttl --languages en,de,fr
+```
+
 ## Documentation
 
 📚 **[Complete Documentation](docs/index.md)** - Start here
 
 **For Users**:
 - [Getting Started](docs/user_guides/GETTING_STARTED.md) - 5-minute quick start
+- [Describe Guide](docs/user_guides/DESCRIBE_GUIDE.md) - Quick ontology orientation
 - [Docs Guide](docs/user_guides/DOCS_GUIDE.md) - Documentation generation
 - [UML Guide](docs/user_guides/UML_GUIDE.md) - Complete UML features
-- [PlantUML Import Guide](docs/user_guides/PLANTUML_IMPORT_GUIDE.md) - Diagram-first design
+- [PUML2RDF Guide](docs/user_guides/PUML2RDF_GUIDE.md) - Diagram-first design
 - [SHACL Guide](docs/user_guides/SHACL_GUIDE.md) - SHACL shape generation
 - [Diff Guide](docs/user_guides/DIFF_GUIDE.md) - Semantic ontology comparison
 - [Lint Guide](docs/user_guides/LINT_GUIDE.md) - Ontology quality checking
 - [CQ Testing Guide](docs/user_guides/CQ_TEST_GUIDE.md) - Competency question testing
 - [Stats Guide](docs/user_guides/STATS_GUIDE.md) - Ontology metrics
+- [Merge & Split Guide](docs/user_guides/MERGE_SPLIT_GUIDE.md) - Combining and modularising ontologies
+- [Refactor Guide](docs/user_guides/REFACTOR_GUIDE.md) - Renaming and deprecation
+- [Localise Guide](docs/user_guides/LOCALISE_GUIDE.md) - Multi-language translations
 - [CLI Reference](docs/user_guides/CLI_REFERENCE.md) - All commands and options
 
 **For Developers**:
@@ -346,7 +425,7 @@ properties:
 
 ## Project Status
 
-**Current**: v0.2.0 - Feature complete for core ontology workflows  
+**Current**: v0.4.0 - Feature complete for core ontology workflows  
 **License**: MIT
 
 ### Implemented
@@ -362,10 +441,15 @@ properties:
 ✅ Ontology linting (11 rules)  
 ✅ Competency question testing  
 ✅ Ontology statistics  
+✅ Ontology merging and splitting  
+✅ Ontology refactoring (rename, deprecate)  
+✅ Multi-language translation management  
+✅ Ontology description and profile detection  
+✅ Multi-format input support (Turtle, RDF/XML, JSON-LD, N-Triples)  
 ✅ Comprehensive documentation
 
 ### (Possible) Roadmap
-- [ ] Multi-format input support (JSON-LD, RDF/XML)
+- [ ] OWL 2 named profile detection (EL, RL, QL)
 - [ ] Streaming mode for very large graphs
 - [ ] Web UI for diagram configuration
 - [ ] Additional lint rules
@@ -428,6 +512,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**Status**: v0.2.0  
+**Status**: v0.4.0  
 **Python**: 3.10+ required  
 **Maintainer**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+

{rdf_construct-0.2.1 → rdf_construct-0.4.0}/README.md

@@ -12,16 +12,22 @@
 ## Features
 
 - **Semantic Ordering**: Serialise RDF/Turtle with intelligent ordering instead of alphabetical chaos
+- **Ontology Description**: Quick orientation to unfamiliar ontologies with profile detection
 - **Documentation Generation**: Create navigable HTML, Markdown, or JSON documentation from ontologies
 - **UML Generation**: Create PlantUML class diagrams from RDF ontologies
 - **PUML2RDF**: Convert PlantUML diagrams to RDF/OWL ontologies (diagram-first design)
 - **SHACL Generation**: Generate SHACL validation shapes from OWL definitions
 - **Semantic Diff**: Compare ontology versions and identify meaningful changes
+- **Ontology Merging**: Combine multiple ontologies with conflict detection and data migration
+- **Ontology Splitting**: Split monolithic ontologies into modules with dependency tracking
+- **Ontology Refactoring**: Rename URIs and deprecate entities with OWL annotations
+- **Multi-Language Support**: Extract, translate, and merge translations for internationalised ontologies
 - **Ontology Linting**: Check quality with 11 configurable rules
 - **Competency Question Testing**: Validate ontologies against SPARQL-based tests
 - **Ontology Statistics**: Comprehensive metrics with comparison mode
 - **Flexible Styling**: Configure colours, layouts, and visual themes for diagrams
 - **Profile-Based**: Define multiple strategies in YAML configuration
+- **Multi-Format Input**: Supports Turtle, RDF/XML, JSON-LD, N-Triples
 - **Deterministic**: Same input + profile = same output, always
 
 ## Why?
@@ -51,6 +57,19 @@ pip install -e .
 poetry install
 ```
 
+### Describe an Ontology
+
+```bash
+# Quick orientation to an unfamiliar ontology
+rdf-construct describe ontology.ttl
+
+# Brief summary (metadata + metrics + profile)
+rdf-construct describe ontology.ttl --brief
+
+# JSON output for scripting
+rdf-construct describe ontology.ttl --format json
+```
+
 ### Compare Ontology Versions
 
 ```bash
@@ -139,20 +158,80 @@ rdf-construct stats ontology.ttl
 rdf-construct stats v1.ttl v2.ttl --compare --format markdown
 ```
 
+### Merge Ontologies
+
+```bash
+# Basic merge
+rdf-construct merge core.ttl extension.ttl -o merged.ttl
+
+# With priorities (higher wins conflicts)
+rdf-construct merge core.ttl extension.ttl -o merged.ttl -p 1 -p 2
+
+# Generate conflict report
+rdf-construct merge core.ttl extension.ttl -o merged.ttl --report conflicts.md
+```
+
+### Split Ontologies
+```bash
+# Split by namespace (auto-detect modules)
+rdf-construct split large.ttl -o modules/ --by-namespace
+
+# Split with configuration file
+rdf-construct split large.ttl -o modules/ -c split.yml
+
+# Preview what would be created
+rdf-construct split large.ttl -o modules/ --by-namespace --dry-run
+```
+
+### Refactor Ontologies
+```bash
+# Fix a typo
+rdf-construct refactor rename ontology.ttl \
+    --from "ex:Buiding" --to "ex:Building" -o fixed.ttl
+
+# Bulk namespace change
+rdf-construct refactor rename ontology.ttl \
+    --from-namespace "http://old/" --to-namespace "http://new/" -o migrated.ttl
+
+# Deprecate an entity with replacement
+rdf-construct refactor deprecate ontology.ttl \
+    --entity "ex:LegacyClass" --replaced-by "ex:NewClass" \
+    --message "Use NewClass instead." -o updated.ttl
+
+# Preview changes
+rdf-construct refactor rename ontology.ttl --from "ex:Old" --to "ex:New" --dry-run
+```
+
+### Multi-Language Translations
+```bash
+# Extract strings for German translation
+rdf-construct localise extract ontology.ttl --language de -o translations/de.yml
+
+# Merge completed translations
+rdf-construct localise merge ontology.ttl translations/de.yml -o localised.ttl
+
+# Check translation coverage
+rdf-construct localise report ontology.ttl --languages en,de,fr
+```
+
 ## Documentation
 
 📚 **[Complete Documentation](docs/index.md)** - Start here
 
 **For Users**:
 - [Getting Started](docs/user_guides/GETTING_STARTED.md) - 5-minute quick start
+- [Describe Guide](docs/user_guides/DESCRIBE_GUIDE.md) - Quick ontology orientation
 - [Docs Guide](docs/user_guides/DOCS_GUIDE.md) - Documentation generation
 - [UML Guide](docs/user_guides/UML_GUIDE.md) - Complete UML features
-- [PlantUML Import Guide](docs/user_guides/PLANTUML_IMPORT_GUIDE.md) - Diagram-first design
+- [PUML2RDF Guide](docs/user_guides/PUML2RDF_GUIDE.md) - Diagram-first design
 - [SHACL Guide](docs/user_guides/SHACL_GUIDE.md) - SHACL shape generation
 - [Diff Guide](docs/user_guides/DIFF_GUIDE.md) - Semantic ontology comparison
 - [Lint Guide](docs/user_guides/LINT_GUIDE.md) - Ontology quality checking
 - [CQ Testing Guide](docs/user_guides/CQ_TEST_GUIDE.md) - Competency question testing
 - [Stats Guide](docs/user_guides/STATS_GUIDE.md) - Ontology metrics
+- [Merge & Split Guide](docs/user_guides/MERGE_SPLIT_GUIDE.md) - Combining and modularising ontologies
+- [Refactor Guide](docs/user_guides/REFACTOR_GUIDE.md) - Renaming and deprecation
+- [Localise Guide](docs/user_guides/LOCALISE_GUIDE.md) - Multi-language translations
 - [CLI Reference](docs/user_guides/CLI_REFERENCE.md) - All commands and options
 
 **For Developers**:
@@ -308,7 +387,7 @@ properties:
 
 ## Project Status
 
-**Current**: v0.2.0 - Feature complete for core ontology workflows  
+**Current**: v0.4.0 - Feature complete for core ontology workflows  
 **License**: MIT
 
 ### Implemented
@@ -324,10 +403,15 @@ properties:
 ✅ Ontology linting (11 rules)  
 ✅ Competency question testing  
 ✅ Ontology statistics  
+✅ Ontology merging and splitting  
+✅ Ontology refactoring (rename, deprecate)  
+✅ Multi-language translation management  
+✅ Ontology description and profile detection  
+✅ Multi-format input support (Turtle, RDF/XML, JSON-LD, N-Triples)  
 ✅ Comprehensive documentation
 
 ### (Possible) Roadmap
-- [ ] Multi-format input support (JSON-LD, RDF/XML)
+- [ ] OWL 2 named profile detection (EL, RL, QL)
 - [ ] Streaming mode for very large graphs
 - [ ] Web UI for diagram configuration
 - [ ] Additional lint rules
@@ -390,6 +474,6 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**Status**: v0.2.0  
+**Status**: v0.4.0  
 **Python**: 3.10+ required  
-**Maintainer**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+**Maintainer**: See [CONTRIBUTING.md](CONTRIBUTING.md)

{rdf_construct-0.2.1 → rdf_construct-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "rdf-construct"
-version = "0.2.1"
+version = "0.4.0"
 description = "Semantic RDF manipulation toolkit - order, serialize, and diff RDF ontologies"
 license = "MIT"
 readme = "README.md"
@@ -29,7 +29,7 @@ keywords = [
     "sparql",
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
     "Intended Audience :: Information Technology",

{rdf_construct-0.2.1 → rdf_construct-0.4.0}/src/rdf_construct/__init__.py

@@ -4,7 +4,7 @@ Named after the ROM construct from William Gibson's Neuromancer -
 preserved, structured knowledge that can be queried and transformed.
 """
 
-__version__ = "0.2.1"
+__version__ = "0.4.0"
 
 from . import core, uml
 from .cli import cli