NOTE: Indeed has discontinued supporting this project. Archiving will take place on 7/10/24. If you are interested in taking over as the Maintainer, please contact Indeed at [email protected]
Proctor is a A/B testing framework written in Java that enables data-driven product design at Indeed.
Proctor consists of data-model, client specification, client loader, matrix builder, java code generator.
- consistent tests across multiple applications
- group assignment adjustments without code deploys
- rule-based group assignment: e.g. US users experience 50% A, 50% B and non-US users are 25% A, 25% B, 25% C, 25% D
- human-readable test format
- forcing of test groups for internal testing
- java code generation for A/B tests groups
See Quick Start guide
See proctor demo
http://indeedeng.github.io/proctor
$ git checkout gh-pages $ gem install bundler $ bundle install $ rake clean serve => open http://localhost:4000/ in browser
Need to use Java 11 SDK for using gradle:
List installed java JVMs on MacOS:
$ /usr/libexec/java_home -V
Example output:
Matching Java Virtual Machines (9):
17.0.6 (arm64) "Azul Systems, Inc." - "Zulu 17.40.19" /Library/Java/JavaVirtualMachines/jdk17.0.6.jdk/Contents/Home
11.0.18 (arm64) "Azul Systems, Inc." - "Zulu 11.62.17" /Library/Java/JavaVirtualMachines/jdk11.0.18.jdk/Contents/Home
11.0.17 (arm64) "Azul Systems, Inc." - "Zulu 11.60.19" /Library/Java/JavaVirtualMachines/jdk11.0.17.jdk/Contents/Home
11.0.16 (arm64) "Azul Systems, Inc." - "Zulu 11.58.15" /Library/Java/JavaVirtualMachines/jdk11.0.16_8.jdk/Contents/Home
11.0.15 (arm64) "Azul Systems, Inc." - "Zulu 11.56.19" /Library/Java/JavaVirtualMachines/jdk11.0.15_10.jdk/Contents/Home
1.8.0_362 (arm64) "Azul Systems, Inc." - "Zulu 8.68.0.21" /Library/Java/JavaVirtualMachines/jdk1.8.0_362.jdk/Contents/Home
1.8.0_345 (arm64) "Azul Systems, Inc." - "Zulu 8.64.0.19" /Library/Java/JavaVirtualMachines/jdk1.8.0_345.jdk/Contents/Home
1.8.0_332 (arm64) "Azul Systems, Inc." - "Zulu 8.62.0.19" /Library/Java/JavaVirtualMachines/jdk1.8.0_332.jdk/Contents/Home
1.8.0_322 (arm64) "Azul Systems, Inc." - "Zulu 8.60.0.21" /Library/Java/JavaVirtualMachines/jdk1.8.0_322.jdk/Contents/Home
Set JVM version in MacOS:
$ export JAVA_HOME=`/usr/libexec/java_home -v 11.0.18`
How to Build:
$ ./gradlew build
Run the following gradle command and note the local version from the output:
$ ./gradlew clean check publish --refresh-dependencies
Example output:
Calculating version to use for publish ...
Now using version: 0.local.20230711170543
> Task :proctor-common:compileJava
Example above would create local installation of proctor with version equal to 0.local.20230711170543
Use the indeedeng-proctor-users Q&A forum to ask and answer questions about the use of Proctor.
This project is governed by the Contributor Covenant v 1.4.1