Skip to content

Latest commit

 

History

History
63 lines (47 loc) · 1.83 KB

CONTRIBUTING.md

File metadata and controls

63 lines (47 loc) · 1.83 KB
Raw

Contributing

Please check out and build arangojs from source:

git clone https://github.com/arangodb/arangojs.git
cd arangojs
npm install
npm run build

Testing

Run the tests using the npm test or yarn test commands:

npm test
# - or -
yarn test

By default the tests will be run against a server listening on http://127.0.0.1:8529 (using username root with no password). To override this, you can set the environment variable TEST_ARANGODB_URL to something different:

TEST_ARANGODB_URL=http://myserver.local:8530 npm test
# - or -
TEST_ARANGODB_URL=http://myserver.local:8530 yarn test

To run tests against a cluster, you can use multiple comma-separated URLs or append a comma to the URL. The tests will automatically attempt to acquire a host list and use round robin load balancing.

For development arangojs tracks the development build of ArangoDB. This means tests may reflect behavior that does not match any existing public release of ArangoDB.

To run tests for a specific release of ArangoDB other than the latest development build, use the environment variable ARANGO_VERSION, e.g. for 3.3:

ARANGO_VERSION=30300 npm test
# - or -
ARANGO_VERSION=30300 yarn test

The value follows the same format as the arangoVersion config option, i.e. XYYZZ where X is the major version, YY is the two digit minor version and ZZ is the two digit patch version (both zero filled to two digits).

Any incompatible tests will appear as skipped (not failed) in the test result.

Releases

Releases of arangojs are manually published on NPM.

Releases can only be published by authorized ArangoDB staff. For more information see the internal documentation on Releasing ArangoJS.