# BulkRenamerPy
Simple bulk rename tool, rename files in a directory with a given pattern, prefix and padding.
By default, rename is incremental, so if you have a file image.png, it will rename 1.png, 2.png and so on, a prefix and padding can be specified.
Rename is made using regex, also possible to sort and limit files to rename.
Written in python with [rich_click](https://github.com/ewels/rich-click/).
## Installation
```bash
pip install BulkRenamerPy
```
## Example Usage
**Rename all files with png and jpg extension**
`bulk_rename path/to/dir/ ".*.(png|jpg)"`
**Rename all files that contain "image", add prefix "Wallpaper" with 2 padding**
`bulk_rename path/to/dir/ "image*" "Wallpaper" -p 2`
**Rename all files limited to 10, sorted by size**
`bulk_rename path/to/dir/ ".*" -l 10 -s size`
**More info using --help**
`bulk_rename --help`
## **Friendly Reminder**
This tool will rename any file that you have permissions, and can cause damage, specially on UNIX systems, so please be careful and use it with caution. I advise to run using `--dry-run` flag first.
Raw data
{
"_id": null,
"home_page": "",
"name": "BulkRenamerPy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "bulk rename,rename,rename files",
"author": "",
"author_email": "Bruno Anesio <brunohanesio@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/76/e1/f1ec6a69bd399d015802fc9cf3c926ce221044d7be25af81e85d266d1efb/BulkRenamerPy-0.1.5.tar.gz",
"platform": null,
"description": "# BulkRenamerPy\n\nSimple bulk rename tool, rename files in a directory with a given pattern, prefix and padding.\n\nBy default, rename is incremental, so if you have a file image.png, it will rename 1.png, 2.png and so on, a prefix and padding can be specified.\n\nRename is made using regex, also possible to sort and limit files to rename.\n\nWritten in python with [rich_click](https://github.com/ewels/rich-click/).\n\n## Installation\n\n```bash\npip install BulkRenamerPy\n```\n\n## Example Usage\n\n**Rename all files with png and jpg extension**\n\n`bulk_rename path/to/dir/ \".*.(png|jpg)\"`\n\n**Rename all files that contain \"image\", add prefix \"Wallpaper\" with 2 padding**\n\n`bulk_rename path/to/dir/ \"image*\" \"Wallpaper\" -p 2`\n\n**Rename all files limited to 10, sorted by size**\n\n`bulk_rename path/to/dir/ \".*\" -l 10 -s size`\n\n**More info using --help**\n\n`bulk_rename --help`\n\n## **Friendly Reminder**\n\nThis tool will rename any file that you have permissions, and can cause damage, specially on UNIX systems, so please be careful and use it with caution. I advise to run using `--dry-run` flag first.\n",
"bugtrack_url": null,
"license": "",
"summary": "A simple tool to bulk rename files in a directory",
"version": "0.1.5",
"project_urls": {
"Bug Tracker": "https://github.com/brunoanesio/bulk-rename/issues",
"Homepage": "https://github.com/brunoanesio/bulk-rename"
},
"split_keywords": [
"bulk rename",
"rename",
"rename files"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b12469bb8b0286c1775587879ec179f746231a012f5b62375a76cda94a6f5142",
"md5": "d8728194d52a7da79ab1d1eb15d9f8f2",
"sha256": "1a26d384d60f2638e3e7fd9c1110247c83e61913c427ecb5dbd44c6cdd587655"
},
"downloads": -1,
"filename": "BulkRenamerPy-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8728194d52a7da79ab1d1eb15d9f8f2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15933,
"upload_time": "2023-06-21T08:40:42",
"upload_time_iso_8601": "2023-06-21T08:40:42.516254Z",
"url": "https://files.pythonhosted.org/packages/b1/24/69bb8b0286c1775587879ec179f746231a012f5b62375a76cda94a6f5142/BulkRenamerPy-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "76e1f1ec6a69bd399d015802fc9cf3c926ce221044d7be25af81e85d266d1efb",
"md5": "62823e9651348d1ceae1ce8c2c25cb7f",
"sha256": "89b4a9095379bcc87f0dc3e89900f9aecf5f889fc76032532f9218995a7f6733"
},
"downloads": -1,
"filename": "BulkRenamerPy-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "62823e9651348d1ceae1ce8c2c25cb7f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 16017,
"upload_time": "2023-06-21T08:40:43",
"upload_time_iso_8601": "2023-06-21T08:40:43.961283Z",
"url": "https://files.pythonhosted.org/packages/76/e1/f1ec6a69bd399d015802fc9cf3c926ce221044d7be25af81e85d266d1efb/BulkRenamerPy-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-21 08:40:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brunoanesio",
"github_project": "bulk-rename",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "click",
"specs": [
[
"==",
"8.1.3"
]
]
},
{
"name": "iniconfig",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "markdown-it-py",
"specs": [
[
"==",
"3.0.0"
]
]
},
{
"name": "mdurl",
"specs": [
[
"==",
"0.1.2"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"23.1"
]
]
},
{
"name": "pluggy",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.15.1"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"7.3.2"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.4.2"
]
]
},
{
"name": "rich-click",
"specs": [
[
"==",
"1.6.1"
]
]
}
],
"lcname": "bulkrenamerpy"
}
JSON
