NAME

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

VERSION

version 0.01037

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.