pmv 0.4.0

Pattern based mv(1)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# pmv

[![Build Status](https://img.shields.io/github/workflow/status/sgryjp/pmv/Build)](https://github.com/sgryjp/pmv/actions?query=workflow%3ABuild)
[![Latest version](https://img.shields.io/crates/v/pmv.svg)](https://crates.io/crates/pmv)
![GitHub](https://img.shields.io/github/license/sgryjp/pmv)

A command line tool to move multiple files at once, using wildcard patterns.

# Features

- Accepts wildcard patterns for selecting files to move
- Colorized terminal output
- Runs on Windows and Linux (may run on macOS too?)

# Usage

```text
USAGE:
    pmv.exe [FLAGS] <SOURCE> <DEST>

FLAGS:
    -n, --dry-run
            Do not actually move the files, just show what would be done.

    -h, --help
            Prints help information

    -V, --version
            Prints version information

    -v, --verbose
            Write verbose message.


ARGS:
    <SOURCE>
            A pattern string specifying files to move. If the pattern contains wildcard(s), multiple files
            matching to the pattern will be targeted. Supported wildcards are:

                ? ... Matches a single character
                * ... Matches zero or more characters
    <DEST>
            A pattern string specifying where to move the targeted files. If the pattern contains tokens like
            `#1` or `#2`, each of them will be replaced with a substring extracted from the targeted file path.
            Those substrings matches the wildcard patterns in SOURCE; `#1` matches the first wildcard, `#2`
            matches the second wildcard, respectively. For example, if SOURCE is `*_test.py` and DEST is
            `tests/test_#1.py`:

                Exisitng File | Destination
                ------------- | -----------------
                foo_test.py   | tests/test_foo.py
                bar_test.py   | tests/test_bar.py
                hoge_test.py  | tests/test_hoge.py
```

# Installation

## Cargo

    $ cargo install pmv

Rust 1.36.0 or newer is required to build `pmv`.

# References

- [mmv](https://ss64.com/bash/mmv.html)