rnr

RnR adalah alat baris perintah untuk mengganti nama banyak file dan direktori yang mendukung ekspresi reguler dengan aman .

Fitur

• Batch mengganti nama file dan direktori.
• Pemeriksaan otomatis untuk menghindari tabrakan, penghapusan, atau penimpaan file yang tidak diinginkan.
• Gunakan regexp, termasuk grup penangkapan.
• Sertakan direktori secara rekursif.
• Buat file cadangan.
• Membuat dan membaca operasi dari file dump.
• Membatalkan operasi dari file dump.
• Kecualikan/sertakan file tersembunyi.
• Dukungan Linux, Mac dan Windows, termasuk pewarnaan terminal.
• Pengujian unit yang ekstensif.
• Pilih batas penggantian.
• Ubah nama file UTF-8 menjadi representasi ASCII.

Memasang

Biner

Rilis GitHub

Anda dapat mengunduh binari dari halaman rilis terbaru, pilih file terkompresi yang sesuai dengan platform Anda. File terkompresi ini berisi konten tambahan yang dapat dieksekusi dan lainnya seperti file penyelesaian ( Bash , Zsh , fish , dan PowerShell ).

Lengkungan Linux

Sebuah paket tersedia di AUR ( rnr ) untuk menginstal RnR versi terbaru di Arch Linux.

minuman rumahan

Anda dapat menggunakan manajer paket Homebrew untuk menginstal alat ini di sistem macOS atau Linux.

brew install rnr

Dari Sumber

RnR ditulis dalam Rust. Anda dapat membangunnya dari sumber menggunakan Cargo.

Dari repositori git

git clone https://github.com/ismaelgv/rnr .
cargo install

Dari Crates.io

cargo install rnr

Penggunaan

