PREFIX : <http://example.com/>
SOURCE films_xml_file <https://rawgit.com/herminiogg/ShExML/master/src/test/resources/films.xml>
SOURCE films_json_file <https://rawgit.com/herminiogg/ShExML/master/src/test/resources/films.json>
ITERATOR film_xml <xpath: //film> {
    FIELD id <@id>
    FIELD name <name>
    FIELD year <year>
    FIELD country <country>
    FIELD directors <directors/director>
}
ITERATOR film_json <jsonpath: $.films[*]> {
    FIELD id <id>
    FIELD name <name>
    FIELD year <year>
    FIELD country <country>
    FIELD directors <director>
}
EXPRESSION films <films_xml_file.film_xml UNION films_json_file.film_json>

:Films :[films.id] {
    :name [films.name] ;
    :year [films.year] ;
    :country [films.country] ;
    :director [films.directors] ;
}

Usage: ShExML [-h] [-id] [-nu] [--parallel] [-V] [-d=<drivers>] [-f=<format>]
              -m=<file> [--nThreads=<numberOfThreads>] [-o=<output>]
              [-p=<password>] [--parallelAspects=<parallelAspects>]
              [-u=<username>] [-pc | -r | -rp | -s | -sm | -sh | -shc]
Map and merge heterogeneous data sources with a Shape Expressions based syntax
  -m, --mapping=<file>         Path to the file with the mappings. If '-' is
                                 provided as the path the engine will read from
                                 the standard input.
  -h, --help                   Show this help message and exit.
  -V, --version                Print version information and exit.
Options for the transformation to RDF
  -id, --inferenceDatatypes    Use the inference system for choosing the best
                                 suited datatype for the generated literal.
                                 Without this option, and not declaring a
                                 datatype in the mapping rules, all the
                                 literals will be outputted as strings
  -nu, --normaliseURIs         Activate the URI normalisation system which
                                 allows to avoid malformed URIs when using
                                 strings for URI creation
  -f, --format=<format>        Output format for RDF graph. Turtle, RDF/XML,
                                 N-Triples, ...
Other transformation options
  -pc, --precompile            Create a single version including all the
                                 imported files, useful for debugging purposes.
                                 Additionally it checks the input for syntactic
                                 and grammatical errors
  -r, --rml                    Generate RML output
  -rp, --rmlPrettified         Generate RML output using Blank nodes for better
                                 readability
  -s, --shex                   Generate ShEx validation
  -sm, --shapeMap              Generate Shape Map for ShEx validation
  -sh, --shacl                 Generate SHACL validation
  -shc, --shaclClosed          Generate SHACL validation with closed shapes as
                                 default
General configuration options applying to all the available transformations
  -o, --output=<output>        Path where the output file should be created
  -u, --username=<username>    Username in case of using a database
  -p, --password=<password>    Password in case of using a database
  -d, --drivers=<drivers>      Add more JDBC database drivers in the form of
                                 <startJDBCURL>%<driver> and separating them
                                 with ";". Example: jdbc:postgresql%org.
                                 postgresql.Driver;jdbc:oracle%oracle.jdbc.
                                 OracleDriver
  --parallel                   EXPERIMENTAL: Enables the execution of the
                                 engine in concurrent mode
  --parallelAspects=<parallelAspects>
                               EXPERIMENTAL: Allows to select the aspects that
                                 will be parallelised. The possible options
                                 are: "queries", "shapes", or "all".
  --nThreads=<numberOfThreads> EXPERIMENTAL: The number of threads to use in
                                 the parallelisation. Default to the number of
                                 virtual threads of the processor.

val file = scala.io.Source.fromFile(pathToFile).mkString
val mappingLauncher = new MappingLauncher()
val output = mappingLauncher.launchMapping(file, "TURTLE")

García-González, H., Boneva, I., Staworko, S., Labra-Gayo, J. E., & Lovelle, J. M. C. (2020). 
ShExML: improving the usability of heterogeneous data mapping languages for first-time users. 
PeerJ Computer Science, 6, e318. https://doi.org/10.7717/peerj-cs.318

García-González, H. (2025). Optimising the ShExML engine through code profiling: From turtle’s pace 
to state-of-the-art performance. Semantic Web, (Preprint), 1-30. https://doi.org/10.3233/SW-243736

García-González, H., & Dimou, A. (2022, September). Why to tie to a single data mapping language? 
enabling a transformation from shexml to rml. In Proceedings of Poster and Demo Track and Workshop 
Track of the 18th International Conference on Semantic Systems co-located with 18th International 
Conference on Semantic Systems (SEMANTiCS 2022) (Vol. 3235, pp. paper-11). 
https://ceur-ws.org/Vol-3235/paper11.pdf

García-González, H. (2021, June). A ShExML perspective on mapping challenges: already solved ones, 
language modifications and future required actions. In 2nd International Workshop on Knowledge Graph 
Construction co-located with 18th Extended Semantic Web Conference (ESWC 2021), Online, June 6, 2021, 
CEUR Workshop Proceedings (vol. 2873). http://ceur-ws.org/Vol-2873/paper2.pdf

Garcia-Gonzalez, H., Fernandez-Alvarez, D., & Gayo, J. E. L. (2018). ShExML: An Heterogeneous Data 
Mapping Language based on ShEx. In EKAW (Posters & Demos) (pp. 9-12). https://ceur-ws.org/Vol-2262/ekaw-poster-08.pdf

$ sbt compile

$ sbt "run <options>"

$ sbt "set test in assembly := {}" clean update assembly

$ sbt test

$ docker compose up -d

$ sbt "+ test"

$ sbt "++<version> test"

$ sbt dumpLicenseReport