irename 0.1.3

interactive file renaming tool
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
67
68
69
70
71
72
73
74

# irename

[![Crate](https://img.shields.io/crates/v/irename.svg)](https://crates.io/crates/irename)
[![API](https://docs.rs/irename/badge.svg)](https://docs.rs/irename)


Interactive rename tool

[![demo](https://asciinema.org/a/3q2rKc6Z5WzmfHHuRVleA4AeG.svg)](https://asciinema.org/a/3q2rKc6Z5WzmfHHuRVleA4AeG)

## Installation

```shell
cargo install irename
```

## Usage

### Examples

Rename a bunch of files
```
# run renamer on all .txt files in some/dir
irename some/dir/*.txt
```

Execute in `dry-run` mode
```
# run renamer on all .txt files in some/dir and only print generated commands w/o actual renaming
irename --dry-run some/dir/*.txt
```

Output of `dry-run` mode can be piped
```
# generate rename commands and execute them by yourself
irename --dry-run some/dir/*.txt | parallel -n1
```

**P.S.: The app will exit with an error if there are some conflicting names.
It won't destruct your files as `GNU rename` does**

### Cli help output
```
irename 0.1.0

USAGE:
    irename [OPTIONS] <FILES>...

ARGS:
    <FILES>...

OPTIONS:
        --dry-run          only print shell commands w/o executing them
    -h, --help             Print help information
        --regex <REGEX>    Initial replacement regex
    -V, --version          Print version information
```


### Shortcuts

- `Tab` - switch between `regex` and `replacement` text input areas
- `Enter` - execute renaming
- `Ctrl-c` - exit


## TODO

- [ ] Read input files paths from stdin if no positional args are supplied
- [ ] Files list scrolling with `Ctrl-d/Ctrl-u`
- [ ] Highlight for conflicting names
- [ ] Help side-pane
- [ ] Full-path mode switch for editing the whole path instead of just filename
- [ ] Docs