covalent-data is a mock API server with the following features:
- mock CRUD capability
- mock chart data (TBA)
To run from source or to create your own executables, you must first install Go.
- Pull down this repository into your $GOROOT src folder
- cd into this repo and
go get
go run server.go
- The
/schema
directory and the/datum
directory must be in the root of this repo.
The covalent-data CLI is available to download as a package in the npm repository.
npm install @covalent/data -g
covalent-data
To run from docker:
- Install Docker Engine.
- Pull down this repo and
cd
into it. docker build -t covalent-data .
docker run -p 8080:8080 --name covalent-data covalent-data
- To stop-
docker stop covalent-data
covalent-data is included in the covalent-quickstart repo.
- Pull down the latest covalent-quickstart repo.
npm install
npm run start-api
(npm run stop-api
to stop the API server)ng serve
and go to http://localhost:4200
covalent-data allows you to create custom CRUD endpoints.
On startup, it will automatically create these endpoints from yaml files in the /schemas
directory and seed them with mock data based on example files in the datum
directory.
There are two steps to customizing CRUD objects:
- Create a yaml file in the
/schemas
directory. - The CRUD endpoints will be automatically created based on the name of the file you create. (for instance,
systems.yaml
will create GET, POST, PUT, PATCH, and DELETE at http://localhost:8080/systems) - The first line of the yaml file can optionally be labeled
initial_entries
. This tells the API server how many initial entries to seed your table with. - The second line of the yaml file can optionally be labeled
randomize
. This tells the API server whether you want the seed data randomized, or ordered. Ordered data can be useful if you need to have the same usernames across multiple objects, for example. - The following lines in the yaml file define what the structure of your object will look like.
- Notice the following yaml example has some variable names bounded by underscores (
_systemname_
)- these will be discussed in the next step.
systems.yaml:
initial_entries: 8
randmoize: false
name: _systemname_
status: _activity_
sessions: _session_
workloads: _workload_
will generate eight random JSON objects that look like this:
{
"name": "tdsystem",
"status": "active",
"sessions": "12",
"workloads": "55"
- Create a text file in the
/datum
directory. - The text file should be named with one of the underscore bounded variables from the previous steps. (For instance,
systemname.txt
. - Each line of the txt file should have one value that you want to seed your initial database with. (For instance,
tdsystem
). - Each underscore bounded variable should have a corresponding txt file!
systemname.txt:
tdsystem
awssystem
aster
localsystem
Once your mock objects are created, run the mock server. You can then send RESTful commands to it! Try the following:
GET http://localhost:8080/ping
(this will return a pong)GET http://localhost:8080/systems
(this will return the fake systems defined by the schemas and datum)POST http://localhost:8080/systems
- send a body with this one to create a new entryGET http://localhost:8080/systems/{system_name}
PUT http://localhost:8080/systems/{system_name}
- send a body with this one to update the systemDELETE http://localhost:8080/systems/{system_name}
- delete the system
Covalent-data will create realistic chart data that you can use right away in your charts.
Send a POST http://localhost:8080/charts
with a body that's formatted as such:
{
"name": "my new chart",
"key": "MyChartKey",
"num_data_points": 60,
"interval_seconds": 90,
"y_axes": [
{
"name": "cpu",
"function_type": "black_friday"
},
{
"name": "hits",
"function_type": "sawtooth"
}
]
}
This will create 60 points, spaced 90 seconds apart, with two y-axes- cpu
and hits
.
IMPORTANT NOTE: if you omit num_data_points
(or set to 0) then the chart data will disappear as you consume it. Otherwise,
you will always get 60 time ordered data points in a queue.
The following function_types
for Y axes are available:
black_friday
sawtooth
sine
slow_rise
slow_decline
square
triangle
The value you set for key
is how you will access your mock chart data. This is an optional value, and if you dont set this, the API will assign a unique key for your mock chart data.
Send a GET http://localhost:8080/charts/MyChartKey
and you will get a JSON array back that looks similar to this:
[
{
"cpu": 3.4086436391430617,
"hits": 0,
"timestamp": 1474998463
},
{
"cpu": 3.436764648923683,
"hits": 1,
"timestamp": 1474998523
},
{
"cpu": 4.839440493047819,
"hits": 2,
"timestamp": 1474998583
},
{
"cpu": 3.871987273635802,
"hits": 3,
"timestamp": 1474998643
},
{
"cpu": 3.3517529842176668,
"hits": 4,
"timestamp": 1474998703
},
{
"cpu": 4.161895630999336,
"hits": 5,
"timestamp": 1474998763
}
]
- Update schema detection to use go templates
- Godoc support
- Function support for CRUD seeding