mirror of
https://github.com/nushell/nushell
synced 2025-01-02 16:29:00 +00:00
bb8949f2b2
> **Warning** > this PR is the result of a demand from the core team, to have the simplest structure for the standard library, at least for now 👍 # Description this PR mainly - moved the `dirs.nu` module to the end of `std.nu` - fixed the imports in `test_dirs.nu` # User-Facing Changes ``` $nothing ``` # Tests + Formatting with the new runner from #8443, we get as expected 👌 ``` >_ nu crates/nu-utils/standard_library/tests.nu INFO Run tests in test_dirs DEBUG Run test test_dirs/test_dirs_command INFO Run tests in test_std DEBUG Run test test_std/test_assert DEBUG Run test test_std/test_match DEBUG Run test test_std/test_path_add ``` # After Submitting ``` $nothing ```
281 lines
7.7 KiB
Text
281 lines
7.7 KiB
Text
# std.nu, `used` to load all standard library components
|
||
|
||
# ---------------- builtin std functions --------------------
|
||
|
||
def _assertion-error [start, end, label, message?: string] {
|
||
error make {
|
||
msg: ($message | default "Assertion failed."),
|
||
label: {
|
||
text: $label,
|
||
start: $start,
|
||
end: $end
|
||
}
|
||
}
|
||
}
|
||
|
||
# ```nushell
|
||
# >_ assert (3 == 3)
|
||
# >_ assert (42 == 3)
|
||
# Error:
|
||
# × Assertion failed:
|
||
# ╭─[myscript.nu:11:1]
|
||
# 11 │ assert (3 == 3)
|
||
# 12 │ assert (42 == 3)
|
||
# · ───┬────
|
||
# · ╰── It is not true.
|
||
# 13 │
|
||
# ╰────
|
||
# ```
|
||
export def assert [cond: bool, message?: string] {
|
||
if $cond { return }
|
||
let span = (metadata $cond).span
|
||
_assertion-error $span.start $span.end "It is not true." $message
|
||
}
|
||
|
||
# ```nushell
|
||
# ❯ assert eq 3 "a string"
|
||
# Error:
|
||
# × Assertion failed.
|
||
# ╭─[entry #13:1:1]
|
||
# 1 │ assert eq 3 "a string"
|
||
# · ──────┬─────
|
||
# · ╰── Different types cannot be equal: int <-> string.
|
||
# ╰────
|
||
#
|
||
#
|
||
# ❯ assert eq 3 3
|
||
# ❯ assert eq 3 1
|
||
# Error:
|
||
# × Assertion failed.
|
||
# ╭─[entry #14:1:1]
|
||
# 1 │ assert eq 3 1
|
||
# · ─┬─
|
||
# · ╰── They are not equal: 3 != 1
|
||
# ╰────
|
||
#
|
||
#
|
||
# 👇👇👇 BE CAREFUL! 👇👇👇
|
||
# ❯ assert ( 1 == 1.0) # passes
|
||
# ❯ assert eq 1 1.0
|
||
# Error:
|
||
# × Assertion failed.
|
||
# ╭─[entry #16:1:1]
|
||
# 1 │ assert eq 1 1.0
|
||
# · ──┬──
|
||
# · ╰── Different types cannot be equal: int <-> float.
|
||
# ╰────
|
||
#
|
||
# ```
|
||
export def "assert eq" [left: any, right: any, message?: string] {
|
||
let left_type = ($left | describe)
|
||
let right_type = ($right | describe)
|
||
let left_start = (metadata $left).span.start
|
||
let right_end = (metadata $right).span.end
|
||
|
||
if ($left_type != $right_type) {
|
||
_assertion-error $left_start $right_end $"Different types cannot be equal: ($left_type) <-> ($right_type)." $message
|
||
}
|
||
if ($left != $right) {
|
||
_assertion-error $left_start $right_end $"They are not equal: ($left) != ($right)" $message
|
||
}
|
||
}
|
||
|
||
# ```nushell
|
||
# ❯ assert ne 1 3
|
||
# ❯ assert ne 42 42
|
||
# Error:
|
||
# × Assertion failed.
|
||
# ╭─[entry #23:1:1]
|
||
# 1 │ assert ne 42 42
|
||
# · ──┬──
|
||
# · ╰── They both are 42
|
||
# ╰────
|
||
#
|
||
#
|
||
# 👇👇👇 BE CAREFUL! 👇👇👇
|
||
# ❯ assert ( 1 != "a string" ) # passes
|
||
# ❯ assert ne 1 "a string"
|
||
# Error:
|
||
# × Assertion failed.
|
||
# ╭─[entry #20:1:1]
|
||
# 1 │ assert ne 1 "a string"
|
||
# · ──────┬─────
|
||
# · ╰── They are not equal, although they have different types: int <-> string.
|
||
# ╰────
|
||
# ```
|
||
export def "assert ne" [left: any, right: any, message?: string] {
|
||
let left_type = ($left | describe)
|
||
let right_type = ($right | describe)
|
||
let left_start = (metadata $left).span.start
|
||
let right_end = (metadata $right).span.end
|
||
|
||
if (($left | describe) != ($right | describe)) {
|
||
_assertion-error $left_start $right_end $"They have different types: ($left_type) <-> ($right_type)." $message
|
||
}
|
||
if ($left == $right) {
|
||
_assertion-error $left_start $right_end $"They both are ($left)" $message
|
||
}
|
||
}
|
||
|
||
# ```nushell
|
||
# >_ let branches = {
|
||
# ))) 1: { print "this is the 1st branch"}
|
||
# ))) 2: { print "this is the 2nd branch" }
|
||
# ))) 3: { print "this is the 3rd branch" }
|
||
# ))) 4: { print "this is the 4th branch" }
|
||
# ))) }
|
||
#
|
||
# >_ match 1 $branches
|
||
# ))) match 2 $branches
|
||
# ))) match 3 $branches
|
||
# ))) match 4 $branches
|
||
# ))) match 5 $branches
|
||
# this is the 1st branch
|
||
# this is the 2nd branch
|
||
# this is the 3rd branch
|
||
# this is the 4th branch
|
||
#
|
||
# >_ match 1 $branches { "this is the default branch" }
|
||
# ))) match 2 $branches { "this is the default branch" }
|
||
# ))) match 3 $branches { "this is the default branch" }
|
||
# ))) match 4 $branches { "this is the default branch" }
|
||
# ))) match 5 $branches { "this is the default branch" }
|
||
# this is the 1st branch
|
||
# this is the 2nd branch
|
||
# this is the 3rd branch
|
||
# this is the 4th branch
|
||
# this is the default branch
|
||
# ```
|
||
export def match [
|
||
input:string
|
||
matchers:record
|
||
default?: block
|
||
] {
|
||
if (($matchers | get -i $input) != null) {
|
||
$matchers | get $input | do $in
|
||
} else if ($default != null) {
|
||
do $default
|
||
}
|
||
}
|
||
|
||
# Add the given paths to the PATH.
|
||
#
|
||
# # Example
|
||
# - adding some dummy paths to an empty PATH
|
||
# ```nushell
|
||
# >_ with-env [PATH []] {
|
||
# std path add "foo"
|
||
# std path add "bar" "baz"
|
||
# std path add "fooo" --append
|
||
#
|
||
# assert eq $env.PATH ["bar" "baz" "foo" "fooo"]
|
||
#
|
||
# print (std path add "returned" --ret)
|
||
# }
|
||
# ╭───┬──────────╮
|
||
# │ 0 │ returned │
|
||
# │ 1 │ bar │
|
||
# │ 2 │ baz │
|
||
# │ 3 │ foo │
|
||
# │ 4 │ fooo │
|
||
# ╰───┴──────────╯
|
||
# ```
|
||
export def-env "path add" [
|
||
--ret (-r) # return $env.PATH, useful in pipelines to avoid scoping.
|
||
--append (-a) # append to $env.PATH instead of prepending to.
|
||
...paths # the paths to add to $env.PATH.
|
||
] {
|
||
let-env PATH = (
|
||
$env.PATH
|
||
| if $append { append $paths }
|
||
else { prepend $paths }
|
||
)
|
||
|
||
if $ret {
|
||
$env.PATH
|
||
}
|
||
}
|
||
|
||
# Maintain a list of working directories and navigates them
|
||
|
||
# the directory stack
|
||
export-env {
|
||
let-env DIRS_POSITION = 0
|
||
let-env DIRS_LIST = [($env.PWD | path expand)]
|
||
}
|
||
|
||
# Add one or more directories to the list.
|
||
# PWD becomes first of the newly added directories.
|
||
export def-env "dirs add" [
|
||
...paths: string # directory or directories to add to working list
|
||
] {
|
||
mut abspaths = []
|
||
for p in $paths {
|
||
let exp = ($p | path expand)
|
||
if ($exp | path type) != 'dir' {
|
||
let span = (metadata $p).span
|
||
error make {msg: "not a directory", label: {text: "not a directory", start: $span.start, end: $span.end } }
|
||
}
|
||
$abspaths = ($abspaths | append $exp)
|
||
|
||
}
|
||
let-env DIRS_LIST = ($env.DIRS_LIST | insert ($env.DIRS_POSITION + 1) $abspaths | flatten)
|
||
let-env DIRS_POSITION = $env.DIRS_POSITION + 1
|
||
|
||
_fetch 0
|
||
}
|
||
|
||
# Advance to the next directory in the list or wrap to beginning.
|
||
export def-env "dirs next" [
|
||
N:int = 1 # number of positions to move.
|
||
] {
|
||
_fetch $N
|
||
}
|
||
|
||
# Back up to the previous directory or wrap to the end.
|
||
export def-env "dirs prev" [
|
||
N:int = 1 # number of positions to move.
|
||
] {
|
||
_fetch (-1 * $N)
|
||
}
|
||
|
||
# Drop the current directory from the list, if it's not the only one.
|
||
# PWD becomes the next working directory
|
||
export def-env "dirs drop" [] {
|
||
if ($env.DIRS_LIST | length) > 1 {
|
||
let-env DIRS_LIST = (
|
||
($env.DIRS_LIST | take $env.DIRS_POSITION)
|
||
| append ($env.DIRS_LIST | skip ($env.DIRS_POSITION + 1))
|
||
)
|
||
}
|
||
|
||
_fetch 0
|
||
}
|
||
|
||
# Display current working directories.
|
||
export def-env "dirs show" [] {
|
||
mut out = []
|
||
for $p in ($env.DIRS_LIST | enumerate) {
|
||
$out = ($out | append [
|
||
[active, path];
|
||
[($p.index == $env.DIRS_POSITION), $p.item]
|
||
])
|
||
}
|
||
|
||
$out
|
||
}
|
||
|
||
# fetch item helper
|
||
def-env _fetch [
|
||
offset: int, # signed change to position
|
||
] {
|
||
# nushell 'mod' operator is really 'remainder', can return negative values.
|
||
# see: https://stackoverflow.com/questions/13683563/whats-the-difference-between-mod-and-remainder
|
||
let pos = ($env.DIRS_POSITION
|
||
+ $offset
|
||
+ ($env.DIRS_LIST | length)
|
||
) mod ($env.DIRS_LIST | length)
|
||
let-env DIRS_POSITION = $pos
|
||
|
||
cd ($env.DIRS_LIST | get $pos )
|
||
}
|