The higher level Development Guide gives contributing to Feast codebase as a whole.
This guide is targeted at developers looking to contribute to Feast components in the feast-java Repository:
Don't see the Feast component that you want to contribute to here?
Check out the Development Guide to learn how Feast components are distributed over multiple repositories.
Common Environment Setup for all feast-java Feast components:
Ensure following development tools are installed:
- Java SE Development Kit 11
- Maven 3.6
make
Feast's Java codebase conforms to the Google Java Style Guide.
Automatically format the code to conform the style guide by:
# formats all code in the feast-java repository
mvn spotless:applyIf you're using IntelliJ, you can import these code style settings if you'd like to use the IDE's reformat function.
The Project Makefile provides useful shorthands for common development tasks:
Run all Unit tests:
make test-java
Run all Integration tests:
make test-java-integration
Building Docker images for Feast Core & Feast Serving:
make build-docker REGISTRY=gcr.io/kf-feast VERSION=develop
If you're using IntelliJ, some additional steps may be needed to make sure IntelliJ autocomplete works as expected.
Specifically, proto-generated code is not indexed by IntelliJ. To fix this, navigate to the following window in IntelliJ:
Project Structure > Modules > datatypes-java, and mark the following folders as Source directorys:
- target/generated-sources/protobuf/grpc-java
- target/generated-sources/protobuf/java
- target/generated-sources/annotations
See instructions here for developing.
Setting up your development environment for Feast Java SDK:
- Complete the feast-java Common Setup
Feast Java Client is a Java Client for retrieving Features from a running Feast Serving instance.
See the Feast Serving Section section for how to get a Feast Serving instance running.
- Build / Compile Feast Java Client with Maven:
mvn package -pl sdk/java --also-make -Dmaven.test.skip=true
Unit Tests can be used to verify functionality:
mvn package -pl sdk/java test --also-make