Installing the Java API client

Iboga depends on IB's official Java API client which unfortunately isn't available in a public maven repo. To use iboga you will need to install the official Java client locally with Maven (maven install instructions).

To install the IB Java client locally

1. Download the api source from http://interactivebrokers.github.io. Agree to their terms then choose one of the versions under "Mac / Unix".
2. Extract the zip file and navigate to "IBJts/source/JavaClient"
3. run mvn install.
4. Add one of the following to your deps.edn or project.clj dependencies (replace version string as needed):

   [com.interactivebrokers/tws-api "9.73.01-SNAPSHOT"]
   

   com.interactivebrokers/tws-api {:mvn/version "9.73.01-SNAPSHOT"}
   

Now you can add the Clojars Iboga dependency

Developing Iboga

The javac -parameters argument is used to generate names used by Iboga from the java api source. If you want to work on developing this part of Iboga you will need to add the following lines to the pom.xml file for the Java api, under maven-compiler-plugin's <configuration>:

<compilerArgument>-parameters</compilerArgument> 

So that the maven-compiler-plugin section is as follows:

<plugin>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.7.0</version>
  <configuration>
    <source>1.8</source>
    <target>1.8</target>
    <includes>com/**</includes>
    <compilerArgument>-parameters</compilerArgument>
  </configuration>
</plugin>

Now make sure there is no build folder of old jars and run mvn install.