Skip to content

Team Generator is a Node CLI that takes in information about employees and generates an HTML webpage that displays summaries for each person.

Notifications You must be signed in to change notification settings

CodingErik/teamGenerator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Team Generator

GitHub Language Count GitHub Followers NPM Inquirer NPM Chalk-pipe License: MIT Tweet

Description

Team Generator is a Node CLI that takes in information about employees and generates an HTML webpage that displays summaries for each person. The application will prompt the user for information about the team manager and then information about the team members. The user can input any number of team members, and they may be a mix of engineers and interns. This assignment must also pass all unit tests. When the user has completed building the team, the application will create an HTML file that displays a nicely formatted team roster based on the information provided by the user. Following the common templates for user stories, we can frame this challenge as follows:

Table of Contents

Please use the links in the table below to navigate the ReadMe contents.

User Story

As a manager
I want to generate a webpage that displays my team's basic info
so that I have quick access to emails and GitHub profiles
  • Below is a demo of what the application.

Employee Summary 1 Employee Summary 2

Get Started

In the Develop folder, there is a package.json, so make sure to npm install.

The dependencies are, jest for running the provided tests, and inquirer for collecting input from the user.

There are also unit tests to help you build the classes necessary.

It is recommended that you follow this workflow:

  1. Run tests
  2. Create or update classes to pass a single test case
  3. Repeat

🎗 Remember, you can run the tests at any time with npm run test

It is recommended that you start with a directory structure that looks like this:

lib/           // classes and helper code
output/        // rendered output
templates/     // HTML template(s)
test/          // jest tests
  Employee.test.js
  Engineer.test.js
  Intern.test.js
  Manager.test.js
app.js         // Runs the application

MVP

  • Functional application.

  • GitHub repository with a unique name and a README describing the project.

  • User can use the CLI to generate an HTML page that displays information about their team.

  • All tests must pass.

User input

The project will prompt the user with questions to build an engineering team. An engineering team consists of a manager, and any number of engineers and interns.

Roster output

The project generates a team.html page in the output directory, that displays a nicely formatted team roster. Each team member displays the following in no particular order:

  • Name

  • Role

  • ID

  • Role-specific property (School, link to GitHub profile, or office number)

Final Output

Expected testing out should be written directory called Output after going throught he prompt and answering all pertinent questions.

Installation Requirements

  • Node.js - Make sure Node.js is installed in your machine. If Node.js is not installed on your machine, click here to download the application.
  • NPM Inquirer Package - The NPM inquirer package is needed to prompt questions in the commandline.
    • This package is already listed as a dependency in the package.json file, so you will only need to run the npm install command in your terminal to access this package.

Dependencies

  • Jest - The jest is the Js testing framework that is used for unit testing in this project.

    • This dependency is already included in the package.json file, so you will only need to run the npm install command in your terminal to enable testing funcitionality.
  • chalk-pipe - chalk-pipe is a Js styling library used for CLI interfaces.

    • This dependency is included in the packege.json. All that needs to be done is run npm install or npm i for short.

Testing

To run test a test simply run npm run test to run all suites or npm run watch to continue to watch or run a specific suite. The following image shows all unit testing done.

  • Screenshot that demonstrates all unit tests pass.

Unit Test Pass

About

Team Generator is a Node CLI that takes in information about employees and generates an HTML webpage that displays summaries for each person.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published