Skip to content

Latest commit

 

History

History
97 lines (77 loc) · 4.43 KB

README.rst

File metadata and controls

97 lines (77 loc) · 4.43 KB

ili2db - imports/exports interlis transfer files to a sql db

Features

  • Translates INTERLIS 1+2 data model definitions to a SQL schema.
  • Loads INTERLIS 1+2 data into a SQL database.
  • Extracts INTERLIS 1+2 data from a SQL database.

This is the developer documentation, see ../docs/ili2db.rst for user documentation.

License

ili2db is licensed under the LGPL (Lesser GNU Public License).

Build System Requirements

For the current version of ili2db, you will need a JDK (Java Development Kit) and Apache Ant installed on your system.

The JDK (Java Development Kit), version 1.6 or later, can be downloaded for free from the Website <http://www.oracle.com/technetwork/java/javase/downloads/index.html>.

Apache Ant can be downloaded from <http://ant.apache.org/>.

How to build

PostGIS: ant -f build-ili2pg.xml jar bindist srcdist

GeoPackage: ant -f build-ili2gpkg.xml jar bindist srcdist

FileGDB: ant -f build-ili2fgdb.xml jar bindist srcdist

Runtime dependencies

Dependency Source Website
libs/antlr.jar  
libs/ehibasics.jar  
libs/ili2c-core.jar  
libs/ili2c-tool.jar  
libs/iox-api.jar  
libs/iox-ili.jar  
libs/jts-core-1.14.0.jar  
libs/gson-2.6.2.jar  
libs/toml4j-0.5.1.jar  
libs/ehisqlgen.jar  
libs/postgresql-9.4.1208.jre6.jar [1]  
libs/sqlite-jdbc-3.8.11.2.jar [2]  
libs/fgdb4j.jar [3]  

Development dependencies

TODO

Coding

  • only one single thing (bug fix/new feature/...) in one commit/pull request
  • for one thing only one commit/pull request
  • use only US-ASCII for source encoding
  • do not use TAB in source files
  • if you make important commits, please add the commit log or something similar to the changelist (<https://github.com/claeis/ili2db/blob/master/docs/CHANGELOG.txt>);
  • if you change anything in an existing feature, make sure that there are unit tests for it and make sure that they (and all other unit tests) pass before you commit the code;
  • if you add a new feature, please document it in a similar manner to the existing code (or better!), and add some minimal unit tests before you commit it;
  • last but not least, please respect the same naming and indentation.

In order to oversee the commit messages more easily and that the changelist looks homogenous please keep the following format:

- {area}: {fixed|bugfix|changed|new} {what and/or why} (#{issue number})

Design

TODO

[1]ili2pg only
[2]ili2gpkg only
[3]ili2fgdb only