https://github.com/clarius/dotnet-evergreen

Official public website for https://github.com/devlooped/dotnet-evergreen
https://github.com/clarius/dotnet-evergreen

Last synced: 6 months ago
JSON representation

Official public website for https://github.com/devlooped/dotnet-evergreen

• Host: GitHub
• URL: https://github.com/clarius/dotnet-evergreen
• Owner: clarius
• License: mit
• Created: 2021-07-20T01:16:13.000Z (about 5 years ago)
• Default Branch: gh-pages
• Last Pushed: 2022-10-18T13:44:00.000Z (almost 4 years ago)
• Last Synced: 2025-10-22T18:03:14.853Z (9 months ago)
• Language: HTML
• Homepage: https://clarius.org/dotnet-evergreen
• Size: 29.3 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • Changelog: changelog.html
  • License: LICENSE
  • Code of conduct: code-of-conduct.html
  • Security: security.html

Awesome Lists containing this project

README

          
![Icon](https://raw.githubusercontent.com/devlooped/dotnet-evergreen/main/assets/img/icon.png) dotnet-evergreen

============

[![Version](https://img.shields.io/nuget/v/dotnet-evergreen.svg?color=royalblue)](https://www.nuget.org/packages/dotnet-evergreen) [![Downloads](https://img.shields.io/nuget/dt/dotnet-evergreen.svg?color=green)](https://www.nuget.org/packages/dotnet-evergreen) [![License](https://img.shields.io/github/license/devlooped/dotnet-evergreen.svg?color=blue)](https://github.com/devlooped/dotnet-evergreen/blob/main/license.txt) [![Build](https://github.com/devlooped/dotnet-evergreen/workflows/build/badge.svg?branch=main)](https://github.com/devlooped/dotnet-evergreen/actions)

A dotnet global tool runner that automatically updates the tool package before running it, 

checks for updates while it runs, and restarts the tool as needed after updating it.

```

dotnet evergreen

  Run an evergreen version of a tool

Usage:

  dotnet evergreen [options] [ [...]]

Arguments:

    Package Id of tool to run.

    Additional arguments and options supported by the tool

Options:

  -s, --source       NuGet feed to check for updates. [default: https://api.nuget.org/v3/index.json]

  --singleton                Ensure a single tool process is running.

  -i, --interval   Time interval in seconds for the update checks. [default: 5]

  -f, --force                Stop all running tool processes to apply updates. [default: True]

  -p, --prerelease           Whether to include pre-release packages. [default: False]

  -q, --quiet                Do not display any informational messages.

  -?, -h, --help             Show help and usage information

  --version                  Show version information

```

Features:

* Automatically exits if the tool also runs to completion

* Forwards exit code from the tool

* Restarts tool as needed to apply updates

* Stops all other tool running processes so updating succeeds (can be opted out with `-f=false`)

* Ensures a single tool is running (`--singleton` option)

* Passes all tool options verbatim (except for `evergreen` options, specified *before* the tool argument)

* Automatically discovers tool *command* when it doesn't match the tool *package id* 

  (i.e. [dotnet-eventgrid](https://www.nuget.org/packages/dotnet-eventgrid) > `eventgrid`).

* Supports [dotnetconfig](https://dotnetconfig.org) for options. Example:

  ```

  [evergreen]

    interval = 5

    source = https://myfeed.com/index.json 

    singleton = true

    prerelease = true

  ```

Examples:

```

> dotnet evergreen dotnet-echo

> dotnet evergreen dotnet-tor

```