Cliquers

Manage filesequences with a common numeric component in Rust.

Usage

Using the commandline

```bash $ cliquers --help cliquers 0.2.0

USAGE: cliquers [FLAGS] [OPTIONS] [--] [paths]...

FLAGS: -h, --help Prints help information -r, --recurse Recurse down subdirectories -s, --show-remainder Print files not in a collection -V, --version Prints version information

OPTIONS: -f, --format Optional format of filesequences, default format: "{head}{padding}{tail} [{ranges}]" -p, --patterns ... Optional custom pattern for grouping collections of files, default pattern: "(?P(?P0*)\d+)"

ARGS: ... The path to list files and filesequences under bash $ cliquers /shot/task/main /shot/task/main/render.%04d.exr [1001-1005]

$ cliquers -r /shot/task /shot/task/main/render.%04d.exr [1001-1005] /shot/task/foo/render.%04d.exr [1001-1005] /shot/task/bar/render.%04d.exr [1001-1005]

$ cliquers --format "{head}####{tail}" /shot/task/main /shot/task/main/render.####.exr

$ cliquers --patterns "v(?P(?P0*)\d+)" /shot/task/main /shot/task/main/render.1001.exr /shot/task/main/render.1002.exr /shot/task/main/render.1003.exr /shot/task/main/render.1004.exr /shot/task/main/render.1005.exr

$ cliquers --patterns "(?P(?P0*)\d+)" /shot/task/main /shot/task/main/render.%04d.exr [1001-1005] ```

Using the library

```rust use cliquers;

let files = vec![ "/shot/task/main/render.1001.exr", "/shot/task/main/render.1002.exr", "/shot/task/main/render.1003.exr", "/shot/task/main/render.1004.exr", "/shot/task/main/render.1005.exr", ]; let (collections, remainders) = cliquers.assemble(&files, None); let c = &collections[0];

// access structure of file sequence asserteq!(c.head, "/shot/task/main/render."); asserteq!(c.tail, ".exr"); asserteq!(c.padding, 4); asserteq!(c.indexes, vec![1001, 1002, 1003, 1004, 1005]); asserteq!(c.format(None), "/shot/task/main/render.%04d.exr [1001-1005]"); asserteq!(c.format(Some("{head}####{tail}")), "/shot/task/main/render.####.exr");

// iterate over files of filesequence let mut iter = c.intoiter(); asserteq!(iter.next(), Some("/shot/task/main/render.1001.exr".to_string())); ```

Documentation

Origin

This library is a direct port of the fantastic Python module Clique.

This is still a work in progress, so is not a complete port... yet!