repolint

Tool to check github user/organization repositories for some simple and common issues.

Using the collected results

./issues/ directory contains a list of issues found in multiple Github organizations. Every file contains a whole organization analysis.

Here is a list of analyzed organizations (in alphabetical order):

• adobe
• apache
• apple
• autodesk
• CanonicalLtd
• Debian
• dell
• docker
• eclipse
• esri
• freedesktop
• gentoo
• github
• google
• hewlettpackard
• IBM
• intel
• JetBrains
• microsoft
• Netflix
• nvidia
• openshift
• oracle
• sap
• siemens
• spotify
• tdf
• twitter
• vmware
• yandex

Some stats:

Kind of an issue	Numbers reported
Broken link	3860
Misspell (typo)	3408
Acronym	166
Unwanted file	137

Number of checked repositories: 5891.

Overview

repolint makes contributions during events like hacktoberfest simpler for first time contributors and people that are not familiar with open source very well.

One can prepare a list of detected issues and propose them as a tasks to be solved by attendees or ask them to run repolint on their own.

Almost everything that repolint finds can be converted into a pull request that fixes reported issues.

Installation / Usage / Quick start

To get repolint binary, run:

go get -v github.com/Quasilyte/repolint

This assumes that $(go env GOPATH)/bin is under your system $PATH.

You need github auth token to continue.

There are 2 ways to pass token to the repolint:

1. Use environment variable TOKEN.
2. Place token file that contains the token in the current working directory.

Code below runs repolint over all Microsoft organization repositories. Note that it can take a lot of time to complete:

# Suppose your token is `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
export TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
repolint -v -user=Microsoft

-v flag is used to get more debug output from the repolint. It's optional.

By default, it skips all fork repositories. -skipForks=false will enable forked repositories checks.

What repolint can find

Most issues are very simple and are agnostic to the repository programming language.

• Typos in some common files like readme and contributing guidelines.
• Broken links.
• Committed files that should be removed (like Emacs autosave and backup files).
• Issues in special files like .travis.ci.

Dependencies

• liche - link checker.
• misspell - spelling checker.

Example

For bad-repo it can output something like:

	checking Quasilyte/bad-repo...
bad-repo: broken link: dir/README.md: http://non-existing.link.ever/ok: Lookup non-existing.link.ever on 127.0.1.1:53: no such host
bad-repo: broken link: dir/README.md: http://this-url.doesnotexist.ru/: Lookup this-url.doesnotexist.ru on 127.0.1.1:53: no such host
bad-repo: broken link: dir/README.md: https://link.foo-and-bar.bar: Lookup link.foo-and-bar.bar on 127.0.1.1:53: no such host
bad-repo: misspell: CONTRIBUTING.md:1:0: "existance" is a misspelling of "existence"
bad-repo: misspell: CONTRIBUTING:1:0: "existance" is a misspelling of "existence"
bad-repo: misspell: README.rst:11:0: "excelent" is a misspelling of "excellent"
bad-repo: misspell: dir/README.md:1:0: "oversimplificiation" is a misspelling of "oversimplification"
bad-repo: var name typo: README.rst:19: $CLASSPAHT could be a misspelling of CLASSPATH
bad-repo: var name typo: README.rst:20: ${GOPAHT} could be a misspelling of GOPATH
bad-repo: unwanted file: remove Emacs autosave file: #autosave.txt#
bad-repo: unwanted file: remove Emacs lock file file: .#lockfile.txt
bad-repo: unwanted file: remove Mac OS sys file file: .DS_STORE
bad-repo: unwanted file: remove Vim swap file: .foo.swp
bad-repo: unwanted file: remove Windows sys file file: Thumbs.db
bad-repo: unwanted file: remove Emacs backup file: backup.txt~
bad-repo: sloppy copyright: LICENSE: license contains sloppy copyright
bad-repo: acronym: README.rst:13: replace sql with SQL
bad-repo: acronym: README.rst:14: replace gcc with GCC
bad-repo: acronym: README.rst:15: replace gnu with GNU

Note that this example output may be outdated and the bad-repo itself can change over time. It's only a demonstration.