This application provides different tools for multiple purposes

Overview

Welcome to readme-md-generator 👋

downloads License: MIT gitmoji-changelog Twitter: FranckAbgrall

CLI that generates beautiful README.md files.
readme-md-generator will suggest you default answers by reading your package.json and git configuration.

Demo

readme-md-generator is able to read your environment (package.json, git config...) to suggest you default answers during the README.md creation process:

demo

Generated README.md:

cli output

Example of package.json with good meta data:

// The package.json is not required to run README-MD-GENERATOR
{
  "name": "readme-md-generator",
  "version": "0.1.3",
  "description": "CLI that generates beautiful README.md files.",
  "author": "Franck Abgrall",
  "license": "MIT",
  "homepage": "https://github.com/kefranabg/readme-md-generator#readme",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/kefranabg/readme-md-generator.git"
  },
  "bugs": {
    "url": "https://github.com/kefranabg/readme-md-generator/issues"
  },
  "engines": {
    "npm": ">=5.5.0",
    "node": ">=9.3.0"
  }
}

🚀 Usage

Make sure you have npx installed (npx is shipped by default since npm 5.2.0)

Just run the following command at the root of your project and answer questions:

npx readme-md-generator

Or use default values for all questions (-y):

npx readme-md-generator -y

Use your own ejs README template (-p):

npx readme-md-generator -p path/to/my/own/template.md

You can find ejs README template examples here.

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

🤝 Contributing

Contributions, issues and feature requests are welcome.
Feel free to check issues page if you want to contribute.
Check the contributing guide.

Author

👤 Franck Abgrall

Show your support

Please ⭐️ this repository if this project helped you!

📝 License

Copyright © 2019 Franck Abgrall.
This project is MIT licensed.


This README was generated with ❤️ by readme-md-generator

