Skip to content
DavidLeoni edited this page Dec 30, 2014 · 24 revisions

Welcome to the TraceProv wiki!

TraceProv is a Java library to model provenance of data from DCAT catalogs, which are represented using DCAT W3C vocabulary . It allows to reference data in sources having table-like formats such as CSV.

General info

Usage

Testing

Contributing


General information

TraceProv is versioned according to semantic versioning.

Usage

TODO put maven example dep and usage example.

logging: TraceProv uses native Java logging system (JUL). If you have an application which uses SLF4J logging system and want to see TraceProv logs, you can route logging with JUL to SLF4J bridge, just remember to programmatically install it first.

Contributing

name casing: We follow Google's naming coding style.

libraries: When a feature is not satisfactorily covered by vanilla Java 6 we use Guava library . Code must work in a Java 6 environment.

collections: For collections we prefer Guava's immutable collections

null values: Null values are generally avoided and empty objects used instead. The few fields that can be null are marked with JSR-305 @Nullable annotation.

logging: We use native Java logging (JUL), there's no need to have extra dependencies such as SLF4J.

testing: Tests are normal Junit tests which are run during the build. todo write how to enable logging during testing.

Snapshot testing

WARNING: SNAPSHOTS ARE DEVELOPMENT VERSION THAT CAN CHANGE AT ANY TIME, DO NOT USE IT IN PRODUCTION

Snapshots are deployed to sonatype repositories. To use snapshots them in Maven, add this to your pom.xml:

  <repositories>
    <repository>
        <id>sonatype-nexus-snapshots</id>
        <name>project</name>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>            
    </repository>        
</repositories>

in the dependencies section, add:

    <dependency>
      <groupId>eu.trentorise.opendata</groupId>
      <artifactId>traceprov</artifactId>
      <version>0.X.0-SNAPSHOT</version>
    </dependency>

where X is the current version

Snapshot deployment

Snapshot deployment is done on Sonatype: https://oss.sonatype.org/content/repositories/snapshots/eu/trentorise/opendata/jackan/

    mvn clean deploy

TraceProv

Clone this wiki locally