GITHUB

Usage: lftools github [OPTIONS] COMMAND [ARGS]...

  GITHUB TOOLS.

Options:
  --help  Show this message and exit.

Commands:
  create-repo  Create a Github repo within an Organization.
  create-team  Create a Github team within an Organization.
  list         List options for github org repos.
  submit-pr    Submit a pr if mergeable.
  update-repo  Update a Github repo within an Organization.
  user         Add and Remove users from an org team.
  votes        Helper for votes.

Commands

create-repo

Usage: lftools github create-repo [OPTIONS] ORGANIZATION REPOSITORY
                                  DESCRIPTION

  Create a Github repo within an Organization.

  By default has_issues has_wiki and has_projects is set to false. See --help
  to create a repo with these enabled.

Options:
  --has_issues    Repo should have issues
  --has_projects  Repo should have projects
  --has_wiki      Repo should have wiki
  --help          Show this message and exit.

create-team

Usage: lftools github create-team [OPTIONS] ORGANIZATION NAME PRIVACY

  Create a Github team within an Organization.

  Privacy should be set to closed This allows us to control group membership.

Options:
  --repo TEXT  Assign team to repo
  --help       Show this message and exit.

list

Usage: lftools github list [OPTIONS] ORGANIZATION

  List options for github org repos.

Options:
  --audit         List members without 2fa
  --repos         List all repos
  --full          All members and their respective teams
  --teams         List avaliable teams
  --team TEXT     List members of a team
  --repofeatures  List enabled features for repos in an org
  --help          Show this message and exit.

update-repo

Usage: lftools github update-repo [OPTIONS] ORGANIZATION REPOSITORY

  Update a Github repo within an Organization.

  By default has_issues has_wiki and has_projects is set to false. See --help
  to use this command to enable these options.

Options:
  --has_issues        Repo should have issues
  --has_projects      Repo should have projects
  --has_wiki          Repo should have wiki
  --add_team TEXT     Add team to repo
  --remove_team TEXT  remove team from repo
  --help              Show this message and exit.

submit-pr

Usage: lftools github submit-pr [OPTIONS] ORGANIZATION REPO PR

  Submit a pr if mergeable.

Options:
  --help  Show this message and exit.

user

Usage: lftools github user [OPTIONS] ORGANIZATION USER TEAM

  Add and Remove users from an org team.

Options:
  --delete  Remove user from org
  --admin   User is admin for org, or a maintaner of a team
  --help    Show this message and exit.

votes

Usage: lftools github votes [OPTIONS] ORGANIZATION REPO PR

  Helper for votes.

Options:
  --help  Show this message and exit.

API requires a [github] or [github.OrgName] section in ~/.config/lftools/lftools.ini:

[github] or [github.orgName]
token = REDACTED