#directory #random #file #command-line-tool #generate

bin+lib randselect

Tool for randomly selecting files from a directory

9 releases

0.3.1 Jul 3, 2023
0.3.0 Dec 21, 2020
0.2.4 Jan 8, 2019
0.2.3 Dec 6, 2018
0.1.1 Nov 25, 2018

#2407 in Command line utilities

BlueOak-1.0.0

15KB
138 lines

randselect

Crates.io GitHub Workflow Status (with event) Crates.io

This crate provides a simple command line utility for randomly selecting N files from a directory and copying or moving them to a target directory.

randselect operates (inefficiently) by generating a random permutation of the files in a given directory, then moving or copying the first N files in the resulting permutation to a target directory.

Could you do this with a few lines of bash? Almost certainly! This was just an excuse to write some Rust.

Install

You can install this with Cargo:

$ cargo install randselect

Usage

randselect
Tool for randomly selecting files from a directory.

USAGE:
    randselect [OPTIONS] <IN_DIR> <OUT_DIR>

ARGS:
    <IN_DIR>     The input directory to select from
    <OUT_DIR>    The directory to output to. Will be created if it doesn't exist

OPTIONS:
    -g, --go                       Execute the copy or move. Specify a seed for deterministic
                                   behavior
    -h, --help                     Print help information
    -m, --move-files               Whether to move the files from IN_DIR to OUT_DIR, rather than cp
    -n, --num-files <NUM_FILES>    The number of files to select [default: 1]
    -s, --seed <SEED>              The seed to use for the PRNG (u64)
    -V, --version                  Print version information

Dependencies

~10–22MB
~288K SLoC