The eve-crest-java from maurerit

eve-crest-java's Introduction

eve-crest-java

Eve Online CREST implementation in Java.

Getting Started

Clone and build this library

git clone https://github.com/evanova/eve-crest-java.git
./gradlew build install -x test

Import it in your project

compile 'org.devfleet.crest:retrofit:0.+'

Using the library

Configure a CrestClient

final CrestClient client =
    CrestClient.TQ()
    .id("Your CREST application ID")
    .key("Your CREST application key")
    .build();

There are more options available to build a client. Please see CrestClient.Builder for more details.

Obtain a CrestService instance from a CrestClient

 //from a known refresh token
 service = client.fromRefreshToken("Token");
 
 //from an authentication code provided by CREST on your application's callback URI 
 service = client.fromAuthCode("AuthCode");
 
 //Public CREST access
 service = client.fromDefault();

Interact with CREST

 final List<CrestContact> contacts = service.getContacts();
 Assert.assertFalse("No contact found. Do you have any friend?", contacts.isEmpty());

 service.deleteContact(contact.getContact().getId());
 service.addContact(contact);

Testing

You will need to edit the crest.properties file in the test folder and fill it with the required information (see that file for details). Then you can run ./gradlew check

Further documentation

Eve Online 3rd Party documentation

Contributing

You are encouraged to add more CrestService method and/or add new CREST endpoints to the CREST Retrofit interface. Ask around on slack/#devfleet for details.