Metadata-Version: 2.4
Name: benamer
Version: 0.3.0
Summary: A cross-platform bulk file renamer.
Author-email: "Baltasar (dev::baltasarq)" <baltasarq@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/baltasarq/benamer
Project-URL: Bug Tracker, https://github.com/baltasarq/benamer/issues
Project-URL: Documentation, https://github.com/baltasarq/benamer/blob/main/README.md
Project-URL: Repository, https://github.com/baltasarq/benamer
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Filesystems
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# benamer
Bulk renamer with intuitive (no regex) options.

## Getting Started

In order to run this software, you need Python, it does not matter what version (provided it is updated enough), **benamer** will only run in Python 3, though.


## Installation

You can use pip in order to retrieve the package from PyPI: `pip install benamer`.

Then, you can directly invoke it as `benamer [args...]`, or as `python -m benamer [args...]`, depending on your installation of Python.

## Usage

`benamer.py [-h] [-d DIR] [-as RPREFX] [-ac START] [-rs RSUFX] [-ap RPREFX] [-rp RPREFX] [-fe FILTER_EXT] [-fp FILTER_PREFIX] [-fs FILTER_SUFFIX] [-st SUST] [-e EXT] [-rsp] [-s] [-p] [-jd] [-jf] [-u] [-l] [-v]`

Use `benamer -h` to get a complete list of available options. The availabe operations at the time of writing are:

```
-    -h, --help show this help message and exit
-    -d DIR, --dir DIR set the directory to work with
-    -as RPREFX, --add-suffix RPREFX add suffix to name
-    -ac START, --add-count START add count suffix to name
-    -rs RSUFX, --remove-suffix RSUFX remove suffix in name
-    -ap RPREFX, --add-prefix RPREFX add prefix to name
-    -rp RPREFX, --remove-prefix RPREFX remove prefix in name
-    -fe FILTER_EXT, --filter_by_ext FILTER_EXT filter by extension
-    -fp FILTER_PREFIX, --filter_by_prefix FILTER_PREFIX filter by prefix
-    -fs FILTER_SUFFIX, --filter_by_suffix FILTER_SUFFIX filter by suffix
-    -st SUST, --sust SUST substitute string
-    -e EXT, --ext EXT substitute extension
-    -rsp, --replace-spaces replace spaces in files with underscores
-    -s, --sort sort files before renaming
-    -p, --print do nothing, just show renamings
-    -jd, --directories rename only directories
-    -jf, --files rename only files
-    -u, --upper uppercase file names
-    -l, --lower lowercase file names
-    -v, --verbose describe what I am doing
````

## Examples

### Adding a prefix

The following command will show the effects of adding a prefix to all files in the current directory. Nothing will be actually changed, due to the use of the `-p` option.

    benamer -p -ap file_

    benamer --print --add-prefix file_

### Adding a prefix

 The following command will add a prefix to all files in the current directory.

    benamer -ap file_

    benamer --add-prefix file_
    
### Adding a count suffix

The following command will add a suffix with a count to all files in the sub subdirectory.

    benamer -ac 1 -d sub

    benamer --add-count 1 --directory sub
    
### Replacing a part of the name

The following command will replace all "er" with "ar" in all files of the current directory.

    benamer -st er/ar

    benamer --sust er/ar
    
### Replacing the whole file name

The following command will replace the whole file name with "f" and a number, in all files of the current directory. The original order will be respected.

    benamer -s -ac 1 -st /f

    benamer --sort --add-count 1 --sust /f

### Remove a part of the file name

The following command will remove the "er" part of the file name in all files of the current directory.

    benamer -st er/

    benamer --sust er/
