Skip to content
This repository has been archived by the owner on May 17, 2021. It is now read-only.

Latest commit

 

History

History
78 lines (48 loc) · 4.01 KB

README.md

File metadata and controls

78 lines (48 loc) · 4.01 KB
Raw

🗄 Archival Notice

This repository is being archived in May 2021. This repository was originally conceived as a joint project between the Digital Impact Alliance (DIAL), Digital Public Goods Alliance (DPGA) + UNICEF Office of Innovation and Ovio to synchronize and share our data. It served its purpose during the many months that we have been maintaining it, and it has allowed all organizations involved to grow our respective datasets and to coordinate efforts in the joint space in which we operate. We now have realized that there are more efficient ways to accomplish the same goals, and we will continue to periodically share and synchronize our data, while each organization maintains and makes their data publicly available through the resources below:

Products

Collection of public goods.

This repository is designed to be both browsed by humans, and consumed directly by other applications that can easily parse machine-readable JSON files.

Installation

If you want to contribute, clone this repository locally as follows:

  • Clone with HTTPS:

     git clone --recurse-submodules https://github.com/publicgoods/products.git

  • Clone with SSH:

     git clone --recurse-submodules [email protected]:publicgoods/products.git

Install dependencies:

npm install

Create your product files inside the products/ folder. The filename for each product should match the name field in that product in kebab-case.

The following checks will run automatically (both as a pre-commit hook through Husky, and in the Continuous Integration (CI)):

  • npm test: Validates all JSON product files against the JSON data schema
  • npm run order: Checks that all JSON properties are listed in the same order as specified in the JSON data schema. If this fails, run npm run order:fix to fix.
  • npm run lint: Ensures that all JSON files are formated properly using 2 spaces for indentation. If this fails, run npm run lint:fix to fix.
  • npm run check: Checks that all files are named according to their product name in kebab-case. If this fails, run npm run check:fix to fix.

Bulk Import

A script utility scripts/import.js is provided to facilitate the merging of product files coming from another existing dataset:

  1. Create a tmp folder at the root of this repository:
mkdir tmp

  1. Copy all files to be imported into the above tmp/ folder.

  2. From the repository root folder run:

node scripts/import.js

This will find files that exist in both datasets and attempt to merge. For each field that has different values between both sets, it will interactively prompt the user to choose one or the other. At any point in time, the user can abort the script to manually edit any field with a different value. Additional files that do not already exist, will simply be copied over. This script will modify both sets of files in tmp/ and products/. You can then commit the changes in products/ and discard the files left in tmp/.

License

Licensed under the CC-0.