view release on metacpan or  search on metacpan

script/github-cmd  view on Meta::CPAN

#!perl

our $DATE = '2020-04-08'; # DATE
our $VERSION = '0.008'; # VERSION

use 5.010001;
use strict;
use warnings;

use Perinci::CmdLine::github::cmd;

my $prefix = '/App/github/cmd/';

Perinci::CmdLine::github::cmd->new(
    url => $prefix,
    log => 1,
    pass_cmdline_object => 1,
    config_filename => ["github-cmd.conf"],
    subcommands => {
        'get-user'    => {url => "${prefix}get_user"},

        'get-repo'    => {url => "${prefix}get_repo"},
        'repo-exists' => {url => "${prefix}repo_exists"},
        'list-repos'  => {url => "${prefix}list_repos"},
        'create-repo' => {url => "${prefix}create_repo"},
        'delete-repo' => {url => "${prefix}delete_repo"},
        'rename-repo' => {url => "${prefix}rename_repo"},
    },
)->run;

# ABSTRACT: Yet another github CLI
# PODNAME: github-cmd

__END__

=pod

=encoding UTF-8

=head1 NAME

github-cmd - Yet another github CLI

=head1 VERSION

This document describes version 0.008 of github-cmd (from Perl distribution App-github-cmd), released on 2020-04-08.

=head1 SYNOPSIS

=head2 Setup

In F<~/.config/github-cmd.conf>:

 login = YOUR_GITHUB_LOGIN
 pass  = YOUR_GITHUB_PASSWORD

 # or
 access_token = YOUR_API_TOKEN

or just run C<github-cmd>, which will prompt you login+pass and write them to
configuration.

=head2 User commands

 % github-cmd get-user
 % github-cmd get-user perlancar

=head2 Repo commands

 % github-cmd list-repos
 % github-cmd list-repos -l
 % github-cmd list-repos --start 100

 % github-cmd get-repo perl-App-github-cmd
 % github-cmd get-repo --user perlancar perl-App-github-cmd

 % github-cmd repo-exists perl-App-github-cmd
 1

 % github-cmd repo-exists --user perlancar perl-App-github-cmd-FOO
 0

 % github-cmd create-repo foo

 % github-cmd delete-repo foo

 % github-cmd rename-repo foo bar

=head1 DESCRIPTION

B<EARLY RELEASE. More subcommands coming soon.>

This is yet another Github CLI, written in Perl using the L<Perinci::CmdLine>
framework and L<Net::GitHub::V3> API client.

=head1 SUBCOMMANDS

=head2 B<create-repo>

Create a repository.

=head2 B<delete-repo>

=head2 B<get-repo>

Get information about a repository.

=head2 B<get-user>

Get information about a user.

=head2 B<list-repos>

List user's repositories.

=head2 B<rename-repo>

Rename a repository.

=head2 B<repo-exists>