JarCastingWelcome to the Eclipse RDF4J repository
This is the main code repository for the Eclipse RDF4J project.
Visit the project website for news, documentation, and downloadable releases.
Installation and usage
For installation and usage instructions of the RDF4J Workbench and Server applications, see RDF4J Server, Workbench, and Console.
For installation and usage instructions of the RDF4J Java libaries, see Programming with RDF4J.
Building from source
RDF4J is a multi-module maven project. It can be compiled, tested, and installed with the usual maven lifecycle phases from the command line, for example:
mvn verify- compiles and runs all testsmvn package- compiles, tests, and packages all modulesmvn install- compiles, tests, packages, and installs all artifacts in the local maven repositorymvn -Pquick install- compiles, packages and installs everything (skipping test execution)
These commands can be run from the project root to execute on the entire project or (if you're only interested in working with a particular module) from any module's subdirectory.
To build the full RDF4J project, including onejar and SDK files and full aggregated javadoc, from source, run:
mvn -Passembly package
The SDK and onejar will be available in assembly/target. Individual module jars and wars will be in target/ in their respective modules.
Modern IDEs like Eclipse, IntelliJ IDEA, or Netbeans can of course also be used to build, test, and run (parts of) the project.
Keen to contribute?
We welcome contributions! Whether you have a new feature you want to add, or a bug you want to fix, or a bit of documentation you want to improve, it's all very welcome. Have a look in our issue tracker for any open problems, in particular the ones marked as good first issue or as help wanted. Or feel free to add your own new issue if what you have in mind is not there yet.
To get started on your contribution, please first read our Contributor guidelines.
The short version:
- Digitally sign the Eclipse Contributor Agreement (ECA). You can do this by logging into the Eclipse projects forge; click on "Eclipse Contributor Agreement"; and Complete the form. Be sure to use the same email address when you register for the account that you intend to use on Git commit records. See the ECA FAQ for more info.
- Create an issue in the issue tracker that describes your improvement, new feature, or bug fix - or if you're picking up an existing issue, comment on that issue that you intend to provide a solution for it.
- Fork the GitHub repository.
- Create a new branch (starting from master) for your changes. Name your branch like this:
GH-1234-short-description-herewhere 1234 is the Github issue number. - Make your changes on this branch. Apply the rdf4j code formatting guidelines. Don't forget to include unit tests.
- sign off every commit (using the
-sflag). - Run
mvn verifyfrom the project root to make sure all tests succeed (both your own new ones, and existing). - Use meaningful commit messages and include the issue number in each commit message.
- Once your fix is complete, put it up for review by opening a Pull Request against the master branch in the central Github repository. If you have a lot of commits on your PR, make sure to squash your commits.
These steps are explained in more detail in the Contributor guidelines.
You can find more detailed information about our development and release processes in the Developer Workflow and Project Management documentation.
