This GitHub Action will setup a Nushell environment for you.
In most cases you just need to specify the version of Nushell to be used in your workflow.
For example the following installs the v0.80 version of Nushell.
Then you can set the command you want to run in the following steps, and don't forget to set shell: nu {0}
to make the commands be executed by nu:
- uses: hustcer/setup-nu@v3
with:
version: "0.90" # Don't use 0.90 here, as it was a float number and will be convert to 0.9, you can use v0.90/0.90.0 or '0.90'
- run: print $'Nu version info:(char nl)'; version
shell: nu {0}
- name: Default shell will be `nu`
shell: nu {0}
run: |
print $'Nu path:(which nu)(char nl)'
def greeting [name: string] {
print $'Hello ($name)'
}
greeting hustcerOf cause, You can also set the default shell to nu by setting the defaults.run.shell config:
name: basic
on: push
defaults:
run:
shell: nu {0}
jobs:
basic-usage:
runs-on: ubuntu-latest
steps:
- uses: actions/[email protected]
- uses: hustcer/setup-nu@main
with:
version: "*"
- run: version; print $"(char nl)Dir contents:(char nl)"; ls ((which nu).path.0 | path dirname)
- run: |
print $'Current env:(char nl)'
print $env
- name: You can run bash commands, too
run: pwd && ls -la
shell: bashTo use modules in Nu, please refer to the following examples:
- Use Nu modules in
nu -c
- name: Setup nu
uses: hustcer/setup-nu@v3
with:
version: 0.95.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Use Your Nu Modules
shell: nu {0}
run: |
nu -c "use nu/module.nu *; print (get-env 'ABC-XYZ' 'DEFAULT-ABC-XYZ')"You have to wrap the nu code in nu -c "", and the nu version should be equal to or above 0.69.
- Use modules from absolute path
- name: Setup nu
uses: hustcer/setup-nu@v3
with:
version: 0.95.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Use Your Nu Modules by Absolute Path
shell: nu {0}
run: |
use ${{ github.workspace }}/nu/module.nu *
print 'Use module from: ${{ github.workspace }}/nu/module.nu'
print (get-env 'ABC-XYZ' 'DEFAULT-ABC-XYZ-ABSOLUTE-PATH')Again, the nu version should be equal to or above 0.69.
- Copy your modules to one of the default
$env.NU_LIB_DIRS
- name: Setup nu@latest
uses: hustcer/setup-nu@v3
with:
version: 0.95.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Prepare Nu Modules
shell: nu {0}
run: |
let LIB_DIR = [$nu.default-config-dir 'scripts'] | path join
if not ($LIB_DIR | path exists) { mkdir $LIB_DIR }
cp -r nu/* $LIB_DIR
- name: Use Your Nu Modules
shell: nu {0}
run: |
use module.nu *
print (get-env 'ABC-XYZ' 'DEFAULT-ABC-XYZ')To make it work please make sure that the nu version should be equal to or above 0.85.
They are not perfect yet, but they do work. BTW: Please tell me if you found a better way and PRs are always welcomed.
Nushell is currently in active development, if you want to use the latest features it's also available by set the version to nightly, just as below:
- uses: hustcer/setup-nu@v3
with:
version: nightly # Will download and setup the latest nightly version of Nushell
- run: print $'Nu version info:(char nl)'; version
shell: nu {0}
- name: Default shell will be `nu`
shell: nu {0}
run: |
print $'Nu path:(which nu)(char nl)'
def greeting [name: string] {
print $'Hello ($name)'
}
greeting hustcerWarning Use
Nushellnightly version with caution: The nu binary may change every other day and this may break your workflow. Only the latest nightly version will be downloaded and setup, and the version must benightly.
Or, check the following examples:
- run-test.yaml
- run-matrix.yaml
- Advanced example: How Nushell Make a Release? Workflow, Script
If you want to use the latest version of nushell you can specify this by set check-latest to
true(it's the same as version: '*', but more readable). For example the following installs
the latest version:
- uses: hustcer/setup-nu@v3
with:
check-latest: true
- run: print $'Nu version info:(char nl)'; versionNote: Before Nushell reaches 1.0, each version may change a lot, it is recommend that you use a specified version instead.
| Name | Required | Description | Type | Default |
|---|---|---|---|---|
version |
no | A valid NPM-style semver specification, such as 0.86.0, etc. and nightly. |
string | * |
check-latest |
no | Set to true if you want to use the latest version |
bool | false |
enable-plugins |
no | Set to true if you want to register the bundled plugins or a comma-separated string of plugin names like nu_plugin_polars,nu_plugin_query, Nu v0.86 and above is required |
bool|string | false |
features |
no | Available choice: default or full, and the full features will include the commands from extra and dataframe. full can be used for Nu from v0.86 to v0.93 and was removed after v0.93.1 |
string | default |
github-token |
no | Your GitHub token or PAT token | string | ${{ github.token }} |
The semver specification is passed directly to NPM's semver package. This GitHub Action will install the latest matching release.
Licensed under:
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)