runfile 1.0.2

.NET 10.0

dotnet tool install --global runfile --version 1.0.2

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 runfile --version 1.0.2

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=runfile&version=1.0.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package runfile --version 1.0.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Run C# code programs from git repos on GitHub, GitLab and Azure DevOps.

Usage:
    [dnx] runfile [--aot] [--alias ALIAS] <repoRef> [<appArgs>...]

Arguments:
    <REPO_REF>  Reference to remote file to run, with format [host/]owner/repo[@ref][:path]
                host optional host name ([gist.]github.com|gitlab.com|dev.azure.com, default: github.com)
                @ref optional branch, tag, or commit (default: default branch)
                :path optional path to file in repo (default: program.cs at repo root)

                Examples:
                * kzu/sandbox@v1.0.0:run.cs           (implied host github.com, explicit tag and file path)
                * gitlab.com/kzu/sandbox@main:run.cs  (all explicit parts)
                * kzu/sandbox                         (implied host github.com, ref and path defaults)

                Can be an alias previously set with --alias.

    <appArgs>   Arguments passed to the C# program that is being run.

Options:
    --aot         (optional) Enable dotnet AOT defaults for run file.cs. Defaults to false.
    --alias ALIAS (optional) Assign an alias on first usage which can be used instead of the full ref.

Example:

dnx runfile kzu/runfile@v1:run.cs dotnet rocks

View source:

#:package Spectre.Console@*

using Spectre.Console;

AnsiConsole.MarkupLine($"Hello world from [green]dnx[/] [yellow]gist[/] :rocket: [bold italic]{string.Join(' ', args)}[/]");

The repo does not need to be public. Private repos will leverage the same authentication used by your local git to access the file, via the Git Credential Manager.

When running different files from the same repo+ref, the download will be performed only once. The last download etag is used to avoid downloading on each run.

Open Source Maintenance Fee

To ensure the long-term sustainability of this project, users of this package who generate revenue must pay an Open Source Maintenance Fee. While the source code is freely available under the terms of the License, this package and other aspects of the project require adherence to the Maintenance Fee.

To pay the Maintenance Fee, become a Sponsor at the proper OSMF tier. A single fee covers all of Devlooped packages.