From 0cb9aac71bb22f8058d1db8eb3ba62e83f5641bf Mon Sep 17 00:00:00 2001 From: RGBCube Date: Wed, 29 May 2024 11:57:55 +0300 Subject: [PATCH] Add help output to README --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/README.md b/README.md index 3fe670b..f42e06b 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,41 @@ Plain simple, just install [Nushell](https://nushell.sh) and run the script: ./github2forgejo --help ``` +
+Help Output + +``` +Migrates a GitHub users repositories to a Forgejo instance. + +Accepted environment variables: + + GITHUB_USER: The user to fetch the repositories from. + GITHUB_TOKEN: An access token for fetching private repositories. Optional. + + FORGEJO_URL: The URL to the Forgejo instance. Must include the protocol (https://). + FORGEJO_USER: The user to migrate the repositories to. + FORGEJO_TOKEN: An access token for the specified user. + + STRATEGY: + The strategy. Valid options are "mirrored" or "cloned" (case insensitive). + "mirrored" will mirror the repository and tell the Forgejo instance to + periodically update it, "cloned" will only clone once. "cloned" is + useful if you are never going to use GitHub again. + + FORCE_SYNC: + Whether to delete a mirrored repo from the Forgejo instance if the + source on GitHub doesn't exist anymore. Must be either "true" or "false". + +To leave an environment variable unspecified, set it to an empty string. + +Usage: + > github2forgejo + +Flags: + -h, --help - Display the help message for this command +``` +
+ You can either specify all the environment variables for a uninteractive run, or run the script like so: