@gooddata/mock-js
    TypeScript icon, indicating that this package has built-in type declarations

    2.23.0 • Public • Published

    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 of mock.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 the mock.setup.js's ISchemaGroup 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

    Install Node.js (node 12.16.1, npm v6.13.4) and Yarn 1.22.4.

    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.

    Keywords

    none

    Install

    npm i @gooddata/mock-js

    DownloadsWeekly Downloads

    154

    Version

    2.23.0

    License

    BSD-3-Clause

    Unpacked Size

    2.22 MB

    Total Files

    857

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar