From 33b35a35660bd3ef5ce2b15c8f63db5037691f43 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?benjamin=20melan=C3=A7on?= Date: Thu, 5 Oct 2023 18:19:46 -0400 Subject: [PATCH] Add readme --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..2ffe826 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# Forgejo Helpers + +Setup: + +```bash +git clone https://git.agaric.com/agaric/forgejo_helpers.git +cd forgejo_helpers +cp .env.example .env +``` + +Set your instance URL there and your API token (with permission to read and write issues at least). + +## Move issues + +Currently this is the only script: + +[`move_issue.py`](https://git.agaric.com/agaric/forgejo_helpers/src/branch/main/move_issue.py) + +Use it by passing in the source owner, the source repository, the issue number, the destination owner, and the destination repository, like so: + +```bash +python move_issue old-example-org old-example-repo 123 new-example-org new-example-repo +``` + +All five parameters are needed, even if it is within the same organization. + +It would not be difficult to change it so these could be environment variables so that only the issue need to be passed in, and in would not be hard to allow passing in a list of issues, but this has not been done yet.