Skip to content

Latest commit

 

History

History
67 lines (47 loc) · 2.98 KB

README.md

File metadata and controls

67 lines (47 loc) · 2.98 KB

starwars-names

travis build codecov coverage version downloads MIT License semantic-release

Get random names from Star Wars characters.

starwars-names

Installation

This package is distributed via npm:

npm install starwars-names

Usage

var names = require('starwars-names');
var allNames = names.all;
var randomName = names.random();
var threeRandomNames = names.random(3);

Other

This library was developed by me as part of an egghead.io series called "How to Write a JavaScript Library."

I'm now also using it to give a workshop for Frontend Masters.

Project Setup

This project assumes you have NodeJS v6 or greater installed. You should also have npm v3 or greater installed as well (this comes packaged with Node 6). You'll also need a recent version of git installed as well.

You may have come to this project from different varying sources. There are a different series of branches for each workshop/course I've done. To get started with the project, start with this:

  1. Sign up for a GitHub Account (if you don't already have one)
  2. Fork this repo
  3. Clone your fork
  4. In the directory you cloned the repository, run git fetch --all

If you need help with these steps, you might check out this free Egghead.io course which can help you get things going.

Finally, based on which version of the project you're looking for (workshop, egghead, or Frontend Masters) you'll run one of the following commands in the cloned directory:

  • Frontend Masters Workshop: npm run setup:fem
  • Egghead Course: npm run setup:egghead

If you get any failures at this point something is wrong and needs to be fixed. Remember, Google and StackOverflow are your friends.

You might find it helpful to see a list of the available branches. Run: git branch for that.