dotseeker

Collect dotfile (e.g. .zshrc) from GitHub repositories which has dotfiles topic.

Usage

Install packages.

yarn install

Set GITHUB_API_TOKEN in .env file or environment.

GITHUB_API_TOKEN=xxxxxxxxxxxxxxxxx

Execute!

yarn start

dotseeker downloads dotfile into files directory.

# example for reireias/dotfile repository
files
└── reireias
    └── dotfiles
        ├── .bashrc
        └── .zshrc

You can customize this search logic.

await new Seeker(params).seek()

If params not specified, Seeker use default params.

The default params is follows.

params = {
  q: 'topic:dotfiles',
  sort: 'stars',
  page: 1,
  perPage: 10,
  filenamePattern: /^.*\.?(bashrc|bash_profile|zshrc|zsh_profile)/
}

The params structure is follows.

params = {
  q: String,
  sort: String,
  page: Number,
  perPage: Number,
  filenamePattern: Regexp Object
}

q is a query for searching repository.

sort is a sort option for searching repository.

page is the page number for searching result pagenation.

perPage is the number of repository in one page for searching result pagenation.

The regexp object for filtering download file.

Example

/^.*\.?(bashrc|bash_profile|zshrc|zsh_profile)/