xtend

Description

xtend is a simple tool to help add or remove file extensions.

I started this tool because I needed to change the file extension for certain files, so that another tool stops detecting them when I needed to test something and restore the old extension when I'm done.

This is relatively simple for single files, but if you need many of them it gets a bit more tricky. There are plain unix ways to do it, but those are hard to remember and more error prone.

With this tool I can just do something like this:

# assuming there exists a file named 'test.txt'
xtend toggle bak test.txt

and if the file is named test.txt it will get renamed to test.txt.bak, if it's named test.txt.bak instead, it will get renamed to test.txt.

Install

From binary release: https://github.com/hardliner66/xtend/releases/latest

With cargo:

cargo install xtend

Usage:

xtend --help

xtend
command line helper to work with file extensions

USAGE:
    xtend <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information

SUBCOMMANDS:
    add               Adds an extension to all found files
    help              Print this message or the help of the given subcommand(s)
    remove            Removes an extension from all found files
    set               Replaces the extension with the given one
    toggle            Adds an extension when it's missing or removes it when it's present
    toggle-between    Toggles between two extensions

xtend add --help

xtend-add 
Adds an extension to all found files

USAGE:
    xtend add [OPTIONS] <EXTENSION> <FILES>...

ARGS:
    <EXTENSION>    The extension to add to a file
    <FILES>...     List of files to change

OPTIONS:
    -f, --force    add extension even if the file already has the same extension
    -h, --help     Print help information

xtend set --help

xtend-set 
Replaces the extension with the given one

USAGE:
    xtend set <EXTENSION> <FILES>...

ARGS:
    <EXTENSION>    Extension to be toggled
    <FILES>...     List of files to change

OPTIONS:
    -h, --help    Print help information

xtend remove --help

xtend-remove 
Removes an extension from all found files

USAGE:
    xtend remove <EXTENSION> <FILES>...

ARGS:
    <EXTENSION>    The extension to be removed from a file. Removes any extension if not set
    <FILES>...     List of files to change

OPTIONS:
    -h, --help    Print help information

xtend toggle --help

xtend-toggle 
Adds an extension when it's missing or removes it when it's present

USAGE:
    xtend toggle <EXTENSION> <FILES>...

ARGS:
    <EXTENSION>    Extension to be toggled
    <FILES>...     List of files to change

OPTIONS:
    -h, --help    Print help information

xtend toggle-between --help

xtend-toggle-between 
Toggles between two extensions

USAGE:
    xtend toggle-between <EXTENSION1> <EXTENSION2> [FILES]...

ARGS:
    <EXTENSION1>    Extension 1
    <EXTENSION2>    Extension 2
    <FILES>...      List of files to change

OPTIONS:
    -h, --help    Print help information