mirror of
https://github.com/nushell/nushell.git
synced 2024-12-23 15:39:06 +01:00
7a820b1304
* add a new welcome banner to nushell * remove top line * tweaked colors and wording * changed to dimmed white * removed a comment * make config nu stand out a little * fix type-o
505 lines
20 KiB
Plaintext
505 lines
20 KiB
Plaintext
# Nushell Config File
|
|
|
|
module completions {
|
|
# Custom completions for external commands (those outside of Nushell)
|
|
# Each completions has two parts: the form of the external command, including its flags and parameters
|
|
# and a helper command that knows how to complete values for those flags and parameters
|
|
#
|
|
# This is a simplified version of completions for git branches and git remotes
|
|
def "nu-complete git branches" [] {
|
|
^git branch | lines | each { |line| $line | str replace '[\*\+] ' '' | str trim }
|
|
}
|
|
|
|
def "nu-complete git remotes" [] {
|
|
^git remote | lines | each { |line| $line | str trim }
|
|
}
|
|
|
|
# Download objects and refs from another repository
|
|
export extern "git fetch" [
|
|
repository?: string@"nu-complete git remotes" # name of the repository to fetch
|
|
branch?: string@"nu-complete git branches" # name of the branch to fetch
|
|
--all # Fetch all remotes
|
|
--append(-a) # Append ref names and object names to .git/FETCH_HEAD
|
|
--atomic # Use an atomic transaction to update local refs.
|
|
--depth: int # Limit fetching to n commits from the tip
|
|
--deepen: int # Limit fetching to n commits from the current shallow boundary
|
|
--shallow-since: string # Deepen or shorten the history by date
|
|
--shallow-exclude: string # Deepen or shorten the history by branch/tag
|
|
--unshallow # Fetch all available history
|
|
--update-shallow # Update .git/shallow to accept new refs
|
|
--negotiation-tip: string # Specify which commit/glob to report while fetching
|
|
--negotiate-only # Do not fetch, only print common ancestors
|
|
--dry-run # Show what would be done
|
|
--write-fetch-head # Write fetched refs in FETCH_HEAD (default)
|
|
--no-write-fetch-head # Do not write FETCH_HEAD
|
|
--force(-f) # Always update the local branch
|
|
--keep(-k) # Keep dowloaded pack
|
|
--multiple # Allow several arguments to be specified
|
|
--auto-maintenance # Run 'git maintenance run --auto' at the end (default)
|
|
--no-auto-maintenance # Don't run 'git maintenance' at the end
|
|
--auto-gc # Run 'git maintenance run --auto' at the end (default)
|
|
--no-auto-gc # Don't run 'git maintenance' at the end
|
|
--write-commit-graph # Write a commit-graph after fetching
|
|
--no-write-commit-graph # Don't write a commit-graph after fetching
|
|
--prefetch # Place all refs into the refs/prefetch/ namespace
|
|
--prune(-p) # Remove obsolete remote-tracking references
|
|
--prune-tags(-P) # Remove any local tags that do not exist on the remote
|
|
--no-tags(-n) # Disable automatic tag following
|
|
--refmap: string # Use this refspec to map the refs to remote-tracking branches
|
|
--tags(-t) # Fetch all tags
|
|
--recurse-submodules: string # Fetch new commits of populated submodules (yes/on-demand/no)
|
|
--jobs(-j): int # Number of parallel children
|
|
--no-recurse-submodules # Disable recursive fetching of submodules
|
|
--set-upstream # Add upstream (tracking) reference
|
|
--submodule-prefix: string # Prepend to paths printed in informative messages
|
|
--upload-pack: string # Non-default path for remote command
|
|
--quiet(-q) # Silence internally used git commands
|
|
--verbose(-v) # Be verbose
|
|
--progress # Report progress on stderr
|
|
--server-option(-o): string # Pass options for the server to handle
|
|
--show-forced-updates # Check if a branch is force-updated
|
|
--no-show-forced-updates # Don't check if a branch is force-updated
|
|
-4 # Use IPv4 addresses, ignore IPv6 addresses
|
|
-6 # Use IPv6 addresses, ignore IPv4 addresses
|
|
--help # Display this help message
|
|
]
|
|
|
|
# Check out git branches and files
|
|
export extern "git checkout" [
|
|
...targets: string@"nu-complete git branches" # name of the branch or files to checkout
|
|
--conflict: string # conflict style (merge or diff3)
|
|
--detach(-d) # detach HEAD at named commit
|
|
--force(-f) # force checkout (throw away local modifications)
|
|
--guess # second guess 'git checkout <no-such-branch>' (default)
|
|
--ignore-other-worktrees # do not check if another worktree is holding the given ref
|
|
--ignore-skip-worktree-bits # do not limit pathspecs to sparse entries only
|
|
--merge(-m) # perform a 3-way merge with the new branch
|
|
--orphan: string # new unparented branch
|
|
--ours(-2) # checkout our version for unmerged files
|
|
--overlay # use overlay mode (default)
|
|
--overwrite-ignore # update ignored files (default)
|
|
--patch(-p) # select hunks interactively
|
|
--pathspec-from-file: string # read pathspec from file
|
|
--progress # force progress reporting
|
|
--quiet(-q) # suppress progress reporting
|
|
--recurse-submodules: string # control recursive updating of submodules
|
|
--theirs(-3) # checkout their version for unmerged files
|
|
--track(-t) # set upstream info for new branch
|
|
-b: string # create and checkout a new branch
|
|
-B: string # create/reset and checkout a branch
|
|
-l # create reflog for new branch
|
|
--help # Display this help message
|
|
]
|
|
|
|
# Push changes
|
|
export extern "git push" [
|
|
remote?: string@"nu-complete git remotes", # the name of the remote
|
|
...refs: string@"nu-complete git branches" # the branch / refspec
|
|
--all # push all refs
|
|
--atomic # request atomic transaction on remote side
|
|
--delete(-d) # delete refs
|
|
--dry-run(-n) # dry run
|
|
--exec: string # receive pack program
|
|
--follow-tags # push missing but relevant tags
|
|
--force-with-lease: string # require old value of ref to be at this value
|
|
--force(-f) # force updates
|
|
--ipv4(-4) # use IPv4 addresses only
|
|
--ipv6(-6) # use IPv6 addresses only
|
|
--mirror # mirror all refs
|
|
--no-verify # bypass pre-push hook
|
|
--porcelain # machine-readable output
|
|
--progress # force progress reporting
|
|
--prune # prune locally removed refs
|
|
--push-option(-o): string # option to transmit
|
|
--quiet(-q) # be more quiet
|
|
--receive-pack: string # receive pack program
|
|
--recurse-submodules: string # control recursive pushing of submodules
|
|
--repo: string # repository
|
|
--set-upstream(-u) # set upstream for git pull/status
|
|
--signed: string # GPG sign the push
|
|
--tags # push tags (can't be used with --all or --mirror)
|
|
--thin # use thin pack
|
|
--verbose(-v) # be more verbose
|
|
--help # Display this help message
|
|
]
|
|
}
|
|
|
|
# Get just the extern definitions without the custom completion commands
|
|
use completions *
|
|
|
|
# for more information on themes see
|
|
# https://www.nushell.sh/book/coloring_and_theming.html
|
|
let dark_theme = {
|
|
# color for nushell primitives
|
|
separator: white
|
|
leading_trailing_space_bg: { attr: n } # no fg, no bg, attr none effectively turns this off
|
|
header: green_bold
|
|
empty: blue
|
|
bool: white
|
|
int: white
|
|
filesize: white
|
|
duration: white
|
|
date: white
|
|
range: white
|
|
float: white
|
|
string: white
|
|
nothing: white
|
|
binary: white
|
|
cellpath: white
|
|
row_index: green_bold
|
|
record: white
|
|
list: white
|
|
block: white
|
|
hints: dark_gray
|
|
|
|
# shapes are used to change the cli syntax highlighting
|
|
shape_garbage: { fg: "#FFFFFF" bg: "#FF0000" attr: b}
|
|
shape_binary: purple_bold
|
|
shape_bool: light_cyan
|
|
shape_int: purple_bold
|
|
shape_float: purple_bold
|
|
shape_range: yellow_bold
|
|
shape_internalcall: cyan_bold
|
|
shape_external: cyan
|
|
shape_externalarg: green_bold
|
|
shape_literal: blue
|
|
shape_operator: yellow
|
|
shape_signature: green_bold
|
|
shape_string: green
|
|
shape_string_interpolation: cyan_bold
|
|
shape_datetime: cyan_bold
|
|
shape_list: cyan_bold
|
|
shape_table: blue_bold
|
|
shape_record: cyan_bold
|
|
shape_block: blue_bold
|
|
shape_filepath: cyan
|
|
shape_globpattern: cyan_bold
|
|
shape_variable: purple
|
|
shape_flag: blue_bold
|
|
shape_custom: green
|
|
shape_nothing: light_cyan
|
|
}
|
|
|
|
let light_theme = {
|
|
# color for nushell primitives
|
|
separator: dark_gray
|
|
leading_trailing_space_bg: { attr: n } # no fg, no bg, attr none effectively turns this off
|
|
header: green_bold
|
|
empty: blue
|
|
bool: dark_gray
|
|
int: dark_gray
|
|
filesize: dark_gray
|
|
duration: dark_gray
|
|
date: dark_gray
|
|
range: dark_gray
|
|
float: dark_gray
|
|
string: dark_gray
|
|
nothing: dark_gray
|
|
binary: dark_gray
|
|
cellpath: dark_gray
|
|
row_index: green_bold
|
|
record: white
|
|
list: white
|
|
block: white
|
|
hints: dark_gray
|
|
|
|
# shapes are used to change the cli syntax highlighting
|
|
shape_garbage: { fg: "#FFFFFF" bg: "#FF0000" attr: b}
|
|
shape_binary: purple_bold
|
|
shape_bool: light_cyan
|
|
shape_int: purple_bold
|
|
shape_float: purple_bold
|
|
shape_range: yellow_bold
|
|
shape_internalcall: cyan_bold
|
|
shape_external: cyan
|
|
shape_externalarg: green_bold
|
|
shape_literal: blue
|
|
shape_operator: yellow
|
|
shape_signature: green_bold
|
|
shape_string: green
|
|
shape_string_interpolation: cyan_bold
|
|
shape_datetime: cyan_bold
|
|
shape_list: cyan_bold
|
|
shape_table: blue_bold
|
|
shape_record: cyan_bold
|
|
shape_block: blue_bold
|
|
shape_filepath: cyan
|
|
shape_globpattern: cyan_bold
|
|
shape_variable: purple
|
|
shape_flag: blue_bold
|
|
shape_custom: green
|
|
shape_nothing: light_cyan
|
|
}
|
|
|
|
# The default config record. This is where much of your global configuration is setup.
|
|
let-env config = {
|
|
filesize_metric: false
|
|
table_mode: rounded # basic, compact, compact_double, light, thin, with_love, rounded, reinforced, heavy, none, other
|
|
use_ls_colors: true
|
|
rm_always_trash: false
|
|
color_config: $dark_theme # if you want a light theme, replace `$dark_theme` to `$light_theme`
|
|
use_grid_icons: true
|
|
footer_mode: "25" # always, never, number_of_rows, auto
|
|
quick_completions: true # set this to false to prevent auto-selecting completions when only one remains
|
|
partial_completions: true # set this to false to prevent partial filling of the prompt
|
|
completion_algorithm: "prefix" # prefix, fuzzy
|
|
float_precision: 2
|
|
# buffer_editor: "emacs" # command that will be used to edit the current line buffer with ctrl+o, if unset fallback to $env.EDITOR and $env.VISUAL
|
|
use_ansi_coloring: true
|
|
filesize_format: "auto" # b, kb, kib, mb, mib, gb, gib, tb, tib, pb, pib, eb, eib, zb, zib, auto
|
|
edit_mode: emacs # emacs, vi
|
|
max_history_size: 10000 # Session has to be reloaded for this to take effect
|
|
sync_history_on_enter: true # Enable to share the history between multiple sessions, else you have to close the session to persist history to file
|
|
history_file_format: "plaintext" # "sqlite" or "plaintext"
|
|
shell_integration: true # enables terminal markers and a workaround to arrow keys stop working issue
|
|
disable_table_indexes: false # set to true to remove the index column from tables
|
|
cd_with_abbreviations: false # set to true to allow you to do things like cd s/o/f and nushell expand it to cd some/other/folder
|
|
case_sensitive_completions: false # set to true to enable case-sensitive completions
|
|
enable_external_completion: true # set to false to prevent nushell looking into $env.PATH to find more suggestions, `false` recommended for WSL users as this look up my be very slow
|
|
max_external_completion_results: 100 # setting it lower can improve completion performance at the cost of omitting some options
|
|
# A strategy of managing table view in case of limited space.
|
|
table_trim: {
|
|
methodology: wrapping, # truncating
|
|
# A strategy which will be used by 'wrapping' methodology
|
|
wrapping_try_keep_words: true,
|
|
# A suffix which will be used with 'truncating' methodology
|
|
# truncating_suffix: "..."
|
|
}
|
|
show_banner: true # true or false to enable or disable the banner
|
|
|
|
hooks: {
|
|
pre_prompt: [{
|
|
$nothing # replace with source code to run before the prompt is shown
|
|
}]
|
|
pre_execution: [{
|
|
$nothing # replace with source code to run before the repl input is run
|
|
}]
|
|
env_change: {
|
|
PWD: [{|before, after|
|
|
$nothing # replace with source code to run if the PWD environment is different since the last repl input
|
|
}]
|
|
}
|
|
}
|
|
menus: [
|
|
# Configuration for default nushell menus
|
|
# Note the lack of souce parameter
|
|
{
|
|
name: completion_menu
|
|
only_buffer_difference: false
|
|
marker: "| "
|
|
type: {
|
|
layout: columnar
|
|
columns: 4
|
|
col_width: 20 # Optional value. If missing all the screen width is used to calculate column width
|
|
col_padding: 2
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
}
|
|
{
|
|
name: history_menu
|
|
only_buffer_difference: true
|
|
marker: "? "
|
|
type: {
|
|
layout: list
|
|
page_size: 10
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
}
|
|
{
|
|
name: help_menu
|
|
only_buffer_difference: true
|
|
marker: "? "
|
|
type: {
|
|
layout: description
|
|
columns: 4
|
|
col_width: 20 # Optional value. If missing all the screen width is used to calculate column width
|
|
col_padding: 2
|
|
selection_rows: 4
|
|
description_rows: 10
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
}
|
|
# Example of extra menus created using a nushell source
|
|
# Use the source field to create a list of records that populates
|
|
# the menu
|
|
{
|
|
name: commands_menu
|
|
only_buffer_difference: false
|
|
marker: "# "
|
|
type: {
|
|
layout: columnar
|
|
columns: 4
|
|
col_width: 20
|
|
col_padding: 2
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
source: { |buffer, position|
|
|
$nu.scope.commands
|
|
| where command =~ $buffer
|
|
| each { |it| {value: $it.command description: $it.usage} }
|
|
}
|
|
}
|
|
{
|
|
name: vars_menu
|
|
only_buffer_difference: true
|
|
marker: "# "
|
|
type: {
|
|
layout: list
|
|
page_size: 10
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
source: { |buffer, position|
|
|
$nu.scope.vars
|
|
| where name =~ $buffer
|
|
| sort-by name
|
|
| each { |it| {value: $it.name description: $it.type} }
|
|
}
|
|
}
|
|
{
|
|
name: commands_with_description
|
|
only_buffer_difference: true
|
|
marker: "# "
|
|
type: {
|
|
layout: description
|
|
columns: 4
|
|
col_width: 20
|
|
col_padding: 2
|
|
selection_rows: 4
|
|
description_rows: 10
|
|
}
|
|
style: {
|
|
text: green
|
|
selected_text: green_reverse
|
|
description_text: yellow
|
|
}
|
|
source: { |buffer, position|
|
|
$nu.scope.commands
|
|
| where command =~ $buffer
|
|
| each { |it| {value: $it.command description: $it.usage} }
|
|
}
|
|
}
|
|
]
|
|
keybindings: [
|
|
{
|
|
name: completion_menu
|
|
modifier: none
|
|
keycode: tab
|
|
mode: emacs # Options: emacs vi_normal vi_insert
|
|
event: {
|
|
until: [
|
|
{ send: menu name: completion_menu }
|
|
{ send: menunext }
|
|
]
|
|
}
|
|
}
|
|
{
|
|
name: completion_previous
|
|
modifier: shift
|
|
keycode: backtab
|
|
mode: [emacs, vi_normal, vi_insert] # Note: You can add the same keybinding to all modes by using a list
|
|
event: { send: menuprevious }
|
|
}
|
|
{
|
|
name: history_menu
|
|
modifier: control
|
|
keycode: char_r
|
|
mode: emacs
|
|
event: { send: menu name: history_menu }
|
|
}
|
|
{
|
|
name: next_page
|
|
modifier: control
|
|
keycode: char_x
|
|
mode: emacs
|
|
event: { send: menupagenext }
|
|
}
|
|
{
|
|
name: undo_or_previous_page
|
|
modifier: control
|
|
keycode: char_z
|
|
mode: emacs
|
|
event: {
|
|
until: [
|
|
{ send: menupageprevious }
|
|
{ edit: undo }
|
|
]
|
|
}
|
|
}
|
|
{
|
|
name: yank
|
|
modifier: control
|
|
keycode: char_y
|
|
mode: emacs
|
|
event: {
|
|
until: [
|
|
{edit: pastecutbufferafter}
|
|
]
|
|
}
|
|
}
|
|
{
|
|
name: unix-line-discard
|
|
modifier: control
|
|
keycode: char_u
|
|
mode: [emacs, vi_normal, vi_insert]
|
|
event: {
|
|
until: [
|
|
{edit: cutfromlinestart}
|
|
]
|
|
}
|
|
}
|
|
{
|
|
name: kill-line
|
|
modifier: control
|
|
keycode: char_k
|
|
mode: [emacs, vi_normal, vi_insert]
|
|
event: {
|
|
until: [
|
|
{edit: cuttolineend}
|
|
]
|
|
}
|
|
}
|
|
# Keybindings used to trigger the user defined menus
|
|
{
|
|
name: commands_menu
|
|
modifier: control
|
|
keycode: char_t
|
|
mode: [emacs, vi_normal, vi_insert]
|
|
event: { send: menu name: commands_menu }
|
|
}
|
|
{
|
|
name: vars_menu
|
|
modifier: alt
|
|
keycode: char_o
|
|
mode: [emacs, vi_normal, vi_insert]
|
|
event: { send: menu name: vars_menu }
|
|
}
|
|
{
|
|
name: commands_with_description
|
|
modifier: control
|
|
keycode: char_s
|
|
mode: [emacs, vi_normal, vi_insert]
|
|
event: { send: menu name: commands_with_description }
|
|
}
|
|
]
|
|
}
|