@gooddata/mock-js
v2.24.13
Published
Mock server for GoodData UI applications (Analytical Designer and Dashboards).
Downloads
11,372
Maintainers
Keywords
Readme
mock-js
Mock server for GoodData UI applications (Analytical Designer and Dashboards).
How to use:
Install mock-js from private repository:
yarn add --dev @gooddata/mock-js
Create your mock-schema.json
file:
// mock-schema.json
{
"project": {
"title": "My mocked project"
},
"groups": [{
"attributes": [{
"title": "Account",
"elements": ["1", "2", "3"]
}],
"dateDataSets": [{
"title": "Activity"
}, {
"title": "Opportunity"
}, {
"title": "Closed"
}],
"metrics": [{
"title": "# Won"
}, {
"title": "# Closed"
}],
}, {
"meta": {
"type": "csv",
"identifier": "dataset.1"
},
"attributes": [{
"title": "Attribute A"
}, {
"title": "Attribute B"
}],
"metrics": [{
"title": "Metric A"
}, {
"title": "Metric B"
}]
}],
// if execution request matches (ignoring localIdentifiers) it responds with saved executionResult
"afmExecutions": [
{
"execution": { ...executeAfmRequestBody },
"executionResult": { ...executionResultResponseBody }
}
]
}
The execution request, response and result obtained from production or staging server can be converted to mocked
afmExecutions
record ofmock.setup.js
schema via web based tool hosted at/mock-builder
endpoint. Apart from the execution request, response and result the mocked project ID and index of themock.setup.js
'sISchemaGroup
group index must be entered. The project information is used to choose the mock project and one of its groups of measures and attributes that will be used to replace staging measure and attributes URIs in the execution for the mocked ones.
Register mock-js
middleware:
// server.js
const register = require('@gooddata/mock-js');
const schema = require('./mock-schema.json');
const config = {
pollCount: 1
};
module.exports = {
createMiddleware: function createMiddleware(webpackConfig, webpackOptions) {
return (app) => {
return register.default(app, { schema, config });
};
}
};
Development
Development
Project setup
yarn install --frozen-lockfile
Building project (with watch)
yarn dev
Deployment
Package publishing is done via Jenkins Job:
https://checklist.intgdc.com/job/client-libs/job/mock-js-release/
Running test suite:
yarn test
Running tslint
yarn validate
Source code formatting
The source code in the repository is formatted by Prettier. The format of the code is validated by our Continuous Integration server and is one of the requirements of successful merge.
Prettier is supported by every major IDE. You can find the list of supported editors and how to configure them here.
In the case, when your editor is not supported or you don't want to setup the integration, you can run the yarn prettier-write
command to reformat the code before commit.