Socket
Socket
Sign inDemoInstall

@webiny/api-headless-cms

Package Overview
Dependencies
28
Maintainers
1
Versions
471
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@webiny/api-headless-cms

GraphQL API for Webiny Headless CMS.


Version published
Weekly downloads
1K
increased by34.86%
Maintainers
1
Created
Weekly downloads
 

Readme

Source

@webiny/api-headless-cms

code style: prettier PRs Welcome

Install

npm install --save @webiny/api-headless-cms

Or if you prefer yarn:

yarn add @webiny/api-headless-cms

Testing

Due to possibility of multiple storage operations, the tests are completely decoupled from those storage operations.

The jest.setup.js is using @webiny/project-utils/testing/presets.js to find and load all the packages containing @webiny/api-headless-cms and storage-operations keywords in their package.json file. Those packages are then used to build the test run - one for each of the packages. So depending on how many storage operations there are in the repository, that much of api-headless-cms tests will run.

Defining test environment

To make it possible for api-headless-cms tests to run with a storage operations package you MUST create presets.js file in storage-operations-package-path/__tests__/__api__/ directory. That file is loaded when setting up the api-headless-cms tests.

It MUST contain the testEnvironment variable which contains path to the environment definition file.

That environment file MUST define the test environment which extends NodeEnvironment class.

Test environment MUST expose __getStorageOperationsPlugins method, via this.global property of the class, which will load the required plugins in the api-headless-cms tests.

Examples of preset and test environment files

The first implementation of the decoupled storage operations is DynamoDB/Elasticsearch, which you can find in @webiny/api-headless-cms-ddb-es. Files which you can check to help you define your own presets and test environment are:

  • presets.js - an array of presets of which last one defines the environment to be loaded
  • environment.js - a class which extends NodeEnvironment and exposes __getStorageOperationsPlugins to the tests

Debugging when testing

For the WebStorm (PhpStorm,...) when starting a test you must have some values defined in the run/debug configurations screen:

Node options
--inspect=9229
Working directory
PATH_TO_YOUR_PROJECT_ROOT

example:

~/webiny/webiny-js/
Jest options

For DynamoDB + Elasticsearch storage operations tests:

--keyword=cms:base --keyword=cms:ddb-es

For the DynamoDB storage operations tests:

--keyword=cms:base --keyword=cms:ddb

Note that base keyword is the cms:base. It tells Jest setup to load the api-headless-cms tests with the api-headless-cms-ddb-es tests.

Environment variables

If you want to use local Elasticsearch:

ELASTICSEARCH_PORT=9200;LOCAL_ELASTICSEARCH=true

Nothing if you do not want to use the local Elasticsearch.

Keywords

FAQs

Package last updated on 15 Jul 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc