| Name | mvdate JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | |
| Summary | Move files to directories based on created date |
| upload_time | 2023-12-27 18:54:43 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | GNU Lesser GPLv3 only |
| keywords |
files
date
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://badge.fury.io/py/mvdate)
[](https://pre-commit.com)
[](https://github.com/psf/black)
[](https://github.com/psf/flake8)
[)](https://github.com/astral-sh/ruff)
[](https://pepy.tech/project/mvdate)
[](https://pepy.tech/project/mvdate)
[](https://pepy.tech/project/mvdate)
[](https://liberapay.com/slackline/donate)
# mvdate
A Python package to search for files and move them to a directory structure based on date.
## Motivation
I keep my pictures in a hierarchical data structure of `YYYY/MM/DD` but that isn't how my camera stores them. I wanted
an easy way to copy/move files to this structure.
## Installation
`mvdate` is available from [PyPI](https://pypi.org) to install...
```bash
pip install mvdate
```
### Development
If you wish to try the development version you can install directly using `pip`...
```bash
pip install mvdate@git+https://gitlab.com/nshephard/mvdate.git@main
```
Or if you are likely to want to tinker you can clone the repository and install (although you may wish to fork and clone
that if you want to contribute).
```bash
git clone git@gitlab.com:nshephard/mvdate.git
cd mvdate
pip install .
```
## Usage
To search the current directory for files ending with `png` and move them to `~/pics/YYYY/MM/DD/`
```bash
mvdate --base ./ --destination ~/pics/ --ext png
```
For all options see the help
```bash
mvdate --help
```
## Contributing
If you want to contribute merge requests are more than welcome. Fork and clone the repository and install the
development and test dependencies.
```bash
mkvirtualenv mvdate # Or similar depending on your preferences
git clone git@gitlab.com:nshephard/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](https://pre-commit.com). These include
[pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks), [black](https://github.com/psf/black),
[markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2) and [ruff](https://docs.astral.sh/ruff/). By using
`pre-commit` locally any contributions should then pass the GitLab CI pipelines I have in place.
## Links
Raw data
{
"_id": null,
"home_page": "",
"name": "mvdate",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "files,date",
"author": "",
"author_email": "Neil Shephard <nshephard@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/e8/c8/9292b75e70bd86dca922e4285ef090a56dff79f119094cda68c18e9b6bc5/mvdate-0.1.2.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/py/mvdate)\n\n[](https://pre-commit.com)\n[](https://github.com/psf/black)\n[](https://github.com/psf/flake8)\n[)](https://github.com/astral-sh/ruff)\n[](https://pepy.tech/project/mvdate)\n[](https://pepy.tech/project/mvdate)\n[](https://pepy.tech/project/mvdate)\n[](https://liberapay.com/slackline/donate)\n\n# mvdate\n\nA Python package to search for files and move them to a directory structure based on date.\n\n## Motivation\n\nI keep my pictures in a hierarchical data structure of `YYYY/MM/DD` but that isn't how my camera stores them. I wanted\nan easy way to copy/move files to this structure.\n\n## Installation\n\n`mvdate` is available from [PyPI](https://pypi.org) to install...\n\n```bash\npip install mvdate\n```\n\n### Development\n\nIf you wish to try the development version you can install directly using `pip`...\n\n```bash\npip install mvdate@git+https://gitlab.com/nshephard/mvdate.git@main\n```\n\nOr if you are likely to want to tinker you can clone the repository and install (although you may wish to fork and clone\nthat if you want to contribute).\n\n```bash\ngit clone git@gitlab.com:nshephard/mvdate.git\ncd mvdate\npip install .\n```\n\n## Usage\n\nTo search the current directory for files ending with `png` and move them to `~/pics/YYYY/MM/DD/`\n\n```bash\nmvdate --base ./ --destination ~/pics/ --ext png\n```\n\nFor all options see the help\n\n```bash\nmvdate --help\n```\n\n## Contributing\n\nIf you want to contribute merge requests are more than welcome. Fork and clone the repository and install the\ndevelopment and test dependencies.\n\n```bash\nmkvirtualenv mvdate # Or similar depending on your preferences\ngit clone git@gitlab.com:nshephard/mvdate.git\ncd mvdate\npip install .[dev,tests]\npre-commit install\n```\n\nI use various tools to lint and test the package, mostly via [pre-commit](https://pre-commit.com). These include\n[pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks), [black](https://github.com/psf/black),\n[markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2) and [ruff](https://docs.astral.sh/ruff/). By using\n`pre-commit` locally any contributions should then pass the GitLab CI pipelines I have in place.\n\n## Links\n",
"bugtrack_url": null,
"license": "GNU Lesser GPLv3 only",
"summary": "Move files to directories based on created date",
"version": "0.1.2",
"project_urls": {
"Bug_Tracker": "https://gitlab.com/nshephard/mvdate/issues",
"Source": "https://gitlab.com/nshephard/mvdate"
},
"split_keywords": [
"files",
"date"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7ed2f0a0c73c1de65b8cd49a3438fef5dbb0e0c6ac3da2be5d024a2cb8f368db",
"md5": "b476a8e108e8e8078d8438a565cc0f17",
"sha256": "aefecffd10123db1c95d76f7734ae8a1652c1333b51ca557470b5ae6e7d6561b"
},
"downloads": -1,
"filename": "mvdate-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b476a8e108e8e8078d8438a565cc0f17",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 19609,
"upload_time": "2023-12-27T18:54:41",
"upload_time_iso_8601": "2023-12-27T18:54:41.897920Z",
"url": "https://files.pythonhosted.org/packages/7e/d2/f0a0c73c1de65b8cd49a3438fef5dbb0e0c6ac3da2be5d024a2cb8f368db/mvdate-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e8c89292b75e70bd86dca922e4285ef090a56dff79f119094cda68c18e9b6bc5",
"md5": "43134c958b7ae0403f4bc893b7be71c1",
"sha256": "ffff6d83ff204af5932eee708901c239382b98729e2ecbb411f1a5c9fd3931aa"
},
"downloads": -1,
"filename": "mvdate-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "43134c958b7ae0403f4bc893b7be71c1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 285664,
"upload_time": "2023-12-27T18:54:43",
"upload_time_iso_8601": "2023-12-27T18:54:43.723663Z",
"url": "https://files.pythonhosted.org/packages/e8/c8/9292b75e70bd86dca922e4285ef090a56dff79f119094cda68c18e9b6bc5/mvdate-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-27 18:54:43",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "nshephard",
"gitlab_project": "mvdate",
"lcname": "mvdate"
}
