# 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:
```sh
# 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:
```sh
cargo install xtend
```

## Usage:
### xtend --help
```sh
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
```sh
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
```sh
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
```sh
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
```sh
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
```sh
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
```