Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/cssnr/create-pull-action

Easily create a Pull Request from a GitHub Action.
https://github.com/cssnr/create-pull-action

github-actions

Last synced: 4 months ago
JSON representation

Easily create a Pull Request from a GitHub Action.

Awesome Lists containing this project

README 

          
[![GitHub Tag Major](https://img.shields.io/github/v/tag/cssnr/create-pull-action?sort=semver&filter=!v*.*&logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/create-pull-action/tags)

[![GitHub Tag Minor](https://img.shields.io/github/v/tag/cssnr/create-pull-action?sort=semver&filter=!v*.*.*&logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/create-pull-action/releases)

[![GitHub Release Version](https://img.shields.io/github/v/release/cssnr/create-pull-action?logo=git&logoColor=white&labelColor=585858&label=%20)](https://github.com/cssnr/create-pull-action/releases/latest)

[![GitHub Dist Size](https://img.shields.io/github/size/cssnr/create-pull-action/dist%2Findex.js?logo=bookstack&logoColor=white&label=dist%20size)](https://github.com/cssnr/create-pull-action/blob/master/src)

[![Workflow Release](https://img.shields.io/github/actions/workflow/status/cssnr/create-pull-action/release.yaml?logo=cachet&label=release)](https://github.com/cssnr/create-pull-action/actions/workflows/release.yaml)

[![Workflow Test](https://img.shields.io/github/actions/workflow/status/cssnr/create-pull-action/test.yaml?logo=cachet&label=test)](https://github.com/cssnr/create-pull-action/actions/workflows/test.yaml)

[![Workflow Lint](https://img.shields.io/github/actions/workflow/status/cssnr/create-pull-action/lint.yaml?logo=cachet&label=lint)](https://github.com/cssnr/create-pull-action/actions/workflows/lint.yaml)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=cssnr_create-pull-action&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=cssnr_create-pull-action)

[![GitHub Last Commit](https://img.shields.io/github/last-commit/cssnr/create-pull-action?logo=github&label=updated)](https://github.com/cssnr/create-pull-action/pulse)

[![Codeberg Last Commit](https://img.shields.io/gitea/last-commit/cssnr/create-pull-action/master?gitea_url=https%3A%2F%2Fcodeberg.org%2F&logo=codeberg&logoColor=white&label=updated)](https://codeberg.org/cssnr/create-pull-action)

[![GitHub Contributors](https://img.shields.io/github/contributors-anon/cssnr/create-pull-action?logo=github)](https://github.com/cssnr/create-pull-action/graphs/contributors)

[![GitHub Repo Size](https://img.shields.io/github/repo-size/cssnr/create-pull-action?logo=bookstack&logoColor=white&label=repo%20size)](https://github.com/cssnr/create-pull-action?tab=readme-ov-file#readme)

[![GitHub Top Language](https://img.shields.io/github/languages/top/cssnr/create-pull-action?logo=htmx)](https://github.com/cssnr/create-pull-action)

[![GitHub Discussions](https://img.shields.io/github/discussions/cssnr/create-pull-action?logo=github)](https://github.com/cssnr/create-pull-action/discussions)

[![GitHub Forks](https://img.shields.io/github/forks/cssnr/create-pull-action?style=flat&logo=github)](https://github.com/cssnr/create-pull-action/forks)

[![GitHub Repo Stars](https://img.shields.io/github/stars/cssnr/create-pull-action?style=flat&logo=github)](https://github.com/cssnr/create-pull-action/stargazers)

[![GitHub Org Stars](https://img.shields.io/github/stars/cssnr?style=flat&logo=github&label=org%20stars)](https://cssnr.github.io/)

[![Discord](https://img.shields.io/discord/899171661457293343?logo=discord&logoColor=white&label=discord&color=7289da)](https://discord.gg/wXy6m2X8wY)

[![Ko-fi](https://img.shields.io/badge/Ko--fi-72a5f2?logo=kofi&label=support)](https://ko-fi.com/cssnr)



# Create Pull Action





Create Pull Action



- [Features](#Features)

- [Inputs](#Inputs)

  - [Permissions](#Permissions)

- [Outputs](#Outputs)

- [Tags](#Tags)

- [Support](#Support)

- [Contributing](#Contributing)



Easily create a Pull Request from a GitHub Action.



This action assumes you have already created a commit in a `head` branch.

All the other [Inputs](#inputs) have defaults.



```yaml

- name: 'Create Pull'

  uses: cssnr/create-pull-action@master

  with:

    head: feature-branch

```



See the [Inputs](#inputs) for more options.



## Features



🚀 Created as an alternative to using the gh cli or api.



- Simple

- Defaults



## Inputs



âś… Only the `head` branch is required.



| Input        |            Default Value             | Input Description  |

| :----------- | :---------------------------------------: | :---------------------- |

| `repository` |            `github.repository`            | Repository `owner/name` |

| `head`       |                _Required_                 | Head Branch             |

| `base`       |             `default_branch`              | Base Branch             |

| `title`      |           `Changes from {Name}`           | Pull Request Title      |

| `body`       | `Triggered by {user} in workflow {Name}.` | Pull Request Body       |

| `token`      |              `github.token`               | Token for `repository`  |

| `summary`    |                  `true`                   | Add Job Summary         |



```yaml

- name: 'Create Pull'

  uses: cssnr/create-pull-action@master

  with:

    repository: some/other-repository # optional

    head: feature-branch

    base: master # optional

    title: Ralf Broke It # optional

    body: Broken ${{ github.run_number }} times. # optional

    token: ${{ secrets.ACCESS_TOKEN }} # see permissions

```



### Permissions



đź”’ This action requires the following workflow permissions if the `repository` is the same.



```yaml

permissions:

  pull-request: write

```



If the workflow is in a different `repository` you need to create an Access Token.



The Personal, Fine-Grained or App Token needs these permissions on the `repository`.



```yaml

permissions:

  pull-request: write

  contents: read # to determine base branch if private

```



Permissions documentation for [Workflows](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/controlling-permissions-for-github_token), [Actions](https://docs.github.com/en/actions/security-for-github-actions/security-guides/automatic-token-authentication) and [Apps](https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app).



## Outputs



📤 The pull request response data is accessible via outputs.



| Output     | Description           |

| :--------- | :-------------------- |

| `pull`     | Pull Request JSON     |

| `html_url` | Pull Request HTML URL |

| `id`       | Pull Request ID       |

| `number`   | Pull Request Number   |



Everything is available in the `pull` json. The other outputs are parsed from this object.



```yaml

- name: 'Create Pull Action'

  id: pull

  uses: cssnr/create-pull-action@master

  with:

    head: feature-branch



- name: 'Echo Output'

  run: |

    echo "html_url: ${{ steps.pull.outputs.html_url }}"

    echo "html_url: ${{ fromJSON(steps.pull.outputs.pull).html_url }}"

```



## Tags



The following rolling [tags](https://github.com/cssnr/create-pull-action/tags) are maintained.



| Version Tag                                                                                                                                                                                                     | Rolling | Bugs | Feat. |   Name    |  Target  | Example  |

| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----: | :--: | :---: | :-------: | :------: | :------- |

| [![GitHub Tag Major](https://img.shields.io/github/v/tag/cssnr/create-pull-action?sort=semver&filter=!v*.*&style=for-the-badge&label=%20&color=44cc10)](https://github.com/cssnr/create-pull-action/releases/latest) |   âś…    |  âś…  |  âś…   | **Major** | `vN.x.x` | `vN`     |

| [![GitHub Tag Minor](https://img.shields.io/github/v/tag/cssnr/create-pull-action?sort=semver&filter=!v*.*.*&style=for-the-badge&label=%20&color=blue)](https://github.com/cssnr/create-pull-action/releases/latest) |   ✅    |  ✅  |  ❌   | **Minor** | `vN.N.x` | `vN.N`   |

| [![GitHub Release](https://img.shields.io/github/v/release/cssnr/create-pull-action?style=for-the-badge&label=%20&color=red)](https://github.com/cssnr/create-pull-action/releases/latest)                           |   ❌    |  ❌  |  ❌   | **Micro** | `vN.N.N` | `vN.N.N` |



You can view the release notes for each version on the [releases](https://github.com/cssnr/create-pull-action/releases) page.



The **Major** tag is recommended. It is the most up-to-date and always backwards compatible.

Breaking changes would result in a **Major** version bump. At a minimum you should use a **Minor** tag.



# Support



If you run into any issues or need help getting started, please do one of the following:



- Report an Issue: 

- Q&A Discussion: 

- Request a Feature: 

- Chat with us on Discord: 



[![Features](https://img.shields.io/badge/features-brightgreen?style=for-the-badge&logo=verizon&logoColor=white)](https://github.com/cssnr/create-pull-action/issues/new?template=1-feature.yaml)

[![Issues](https://img.shields.io/badge/issues-red?style=for-the-badge&logo=southwestairlines&logoColor=white)](https://github.com/cssnr/create-pull-action/issues)

[![Discussions](https://img.shields.io/badge/discussions-blue?style=for-the-badge&logo=rocketdotchat&logoColor=white)](https://github.com/cssnr/create-pull-action/discussions)

[![Discord](https://img.shields.io/badge/discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/wXy6m2X8wY)



For more information, see the CSSNR [SUPPORT.md](https://github.com/cssnr/.github/blob/master/.github/SUPPORT.md#support).



# Contributing



If you would like to submit a PR, please review the [CONTRIBUTING.md](#contributing-ov-file).



Please consider making a donation to support the development of this project

and [additional](https://cssnr.com/) open source projects.



[![Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/cssnr)



[![Actions Tools](https://raw.githubusercontent.com/smashedr/repo-images/refs/heads/master/actions/actions-tools.png)](https://actions-tools.cssnr.com/)



Additionally, you can support other [GitHub Actions](https://actions.cssnr.com/) I have published:



- [Stack Deploy Action](https://github.com/cssnr/stack-deploy-action?tab=readme-ov-file#readme)

- [Portainer Stack Deploy Action](https://github.com/cssnr/portainer-stack-deploy-action?tab=readme-ov-file#readme)

- [Docker Context Action](https://github.com/cssnr/docker-context-action?tab=readme-ov-file#readme)

- [Actions Up Action](https://github.com/cssnr/actions-up-action?tab=readme-ov-file#readme)

- [Rhysd Actionlint Action](https://github.com/cssnr/actionlint-action?tab=readme-ov-file#readme)

- [Zensical Action](https://github.com/cssnr/zensical-action?tab=readme-ov-file#readme)

- [VirusTotal Action](https://github.com/cssnr/virustotal-action?tab=readme-ov-file#readme)

- [Mirror Repository Action](https://github.com/cssnr/mirror-repository-action?tab=readme-ov-file#readme)

- [Update Version Tags Action](https://github.com/cssnr/update-version-tags-action?tab=readme-ov-file#readme)

- [Docker Tags Action](https://github.com/cssnr/docker-tags-action?tab=readme-ov-file#readme)

- [TOML Action](https://github.com/cssnr/toml-action?tab=readme-ov-file#readme)

- [Update JSON Value Action](https://github.com/cssnr/update-json-value-action?tab=readme-ov-file#readme)

- [JSON Key Value Check Action](https://github.com/cssnr/json-key-value-check-action?tab=readme-ov-file#readme)

- [Parse Issue Form Action](https://github.com/cssnr/parse-issue-form-action?tab=readme-ov-file#readme)

- [Cloudflare Purge Cache Action](https://github.com/cssnr/cloudflare-purge-cache-action?tab=readme-ov-file#readme)

- [Mozilla Addon Update Action](https://github.com/cssnr/mozilla-addon-update-action?tab=readme-ov-file#readme)

- [Package Changelog Action](https://github.com/cssnr/package-changelog-action?tab=readme-ov-file#readme)

- [NPM Outdated Check Action](https://github.com/cssnr/npm-outdated-action?tab=readme-ov-file#readme)

- [Label Creator Action](https://github.com/cssnr/label-creator-action?tab=readme-ov-file#readme)

- [Algolia Crawler Action](https://github.com/cssnr/algolia-crawler-action?tab=readme-ov-file#readme)

- [Upload Release Action](https://github.com/cssnr/upload-release-action?tab=readme-ov-file#readme)

- [Check Build Action](https://github.com/cssnr/check-build-action?tab=readme-ov-file#readme)

- [Web Request Action](https://github.com/cssnr/web-request-action?tab=readme-ov-file#readme)

- [Get Commit Action](https://github.com/cssnr/get-commit-action?tab=readme-ov-file#readme)



âť” Unpublished Actions



These actions are not published on the Marketplace, but may be useful.



- [cssnr/create-pull-action](https://github.com/cssnr/create-pull-action?tab=readme-ov-file#readme) - Create a pull request.

- [cssnr/create-files-action](https://github.com/cssnr/create-files-action?tab=readme-ov-file#readme) - Create various files from templates.

- [cssnr/draft-release-action](https://github.com/cssnr/draft-release-action?tab=readme-ov-file#readme) - Keep a draft release ready to publish.

- [cssnr/homebrew-action](https://github.com/cssnr/homebrew-action?tab=readme-ov-file#readme) - Homebrew formula update action.

- [cssnr/env-json-action](https://github.com/cssnr/env-json-action?tab=readme-ov-file#readme) - Convert env file to json or vice versa.

- [cssnr/push-artifacts-action](https://github.com/cssnr/push-artifacts-action?tab=readme-ov-file#readme) - Sync files to a remote host with rsync.

- [smashedr/update-release-notes-action](https://github.com/smashedr/update-release-notes-action?tab=readme-ov-file#readme) - Update release notes.

- [smashedr/combine-release-notes-action](https://github.com/smashedr/combine-release-notes-action?tab=readme-ov-file#readme) - Combine release notes.



---



đź“ť Template Actions



These are basic action templates that I use for creating new actions.



- [javascript-action](https://github.com/smashedr/javascript-action?tab=readme-ov-file#readme) - JavaScript

- [typescript-action](https://github.com/smashedr/typescript-action?tab=readme-ov-file#readme) - TypeScript

- [py-test-action](https://github.com/smashedr/py-test-action?tab=readme-ov-file#readme) - Dockerfile Python

- [test-action-uv](https://github.com/smashedr/test-action-uv?tab=readme-ov-file#readme) - Dockerfile Python UV

- [docker-test-action](https://github.com/smashedr/docker-test-action?tab=readme-ov-file#readme) - Docker Image Python



Note: The `docker-test-action` builds, runs and pushes images to [GitHub Container Registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry).



---



For a full list of current projects visit: [https://cssnr.github.io/](https://cssnr.github.io/)