node package manager
Stop writing boring code. Discover, share, and reuse within your team. Create a free org »

blackjack-utils

Blackjack CLI Tools

Contents

Background

These CLI tools are designed to ease working on Blackjack related projects. They should arm anyone unfamiliar with a typical Blackjack project with the necessary tools to run and contribute to such projects.

Once installed, you can be able to start a new component from scratch and run that component in isolation on a server. You can also perform additional tasks such as lint the codebase, or run unit tests.

Installation

Sadly due to odd NPM dependency issues (which will be fixed by us in future versions of the tools), you need to clone the tools and follow a few install steps. In the future we'll get this down to a npm install -g sky-uk/blackjack-tools.

Firstly, clone the repository somewhere on your machine:

git clone git@github.com:sky-uk/blackjack-tools.git

Then run an NPM install:

cd blackjack-tools
npm install

Wait roughly 5 years.

Finally, you need to add the ./bin directory to your path. To do this, get your current working directory, and append /bin to it. Then add it to your path:

pwd # Returns something like /Users/joshnesbitt/Code/blackjack-tools
export PATH="$PATH:/Users/joshnesbitt/Code/blackjack-tools/bin"

You'll probably want to save the export in your bash profile.

Now you should be able to use the tools anywhere on your system:

blackjack --help

Prerequisites

The target application you're running tests on should have the following babel packages installed:

  • babel-loader

Note: we're working on ensuring these dependencies are managed outside of the application.

Usage

For more information on the supported commands, run blackjack --help.

Commands are currently being developed, the status of them is defined below.

Complete

  • init - create a new component.
  • lint - lint all in test and lib dirs.
  • test - run JS tests in your test directory.
  • preview - preview the built component locally.

Pending

No pending commands right now.

Contributors

Contributing & Bug Reports

Contribution guidelines are shared with the main project, please see the CONTRIBUTING.md there.

We keep a list of features and bugs in the issue tracker.