extern/nushell
1
0
Fork 1
mirror of https://github.com/nushell/nushell.git synced 2025-03-22 11:37:10 +01:00
Code Issues Packages Projects Releases Wiki Activity
main
nushell/devdocs
History
Loïc Riegel 2ea2a904e8
Math commands can work with bounded ranges and produce list of numbers (#15319) 
No associated issue, but follows up #15135. See also discussion on
[discord](https://discord.com/channels/601130461678272522/1349139634281513093/1349139639356624966)
with @sholderbach

# Description

### Math commands `range -> list<number>`

This enables the following math commands:
- abs
- ceil
- floor
- log
- round

to work with ranges. When a range is given, the command will apply the
command on each item of the range, thus producing a list of number as
output.

Example

![image](https://github.com/user-attachments/assets/cff12724-5b26-4dbb-a979-a91c1b5652fc)

The commands still do not work work with unbounded ranges:


![image](https://github.com/user-attachments/assets/40c766a8-763f-461d-971b-2d58d11fc3a6)

And I left out the "mode" command because I think it does not make sense
to use it on ranges...

### Math commands `range -> number`

This was the topic of my previous PR, but for whatever reason I didn't
do `math variance` and `math stddev`.
I had to use `input.try_expand_range` to convert the range into a list
before computing the variance/stddev.


![image](https://github.com/user-attachments/assets/803954e7-1c2a-4c86-8b16-e16518131138)

And same, does not work in infinite ranges:


![image](https://github.com/user-attachments/assets/8bfaae2b-34cc-453d-8764-e42c815d28d3)

### Also done:
- find link in documentation

# User-Facing Changes
- Command signatures changes
- ability to use some commands with unbounded ranges
- ability to use variance and stddev with bounded ranges

# Tests + Formatting
Cargo fmt and clippy OK
Tests OK

# After Submitting
I guess nothing, or maybe release notes?
2025-03-20 17:35:50 +01:00
..
FAQ.md Curate developer documentation in tree (#11052) 2023-11-21 18:12:00 +01:00
HOWTOS.md Add SOPs for dealing with adding deps/crates (#12771) 2024-05-06 22:14:00 +02:00
PLATFORM_SUPPORT.md Remove dataframes crate and feature (#12889) 2024-05-20 17:22:08 +00:00
README.md Math commands can work with bounded ranges and produce list of numbers (#15319) 2025-03-20 17:35:50 +01:00
rust_style.md Curate developer documentation in tree (#11052) 2023-11-21 18:12:00 +01:00

README.md

Basic developer documentation

This is intended to give some immediate guidance to how to navigate the codebase and lives from everyone updating it if you make a design change.

A complementary (currently stale) resource has been the Nushell contributor book, which until further notice contains broader design guidance.

Contents