mvdate

A Python package to search for files and move them to a directory structure based on date.

For more detailed information on the topics below please visit the documentation.

Motivation

I keep my pictures in a hierarchical data structure of YYYY/MM/DD but that isn't how my camera stores and copying them to other devices in such a manner was tedious. I wanted an easy way to copy/move files to this structure.

Installation

mvdate is available from PyPI to install...

pip install mvdate

Usage

To search the current directory for files ending with png and move them to ~/pics/YYYY/MM/DD/

mvdate --base ./ --destination ~/pics/ --ext png

For all options see the help

mvdate --help

Development

If you wish to try the development version you can install directly using pip...

pip install mvdate@git+https://codeberg.org/slackline/mvdate.git@main

Contributing

If you want to contribute merge, requests are more than welcome. Fork and clone the repository and install the development and test dependencies.

mkvirtualenv mvdate # Or similar depending on your preferences
git clone ssh://git@codeberg.org/slackline/mvdate.git
cd mvdate
pip install .[dev,tests]
pre-commit install

I use various tools to lint and test the package, mostly via pre-commit. These include pre-commit-hooks, black, markdownlint-cli2 and ruff. By using pre-commit locally any contributions should then pass the GitLab CI pre-commit pipeline that is in place.

Links

• PyPI - mvdate