From e60e313f81326b5c2fd28d1f55ac4311a3a3ce16 Mon Sep 17 00:00:00 2001 From: Xavier Del Campo Romero Date: Sun, 12 Jan 2025 01:52:32 +0100 Subject: Add README.md --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..064e7e4 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +# `upload-artifact` + +As its name suggests, this project defines a simple shell script that +allows to upload one or more artifacts to a +[`slcl`](https://gitea.privatedns.org/xavi/slcl) instance. + +In the context of Forgejo and Gitea, this shell script and `slcl` can +be used as minimalistic alternatives to +[`actions/checkout@v4`](https://code.forgejo.org/actions/checkout), +since this action requires a Node.JS Docker image to run, as well as +some non-trivial complexity on the action itself. + +## How to use + +Set up the following environment variables: + +- `URL`: URL to the `slcl` instance. +- `USERNAME`: username to log into. +- `PASSWORD`: password for the given username. + +Then, call `upload-artifact` with the list of artifacts to upload: + +``` +upload-artifact ... +``` + +## License + +``` +upload-artifact, upload tool for slcl instances +Copyright (C) 2025 Xavier Del Campo Romero + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU Affero General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU Affero General Public License for more details. + +You should have received a copy of the GNU Affero General Public License +along with this program. If not, see . +``` + +Also, see [`LICENSE`](LICENSE). -- cgit v1.2.3