NAME Net::Async::Github - support for the https://github.com REST API with IO::Async SYNOPSIS use IO::Async::Loop; use Net::Async::Github; my $loop = IO::Async::Loop->new; $loop->add( my $gh = Net::Async::Github->new( token => '...', ) ); # Give 'secret_team' pull access to all private repos $gh->repos(visibility => 'private') ->grant_team(secret_team => 'pull') ->await; DESCRIPTION This is a basic wrapper for Github's API. METHODS current_user Returns information about the current user. my $user = $gh->current_user->get; printf "User [%s] has %d public repos and was last updated on %s%s\n", $user->login, $user->public_repos, $user->updated_at->to_string Resolves to a Net::Async::Github::User instance. configure Accepts the following optional named parameters: * token - the Github API token * endpoints - hashref of RFC6570 -compliant URL mappings * http - an HTTP client compatible with the Net::Async::HTTP API * mime_type - the MIME type to use as the Accept header for requests * page_cache_size - number of GET responses to cache. Defaults to 1000, set to 0 to disable. You probably just want token , defaults should be fine for the other settings. If you're creating a large number of instances, you can avoid some disk access overhead by passing endpoints from an existing instance to the constructor for a new instance. reopen Reopens the given PR. Expects the following named parameters: * owner - which user or organisation owns this PR * repo - which repo it's for * id - the pull request ID Resolves to the current status. pr Returns information about the given PR. Expects the following named parameters: * owner - which user or organisation owns this PR * repo - which repo it's for * id - the pull request ID Resolves to the current status. user Returns information about the given user. users Iterates through all users. This is a good way to exhaust your 5000-query ratelimiting quota. head Identifies the head version for this branch. Requires the following named parameters: * owner - which organisation or person owns the repo * repo - the repository name * branch - which branch to check update core_rate_limit Returns a Net::Async::Github::RateLimit::Core instance which can track rate limits. rate_limit METHODS - Internal The following methods are used internally. They're not expected to be useful for external callers. api_key token endpoints Returns an accessor for the endpoints data. This is a hashref containing URI templates, used by "endpoint". endpoint Expands the selected URI via URI::Template. Each item is defined in our endpoints.json file. Returns a URI instance. http Accessor for the HTTP client object. Will load and instantiate a Net::Async::HTTP instance if necessary. Actual HTTP implementation is not guaranteed, and the default is likely to change in future. auth_info Returns authentication information used in the HTTP request. mime_type Returns the MIME type used for requests. Currently defined by github in https://developer.github.com/v3/media/ as application/vnd.github.v3+json. base_uri The URI for requests. Defaults to https://api.github.com. http_get Performs an HTTP GET request. pending_requests A list of all pending requests. validate_branch_name Applies validation rules from git-check-ref-format for a branch name. Will raise an exception on invalid input. validate_owner_name Applies github rules for user/organisation name. Will raise an exception on invalid input. validate_repo_name Applies github rules for repository name. Will raise an exception on invalid input. validate_args Convenience method to apply validation on common parameters. page_cache_size Returns the total number of GET responses we'll cache. Default is probably 1000. page_cache The page cache instance, likely to be provided by Cache::LRU. ryu Our Ryu::Async instance, used for instantiating Ryu::Source instances. AUTHOR Tom Molesworth LICENSE Copyright Tom Molesworth 2014-2019. Licensed under the same terms as Perl itself.