OrkoHunter / repo-scaffolding

Tools for creating repos based on open source standards and best practices

repo-scaffolding

Scaffolding tools for creating and maintaining projects based on Twitter Open Source standards and best practices. The project has 3 parts -

1. Cookiecutter template to generate Twitter OSS policy files e.g. LICENSE, CONTRIBUTING, etc.
2. Script to add License headers to all source files in a project
3. Lint a repository for common missing files (repolinter)

---

1. Cookiecutter template to generate OSS policy files

A cookiecutter template to generate necessary files for a Twitter Open Source project.

Requirements

Install cookiecutter command line: pip install cookiecutter

---

pip is the package manager for Python. If you don't have pip, install Python.

brew install python

Note: cookiecutter can be installed with both pip and pip3.

Usage

Run cookiecutter against this repository.

cookiecutter https://github.com/twitter/repo-scaffolding

or

cookiecutter gh:twitter/repo-scaffolding

or

You can also run it locally after cloning this repository:

cookiecutter /path/to/directory/

See documentation for more usage instructions.

Inputs

See cookiecutter.json for all the variables required as input. Here is the list of places they are used

• author_full_name: 1 time in README.md in the Authors section.
• author_email: 1 time in README.md in the Authors section
• project_slug: 1 time in README.md and also for the name of the parent directory
• github_repo_url: 2 times in README.md and 4 times in CONTRIBUTING.md for the GitHub repo links
• short_description: 1 time in README.md
• project_homepage: 1 time in README.md
• documentation_homepage: 1 time in README.md
• mailing_list: 1 time in README.md
• release_year: 1 time in LICENSE and 1 time in README.md

Notes

• Make sure to update the TODO sections in README.md and CONTRIBUTING.md after generating the files

2. License Headers script

A script to add license headers to all the source files of a project. It is designed to be safe, so do not worry and try it out!

Installation

pip install git+git://github.com/twitter/repo-scaffolding

Or clone the repository and run

python setup.py install

Usage

$ add_license_headers <path_to_source_dir>

3. Linting (repolinter)

Lint all the necessary files in the project. - Project Homepage

• To run against a directory, use npx repolinter /my/code/dir
• To run against a git repository, use the --git option: npx repolinter --git https://my.git.code/awesome
• Note, if you are running a version of npm < 5.2.0, run npm install npx first.

---

Authors

• TwitterOSS <opensource [at] twitter [dot] com>

Follow @TwitterOSS on Twitter for updates.

Security Issues?

Please report sensitive security issues via Twitter's bug-bounty program (https://hackerone.com/twitter) rather than GitHub.

License

This project is licensed under the terms of the Apache 2.0