Welcome to the GeoGit project, exploring the use of distributed management of spatial data. GeoGit draws inspiration from Git, but adapts its core concepts to handle versioning of geospatial data. Users are able to import raw geospatial data (currently from Shapefiles, PostGIS or SpatiaLite) in to a repository where every change to the data is tracked. These changes can be viewed in a history, reverted to older versions, branched in to sandboxed areas, merged back in, and pushed to remote repositories.

For background reading see these two papers on the spatial distributed versioning Concept and Implementation.

Project Lead: Gabriel Roldan

License: all source code is licensed under the BSD New License, except for the GeoServer plugin which is available under the GPL 2.0 License.

Status: A 0.1 release is coming soon, with a full commandline interface to import data and work with repositories. A web API and user interface is slated for 0.2.

Building -----

GeoGit is built using Maven:

cd src/parent
mvn clean install

Online tests, require a geogit endpoint, are available using:

mvn -Ponline

Cobertura is configured for a test coverage report:

mvn cobertura:cobertura
open target/site/cobertura/index.html

Any additional build profiles are documented in the root `pom.xml`:pom.xml .

If you would like to work in Eclipse use of the m2eclipse plugin recommended.

Please carefully apply the code formatting options in the buld/eclipse/formatter.xml file. These are the standard Java formatting options with 100 character line length for both code and comments, and 4 spaces for indentation. It is also recommended to use the code templates from build/eclipse/codetemlates.xml.

See: QuickStart and Manual (full doc builds coming soon).

The project is hosted on github:

• https://github.com/opengeo/GeoGit

Participation is encouraged using the github fork and pull request workflow:

* Include test case demonstrating functionality
* Contributions are expected to pass all tests and not break the build
* Include proper license headers on your contributed files

Issues to help out on are at: https://github.com/opengeo/GeoGit/issues

For those who can't code help on documentation is always appreciated, all docs can be found at https://github.com/opengeo/GeoGit/tree/master/doc/ and contributed to by editing in ReStructuredText and using standard GitHub workflows.

Project resources:

• Full on-line project documentation
• GeoGit Discussion Group
• The build is actively monitored using hudson
• https://github.com/opengeo/GeoGit/issues

Additional resources:

• guava-libraries