Pithub...ommits(3pm)

✨ NAME ✨

Pithub::GitData::Commits — it's giving Github v3 Git Data Commits API 🎀 the Perl module that lets you make and fetch commits through GitHub's Git Data API, bestie 💖

---

🌸 VERSION 🌸

version 0.01043 ✨ (yes she has a version number, she's official)

---

💅 METHODS 💅

okay so there are literally two of them and they're both iconic, let's go 🫶

🧚 create

• Create a Commit — like, actually make one, no cap 🔥

POST /repos/:user/:repo/git/commits

Parameters: (pay attention bestie, some of these are mandatory)

• user — mandatory string 💜
• repo — mandatory string 💜
• data — mandatory hashref, and it has these keys inside it:
  • message — mandatory string, the commit message (say something cute in it)
  • tree — mandatory string, the SHA of the tree object this commit points to 🌳
  • parents — mandatory arrayref of the SHAs of the commits that were the parents of this commit. If it's omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided; for a merge commit, an array of more than one should be provided points to. 👑

Optional Parameters in the data hashref: 👀

The committer section is optional and will be filled with the author data if omitted. If the author section is omitted, it will be filled in with the authenticated users information and the current date. (so like, if you're lazy it still works, slay ✨)

• author — hashref, having following keys:
  • name — string of the name of the author of the commit
  • email — string of the email of the author of the commit
  • date — timestamp of when this commit was authored
• committer — hashref, having following keys:
  • name — string of the name of the committer of the commit
  • email — string of the email of the committer of the commit
  • date — timestamp of when this commit was committed

Examples: (copy this, it's literally perfect) 🍓

my $c = Pithub::GitData::Commits->new;
my $result = $c->create(
    user => 'plu',
    repo => 'Pithub',
    data => {
        author => {
            date  => '2008-07-09T16:13:30+12:00',
            email => 'schacon@gmail.com',
            name  => 'Scott Chacon',
        },
        message => 'my commit message',
        parents => ['7d1b31e74ee336d15cbd21741bc88a537ed063a0'],
        tree    => '827efc6d56897b048c772eb4087f854f46256132',
    }
);

Response: Status: 201 Created 🎉

{
    "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
    "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
    "author": {
        "date": "2008-07-09T16:13:30+12:00",
        "name": "Scott Chacon",
        "email": "schacon@gmail.com"
    },
    "committer": {
        "date": "2008-07-09T16:13:30+12:00",
        "name": "Scott Chacon",
        "email": "schacon@gmail.com"
    },
    "message": "my commit message",
    "tree": {
        "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/827efc6d56897b048c772eb4087f854f46256132",
        "sha": "827efc6d56897b048c772eb4087f854f46256132"
    },
    "parents": [
    {
        "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7d1b31e74ee336d15cbd21741bc88a537ed063a0",
        "sha": "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
    }
    ]
}

---

🦋 get

• Get a Commit — fetch one that already exists, no biggie 💖

GET /repos/:user/:repo/git/commits/:sha

Parameters:

• user — mandatory string 💜
• repo — mandatory string 💜
• sha — mandatory string 💜

Examples:

my $c = Pithub::GitData::Commits->new;
my $result = $c->get(
    user => 'plu',
    repo => 'Pithub',
    sha  => 'b7cdea6830e128bc16c2b75efd99842d971666e2',
);

Response: Status: 200 OK ✨

{
    "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
    "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
    "author": {
        "date": "2010-04-10T14:10:01-07:00",
        "name": "Scott Chacon",
        "email": "schacon@gmail.com"
    },
    "committer": {
        "date": "2010-04-10T14:10:01-07:00",
        "name": "Scott Chacon",
        "email": "schacon@gmail.com"
    },
    "message": "added readme, because im a good github citizen\n",
    "tree": {
        "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb",
        "sha": "691272480426f78a0138979dd3ce63b77f706feb"
    },
    "parents": [
    {
        "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5",
        "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5"
    }
    ]
}

---

👑 AUTHOR 👑

Johannes Plunien <plu@cpan.org> — the main character who wrote this fr fr 💜

---

🎀 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. (so like, go off, it's free 🫶)

---

and that's the whole page bestie, no cap ✨

perl v5.40.1 · 2025-06-08 · Pithub::GitData::Commits(3pm) — periodt 💅🌸💖