Issues
  • ✨Ask for package manager for a JS Project fixes#167

    ✨Ask for package manager for a JS Project fixes#167

    Hi!

    I am asking the user about the package manager in the project-info.js file after checking for package.json. Please let me know if there is a better place to put that question.

    Thank you.

    opened by anku255 14
  • Escape markdown characters in user input strings

    Escape markdown characters in user input strings

    Describe the bug Sometimes the username can itself contain markdown characters and it would render improperly. We need to escape markdown character for it to actually render the correct username.

    For example:

    * Twitter: [@__anku__](https://twitter.com/__anku__)
    

    renders as

    expected output

    To Reproduce Use markdown characters while entering username/email.

    I am not exactly sure how to solve this but I think we need to create a function that will escape all markdown characters and use that function to sanitize user input.

    I would like to take a shot at this :)

    opened by anku255 10
  • Use npm/yarn

    Use npm/yarn

    If a package.json is detected, readme-md-generator should ask to choose between yarn and npm. It would allow suggest install, usage and test command with correct package manager (instead of always using npm)

    enhancement good first issue 
    opened by kefranabg 7
  • Error on

    Error on "readme" command : TypeError [ERR_INVALID_ARG_TYPE]

    When I try to use the "readme" command it returns this error that I may have found in several Issue on other repo but none of the solutions are useful here :

    ⠋ Gathering project infosreadme [template]
    
    Generate README.md from a template
    
    Positionals:
      template  The name of template you want to use             [défaut: "default"]
    
    Options:
      --version  Affiche le numéro de version                              [booléen]
      --help     Affiche de l'aide                                         [booléen]
    
    TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received type undefined
        at validateString (internal/validators.js:107:11)
        at Object.basename (path.js:1149:5)
        at module.exports (/usr/local/lib/node_modules/readme-md-generator/node_modules/project-name/index.js:8:47)
        at Object.getProjectInfos (/usr/local/lib/node_modules/readme-md-generator/src/project-infos.js:106:16)
        at async mainProcess (/usr/local/lib/node_modules/readme-md-generator/src/cli.js:46:31)
    

    Thank you !

    bug 
    opened by Akecel 7
  • ✨Ask user for a link to  contributing guide (fixes #168)

    ✨Ask user for a link to contributing guide (fixes #168)

    Hi!

    This PR fixes #168

    I had to rename contributingUrl to issuesUrl first and then I used contributingUrl for the contributing guide link.

    Please take a look and suggest any changes if required. Thank you 🙂

    opened by anku255 6
  • [Hacktoberfest friendly]  Process stuck after readme creation

    [Hacktoberfest friendly] Process stuck after readme creation

    Describe the bug

    After the readme is generated, the process does not exit so we can't go back to the shell.

    To Reproduce

    1. Clone project
    2. Remove package-lock.json and node_modules (I think the problem is that when package is globally installed with npm, lock file is not used)
    3. Run npm start
    4. Answer questions
    5. The process does not quit after the readme is generated
    bug good first issue Hacktoberfest 
    opened by kefranabg 6
  • Static badge generation not working when license name contains special characters

    Static badge generation not working when license name contains special characters

    Describe the bug Static badge generation not working when license name contains special characters. Example Apache-2

    To Reproduce Steps to reproduce the behavior:

    • In your package.json, add "license": "Apache-2"
    • Run readme generator
    • Fill license url

    Expected behavior A clear and concise description of what you expected to happen.

    Should display a license badge in README with Apache-2 but we get a 404.

    Additional context Add any other context about the problem here.

    The issue come from shields.io that cannot contains special characters in url. readme-md-generator should skip special chars in license name.

    Hacktoberfest 
    opened by kefranabg 6
  • fixes #134: Display license badge even when there is no license url

    fixes #134: Display license badge even when there is no license url

    When there is a license name but no license URL, we will show the license badge with href=#.

    Example Image:

    image

    I ran the tests and all tests are passing.

    If it is not the desired fix, please let me know and I will update my PR accordingly.

    Thank you.

    opened by anku255 5
  • .git is added to the package

    .git is added to the package

    Hello!

    I juste updated readme-md-generator to version 0.6.0 and it seems there is the .git directory that has been added to the package. That implies that when when we try to do a npm install when readme-md-generator is already installed, we got the following error:

    npm ERR! path node_modules/readme-md-generator
    npm ERR! code EISGIT
    npm ERR! git node_modules/readme-md-generator: Appears to be a git repo or submodule.
    npm ERR! git node_modules/readme-md-generator
    npm ERR! git Refusing to remove it. Update manually,
    npm ERR! git or move it out of the way first.

    To reproduce it, simply install [email protected], install it and than try to do an other npm install

    Have a good day!

    Le Poulet Suisse

    opened by lepouletsuisse 5
  • Lock in question. I can't type anything.

    Lock in question. I can't type anything.

    When i execute, it's locked in second question "project version (use empty value to skip)".I can not type anything and I have to close the terminal.

    issueGenerator

    bug 
    opened by alanlopes4 5
  • :sparkles: Add Author Github homepage url if exists (fixes #124)

    :sparkles: Add Author Github homepage url if exists (fixes #124)

    Hi @kefranabg !

    I am referring Author's Github Website page URL as Author Homepage in the codebase. Please let me know if you want me to change this.

    Some points that will help during the code review:

    • Screenshot of the README

    image

    • I am using node-fetch library to make the get request.

    • I have added some tests but I guess I need to add a few more to get 100% code coverage. I will do that soon.

    • I needed to update the snapshots to make the tests pass.

    Please take a look and let me know what you think. Thank you.

    opened by anku255 4
  • Generating bad links

    Generating bad links

    The command line program generates bad links.

    To Reproduce Steps to reproduce the behavior:

    1. When prompted for to add a link the link will be entered with // between https: and the second level domain (website name)

    Expected behavior Should return the url as entered

    Screenshots

    Screen Shot 2021-11-25 at 9 46 48 AM

    Desktop (please complete the following information):

    • OS: Mac 12.01
    opened by SJellen 0
  • Improve readability of README.md

    Improve readability of README.md

    Fixed some language issues like metadata is one word. And "suggest you" is poor English so "suggest ... to you"

    Fixed up links to be local absolute paths and point license badge to license section.

    opened by MichaelCurrin 1
  • [Feature] Ask changelog and update copyright year license

    [Feature] Ask changelog and update copyright year license

    Resolving issue #205

    Ask a new question to set the changelog url. By default, it takes the base url of the repository and get a file named : "CHANGELOG.md"

    In the same time, I have updated the copyright year to 2021 for passing all the test.

    opened by Mousticke 0
  • Tests on master fail when project is cloned locally

    Tests on master fail when project is cloned locally

    Describe the bug When the project is cloned from the master branch, one of the test suites fails.

    To Reproduce Steps to reproduce the behavior:

    1. Clone this project
    2. run npm install
    3. run npm run test
    4. Two tests for src/readme.spec.js should fail. They should be:
      1. should return readme default template no html content
      2. should return readme default template content

    Expected behavior Tests should not fail when the project is cloned from the master branch.

    Desktop (please complete the following information):

    • OS: Linux, Manjaro
    • Browse Firefox
    • Version 86.0

    Additional context The issue seems to be caused by the snapshot README file in src/__snapshots__ folder. The two lines in the file causing the problem are:

    1. Copyright © 2019 [Franck Abgrall](https://github.com/kefranabg).<br />
    2. Copyright © 2019 [Franck Abgrall](https://github.com/kefranabg).

    One of the offending tests is this one:

    it('should return readme default template no html content', async () => {
          const result = await buildReadmeContent(
            context,
            defaultNoHtmlTemplatePath
          )
    
          expect(result).toMatchSnapshot()
        })
    

    It seems like the readme built for test contains a copyright year of 2021 instead of 2019.

    opened by sehnsucht13 1
  • Add README Badge Option feature section in auto generated README.md

    Add README Badge Option feature section in auto generated README.md

    Is your feature request related to a problem? Please describe. It is an enhancement. README badges look really cool.
    How? Suppose I am using Tensorflow in my Project or Application. Tensorflow would love to reference "HOW TO Add Readme Badge" in their README.md for their users to add in their README similar to "powered by Tensorflow" badge with logo or color.

    Describe the solution you'd like This helps to implement this Badge/Shield Feature.

    What we can do?

    While generating the README automatically, along with that we can add a section in README.md file which has something like this that has been implemented in Hub:

    image

    Additional context Let me know how this sounds. Up for discussions and implementation ideas! Thank you

    opened by sohamsshah 0
Releases(v1.0.0)
Package damsel provides html outlining via css-selectors and common template functionality.

Damsel Markup language featuring html outlining via css-selectors, extensible via pkg html/template and others. Library This package expects to exist

Daniel Skinner 25 Jan 24, 2022
Goview is a lightweight, minimalist and idiomatic template library based on golang html/template for building Go web application.

goview Goview is a lightweight, minimalist and idiomatic template library based on golang html/template for building Go web application. Contents Inst

foolin 283 Jun 19, 2022
This application provides different tools for multiple purposes

Welcome to phoenix ?? A command line helper made to simplify your life. This application provides different tools for multiple purposes. Install curl

Mugdha Arunim Ahmed 0 Dec 18, 2021
A vulnerable graphQL application, for testing purposes

Vulnerable-GoQL Vulnerable-GoQL is an web API which implements main security breach.

Escape 3 Jul 31, 2021
CSPFinder is a tool to compare ROI of selling Cash Secure Put options between different tickers for different expiry dates.

CSPFinder is a tool to compare ROI of selling Cash Secure Put options between different tickers for different expiry dates. It is intended to help open new cash secured put positions.

Sreenidhi Sreesha 26 Dec 21, 2021
Plugs module to see different types of plug types needed in different countries, and a comparison tool between two countries plug socket types.

plugs Importing the module: go get github.com/matthewboyd/plugs "github.com/matthewboyd/plugs" How to use the module: There are two functions wi

Matthew Boyd 2 Dec 28, 2021
siusiu (suite-suite harmonics) a suite used to manage the suite, designed to free penetration testing engineers from learning and using various security tools, reducing the time and effort spent by penetration testing engineers on installing tools, remembering how to use tools.

siusiu (suite-suite harmonics) a suite used to manage the suite, designed to free penetration testing engineers from learning and using various security tools, reducing the time and effort spent by penetration testing engineers on installing tools, remembering how to use tools.

Re 242 Jun 20, 2022
what the name says (made for "educational" purposes)

NOTES You will need to Download Golang - golang compiler Download MinGW - C compiler (Add this to your path.) You can safely ignore these errors below

Cyrus 42 May 9, 2022
"Go SQL DB" is a relational database that supports SQL queries for research purposes

A pure golang SQL database for database theory research

auxten 677 Jun 16, 2022
Gets Firebase auth tokens (for development purposes only)Gets Firebase auth tokens

Firebase Token Gets Firebase auth tokens (for development purposes only) Getting started Create Firebase project Setup Firebase authentication Setup G

MousyBusiness 1 Nov 17, 2021
A CoreDNS plugin to serve temporary TXT records for validation purposes (eg. Let's Encrypt DNS-01)

temptxt Name temptxt - serves TXT records for validation purposes (eg. ACME DNS-01 challenge) updated through a HTTP api. Description The temptxt plug

null 0 Dec 17, 2021
Simple auth service for testing purposes

Auth mock service Simple auth service for testing purposes. Based on https://github.com/stefanprodan/podinfo Credentials: { "username": "username-ro

Kajetan 0 Oct 5, 2021
Collection of useful golang code snippets, mainly for learning purposes

Go-Things Collection of go code snippets, tools, etc. mainly for learning purpos

Marcel Hertel 0 Dec 31, 2021
Generate wordlist from already collected subdomains for bruteforcing purposes.

goSubsWordlist Generate a wordlist from a list of already discovered subdomains. This list can be used for further bruteforcing for more subdomains. I

kenjoe41 2 May 2, 2022
An event driven remote access trojan for experimental purposes.

erat An event driven remote access trojan for experimental purposes. This example is very simple and leverages ssh failed login events to trigger erat

siovador 0 Jan 16, 2022
Social network - A microservices based backend for training purposes

social_network A microservices based backend for training purposes Requirements

Thomas 1 Feb 24, 2022
The dynamic infrastructure framework for everybody! Distribute the workload of many different scanning tools with ease, including nmap, ffuf, masscan, nuclei, meg and many more!

Axiom is a dynamic infrastructure framework to efficiently work with multi-cloud environments, build and deploy repeatable infrastructure focussed on

pry0cc 2.7k Jun 24, 2022
FizzBuzz: A ready-to-use console application that provides tools to format output with conditions

FizzBuzz FizzBuzz is a ready-to-use console application that provides tools to f

null 0 Feb 16, 2022
This benchmark provides a overview of the different SQLite driver performances available in Go.

SQLite/HTTP Server Performance Benchmark This benchmark provides a overview of the different SQLite driver performances available in Go. For benchmark

Philipp Tanlak 1 Dec 2, 2021
Linux provisioning scripts + application deployment tools. Suitable for self-hosting and hobby-scale application deployments.

Apollo Linux provisioning scripts + application deployment tools. Suitable for self-hosting and hobby-scale application deployments. Philosophy Linux-

K T Corp. 1 Feb 7, 2022
Application for HTTP benchmarking via different rules and configs

Go Benchmark App The efficiency and speed of application - our goal and the basic idea. Application for HTTP-benchmarking via different rules and conf

Evgeny Ukhanov 22 Nov 7, 2021
🐺 Garment retains a single connection pool for different database types used inside you application

Garment A Thread Safe Connection Pooling. Garment retains a single connection pool for different database types used inside you application (MySQL, Re

SpaceWalk 12 Jun 26, 2022
Get any cryptocurrencies ticker and trade data in real time from multiple exchanges and then save it in multiple storage systems.

Cryptogalaxy is an app which will get any cryptocurrencies ticker and trade data in real time from multiple exchanges and then saves it in multiple storage systems.

Pavan Shetty 97 Jun 6, 2022
S3pd - CLI utility that downloads multiple s3 objects at a time, with multiple range-requests issued per object

S3 Parallel Downloader CLI utility that downloads multiple s3 objects at a time,

Colin Bookman 2 May 13, 2022
Log4j-scanner tools - Support for multiple scan method

Log4j-scanner URL mode (fuzzing url with header, payload) go run . url -h Usage

BREAK TEAM - Hacking Team 1 Jan 4, 2022
Go-utils - Multiple tools and example for golang

go-utils Description Multiple tools and example for golang database : example to

null 0 Jan 1, 2022
gNXI Tools - gRPC Network Management/Operations Interface Tools

gNxI Tools gNMI - gRPC Network Management Interface gNOI - gRPC Network Operations Interface A collection of tools for Network Management that use the

Google 213 Jun 12, 2022
Chanify is a safe and simple notification tools. This repository is command line tools for Chanify.

Chanify is a safe and simple notification tools. For developers, system administrators, and everyone can push notifications with API.

Chanify 868 Jun 23, 2022
Tools - This subrepository holds the source for various packages and tools that support

Go Tools This subrepository holds the source for various packages and tools that

Rohan 0 Jan 12, 2022