PleOps.Forjil.Cli 1.0.1

dotnet tool install --global PleOps.Forjil.Cli --version 1.0.1
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local PleOps.Forjil.Cli --version 1.0.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=PleOps.Forjil.Cli&version=1.0.1
                    
nuke :add-package PleOps.Forjil.Cli --version 1.0.1
                    

Forjil

<p align="center"> <a href="https://github.com/oAGoulart/awesome-nollm?tab=readme-ov-file#ai-free-content-badge"> <img alt="AI-free content" src="https://github.com/oAGoulart/awesome-nollm/blob/main/assets/nollm-b-31px.png?raw=true"> </a>   <a href="https://codeberg.org/pleonex/forjil/releases"> <img alt="Last release" src="https://codeberg.org/pleonex/forjil/badges/release.svg"> </a>   <a href="https://codeberg.org/pleonex/forjil"> <img alt="Last Commit" src="https://img.shields.io/gitea/last-commit/pleonex/forjil?gitea_url=https%3A%2F%2Fcodeberg.org"> </a>   <a href="https://codeberg.org/pleonex/forjil/actions"> <img alt="Build and release" src="https://codeberg.org/pleonex/forjil/badges/workflows/build-and-release.yml/badge.svg" /> </a>   <a href="https://choosealicense.com/licenses/mit/"> <img alt="MIT License" src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat" /> </a>   </p>

Command-line utilities for DevOps tasks with Forgejo hosted projects.

  • 🎼 C# / .NET client for Forgejo REST API
  • ⬇️ Download pipeline artifacts
  • ♻️ HTTP service to download predefined artifacts to local disk
  • 📃 Download release message
  • ⬆️ Upload assets to release
  • 📝 Generate release notes from PR and commit list

The current version is compatible with Forgejo v15.0.0.

Getting started

Artifacts synchronizer

  1. Build the container image with: dotnet run build.cs -- --target=Default --target=Bundle --dotnet-configuration=Release

  2. Load the container image into an OCI engine from /build/artifacts

  3. Create the list of supported artifacts in a JSON file, take as a reference artifacts.json

  4. Run the image with the OCI engine (e.g., Docker Compose). Take the following command as a reference:

    docker run -p 5173:8080 --rm -v ./docs:/downloads -v ./myartifacts.json:/app/artifacts.json pleonex/artifacts-sync:0.1.0-preview.10
    

Build

The build system requires .NET 10.0 SDK.

To build, test and generate artifacts run:

# Build and run tests
dotnet run build.cs

# Create bundles
dotnet run build.cs -- --target=Bundle

Release

Create a new release with a tag v{Version} (e.g., v2.4) and that's it! This triggers a pipeline that builds and deploy the project.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.1 61 5/12/2026

## v1.0 (May 12, 2026)

First release of the project!

### New command-line `forjil` and library `PleOps.Forjil`

This .NET tool and .NET library useful commands for CI / DevOps pipelines with Forgejo projects:

- Download Forgejo Action pipeline artifacts
- Download release message
- Upload assets to release
- Generate release notes from PR and commit list

You can install it via `dotnet tool install PleOps.Forjil.Cli`, and restore the .NET library fro nuget.org.

### New Forgejo API .NET client

The .NET library `PleOps.Forgejo.Client` provides a client for the REST API of a Forgejo instance. It&apos;s compatible with Forgejo v15.0.

### New OpenAPI server to synchronize artifacts

This service offers a simple OpenAPI / REST API to trigger an action that downloads the latest pipeline artifact available in a Forgejo repository.
The project provides a OCI (Docker) container image to run it easily.
This can be used for [static documentation sites](https://codeberg.org/pleonex/self-hosting/src/branch/main/cloud/pages).

**Note:** v1.0.1 is identical to v1.0.0 with a CI fix.