项目作者: palowenstein

项目描述 :
Javascript powered Command-line application that dynamically generates a professional README markdown. Powered by Node.js. Executes in Terminal.
高级语言: JavaScript
项目地址: git://github.com/palowenstein/cli-good-readme-generator.git
创建时间: 2020-08-21T18:19:33Z
项目社区:https://github.com/palowenstein/cli-good-readme-generator

开源协议:

下载


#9-cli-good-readme-generator

Project license

READ ME Generator executed via Command Line Interface (CLI) in Terminal.

Github Repository Page: https://github.com/palowenstein/cli-good-readme-generator


Github Deployment Page: N/A - App is to be executed in Terminal via CLI.

Table of Contents

GIF

CLI Good Read Me Generator (GIF)

Overview


  • Read Me Generator executed in Terminal via (CLI) Command Line Interface.

  • Application behaves accordingly to standard (“good”) practices and dynamically generates a professional README markdown file.

  • User is prompted to respond to each question, one at a time.

  • All questions are answered via a character string except for the licence, which is choice driven.

  • The goal of the application is its simplicity of use and its overall time saving for the final user.

Details


  • A .gitignore file is present at the root level to prevent the upload of node_modules, .DS_Store.

  • The included package.json file includes all dependencies if the user wants to run ‘npm install’ instead of the instructions below

Instructions


  • In Terminal, locate the application folder and enter into it via the ‘cd’ command: cd hw9-cli-good-readme-generator

  • Run the ‘npm init’ command to fill the package json with the application information (screenshot #1).
  • Run the ‘npm inquirer’ to install the inquirer dependencies (screenshot #2).

  • Run the ‘node index.js’ command to start the application in Terminal (GIF/MP4).

  • While still in Terminal, answer the following prompts (GIF/MP4):

    1. GitHub Username

    2. E-Mail

    3. Title

    4. Description

    5. Licence

    6. Installation

    7. Tests

    8. Usage

    9. Contributions


  • Once all questions have been answered, a “README — Title (based on the title entered).md” will be generated in the application folder (screenshot #3).

Refer to index.js (javascript file) for code dissection.

Screenshots

CLI Good Read Me Generator (Screenshot #1: npm init)

CLI Good Read Me Generator (Screenshot #1: npm init)


CLI Good Read Me Generator (Screenshot #2: npm install inquirer)

CLI Good Read Me Generator (Screenshot #2: npm install inquirer)


CLI Good Read Me Generator (Screenshot #3: Read Me Markdown generated from user input)

CLI Good Read Me Generator (Screenshot #3: Generated Read Me Markdown)


Video

CLI Good Read Me Generator Prompt Flow (MP4)

CLI Good Read Me Generator Prompt Flow (MP4)


References


  • Node.js

  • Javascript

  • Inquirer

  • ES6+

  • Axios (optional - for GitHub username verification)

License


MIT License | Copyright © [2020] Pierre André Lowenstein

Contact


[www] pierreandrelowenstein.com
|
Send me a ‘courriel’