{"id":13409505,"url":"https://github.com/litetex/pull-detached-remote","last_synced_at":"2025-03-12T18:21:30.451Z","repository":{"id":41199799,"uuid":"263694795","full_name":"litetex/pull-detached-remote","owner":"litetex","description":"Creates a branch with updates from a detached upstream of a repo and a corresponding PullRequest","archived":false,"fork":false,"pushed_at":"2023-03-10T21:31:19.000Z","size":99,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2024-09-17T19:26:19.720Z","etag":null,"topics":["auto-pull-request","automated-updates","detached","forks","pull","upstream"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/litetex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-13T17:11:54.000Z","updated_at":"2023-03-10T21:31:24.000Z","dependencies_parsed_at":"2024-10-26T04:53:31.345Z","dependency_job_id":"22a89e04-cc22-47e9-9b7a-695241e6dce8","html_url":"https://github.com/litetex/pull-detached-remote","commit_stats":{"total_commits":73,"total_committers":3,"mean_commits":"24.333333333333332","dds":0.0273972602739726,"last_synced_commit":"2bf34849aaf0f5031cb432ef19c08ac1d7ff7815"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litetex%2Fpull-detached-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litetex%2Fpull-detached-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litetex%2Fpull-detached-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litetex%2Fpull-detached-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/litetex","download_url":"https://codeload.github.com/litetex/pull-detached-remote/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243268789,"owners_count":20263925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-pull-request","automated-updates","detached","forks","pull","upstream"],"created_at":"2024-07-30T20:01:01.458Z","updated_at":"2025-03-12T18:21:30.424Z","avatar_url":"https://github.com/litetex.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"# \u003cimg width=\"26\" height=\"26\" src=\"logo.png\" /\u003e pull-detached-remote\n[![GitHub Marketplace](https://img.shields.io/badge/Marketplace-pull--detached--remote-blue.svg?colorA=1b1e21\u0026colorB=0265de\u0026style=flat\u0026longCache=true\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAM6wAADOsB5dZE0gAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAERSURBVCiRhZG/SsMxFEZPfsVJ61jbxaF0cRQRcRJ9hlYn30IHN/+9iquDCOIsblIrOjqKgy5aKoJQj4O3EEtbPwhJbr6Te28CmdSKeqzeqr0YbfVIrTBKakvtOl5dtTkK+v4HfA9PEyBFCY9AGVgCBLaBp1jPAyfAJ/AAdIEG0dNAiyP7+K1qIfMdonZic6+WJoBJvQlvuwDqcXadUuqPA1NKAlexbRTAIMvMOCjTbMwl1LtI/6KWJ5Q6rT6Ht1MA58AX8Apcqqt5r2qhrgAXQC3CZ6i1+KMd9TRu3MvA3aH/fFPnBodb6oe6HM8+lYHrGdRXW8M9bMZtPXUji69lmf5Cmamq7quNLFZXD9Rq7v0Bpc1o/tp0fisAAAAASUVORK5CYII=)](https://github.com/marketplace/actions/pull-detached-remote)\n\n\u003e **Warning**: **Deprecated** \u003cbr/\u003e This action is deprecated and can easily be replaced by a [simpler alternative workflow](./alternative.yml)\n\nCreates a branch with updates from a detached (not actively set) upstream of a repo and a corresponding PullRequest\n\nIf you don't understand the quick summary read the following:\n\n## Why?\nThis action was mainly created for the following use-case:\n\nYou have a GitHub repo that is not directly linked via an [upstream-remote](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork)\nThis can be achieved by\n* [duplicating](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/duplicating-a-repository) a repo or\n* [forking](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-forks) a repo and [removing it's upstream remote](https://stackoverflow.com/questions/29326767/unfork-a-github-fork-without-deleting/41486339)\n\nNow you wan't to update this repo from it's \"upstream\" (which is not actively set / detached). \u003cbr/\u003e\nYou [can do that manually](https://gist.github.com/CristinaSolana/1885435), but after some time (especially when there are more often commits on the \"upstream\"), you definetly wan't to do that automated.\n\nAn here this action comes into spotlight.\n\nIt automatically updates your \"detached upstream\":\u003cbr/\u003e\nFirstly it checks if there are new commits on the upstream.\u003cbr/\u003e\nWhen there are new ones, it creates a new branch and a pull request.\n\u003cbr/\u003e\n\u003cbr/\u003e\nThe action is based on [PullDetachedRemote](https://github.com/litetex/PullDetachedRemote)\n\n## Usage\nA simple worfklow example:\n```YAML\nname: Pull detached upstream automatically from https://github.com/\u003cowner\u003e/\u003crepo\u003e\n\non:\n  # Possibility to run it manually\n  workflow_dispatch:\n  # Automated\n  schedule:\n    # Run this every day at 02:22 UTC\n    - cron: '22 2 * * *'\n  \n  \njobs:\n  build:\n    runs-on: ubuntu-latest\n\n    steps:\n      # Checkout the current repo\n      - uses: actions/checkout@v2\n      # Fetch the history and unshallow the repo so that it can be used\n      - name: Fetch all history for all tags and branches\n        run: git fetch --prune --unshallow\n      # Pull the detached remote and do the magic\n      - name: Pull Detached Remote\n        uses: litetex/pull-detached-remote@\u003cVERSIONTAG\u003e\n        with:\n          upstreamrepo: https://github.com/\u003cowner\u003e/\u003crepo\u003e\n          upstreambranch: \u003cbranchname\u003e\n        env:\n          GITHUB_PAT: ${{ secrets.GH_PAT }}\n          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n```\n\n## Inputs\n→ see also [Configuration.cs](https://github.com/litetex/PullDetachedRemote/blob/develop/PullDetachedRemote/Config/Configuration.cs)\n### Parameters\n→ see [action.yml](action.yml)\n### Environment-Variables\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eVariable\u003c/th\u003e\n    \u003cth\u003eState\u003c/th\u003e\n    \u003cth\u003eDescription\u003c/th\u003e\n    \u003cth\u003eNotes\u003c/th\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n    \u003ctd\u003eGITHUB_PAT\u003c/td\u003e\n    \u003ctd\u003eRequired\u003c/td\u003e\n    \u003ctd\u003e\n      A personal access token, that is used for git modifications of the targeted repo\n    \u003c/td\u003e\n    \u003ctd\u003e\n      This is the fallback if no GITHUB_TOKEN is set\u003cbr/\u003e\n      \u003cbr/\u003e\n      Add it to the \u003ca href=\"https://help.github.com/en/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository\"\u003esecrets\u003c/a\u003e\u003cbr/\u003e\n      \u003cbr/\u003e\n      \u003ca href=\"https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line\"\u003eGitHub Documentation\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n    \u003ctd\u003eGITHUB_TOKEN\u003c/td\u003e\n    \u003ctd\u003eRecommended\u003c/td\u003e\n    \u003ctd\u003e\n      A token automatically created by GitHub for workflows on the current repo\n    \u003c/td\u003e\n    \u003ctd\u003e\n      If not set, the owner of the GITHUB_PAT will be the author of the pull request\u003cbr/\u003e\n      \u003cbr/\u003e\n      \u003ca href=\"https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token#about-the-github_token-secret\"\u003eGitHub Documentation\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n    \u003ctd\u003eDETACHED_CREDS_PRINCIPAL\u003c/td\u003e\n    \u003ctd\u003eOptional\u003c/td\u003e\n    \u003ctd\u003e\n      Principal/Username (if you have a token, use it here and leave password blank)\n    \u003c/td\u003e\n    \u003ctd rowspan=2\u003e\n      Only required if a repository outside of GitHub has to be authenticated\u003cbr/\u003e\n      \u003cbr/\u003e\n      Only used if:\u003cbr/\u003e\n      \u003cul\u003e\n        \u003cli\u003eupstreamcredmode=AUTO (default)\u003cbr/\u003ethe upstream-repo is not hosted on GitHub and DETACHED_CREDS_PRINCIPAL is set\n        \u003c/li\u003e\n        \u003cli\u003eupstreamcredmode=CUSTOM\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\n  \u003ctr\u003e\n    \u003ctd\u003eDETACHED_CREDS_PW\u003c/td\u003e\n    \u003ctd\u003eOptional\u003c/td\u003e\n    \u003ctd\u003e\n      Password\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\u003ctd colspan=4\u003e\u003c/td\u003e\u003c/tr\u003e\n  \n  \u003ctr\u003e\n    \u003ctd\u003eNO_PR_STATUS\u003c/td\u003e\n    \u003ctd\u003eOptional\u003c/td\u003e\n    \u003ctd\u003eDisables the status message in the pull request\u003c/td\u003e\n    \u003ctd\u003eValid values: \u003ccode\u003e1\u003c/code\u003e or \u003ccode\u003etrue\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \n  \u003ctr\u003e\n    \u003ctd\u003eNO_CREDITS\u003c/td\u003e\n    \u003ctd\u003eOptional\u003c/td\u003e\n    \u003ctd\u003eDisables the credits in the pull request\u003c/td\u003e\n    \u003ctd\u003eValid values: \u003ccode\u003e1\u003c/code\u003e or \u003ccode\u003etrue\u003c/code\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Demos\nHere you can find a demo implementations:\n* [avesflower](https://github.com/BaseMC/avesflower/blob/develop/.github/workflows/upstream_update.yml)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitetex%2Fpull-detached-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flitetex%2Fpull-detached-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitetex%2Fpull-detached-remote/lists"}