API-GitForge

 view release on metacpan or  search on metacpan

COPYING  view on Meta::CPAN

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

Also add information on how to contact you by electronic and paper mail.

  If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:

    <program>  Copyright (C) <year>  <name of author>
    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
    This is free software, and you are welcome to redistribute it
    under certain conditions; type `show c' for details.

The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License.  Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".

  You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
<http://www.gnu.org/licenses/>.

META.json  view on Meta::CPAN

            "perl" : "5.028",
            "strict" : "0",
            "subs" : "0",
            "warnings" : "0"
         }
      }
   },
   "release_status" : "stable",
   "resources" : {
      "repository" : {
         "type" : "git",
         "url" : "https://git.spwhitton.name/p5-API-GitForge",
         "web" : "https://git.spwhitton.name/p5-API-GitForge"
      }
   },
   "version" : "0.007",
   "x_generated_by_perl" : "v5.32.1",
   "x_serialization_backend" : "Cpanel::JSON::XS version 4.25",
   "x_spdx_expression" : "GPL-3.0-only"
}

dist.ini  view on Meta::CPAN

-remove = Readme
-remove = License

[AutoPrereqs]
[Prereqs]
perl = 5.028

[MetaResources]
repository.url  = https://git.spwhitton.name/p5-API-GitForge
repository.web  = https://git.spwhitton.name/p5-API-GitForge
repository.type = git

lib/API/GitForge.pm  view on Meta::CPAN

=head1 NAME

API::GitForge - generic interface to APIs of sites like GitHub, GitLab etc.

=head1 VERSION

version 0.007

=head1 SYNOPSIS

    # try to autodetect the forge type; works for GitHub and some others
    my $github = API::GitForge->new_from_domain(
        domain     => "github.com",
        access_key => "12345678"
    );

    # specify the forge type yourself by instantiating the right class
    my $salsa = API::GitForge::GitLab->new(
        domain     => "salsa.debian.org",
        access_key => "abcdef"
    );

    # generic user operations regardless of the forge type
    $github->clean_fork("spwhitton/git-remote-gcrypt");
    $salsa->clean_fork("Debian/devscripts");

=head1 DESCRIPTION

A I<git forge> is a site like GitHub, GitLab etc.  This module
provides access to some operations which one might wish to perform
against any git forge, wrapping the details of the APIs of particular
forges.  An example of such an operation is forking a repository into
the user's own namespace.