circleCI 


mason-js: a javascript client for mason

Why mason-js?

Mason-js is a JS client for Mason, the C++ package manager.

This project is:

- The first standalone cross-platform client for Mason.
- Makes installing packages seamless for node c++ addons.
- Could also be used in stacks that have nodejs as a dep.
- We are able to remove mason’s custom install scripts and house all of our logic in a JS client. Diff of install script vs mason-js in node-cpp-skel.

How to use this?

Install all package dependencies

``mason-js install`
- installs all packages from the mason-versions.ini file

Example mason-versions.ini:


[headers]
protozero=1.6.1
boost=1.65.1
[compiled]
jpeg_turbo=1.5.1
libpng=1.6.28
libtiff=4.0.7
icu=57.1
proj=4.9.3
pixman=0.34.0
cairo=1.14.8

Symlink Installed Packages

`mason-js link`
- symlinks packages

Install a Single Package

`mason-js = --type=[header or compiled]`
- installs a single package

Example

mason-js protozero=1.5.1 --type=header

What is V1?


- Ability to install all packages from a mason-versions.ini file
- Ability to link all packages from a mason-versions.ini file
- Ability to install a single package
- Available on Mac, Linux, and Windows environments
- Tests via CircleCI & Apprevyor

In short, mason-js:

1. Reads a mason-versions.ini file in the root directory of a project.
2. Installs header only and precompiled packages from the S3 bucket mason-binaries into a mason-packages folder
3. Creates symlinks a .link directory to package executables


Remote Package Paths:

- Header-only: s3://mason-binaries/headers/{package}/{version}.tar.gz

- Binaries: s3://mason-binaries/{MASON_PLATFORM}-{MASON_PLATFORM_VERSION}/{package}/{version}.tar.gz


Note: The value of MASON_PLATFORM_VERSION is determined per platform.

Local Package Paths:


- Header-only: ./mason_packages/headers/{package}/{version}/
- e.g. mason_packages/headers/vtzero/556fac5/include/vtzero/vector_tile.hpp


- Binaries: ./mason_packages/{platform}-{arch}/{package}/{version}/
- e.g. mason_packages/osx-x86_64/gdal/2.2.1/bin/ogr2ogr


- Linked folder: ./mason_packages/.link/
- e.g. mason_packages/.link/lib/libpng.a




Development

Install Local Dependencies

`npm install`

`npm link`

Run Tests

`npm test`

Make commands

The Make file has a series of commands that run a Docker container locally. By using these commands, you’re able to simulate staging/production environments locally.

Make sure to set your NPMAccessToken in your environment before running any make commands.


- make bash - opens a terminal shell session in your Docker image
- make build - build your Docker image locally
- make run - send a message to the queue. (this command runs make build first)
- make test` - run tests