Skip to content

Commit 45f88a4

Browse files
committed
review docjs
2 parents 8bfdf83 + ec88fc4 commit 45f88a4

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+15323
-2499
lines changed

.gitignore

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
11
package-lock.json
2+
docs/api/*.json
3+
4+
.vscode
5+
6+
local_test
27

38
dist
49
# Logs

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,4 +141,4 @@ Please check [Contributing.md](Contributing.md) for more information.
141141

142142
The APACHE 2.0 License
143143

144-
Copyright (c) 2019
144+
Copyright (c) 2019

docs/.nojekyll

Whitespace-only changes.

docs/README.md

Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
# terminusdb-client
2+
3+
[![build status](https://api.travis-ci.com/terminusdb/terminusdb-client.svg?branch=master)](https://travis-ci.com/terminusdb/terminusdb-client)
4+
[![Coverage Status](https://coveralls.io/repos/github/terminusdb/terminusdb-client/badge.svg?branch=master)](https://coveralls.io/repos/github/terminusdb/terminusdb-client/badge.svg?branch=master)
5+
6+
Promise based terminus client for the browser and node.js
7+
8+
## Requirements
9+
10+
- [TerminusDB](https://github.com/terminusdb/terminusdb-server)
11+
- [NodeJS 8.1.4+](https://nodejs.org/en/)
12+
13+
## Installation
14+
15+
TerminusDB Client can be used as either a Node.js module available through the npm registry, or directly included in web-sites by including the script tag below.
16+
17+
### NPM Module
18+
19+
Before installing, download and install Node.js. Node.js 0.10 or higher is required.
20+
21+
Installation is done using the npm install command:
22+
23+
Using npm:
24+
25+
```bash
26+
$ npm install --save @terminusdb/terminusdb-client
27+
```
28+
29+
### Minified Script
30+
31+
Using cdn:
32+
33+
```html
34+
<script src="https://unpkg.com/@terminusdb/terminusdb-client/dist/terminusdb-client.min.js"></script>
35+
```
36+
37+
Downloading:
38+
39+
Download the terminusdb-client.min.js file from the /dist directory and save it to your location of choice, then:
40+
41+
```html
42+
<script src="http://my.saved.location/terminusdb-client.min.js"></script>
43+
```
44+
45+
## Usage
46+
47+
This example creates a simple Express.js server that will post an account to
48+
a database with the id "banker" and the default "admin" user with password "root"
49+
For the [full Documentation](https://terminusdb.com/docs/reference/js-client)
50+
51+
```javascript
52+
const express = require("express");
53+
const app = express();
54+
const port = 3000;
55+
56+
const TerminusClient = require("@terminusdb/terminusdb-client");
57+
58+
// Connect and configure the TerminusClient
59+
const client = new TerminusClient.WOQLClient("https://127.0.0.1:6363/", {
60+
dbid: "banker",
61+
user: "admin",
62+
key: "root",
63+
});
64+
client.db("banker");
65+
client.organization("admin");
66+
67+
async function postAccount() {
68+
try {
69+
const WOQL = TerminusClient.WOQL;
70+
const query = WOQL.using("admin/banker").and(
71+
WOQL.add_triple("doc:smog", "type", "scm:BankAccount"),
72+
WOQL.add_triple("doc:smog", "owner", "smog"),
73+
WOQL.add_triple("doc:smog", "balance", 999)
74+
);
75+
await client.connect();
76+
client
77+
.query(query, "adding smog's bank account")
78+
.then((response) => {
79+
return response;
80+
})
81+
.catch((err) => {
82+
console.log("error", err);
83+
});
84+
} catch (err) {
85+
console.error(err);
86+
}
87+
}
88+
89+
app.post("/account", (req, res) => {
90+
postAccount().then((dbres) => res.send(JSON.stringify(dbres)));
91+
});
92+
93+
app.listen(port, () => {
94+
console.log(`Backend Server listening at http://localhost:${port}`);
95+
client
96+
.connect()
97+
.then(function (response) {
98+
// handle success
99+
console.log(response);
100+
})
101+
.catch(function (error) {
102+
// handle error
103+
console.log(error);
104+
});
105+
});
106+
```
107+
108+
## Options
109+
110+
connections options.
111+
112+
To initialize `TerminusDB client` with custom options use
113+
114+
```js
115+
const TerminusClient = require("@terminusdb/terminusdb-client");
116+
117+
const client = new TerminusClient.WOQLClient("https://127.0.0.1:6363/", {
118+
dbid: "test_db",
119+
user: "admin",
120+
key: "my_secret_key",
121+
});
122+
```
123+
124+
## API
125+
126+
The API is documented at: https://terminusdb.com/docs/reference/js-client/core/#terminusdb-client-api
127+
128+
## Report Issues
129+
130+
If you have encounter any issues, please report it with your os and environment setup, version that you are using and a simple reproducible case.
131+
132+
If you encounter other questions, you can ask in our community [forum](https://community.terminusdb.com/) or [Slack channel](http://bit.ly/terminusdb-slack).
133+
134+
## Contribute
135+
136+
It will be nice, if you open an issue first so that we can know what is going on, then, fork this repo and push in your ideas. Do not forget to add a bit of test(s) of what value you adding.
137+
138+
Please check [Contributing.md](Contributing.md) for more information.
139+
140+
## Licence
141+
142+
The APACHE 2.0 License
143+
144+
Copyright (c) 2019

docs/api/navtest.js.md

Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
- [WOQLClient](api/woqlClient.js?id=WOQLClient)
2+
- [copy](api/woqlClient.js?id=copy)
3+
- [server](api/woqlClient.js?id=server)
4+
- [api](api/woqlClient.js?id=api)
5+
- [organization](api/woqlClient.js?id=organization)
6+
- [user](api/woqlClient.js?id=user)
7+
- [uid](api/woqlClient.js?id=uid)
8+
- [userOrganization](api/woqlClient.js?id=userOrganization)
9+
- [databases](api/woqlClient.js?id=databases)
10+
- [databaseInfo](api/woqlClient.js?id=databaseInfo)
11+
- [db](api/woqlClient.js?id=db)
12+
- [setSystemDb](api/woqlClient.js?id=setSystemDb)
13+
- [repo](api/woqlClient.js?id=repo)
14+
- [checkout](api/woqlClient.js?id=checkout)
15+
- [ref](api/woqlClient.js?id=ref)
16+
- [localAuth](api/woqlClient.js?id=localAuth)
17+
- [remoteAuth](api/woqlClient.js?id=remoteAuth)
18+
- [author](api/woqlClient.js?id=author)
19+
- [set](api/woqlClient.js?id=set)
20+
- [resource](api/woqlClient.js?id=resource)
21+
- [createDatabase](api/woqlClient.js?id=createDatabase)
22+
- [deleteDatabase](api/woqlClient.js?id=deleteDatabase)
23+
- [createGraph](api/woqlClient.js?id=createGraph)
24+
- [deleteGraph](api/woqlClient.js?id=deleteGraph)
25+
- [getTriples](api/woqlClient.js?id=getTriples)
26+
- [updateTriples](api/woqlClient.js?id=updateTriples)
27+
- [insertTriples](api/woqlClient.js?id=insertTriples)
28+
- [insertCSV](api/woqlClient.js?id=insertCSV)
29+
- [updateCSV](api/woqlClient.js?id=updateCSV)
30+
- [getCSV](api/woqlClient.js?id=getCSV)
31+
- [deleteCSV](api/woqlClient.js?id=deleteCSV)
32+
- [message](api/woqlClient.js?id=message)
33+
- [action](api/woqlClient.js?id=action)
34+
- [info](api/woqlClient.js?id=info)
35+
- [query](api/woqlClient.js?id=query)
36+
- [branch](api/woqlClient.js?id=branch)
37+
- [pull](api/woqlClient.js?id=pull)
38+
- [fetch](api/woqlClient.js?id=fetch)
39+
- [push](api/woqlClient.js?id=push)
40+
- [rebase](api/woqlClient.js?id=rebase)
41+
- [reset](api/woqlClient.js?id=reset)
42+
- [clonedb](api/woqlClient.js?id=clonedb)
43+
- [dispatch](api/woqlClient.js?id=dispatch)
44+
- [generateCommitInfo](api/woqlClient.js?id=generateCommitInfo)
45+
- [prepareRevisionControlArgs](api/woqlClient.js?id=prepareRevisionControlArgs)
46+
- [_load_db_prefixes](api/woqlClient.js?id=_load_db_prefixes)
47+
- [getClassFrame](api/woqlClient.js?id=getClassFrame)
48+
- [updateDatabase](api/woqlClient.js?id=updateDatabase)
49+
- [organizations](api/woqlClient.js?id=organizations)
50+
- [action_permitted](api/woqlClient.js?id=action_permitted)
51+
- [createUser](api/woqlClient.js?id=createUser)
52+
- [getUser](api/woqlClient.js?id=getUser)
53+
- [updateUser](api/woqlClient.js?id=updateUser)
54+
- [deleteUser](api/woqlClient.js?id=deleteUser)
55+
- [createOrganization](api/woqlClient.js?id=createOrganization)
56+
- [getOrganization](api/woqlClient.js?id=getOrganization)
57+
- [updateOrganization](api/woqlClient.js?id=updateOrganization)
58+
- [deleteOrganization](api/woqlClient.js?id=deleteOrganization)
59+
- [getRoles](api/woqlClient.js?id=getRoles)
60+
- [updateRoles](api/woqlClient.js?id=updateRoles)
61+
- [connect](api/woqlClient.js?id=connect)
62+
- [WOQL](api/woql.js?id=WOQL)
63+
- [eval](api/woql.js?id=eval)
64+
- [using](api/woql.js?id=using)
65+
- [comment](api/woql.js?id=comment)
66+
- [select](api/woql.js?id=select)
67+
- [distinct](api/woql.js?id=distinct)
68+
- [and](api/woql.js?id=and)
69+
- [or](api/woql.js?id=or)
70+
- [from](api/woql.js?id=from)
71+
- [into](api/woql.js?id=into)
72+
- [triple](api/woql.js?id=triple)
73+
- [added_triple](api/woql.js?id=added_triple)
74+
- [removed_triple](api/woql.js?id=removed_triple)
75+
- [quad](api/woql.js?id=quad)
76+
- [added_quad](api/woql.js?id=added_quad)
77+
- [removed_quad](api/woql.js?id=removed_quad)
78+
- [sub](api/woql.js?id=sub)
79+
- [eq](api/woql.js?id=eq)
80+
- [substr](api/woql.js?id=substr)
81+
- [update_object](api/woql.js?id=update_object)
82+
- [delete_object](api/woql.js?id=delete_object)
83+
- [read_object](api/woql.js?id=read_object)
84+
- [get](api/woql.js?id=get)
85+
- [put](api/woql.js?id=put)
86+
- [as](api/woql.js?id=as)
87+
- [remote](api/woql.js?id=remote)
88+
- [file](api/woql.js?id=file)
89+
- [post](api/woql.js?id=post)
90+
- [delete_triple](api/woql.js?id=delete_triple)
91+
- [delete_quad](api/woql.js?id=delete_quad)
92+
- [add_triple](api/woql.js?id=add_triple)
93+
- [add_quad](api/woql.js?id=add_quad)
94+
- [when](api/woql.js?id=when)
95+
- [trim](api/woql.js?id=trim)
96+
- [evaluate](api/woql.js?id=evaluate)
97+
- [plus](api/woql.js?id=plus)
98+
- [minus](api/woql.js?id=minus)
99+
- [times](api/woql.js?id=times)
100+
- [divide](api/woql.js?id=divide)
101+
- [div](api/woql.js?id=div)
102+
- [exp](api/woql.js?id=exp)
103+
- [floor](api/woql.js?id=floor)
104+
- [isa](api/woql.js?id=isa)
105+
- [like](api/woql.js?id=like)
106+
- [less](api/woql.js?id=less)
107+
- [greater](api/woql.js?id=greater)
108+
- [WOQL.opt](api/woql.js?id=WOQL.opt)
109+
- [WOQL.unique](api/woql.js?id=WOQL.unique)
110+
- [WOQL.idgen](api/woql.js?id=WOQL.idgen)
111+
- [WOQL.upper](api/woql.js?id=WOQL.upper)
112+
- [WOQL.lower](api/woql.js?id=WOQL.lower)
113+
- [WOQL.pad](api/woql.js?id=WOQL.pad)
114+
- [split](api/woql.js?id=split)
115+
- [member](api/woql.js?id=member)
116+
- [WOQL.concat](api/woql.js?id=WOQL.concat)
117+
- [WOQL.join](api/woql.js?id=WOQL.join)
118+
- [sum](api/woql.js?id=sum)
119+
- [WOQL.start](api/woql.js?id=WOQL.start)
120+
- [WOQL.limit](api/woql.js?id=WOQL.limit)
121+
- [WOQL.re](api/woql.js?id=WOQL.re)
122+
- [WOQL.length](api/woql.js?id=WOQL.length)
123+
- [WOQL.not](api/woql.js?id=WOQL.not)
124+
- [once](api/woql.js?id=once)
125+
- [immediately](api/woql.js?id=immediately)
126+
- [count](api/woql.js?id=count)
127+
- [WOQL.typecast](api/woql.js?id=WOQL.typecast)
128+
- [order_by](api/woql.js?id=order_by)
129+
- [WOQL.group_by](api/woql.js?id=WOQL.group_by)
130+
- [WOQL.true](api/woql.js?id=WOQL.true)
131+
- [WOQL.path](api/woql.js?id=WOQL.path)
132+
- [WOQL.size](api/woql.js?id=WOQL.size)
133+
- [WOQL.triple_count](api/woql.js?id=WOQL.triple_count)
134+
- [WOQL.type_of](api/woql.js?id=WOQL.type_of)
135+
- [WOQL.star](api/woql.js?id=WOQL.star)
136+
- [WOQL.all](api/woql.js?id=WOQL.all)
137+
- [WOQL.node](api/woql.js?id=WOQL.node)
138+
- [insert](api/woql.js?id=insert)
139+
- [schema](api/woql.js?id=schema)
140+
- [graph](api/woql.js?id=graph)
141+
- [WOQL.add_class](api/woql.js?id=WOQL.add_class)
142+
- [add_property](api/woql.js?id=add_property)
143+
- [delete_class](api/woql.js?id=delete_class)
144+
- [WOQL.delete_property](api/woql.js?id=WOQL.delete_property)
145+
- [WOQL.doctype](api/woql.js?id=WOQL.doctype)
146+
- [WOQL.insert_data](api/woql.js?id=WOQL.insert_data)
147+
- [WOQL.insert_class_data](api/woql.js?id=WOQL.insert_class_data)
148+
- [insert_doctype_data](api/woql.js?id=insert_doctype_data)
149+
- [insert_property_data](api/woql.js?id=insert_property_data)
150+
- [nuke](api/woql.js?id=nuke)
151+
- [query](api/woql.js?id=query)
152+
- [json](api/woql.js?id=json)
153+
- [string](api/woql.js?id=string)
154+
- [literal](api/woql.js?id=literal)
155+
- [iri](api/woql.js?id=iri)
156+
- [vars](api/woql.js?id=vars)
157+
- [client](api/woql.js?id=client)
158+
- [update_triple](api/woql.js?id=update_triple)
159+
- [update_quad](api/woql.js?id=update_quad)
160+
- [value](api/woql.js?id=value)
161+
- [link](api/woql.js?id=link)
162+
- [makeEnum](api/woql.js?id=makeEnum)
163+
- [generateChoiceList](api/woql.js?id=generateChoiceList)
164+
- [updateChoiceList](api/woql.js?id=updateChoiceList)
165+
- [deleteChoiceList](api/woql.js?id=deleteChoiceList)
166+
- [libs](api/woql.js?id=libs)
167+
- [boxClasses](api/woql.js?id=boxClasses)
168+
- [GraphRef](api/typedef.js?id=GraphRef)
169+
- [DataFormatObj](api/typedef.js?id=DataFormatObj)
170+
- [FuntionType](api/typedef.js?id=FuntionType)
171+
- [ClassObj](api/typedef.js?id=ClassObj)
172+
- [PropertyObj](api/typedef.js?id=PropertyObj)
173+
- [ResourceType](api/typedef.js?id=ResourceType)
174+
- [GraphType](api/typedef.js?id=GraphType)
175+
- [CredentialObj](api/typedef.js?id=CredentialObj)
176+
- [ActionType](api/typedef.js?id=ActionType)
177+
- [ParamsObj](api/typedef.js?id=ParamsObj)
178+
- [RolesObj](api/typedef.js?id=RolesObj)
179+
- [RepoType](api/typedef.js?id=RepoType)
180+
- [DbDetails](api/typedef.js?id=DbDetails)
181+
- [RemoteRepoDetails](api/typedef.js?id=RemoteRepoDetails)
182+
- [CloneSourceDetails](api/typedef.js?id=CloneSourceDetails)

0 commit comments

Comments
 (0)