Skip to main content

Configure your GitHub repository from a file, without having to click around in the UI.

Project description

https://travis-ci.org/jacquerie/github-file.svg?branch=master https://coveralls.io/repos/github/jacquerie/github-file/badge.svg?branch=master

About

Configure your GitHub repository from a file, without having to click around in the UI.

Install

github-file is on PyPI, so all you have to do is:

$ pip install github-file

Usage

First, you will need to provide your GitHub credentials through the environment. Since github-file uses python-dotenv you can do so by creating a .env file with the following contents:

GITHUB_USER=your_username
GITHUB_PASS=your_password

Next, you will need to create a valid Githubfile. Here’s an example of one:

[core]
owner = jacquerie
repo = github-file
description = Configure your GitHub repository from a file,
    without having to click around in the UI.
topics = github, configuration, file

[features]
has_issues = true
has_projects = false
has_wiki = false

[merges]
allow_squash_merge = false
allow_merge_commit = false
allow_rebase_merge = true

The meaning of these options is explained in GitHub’s API documentation, although not all the options are currently supported (in particular you currently can’t archive the repository or configure the default branch.)

Finally, running

$ github-file update -f Githubfile

will update the configuration of your GitHub repository so that it matches what is described in the file. Note that if you don’t provide a filename it will look by default in .github/Githubfile.

Author

Jacopo Notarstefano (@Jaconotar)

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for github-file, version 0.5.2
Filename, size File type Python version Upload date Hashes
Filename, size github-file-0.5.2.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page