See here for the TriplyDB JavaScript client documentation.
- NodeJS and Yarn should be installed
- For unit-testing we recommend having direnv installed.
- Run
yarn
to install all dependencies
To run the tests you need to set the API server URL and a access token in your ./.env
variable first: UNITTEST_TOKEN_READ
, UNITTEST_TOKEN_WRITE
, UNITTEST_TOKEN_ACCOUNT
and UNITTEST_API_URL
.
Recommendations for these tokens:
- Create a separate user (e.g.
<MyUserName>-triplydb-js
) the TriplyDB instance you're using, as the unittest will thoroughly removes all datasets from this account before starting the test - Create the tokens for that one, and use these tokens in
./envrc-private
yarn test
.
-
yarn build
transpiles the typescript code, and stores the JS results in the./lib
directory -
yarn dev
does the same, but watches for any changes to the typescript files and incrementally transpiles them when needed
- Run
npm version [patch|minor|major]
yarn's new version plugin does more than we want. We just want to modify the package.json file. I.e., just use npm
- The CI will automatically publish the NPM package
TriplyDB-js is also available as a CLI. This CLI supports uploading files to TriplyDB from the command-line. To build the executable, run yarn run package
.
Run the stored executable (e.g. ./triplydb-linux
) with a --help
argument to find the supported command line arguments.