URI Engineer

The URI Engineer assists you in common URI engineering tasks.

At the moment the tool implements two methods:

• 'collect-prefixes': given a path to a (folder of) RDF file(s) returns the list of prefixes of the entities occurring in the file(s) as subjects, predicates, objects of triples and named-graphs of quads. If the argument --collect-examples is provided, then tool also prints for each prefix, a list of URIs having that prefix.

• 'refactor-prefixes': given a path to a (folder of) RDF file(s), an output folder and a mapping specification, substitutes the prefixes of the entities as specified in the mapping file. The mapping file is a table in csv format containing a row for each mapping where the first cell of the row is the prefix to be substituted and the second is the desired prefix. If --generate-sameAs-links is specified, then the tool generates for each a sameAs link connecting the new and the old URIs. SameAs links will be included in a single file that will be stored in the directory whose path is passed as parameter. An executable JAR file of the tool can be obtained from the Releases page. To be executed the JAR requires Java 11+.

The jar can be executed as follows:

usage: java -jar framester.uri-engineer-<version>.jar -m
            (collect-prefixes|refactor-prefixes) -i filepath [-e -mf
            filepath -o filepath -x regex]
 -m,--method <collect-prefixes|refactor-prefixes>   The method to invoke.
                                                    Only two methods
                                                    available
                                                    'collect-prefixes' and
                                                    'refactor-prefixes'.
                                                    By passing
                                                    'collect-prefixes' the
                                                    tool returns the set
                                                    of prefixes used in
                                                    the URIs files. By
                                                    passing
                                                    'refactor-prefixes',
                                                    the tool performs the
                                                    refactoring of the
                                                    input files.
 -i,--input <filepath>                              A path to a file or a
                                                    folder.
 -mf,--mapping-file <filepath>                      A path to a csv file
                                                    (Mandatory for
                                                    refactor-prefixes).
 -o,--output-folder <filepath>                      A path to an output
                                                    folder (Mandatory for
                                                    refactor-prefixes).
 -e,--collect-examples                              If set, the tool will
                                                    collect examples of
                                                    URIs for each prefix.
 -s,--generate-sameAs-links <filepath>              If set, the tool will
                                                    generate sameAs links
                                                    for the URIs changed.
                                                    SameAs links will be
                                                    included in a single
                                                    file that will be
                                                    stored in the
                                                    directory whose path
                                                    is passed as
                                                    parameter.
 -x,--exclude-files <regex>                         If set, the tool will
                                                    exclude the input
                                                    files that match the
                                                    given regular
                                                    expression.

License

The URI Engineer is distributed under Apache 2.0 License