skip to navigation
skip to content

Not Logged In

reFILE 0.2

Utility for manipulating files via regex.

Latest Version: 0.3.3

List, rename and delete files using Python-style regex.

THIS PROGRAM IS STILL IN THE ALPHA TESTING STAGE SO PLEASE ENSURE THAT YOU KEEP REGULAR BACKUPS AND DO NOT USE IT ON ANY IMPORTANT DOCUMENTS OR FILES

Installation

reFILE should be available on the PyPI repository so installing should be as simple as:

$ pip install reFILE

Alternatively you can clone the github repository and use setuptools, like so:

$ git clone https://github.com/Sean1708/reFILE.git
$ python setup.py install

reFILE uses the pathlib module which only has tentative support for Python 2. For this reason, it is reccomended that you use Python 3 to download reFILE. Having said this, however, reFILE should still work on Python 2 installations.

Documentation

The refile command line utility performs three useful tasks on a directory of files; listing files which match a regular expression, renaming files which matche a regular expression and deleting files which match a regular expression.

Usage:

$ refile -h
$ refile [-rqvdli] ls [-h] PATTERN [DIR]
$ refile [-rqvdli] mv [-h] PATTERN REPLACE [DIR]
$ refile [-rqvdli] rm [-h] PATTERN [DIR]

General Usage

To avoid issues with variable expansion and special characters on the command line it is advisable to enclose the regular expression in single quotes:

$ refile ls '.*'

without the quotes this would cause a list of all files whose name starts with a period to be passed to refile which would, unsurprisingly, lead to unexpected behaviour.

If no directory is specified, the current directory is searched. A directory can be specified as an absolute path or a relative one, if an absolute path is used then filenames will be printed as an absolute path and similarly for relative paths. Tilde expansion is performed at the command line but not within the program so wrapping your directory in single quotes is ill-advised.

Options

reFILE uses the idea of global and local options. Global options are available for all subcommands and must be place before the subcommand whereas local options are specific to a subcommand and must be placed after the subcommand. Most options are global, they are:

-h, --help print a useful help message
-r, --recurse search directories recursively
-q, --quiet supress all output except errors
-v, --verbose print extra information
-d, --directories
 rename and delete (if empty) directories
-l, --limit maximum depth limit when searching recursively
-i, --ignore ignore any files which match this regex

The only local options are for help on a specific command.

Listing Files

Usage:

$ refile [-rqvdli] ls PATTERN [DIR]

The ls subcommand lists all files in the directory DIR which match the regular expression PATTERN. Internally this is run using the re.search function so the pattern can match any part of the filename, not just the start.

Options

-h, --help print a useful help message

Renaming Files

Usage:

$ refile [-rqvdli] mv PATTERN REPLACE [DIR]

The mv subcommand renames any file in the directory DIR which matches the regular expression PATTERN to the name RENAME. This is run internally using the re.sub function.

If PATTERN matches more than once in the filename then each match will be replaced by the string REPLACE providing the matches don’t overlap. If the regular expression matches the entire filename then PATTERN and REPLACE must contain groups and backreferences to avoid files overwriting eachother. This is not checked at run-time so it is up to the user to ensure proper usage.

Options

-h, --help print a useful help message

Deleting Files

Usage:

$ refile [-rqvdli] rm PATTERN [DIR]

The rm subcommand deletes all files in the directory DIR which match regular expression PATTERN. The search is performed identically to the ls subcommand so a good way to ensure that you are deleting the correct files is to run the command as ls first.

Options

-h, --help print a useful help message
 
File Type Py Version Uploaded on Size
reFILE-0.2-py2.py3-none-any.whl (md5) Python Wheel py2.py3 2014-05-09 10KB
reFILE-0.2.tar.gz (md5) Source 2014-05-09 18KB
  • Downloads (All Versions):
  • 1 downloads in the last day
  • 157 downloads in the last week
  • 914 downloads in the last month