Skip to content

Commit

Permalink
Add notes about fork to readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Nakaner committed May 2, 2024
1 parent 0bb5367 commit a6d7965
Show file tree
Hide file tree
Showing 2 changed files with 47 additions and 1 deletion.
29 changes: 29 additions & 0 deletions NOTES_FOR_DEVS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Notes for developers working on this fork

## Building

This fork is built like the upstream version using Maven.

Compile and run tests:

```sh
mvn clean compile test
```

Build JAR files:

```sh
mvn install
```

## Deployment

Deployment is done by

`mvn deploy`.

The fork is hosted in a [custom Maven repository run by Geofabrik](https://maven.geofabrik.de). New versions are
pushed there using SCP (OpenSSH secure file copy) – authenticated by public key.

If the version string in the `pom.xml` files ends with `-SNAPSHOT`, calling `mvn deploy` will deploy to the
snapshot repository located in the `maven_repository` directory.
19 changes: 18 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,21 @@
# GraphHopper Routing Engine
# GraphHopper Routing Engine – Geofabrik Fork

**This is a fork the GraphHopper routing engine with modifications required by non-standard use cases.**

Changes:

* Allow to provide custom callbacks to be called during reading of an OSM file.
* Add support to add custom turn restrictions at the end of the import.
* If requested, map matching can return incomplete tracks instead of throwing an exception.
* Add visibility to some methods to permit overwriting of their implementation.
* Add transporation mode for trains.

Any code that compiles and runs with GraphHopper should be buildable and runnable with this fork as well.
Be aware that custom interfaces will be dropped if a sufficient replacement is available upstream.

Released versions of the fork follow this naming schema: `<upstream_version>-osm-reader-callbacks`

**Original readme following:**

![Build Status](https://github.com/graphhopper/graphhopper/actions/workflows/build.yml/badge.svg?branch=master)

Expand Down

0 comments on commit a6d7965

Please sign in to comment.