Skip to main content

Template-based renaming utility

Project description

[WIP] Tempren - template-based batch file renaming utility

Build Status codecov

This project is currently in a Work-In-Progress stage so if you are looking for working solution... keep looking.

TODO: Summary


  • Template-based filename/path generation
  • Configurable file selection
  • Metadata-based sorting


$ pip install [--user] poetry
$ poetry install

TODO: Usage

Note: When playing with tempren make sure to use --dry-run (-d) flag so that the actual files are not accidentally changed.

Tempren have two main modes of operation: name and path.

In the name mode, the template is used for filename generation only. This is useful if you want to operate on files specified on the command line or in a single directory.

With path mode, the template generates a whole path (relative to the input directory). This way you can sort files into dynamically generated catalogues.

Template syntax

Pipe list sugar

Name mode

Path mode


Glob filtering

Regex filtering

Template filtering

Case sensitiveness and filter inversion



Tests are written with a help of pytest. Just enter repository root and run:

$ pytest


Code conventions are enforced via pre-commit. It is listed in development depenencies so if you are able to run tests - you should have it installed too. To get started you will still need to install git hooks via:

$ pre-commit install

Now every time you invoke git commit a series of cleanup scripts will run and modify your patchset.

TODO: Tags development

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tempren-0.2.0.tar.gz (36.2 kB view hashes)

Uploaded Source

Built Distribution

tempren-0.2.0-py3-none-any.whl (42.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page