Skip to content

cloudposse-github-actions/get-pr

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace
Β 
Β 

Project Banner

Latest ReleaseSlack Community

Get the PR info associated with the commit.


Note

This project is part of Cloud Posse's comprehensive "SweetOps" approach towards DevOps.

Learn More

We have dozens of GitHub Actions that are Open Source and well-maintained. Check them out!

Introduction

Fork of 8BitJonny/gh-get-current-pr adopted to Cloud Posse's GitHub Actions standards.

Usage

Important

In Cloud Posse's examples, we avoid pinning GitHub Actions to specific versions to prevent discrepancies between the documentation and the latest released versions. However, for your own projects, we strongly advise pinning each GitHub Action to the exact version you're using. This practice ensures the stability of your workflows. Additionally, we recommend implementing a systematic approach for updating versions to avoid unexpected changes.

This action will retrieve the PR metadata by id (PR number) or commit sha. The id takes precedence over sha, if both are passed.

By ID

  on:
    pull_request:
      branches:
        - main
      types: [opened, synchronize, reopened]

  jobs:
    pr:
      name: PR Info
      runs-on: ubuntu-latest
      steps:
        - uses: cloudposse-github-actions/get-pr@main
          id: pr
          with:
            id: ${{ github.event.number }}
      outputs:
        base: ${{ fromJSON(steps.pr.outputs.pr).base.sha }}
        head: ${{ fromJSON(steps.pr.outputs.pr).head.sha }}
        found: ${{ steps.pr.outputs.found }}
        json: ${{ steps.pr.outputs.json }}
        number: ${{ steps.pr.outputs.number }}
        title: ${{ steps.pr.outputs.title }}
        body: ${{ steps.pr.outputs.body }}
        url: ${{ steps.pr.outputs.url }}
        created_at: ${{ steps.pr.outputs.created_at }}
        merged_at: ${{ steps.pr.outputs.merged_at }}
        closed_at: ${{ steps.pr.outputs.closed_at }}
        labels: ${{ steps.pr.outputs.labels }}

By SHA

  on:
    push:
      branches:
        - main

  jobs:
    pr:
      name: PR Info
      runs-on: ubuntu-latest
      steps:
        - uses: cloudposse-github-actions/get-pr@main
          id: pr
      outputs:
        base: ${{ fromJSON(steps.pr.outputs.pr).base.sha }}
        head: ${{ fromJSON(steps.pr.outputs.pr).head.sha }}
        found: ${{ steps.pr.outputs.found }}
        json: ${{ steps.pr.outputs.json }}
        number: ${{ steps.pr.outputs.number }}
        title: ${{ steps.pr.outputs.title }}
        body: ${{ steps.pr.outputs.body }}
        url: ${{ steps.pr.outputs.url }}
        created_at: ${{ steps.pr.outputs.created_at }}
        merged_at: ${{ steps.pr.outputs.merged_at }}
        closed_at: ${{ steps.pr.outputs.closed_at }}
        labels: ${{ steps.pr.outputs.labels }}

Inputs

Name Description Default Required
filterOutClosed True, False, 1 or 0 if only open PRs should be returned. Defaults to false. N/A false
filterOutDraft True, False, 1 or 0 if only non-draft PRs should be returned. Defaults to false. N/A false
github-token The GitHub token used to create an authenticated client. ${{ github.token }} false
id PR ID to get info for. N/A false
sha Sha to get PR for. Defaults to current sha. N/A false

Outputs

Name Description
body The PR Body if one was found.
closed_at The PR Closed timestamp if one was found.
created_at The PR Created timestamp if one was found.
found The outcome if a PR has been found. If so, the other outputs are set.
json The whole PR object if one was found.
labels The PR Labels if any was found.
merged_at The PR Merged timestamp if one was found.
number The PR number if one was found.
title The PR Title if one was found.
url The PR Url if one was found.

Related Projects

Check out these related projects.

References

For additional context, refer to some of these links.

✨ Contributing

This project is under active development, and we encourage contributions from our community. Many thanks to our outstanding contributors:

πŸ› Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or file feature requests.

πŸ’» Developing

If you are interested in being a contributor and want to get involved in developing this project or help out with Cloud Posse's other projects, we would love to hear from you! Hit us up in Slack, in the #cloudposse channel.

In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow.

  1. Review our Code of Conduct and Contributor Guidelines.
  2. Fork the repo on GitHub
  3. Clone the project to your own machine
  4. Commit changes to your own branch
  5. Push your work back up to your fork
  6. Submit a Pull Request so that we can review your changes

NOTE: Be sure to merge the latest changes from "upstream" before making a pull request!

🌎 Slack Community

Join our Open Source Community on Slack. It's FREE for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build totally sweet infrastructure.

πŸ“° Newsletter

Sign up for our newsletter and join 3,000+ DevOps engineers, CTOs, and founders who get insider access to the latest DevOps trends, so you can always stay in the know. Dropped straight into your Inbox every week β€” and usually a 5-minute read.

πŸ“† Office Hours

Join us every Wednesday via Zoom for your weekly dose of insider DevOps trends, AWS news and GitHub Action insights, all sourced from our SweetOps community, plus a live Q&A that you can’t find anywhere else. It's FREE for everyone!

About

This project is maintained by Cloud Posse, LLC.

We are a DevOps Accelerator for funded startups and enterprises. Use our ready-to-go terraform architecture blueprints for AWS & GitHub Actions to get up and running quickly. We build it with you. You own everything. Your team wins. Plus, we stick around until you succeed.

Learn More

Your team can operate like a pro today.

Ensure that your team succeeds by using our proven process and turnkey blueprints. Plus, we stick around until you succeed.

πŸ“š See What's Included
  • Reference Architecture. You'll get everything you need from the ground up built using 100% infrastructure as code.
  • Deployment Strategy. You'll have a battle-tested deployment strategy using GitHub Actions that's automated and repeatable.
  • Site Reliability Engineering. You'll have total visibility into your apps and microservices.
  • Security Baseline. You'll have built-in governance with accountability and audit logs for all changes.
  • GitOps. You'll be able to operate your infrastructure via Pull Requests.
  • Training. You'll receive hands-on training so your team can operate what we build.
  • Questions. You'll have a direct line of communication between our teams via a Shared Slack channel.
  • Troubleshooting. You'll get help to triage when things aren't working.
  • Code Reviews. You'll receive constructive feedback on Pull Requests.
  • Bug Fixes. We'll rapidly work with you to fix any bugs in our projects.

Trademarks

All other trademarks referenced herein are the property of their respective owners.

Copyright Β© 2017-2024 Cloud Posse, LLC

README footer

Beacon

About

Get the PR info by ID or associated commit

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages

  • TypeScript 92.3%
  • Makefile 4.7%
  • JavaScript 3.0%