google-cast-launcher
npm install google-cast-launcherAn API Boilerplate project built with Node.js and Typescript.
- ā± Runtime: Node.js
- š„ API Framework: Fastify
- š Type System: TypeScript
- š§Ŗ Test Runner: Jest
- š Linter: ESLint
- š¦ Continuous Integration: Azure DevOps
The following npm scripts can be run using npm run . This project relies on opn and rimraf utilities in order to support cross-platform opening and deleting files.
- buildā-ābuild the TypeScript files and output to lib/
- build:watchā-āautomatically rebuild files if changes are detected in src/
- cleanā-ārecursively delete the lib/ and coverage/ directories
- clean:buildā-ārecursively delete the lib/ directory
- clean:coverageā-ārecursively delete the coverage/ directory
- coverageā-ārun the test suite and generate code coverage reports
- coverage:openā-ārun npm run coverage then open the results in a browser
- devā-āconcurrently run build:watch and start:watchĀ
- lintā-ārun the linter configured by TSLint on the src/ directory
- startā-ārun the app from lib/. Make sure to use npm run build first!
- start:watchā-ārelaunch the server if new changes are detected in lib/Ā
- testā-ārun unit tests defined in the tests/ directory
- test:ciā-ārun unit tests and generate necessary files for CI integration
Matterhorn implements example usage of both command line arguments and environment variables. It uses yargs-parser to manage command line arguments. Command line arguments are passed in through the start command: node lib/index.js . The --log argument has been enabled as an example. Running npm run start starts up the project without any command line arguments. This command is intended to be used in production, so logging is disabled by default (i.e. we don't pass the --log argument). If you are using this command to test your code locally and want to see the logging output, then run npm run start -- --log. This passes the command line argument through npm and into the aliased command.
Environment variables work in a similar way to command line arguments. They can be set in multiple ways depending on the terminal and operating system you are using. In a bash terminal you can specify environment variables as you use any of the above mentioned scripts by prepending the assignment to the command. For example, this project has the PORT environment variable enabled. In a bash terminal run PORT=8080 npm run start to run the API on port 8080.
Open an issue if you'd like to report a bug or a feature. Make sure to write a detailed description and indicate if you will or will not be resolving the issue yourself.
If you are interested in contributing make sure to follow these practices:
- Prepend branches with fix/, feature/, or docs/ depending on the change being made
- NPM commands test, lint, and build run without failing.
- If you are solving an open issue, reference it in the Pull Request description using Ref #.
Matterhorn has a unique Jest set up. Under the jest/ directory there are three configuration files ci.config.json, coverage.config.json, and test.config.json. Each configuration file maps to a specific jest experience.
#### npm run test
Runs jest with the test.config.json configuration. This configuration does not collect any code coverage.
#### npm run coverage
Runs jest with the coverage.config.json configuration. It runs the same test suite as npm run test and collects coverage from all files under the src/ directory. It outputs the coverage information in the following formats: json, text, lcov, and html. It does not rely on any external reporter dependencies.
#### npm run test:ci
Runs jest with the ci.config.json configuration. It runs the same test suite as npm run test and collects coverage similar to the npm run coverage command, but utilizes jest's built in ci caching functionality. Additionally, it outputs the coverage in the following formats: html, json, and cobertura. It utilizes jest-junit reporter to generate compatible junit xml files for Azure DevOps test reporting, and the cobertura format for the code coverage reporting.
š Alyssa Cooper _Maintainer_ - Follow on: Twitter @ayecoops & GitHub @Alyssa-Cooper
 