0.19.3 • Public • Published

    RESTBase Build Status Coverage Status

    RESTBase was built to provide a low-latency & high-throughput API for Wikipedia / Wikimedia content. It is basically a storage proxy, which presents a coherent API powered by Swagger specs to the outside, and backs up many of these entry points with storage. The default table storage backend is based on Cassandra, which helps it to perform well at Wikimedia's scale without placing undue burden on operations.

    As a proxy, RESTBase does not perform any significant content processing itself. Instead, it requests content transformations from backend services when needed, and typically (depending on configuration) stores it back for later retrieval. For high-volume static end points, most requests will be satisfied directly from storage.

    The table storage backends conform to a RESTful table storage API similar to Amazon DynamoDB and Google DataStore. The primary implementation uses Apache Cassandra. Notable features include automatically maintained secondary indexes and some lightweight transaction support. A SQLite backend is under development.

    RESTBase systematically emits statsd metrics about storage and backend requests. Specifically, the systematic metric production for backend services provides a good baseline level of instrumentation for tracking performance and errors in a micro-service architecture.

    Issue tracking

    We use Phabricator to track issues. See the list of current issues in RESTBase.


    Make sure that you have node 6+:

    sudo apt-get install nodejs nodejs-legacy nodejs-dev npm

    Note: if your distribution does not have a recent version of Node, you can install one via nvm.

    From the restbase project directory, install the Node dependencies:

    npm install

    Start RESTBase:

    node server

    The defaults without a config file should work for a local Cassandra installation with the default passwords. Restbase has been tested with Cassandra 2.2.6. To customize RESTBase's behaviour, copy the example config to its default location:

    cp config.example.yaml config.yaml

    You can also pass in the path to another file with the -c commandline option to server.js. If you're running a single Cassandra instance (e.g. a local development environment), set defaultConsistency to one in config.yaml.


    See the Wikimedia REST content API sandbox for a fine example of what RESTBase can do.



    To run all the tests from a clean slate, first make sure Cassandra is running locally, then fire up the tests with npm:

    npm test

    To run tests from a single file, e.g. test/features/pagecontent/rerendering.js, run mocha with the file as an argument:

    mocha test/features/pagecontent/rerendering.js

    Note that this might require some setup (e.g. creating the necessary domain and buckets), which is currently done by test/buckets.js.

    This also works for a directory, e.g. test/features/pagecontent/:

    mocha test/features/pagecontent


    To check the test coverage, use npm, then browse the report:

    npm run-script coverage

    The coverage report can now be found in <project>/coverage/lcov-report/index.html.

    Design docs


    npm i @femiwiki/restbase

    DownloadsWeekly Downloads






    Unpacked Size

    1.09 MB

    Total Files


    Last publish


    • lens0021
    • simnalamburt
    • miriryu
    • revi