Provided by: libpithub-perl_0.01040-1_all bug

NAME

       Pithub::Gists::Comments - Github v3 Gist Comments API

VERSION

       version 0.01040

METHODS

   create
       •   Create a comment

               POST /gists/:gist_id/comments

           Parameters:

           •   gist_id: mandatory string

           •   data: mandatory hashref, having following keys:

               •   body: mandatory string

           Examples:

               my $c = Pithub::Gists::Comments->new;
               my $result = $c->create(
                   gist_id => 'c0ff33',
                   data    => { body => 'Just commenting for the sake of commenting' },
               );

           Response: Status: 201 Created

               {
                   "id": 1,
                   "url": "https://api.github.com/gists/c0ff33/comments/1",
                   "body": "Just commenting for the sake of commenting",
                   "user": {
                       "login": "octocat",
                       "id": 1,
                       "gravatar_url": "https://github.com/images/error/octocat_happy.gif",
                       "url": "https://api.github.com/users/octocat"
                   },
                   "created_at": "2011-04-18T23:23:56Z"
               }

   delete
       •   Delete a comment

               DELETE /gists/:gist_id/comments/:id

           Parameters:

           •   gist_id: mandatory string

           •   comment_id: mandatory integer

           Examples:

               my $c = Pithub::Gists::Comments->new;
               my $result = $c->delete(
                   gist_id    => 'c0ff33',
                   comment_id => 1
               );

           Response: Status: 204 No Content

   get
       •   Get a single comment

               GET /gists/:gist_id/comments/:id

           Parameters:

           •   gist_id: mandatory string

           •   comment_id: mandatory integer

           Examples:

               my $c = Pithub::Gists::Comments->new;
               my $result = $c->get(
                   gist_id    => 'c0ff33',
                   comment_id => 1
               );

           Response: Status: 200 OK

               {
                   "id": 1,
                   "url": "https://api.github.com/gists/c0ff33/comments/1",
                   "body": "Just commenting for the sake of commenting",
                   "user": {
                       "login": "octocat",
                       "id": 1,
                       "gravatar_url": "https://github.com/images/error/octocat_happy.gif",
                       "url": "https://api.github.com/users/octocat"
                   },
                   "created_at": "2011-04-18T23:23:56Z"
               }

   list
       •   List comments on a gist

               GET /gists/:gist_id/comments

           Parameters:

           •   gist_id: mandatory string

           Examples:

               my $c = Pithub::Gists::Comments->new;
               my $result = $c->list( gist_id => 1 );

           Response: Status: 200 OK

               [
                   {
                       "id": 1,
                       "url": "https://api.github.com/gists/c0ff33/comments/1",
                       "body": "Just commenting for the sake of commenting",
                       "user": {
                           "login": "octocat",
                           "id": 1,
                           "gravatar_url": "https://github.com/images/error/octocat_happy.gif",
                           "url": "https://api.github.com/users/octocat"
                       },
                       "created_at": "2011-04-18T23:23:56Z"
                   }
               ]

   update
       •   Edit a comment

               PATCH /gists/:gist_id/comments/:id

           Parameters:

           •   gist_id: mandatory string

           •   comment_id: mandatory integer

           •   data: mandatory hashref, having following keys:

               •   body: mandatory string

           Examples:

               my $c = Pithub::Gists::Comments->new;
               my $result = $c->update(
                   gist_id    => 'c0ff33',
                   comment_id => 1,
                   data       => { body => 'some comment' }
               );

           Response: Status: 200 OK

               {
                   "id": 1,
                   "url": "https://api.github.com/gists/c0ff33/comments/1",
                   "body": "Just commenting for the sake of commenting",
                   "user": {
                       "login": "octocat",
                       "id": 1,
                       "gravatar_url": "https://github.com/images/error/octocat_happy.gif",
                       "url": "https://api.github.com/users/octocat"
                   },
                   "created_at": "2011-04-18T23:23:56Z"
               }

AUTHOR

       Johannes Plunien <plu@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Johannes Plunien.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.