Initials of the project requires a lot of changes, I'd understand if you'd only like to apply a rough review. Thanks for your patience.

Rough summary of changes

plow_cli

• Error handling and reporting system implemented
• Code base modularized
• Sub commands are unified
• Improvements to sub commands
• Harriet updated

plow_linter

• Reform architecture
• Implement performance improvements
• Lay out ideas for possible future performance improvements
• Harriet updated

plow_package_management

• Minor updates to types and tests to be more useful for our backend
• Harriet updated

plow_graphify

• Harriet updated

plow_ontology

• Removed ontology initialization (for now it is part of the CLI)
• Harriet updated

As always thanks for your review. 🙏

Aggregate PR for adding initialization and protege functionalities. This is meant to be the last PR with large scope and fast development. A refactoring PRs will follow and a proper CI will be implemented following this.

Certain validations and lints are required for the standardization of fields in our plow remote registry. This PR attempts to add the initial necessary lints to resolve this issue.

Here is the list of lints added and updated which could be found in plow_linter/src/lints directory.

• has_rdfs_comment_manifest_context
• has_rdfs_label_manifest_context
• has_registry_author
• has_registry_category
• has_registry_keyword
• has_registry_license
• has_registry_license_spdx
• has_registry_short_description
• valid_rdfs_labels
• valid_registry_documentation
• valid_registry_homepage
• valid_registry_repository

plow_linter/tests/ directory could be also checked to understand how lints behave to different valid and invalid input.

The lints are concerned about certain fields in plow compliant ontologies.

An example of a compliant blank ontology file annotated with comments is given to understand the context better.

@prefix : <http://field33.com/ontologies/@fld33/test/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix xml: <http://www.w3.org/XML/1998/namespace> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix registry: <http://field33.com/ontologies/REGISTRY/> .
@base <http://field33.com/ontologies/@fld33/test/> .

<http://field33.com/ontologies/@fld33/test/> rdf:type owl:Ontology ;
                                                                          owl:imports <http://field33.com/ontologies/@fld33/communication/> ,
                                                                                      <http://field33.com/ontologies/@fld33/organization/> ;
                                                                          
                                                                          # Optional in plow registry
                                                                          registry:canonicalPrefix "test" ;
    
                                                                          # Required in plow registry
                                                                          # Multiple authors can be specified
                                                                          # The format is like the example
                                                                          # Authors shouldn't be annotated by a language tag
                                                                          registry:author "Miles Davis <[email protected]>" ,
                                                                                                    "Joe Pass <[email protected]>" ;
     
                                                                          # Plow defines a finite set of categories to use
                                                                          # Maximum 5 categories are allowed
                                                                          # Categories shouldn't be annotated by a language tag
                                                                          registry:category "Communication" ,
                                                                                            "Organization" ,
                                                                                            "Upper Ontology";
                                                                          
                                                                          # Dependencies are optional in plow registry
                                                                          registry:dependency "@fld33/communication ^0.1.0" ,
                                                                                              "@fld33/organization ^0.1.1" ;
                                                                          
                                                                          # Keywords could be used freely and will be used for indexing in search
                                                                          # Maximum 5 keywords are allowed
                                                                          # Keywords shouldn't be annotated by a language tag
                                                                          registry:keyword "Communication" ,
                                                                                           "Field 33 Package" ,
                                                                                           "Organization" ,
                                                                                           "Upper Ontology";
                                                                          
                                                                          # Having at least one license related annotation is required for plow 
                                                                          # Using registry:licenseSPDX is advised
                                                                          registry:license "MIT License";
                                                                          registry:licenseSPDX  "MIT";
                                                                
                                                                          # Optional for plow registry
                                                                          registry:homepage  "https://field33.com";
                                                                          
                                                                          # Optional for plow registry
                                                                          registry:documentation  "https://field33.com";
                                                                          
                                                                          # Required for plow registry
                                                                          registry:ontologyFormatVersion "v1" ;
                                                                          
                                                                          # Required for plow registry
                                                                          registry:packageName "@fld33/test" ;
                                                                          
                                                                          # Required for plow registry
                                                                          registry:packageVersion "0.1.2" ;
                                                                          
                                                                          # Optional for plow registry
                                                                          registry:repository "https://github.com/field33/ontology-workspace/tree/main/%40fld33/test" ;
                                                                          
                                                                          # Required for plow registry, language tag required
                                                                          registry:shortDescription "A short description of the field"@en ;
                                                                          
                                                                          # Required for plow registry, language tag required
                                                                          # Will be interpreted as long description in plow
                                                                          rdfs:comment "A long description of the field."@en ;
                                                                          
                                                                          # Required for plow registry, language tag required
                                                                          # Will be interpreted as the readable title of the field in plow
                                                                          rdfs:label "My interesting field"@en .
                                                                          

#################################################################
#    Annotation properties
#################################################################

###  http://field33.com/ontologies/REGISTRY/dependency
registry:dependency rdf:type owl:AnnotationProperty .

Thanks for your review in advance 🙏

I am not sure, if this repository is the right place for my request. Please move, if it isnt.

When opening an ontology in Plow Registry (like https://registry.field33.com/field/@fld33/people/0.1.5), the file given under Download has a name which consists of random letters and numbers.

Is it possible to use the name of the ontology plus the version I selected? For the mentioned link it would be people-0.1.5.ttl. That would make it easier in case someone starts to download and check a couple of your ontologies.

Badges in READMEs can be a really good way to improve the developer experience for an ecosystem, as they can provide a consistently recognizable link to a website with more information (like the registry) in an otherwise unstructured (= of always varying structure) block of text.

Shields.io provides the commonly used service for that (with integrations to all the popular package managers): https://shields.io/category/version

Examples for what the badge could look like:

This is a twin issue to https://github.com/bazel-contrib/bcr-ui/issues/29 which I want to tackle at some point. Depending on where I get around to implementing it first, I think we can benefit from the experience.

plow init currently generates an ontology document with all the required values prefilled to default values.

While this certainly provides a low-friction way towards submitting the ontology, this will likely result in all those metadata fields not being changed by most ontologies, and all those packages being published by "John Doe", etc..

Plow init currently generates a registry:fieldFormatVersion, which deviates from the registry:ontologyFormatVersion, which we assume at every other location in the tooling.

Description

We want to support consuming public ontologies without the need to login. However currently the private index (which requires a login) is retrieved on every plow command.

Instead the private index should only be retrieved if a package name is encountered that cannot be found in the public index.