nushell/crates
Doru 3d65fd7cc4
Expose filtering by file type in glob (#7834)
# Description

Add flags for filtering the output of `glob` by file type. I find myself
occasionally wanting to do this, and getting a file's
[file_type](https://docs.rs/wax/latest/wax/struct.WalkEntry.html#method.file_type)
is presumably fast to do as it doesn't have to go through the fallible
metadata method.

The design of the signature does concern me; it's not as readable as a
filter or "include" type list would be. They have to be filtered one by
one, which can be annoying if you only want files `-D -S`, or only want
folders `-F -S`, or only want symlinks `--butwhy?`. I considered
SyntaxShape::Keyword for this but I'll just defer to comments on this PR
if they pop up.

I'd also like to bring up performance since including these flags
technically incurs a `.filter` penalty on all glob calls, which could be
optimized out if we added a branch for the no-filters case. But in
reality I'd expect the file system to be the bottleneck and the flags to
be pretty branch predictor friendly, so eh

# User-Facing Changes
Three new flags when using `glob` and a slightly more cluttered help
page. No breaking changes, I hope.

# Tests + Formatting

Don't forget to add tests that cover your changes.

Make sure you've run and fixed any issues with these commands:

- `cargo fmt --all -- --check` to check standard code formatting (`cargo
fmt --all` applies these changes)
- `cargo clippy --workspace -- -D warnings -D clippy::unwrap_used -A
clippy::needless_collect` to check that you're using the standard code
style
- `cargo test --workspace` to check that all tests pass

# After Submitting

If your PR had any user-facing changes, update [the
documentation](https://github.com/nushell/nushell.github.io) after the
PR is merged, if necessary. This will help us keep the docs up to date.
2023-01-28 07:50:12 -06:00
..
nu_plugin_custom_values Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu_plugin_example Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu_plugin_gstat Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu_plugin_inc Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu_plugin_python Fix typos by codespell (#7600) 2022-12-26 02:31:26 -05:00
nu_plugin_query Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu-cli Add 'number' command for enumeration (#7871) 2023-01-28 06:45:57 +13:00
nu-color-config Add 'number' command for enumeration (#7871) 2023-01-28 06:45:57 +13:00
nu-command Expose filtering by file type in glob (#7834) 2023-01-28 07:50:12 -06:00
nu-engine Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-explore with the release of rust 1.67, let's bump to 1.66.1 (#7866) 2023-01-26 15:31:17 -06:00
nu-glob Fix typos and use more idiomatic assertions (#7755) 2023-01-15 15:03:32 +13:00
nu-json Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-parser Add 'number' command for enumeration (#7871) 2023-01-28 06:45:57 +13:00
nu-path Fix typos and use more idiomatic assertions (#7755) 2023-01-15 15:03:32 +13:00
nu-plugin LazyRecord (#7619) 2023-01-18 19:27:26 -08:00
nu-pretty-hex Reduce again the number of match calls (#7815) 2023-01-24 12:23:42 +01:00
nu-protocol Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-system Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-table Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-term-grid Bump to 0.74.1 development version (#7721) 2023-01-11 22:30:41 +01:00
nu-test-support Remove 🆖 comments (#7877) 2023-01-27 08:48:31 -05:00
nu-utils add some startup performance metrics (#7851) 2023-01-24 14:28:59 -06:00
README.md Remove old nushell/merge engine-q 2022-02-07 14:54:06 -05:00

Nushell core libraries and plugins

These sub-crates form both the foundation for Nu and a set of plugins which extend Nu with additional functionality.

Foundational libraries are split into two kinds of crates:

  • Core crates - those crates that work together to build the Nushell language engine
  • Support crates - a set of crates that support the engine with additional features like JSON support, ANSI support, and more.

Plugins are likewise also split into two types:

  • Core plugins - plugins that provide part of the default experience of Nu, including access to the system properties, processes, and web-connectivity features.
  • Extra plugins - these plugins run a wide range of different capabilities like working with different file types, charting, viewing binary data, and more.