Pilihan

 USAGE:
    rnr [FLAGS] [OPTIONS] <EXPRESSION> <REPLACEMENT> <PATH(S)>...
    rnr [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
    -b, --backup          Generate file backups before renaming
    -n, --dry-run         Only show what would be done (default mode)
        --dump            Force dumping operations into a file even in dry-run mode
    -f, --force           Make actual changes to files
    -h, --help            Prints help information
    -x, --hidden          Include hidden files and directories
    -D, --include-dirs    Rename matching directories
        --no-dump         Do not dump operations into a file
    -r, --recursive       Recursive mode
    -s, --silent          Do not print any information
    -V, --version         Prints version information

OPTIONS:
        --color <color>            Set color output mode [default: auto]  [possible values: always, auto, never]
    -d, --max-depth <LEVEL>        Set max depth in recursive mode
    -l, --replace-limit <LIMIT>    Limit of replacements, all matches if set to 0 [default: 1]

ARGS:
    <EXPRESSION>     Expression to match (can be a regex)
    <REPLACEMENT>    Expression replacement
    <PATH(S)>...     Target paths

SUBCOMMANDS:
    from-file    Read operations from a dump file
    help         Prints this message or the help of the given subcommand(s)
    to-ascii     Replace all file name chars with ASCII chars. This operation is extremely lossy.

Perilaku bawaan

• Memeriksa semua operasi untuk menghindari penimpaan file yang ada.
• Jalankan kering secara default.
• Hanya argumen masukan dan nama file UTF-8 yang valid .
• Bekerja pada file dan symlink (mengabaikan direktori).
• Menerima banyak file sebagai argumen.
• Menerima regex untuk menghasilkan kecocokan. Ekspresi ini memiliki batasan yang sama pada regex crate. Anda dapat memeriksa sintaks regex di sini. Ini mendukung grup penangkapan yang diberi nomor dan diberi nama.
• Jika kedalaman maksimum tidak disediakan untuk mode rekursif, maka diasumsikan tak terbatas .
• Tidak menghasilkan cadangan.
• Output berwarna (hanya terminal ANSI).
• Abaikan file dan direktori tersembunyi.
• Buang semua operasi ke dalam file dalam mode paksa. File dump ini dapat digunakan untuk membatalkan operasi ini dari subperintah from-file .
• Jumlah penggantian disetel ke satu.

Contoh

• Ganti nama daftar file
  • Sertakan direktori
  • Banyak penggantian
  • Kombinasi dengan alat UNIX lainnya
• Penggantian nama secara rekursif
  • Ganti nama secara rekursif dengan kedalaman direktori maksimal
  • Penggantian nama secara rekursif termasuk direktori dan file tersembunyi
• Membatalkan/mengulang operasi menggunakan file dump
• Buat file cadangan sebelum mengganti nama
• Ubah nama file UTF-8 menjadi ASCII
• Contoh regex tingkat lanjut
  • Ganti ekstensi
  • Ganti nomor
  • Tangkap kelompok
  • Tangkap beberapa grup bernama dan tukar mereka

WINDOWS CATATAN: Dalam contoh yang menggunakan * , Anda perlu memperluas wildcard di PowerShell, misalnya: rnr ab (Get-Item ./*) . Ini tidak didukung di cmd.exe .

Ganti nama daftar file

Anda dapat meneruskan daftar file yang akan diganti namanya sebagai argumen:

rnr -f file renamed ./file-01.txt ./one/file-02.txt ./one/file-03.txt

Pohon asli

 .
├── file-01.txt
├── file-02.txt
├── file-03.txt
└── one
    ├── file-01.txt
    ├── file-02.txt
    └── file-03.txt

Berganti nama menjadi pohon

 .
├── renamed-01.txt
├── file-02.txt
├── file-03.txt
└── one
    ├── file-01.txt
    ├── renamed-02.txt
    └── renamed-03.txt

Sertakan direktori

Direktori diabaikan secara default tetapi Anda juga dapat memasukkannya untuk diganti namanya menggunakan opsi -D .

rnr -f -D foo bar ./ *

Pohon asli

 .
├── foo
│   └── foo.txt
└── foo.txt

Berganti nama menjadi pohon

 .
├── bar
│   └── foo.txt
└── bar.txt

Banyak penggantian

Batas penggantian diatur ke 1 secara default, namun Anda dapat mengonfigurasi batas ini untuk mengganti beberapa kecocokan yang tidak tumpang tindih. Semua kecocokan akan diganti jika opsi ini disetel ke 0.

rnr -f -l 0 o u ./ *

Pohon asli

 .
├── foo.txt
├── foofoo.txt
├── foofoofoo.txt
└── foofoofoofoo.txt

Berganti nama menjadi pohon

 .
├── fuu.txt
├── fuufuu.txt
├── fuufuufuu.txt
└── fuufuufuufuu.txt

Kombinasi dengan alat UNIX lainnya

Anda dapat menggabungkan rnr dengan alat UNIX lainnya menggunakan pipa untuk menyampaikan argumen.

Temukan file yang lebih lama dari 1 hari dan ganti namanya

find . -type f +mtime 1 | xargs rnr -f file renamed

Baca daftar file dari suatu file

cat file_list.txt | xargs rnr -f file rename

konten file_list.txt :

 file-01.txt
one/file-02.txt
one/file-03.txt

Penggantian nama secara rekursif

Jika opsi rekursif ( -r ) dilewatkan, rnr akan mencari semua file di jalur secara rekursif tanpa batas kedalaman.

rnr -f -r file renamed ./

Pohon asli

 .
├── file-01.txt
├── file-02.txt
├── file-03.txt
└── one
    ├── file-01.txt
    ├── file-02.txt
    ├── file-03.txt
    └── two
        ├── file-01.txt
        ├── file-02.txt
        ├── file-03.txt
        └── three
            ├── file-01.txt
            ├── file-02.txt
            └── file-03.txt

Berganti nama menjadi pohon

 .
├── renamed-01.txt
├── renamed-02.txt
├── renamed-03.txt
└── one
    ├── renamed-01.txt
    ├── renamed-02.txt
    ├── renamed-03.txt
    └── two
        ├── renamed-01.txt
        ├── renamed-02.txt
        ├── renamed-03.txt
        └── three
            ├── renamed-01.txt
            ├── renamed-02.txt
            └── renamed-03.txt

Ganti nama secara rekursif dengan kedalaman direktori maksimal

Demikian pula, Anda dapat mengatur kedalaman direktori maksimum yang dikombinasikan dengan operasi rekursif.

rnr -f -r -d 2 file renamed ./

Pohon asli

 .
├── file-01.txt
├── file-02.txt
├── file-03.txt
└── one
    ├── file-01.txt
    ├── file-02.txt
    ├── file-03.txt
    └── two
        ├── file-01.txt
        ├── file-02.txt
        ├── file-03.txt
        └── three
            ├── file-01.txt
            ├── file-02.txt
            └── file-03.txt

Berganti nama menjadi pohon

 .
├── renamed-01.txt
├── renamed-02.txt
├── renamed-03.txt
└── one
    ├── renamed-01.txt
    ├── renamed-02.txt
    ├── renamed-03.txt
    └── two
        ├── file-01.txt
        ├── file-02.txt
        ├── file-03.txt
        └── three
            ├── file-01.txt
            ├── file-02.txt
            └── file-03.txt

Penggantian nama secara rekursif termasuk direktori dan file tersembunyi

rnr abaikan file tersembunyi secara default untuk mempercepat operasi dan menghindari masalah dengan beberapa direktori tertentu seperti .git/ atau .local/ . Anda dapat memasukkan file tersembunyi melalui opsi -x . Selain itu, Anda juga dapat menggunakan opsi sertakan direktori -D dengan -r .

rnr -f -r -D -x foo bar ./

Pohon asli

 .
├── .foo_hidden_file.txt
├── foo.txt
├── foo
│   ├── foo.txt
│   └── foo
│       └── foo.txt
└── .foo_hidden_dir
    └── foo.txt

Berganti nama menjadi pohon

 .
├── .bar_hidden_file.txt
├── bar.txt
├── bar
│   ├── bar.txt
│   └── bar
│       └── bar.txt
└── .bar_hidden_dir
    └── bar.txt

Membatalkan/mengulang operasi menggunakan file dump

Saat Anda melakukan operasi penggantian nama, rnr secara default akan membuat file dump di direktori saat ini tempat Anda menjalankan perintah. File ini dapat digunakan untuk mengembalikan operasi dengan mudah menggunakan opsi from-file dan -u .

Ganti nama operasi

rnr -f foo bar ./ *

Membatalkan operasi sebelumnya

rnr from-file -f -u rnr-[timestamp].json

Jika Anda ingin mengulangi operasi, cukup berikan file dump tanpa argumen tambahan:

rnr from-file -f rnr-[timestamp].json

Buat file cadangan sebelum mengganti nama

rnr dapat membuat file cadangan sebelum mengganti nama operasi apa pun dengan meneruskan opsi -b . Nama file cadangan dipastikan unik dan tidak akan ditimpa jika cadangan lain dibuat. Jika Anda bekerja dengan banyak file besar, pertimbangkan bahwa file tersebut akan diduplikasi.

rnr -f -b file renamed ./ *

Pohon asli

 .
├── file-01.txt
├── file-02.txt
└── file-03.txt

Berganti nama menjadi pohon

 .
├── file-01.txt.bk
├── file-02.txt.bk
├── file-03.txt.bk
├── renamed-01.txt
├── renamed-02.txt
└── renamed-03.txt

Ubah nama file UTF-8 menjadi ASCII

rnr dapat mengonversi nama file UTF-8 menjadi representasi ASCII. Fitur ini menggunakan perpustakaan AnyAscii untuk melakukan transliterasi.

Anda dapat menjalankan:

rnr to-ascii ./ *

Atau:

rnr to-ascii -r .

Pohon asli

 .
├── fïlé-01.txt
├── FïĹÊ-02.txt
└── file-03.txt

Berganti nama menjadi pohon

 .
├── file-01.txt
├── FILE-02.txt
└── file-03.txt

Contoh regex tingkat lanjut

Info lebih lanjut tentang regex yang digunakan dalam paket regex .

Ganti ekstensi

 rnr -f '..*$' '.txt' ./*

Pohon asli

 .
├── file-01.ext1
├── file-02.ext2
└── file-03.ext3

Berganti nama menjadi pohon

 .
├── file-01.txt
├── file-02.txt
└── file-03.txt

Ganti nomor

 rnr -f 'd' '1' ./*

Pohon asli

 .
├── file-01.txt
├── file-02.txt
└── file-03.txt

Berganti nama menjadi pohon

 .
├── file-11.txt
├── file-12.txt
└── file-13.txt

Tangkap kelompok

1. Tangkap tiga grup yang tidak disebutkan namanya [ name(1)-number(2).extension(3) ].
2. Tukar grup 1 (nama) dan grup 2 (nomor).

rnr -f ' (w+)-(d+).(w+) ' ' ${2}-${1}.${3} ' ./ *

Pohon asli

 .
├── file-01.txt
├── file-02.txt
└── file-03.txt

Berganti nama menjadi pohon

 .
├── 01-file.txt
├── 02-file.txt
└── 03-file.txt

CATATAN SHELL: Di shell seperti Bash dan zsh, pastikan untuk membungkus pola REPLACEMENT dalam tanda kutip tunggal. Jika tidak, indeks grup tangkapan akan digantikan oleh variabel shell yang diperluas.

Tangkap beberapa grup bernama dan tukar mereka

1. Tangkap dua digit sebagai number .
2. Tangkap ekstensi sebagai ext .
3. Tukar grup.

rnr -f ' (?P<number>d{2}).(?P<ext>w{3}) ' ' ${ext}.${number} ' ./ *

Pohon asli

 .
├── file-01.txt
├── file-02.txt
└── file-03.txt

Berganti nama menjadi pohon

 .
├── file-txt.01
├── file-txt.02
└── file-txt.03