# File Renamer 🛠️✨
Welcome to **File Renamer**, the tool you never knew you needed until your boss asked you to rename "File_Final_FINAL_v2_ACTUALLYFINAL.docx" to something sane across 12,000 files. 😅
## What Does It Do? 🤔
Simple! It:
- Finds files and folders in a directory and its subdirectories.
- Replaces *that one annoying word* in their names and content.
- Makes your life a tad bit easier (or so we hope).
## Why Use This? 🚀
- You’ve run out of excuses for why your directory still says `OldProject`.
- You're tired of opening files only to manually replace "Lorem Ipsum" 374 times.
- You believe in automation, even if it just helps you avoid doing real work.
## How Do I Use This Sorcery? 🪄
1. Install the package:
```bash
pip install file-renamer
2. Summon the renaming magic:
```
file-renamer
```
3. Answer the oh-so-simple questions:
- Where should I start renaming? (Hint: Use . for the current directory.)
- What’s the cursed word you want to banish?
- What delightful replacement shall we bestow?
- Sit back and watch as the chaos unfolds in your terminal. 🎉
Example 📝
Let’s rename all instances of “boring” to “exciting”:
```
$ file-renamer
Enter the root directory path: .
Enter the word you want to replace: boring
Enter the word to replace it with: exciting
```
Boom! Your files are now way more exciting. 🥳
Features ✨
• Recursive Renaming: No file or folder is safe from the renaming rampage.
• Content Replacement: Yes, it digs inside files too (no secrets here).
• User-Friendly Prompts: Even your grandma could use this.
• Supports Multiple Encodings: Because not all files speak UTF-8. 🤷♂️
Disclaimer ⚠️
• Backup Your Files! This tool will change things faster than your mood on a Monday morning.
• We are not responsible if you replace “yes” with “no” and accidentally break the universe.
Credits 👏
• Developer: Sachin Arora
• GitHub: sachnaror
• License: MIT (aka “Do Whatever You Want With It, But Don’t Blame Me”)
Support 🙋♂️
If you find a bug, create an issue, or if you find this tool life-changing, send me a star 🌟 on GitHub. If not, well… we tried. 😄
```
This README should leave your users chuckling while still providing all the essential info!
```
Raw data
{
"_id": null,
"home_page": "https://github.com/sachnaror/renamer",
"name": "renamering",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "file-renaming, directory-rename, content-replace, utility",
"author": "Sachin Arora",
"author_email": "Sachin Arora <schnaror@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c1/89/6188b7092fe838e7d7c1503ba0b8cabaad64e0644584db18e176e08d02b0/renamering-1.0.0.tar.gz",
"platform": null,
"description": "# File Renamer \ud83d\udee0\ufe0f\u2728\n\nWelcome to **File Renamer**, the tool you never knew you needed until your boss asked you to rename \"File_Final_FINAL_v2_ACTUALLYFINAL.docx\" to something sane across 12,000 files. \ud83d\ude05\n\n## What Does It Do? \ud83e\udd14\n\nSimple! It:\n- Finds files and folders in a directory and its subdirectories.\n- Replaces *that one annoying word* in their names and content.\n- Makes your life a tad bit easier (or so we hope).\n\n## Why Use This? \ud83d\ude80\n\n- You\u2019ve run out of excuses for why your directory still says `OldProject`.\n- You're tired of opening files only to manually replace \"Lorem Ipsum\" 374 times.\n- You believe in automation, even if it just helps you avoid doing real work.\n\n## How Do I Use This Sorcery? \ud83e\ude84\n\n1. Install the package:\n ```bash\n pip install file-renamer\n\n2.\tSummon the renaming magic:\n\n```\nfile-renamer\n\n```\n\n3.\tAnswer the oh-so-simple questions:\n\n- Where should I start renaming? (Hint: Use . for the current directory.)\n- What\u2019s the cursed word you want to banish?\n- What delightful replacement shall we bestow?\n- Sit back and watch as the chaos unfolds in your terminal. \ud83c\udf89\n\nExample \ud83d\udcdd\n\nLet\u2019s rename all instances of \u201cboring\u201d to \u201cexciting\u201d:\n\n```\n$ file-renamer\nEnter the root directory path: .\nEnter the word you want to replace: boring\nEnter the word to replace it with: exciting\n\n```\n\nBoom! Your files are now way more exciting. \ud83e\udd73\n\nFeatures \u2728\n\n\t\u2022\tRecursive Renaming: No file or folder is safe from the renaming rampage.\n\t\u2022\tContent Replacement: Yes, it digs inside files too (no secrets here).\n\t\u2022\tUser-Friendly Prompts: Even your grandma could use this.\n\t\u2022\tSupports Multiple Encodings: Because not all files speak UTF-8. \ud83e\udd37\u200d\u2642\ufe0f\n\nDisclaimer \u26a0\ufe0f\n\n\t\u2022\tBackup Your Files! This tool will change things faster than your mood on a Monday morning.\n\t\u2022\tWe are not responsible if you replace \u201cyes\u201d with \u201cno\u201d and accidentally break the universe.\n\nCredits \ud83d\udc4f\n\n\t\u2022\tDeveloper: Sachin Arora\n\t\u2022\tGitHub: sachnaror\n\t\u2022\tLicense: MIT (aka \u201cDo Whatever You Want With It, But Don\u2019t Blame Me\u201d)\n\nSupport \ud83d\ude4b\u200d\u2642\ufe0f\n\nIf you find a bug, create an issue, or if you find this tool life-changing, send me a star \ud83c\udf1f on GitHub. If not, well\u2026 we tried. \ud83d\ude04\n\n```\nThis README should leave your users chuckling while still providing all the essential info!\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package to recursively rename files, directories, and replace content.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/sachnaror/renamer"
},
"split_keywords": [
"file-renaming",
" directory-rename",
" content-replace",
" utility"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7097a5d13855a0eec18bbecdf844d8e695a929c7914936735c888cbd69309abe",
"md5": "7b388816b11809e8bf397f72696dc182",
"sha256": "6db2f70906d8ed130c39d374456a6c16103aa5f951040c5cc659f289b0daa5a0"
},
"downloads": -1,
"filename": "renamering-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7b388816b11809e8bf397f72696dc182",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 3013,
"upload_time": "2024-11-16T11:01:55",
"upload_time_iso_8601": "2024-11-16T11:01:55.393328Z",
"url": "https://files.pythonhosted.org/packages/70/97/a5d13855a0eec18bbecdf844d8e695a929c7914936735c888cbd69309abe/renamering-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1896188b7092fe838e7d7c1503ba0b8cabaad64e0644584db18e176e08d02b0",
"md5": "ce7c211b3f49180b3b364adc2ed62d4f",
"sha256": "4a36f03bd1ecc2d2807cb728f90fcd0ff9d832b7a02fe1910e12261292a6718a"
},
"downloads": -1,
"filename": "renamering-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ce7c211b3f49180b3b364adc2ed62d4f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 3358,
"upload_time": "2024-11-16T11:01:57",
"upload_time_iso_8601": "2024-11-16T11:01:57.368924Z",
"url": "https://files.pythonhosted.org/packages/c1/89/6188b7092fe838e7d7c1503ba0b8cabaad64e0644584db18e176e08d02b0/renamering-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-16 11:01:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sachnaror",
"github_project": "renamer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "renamering"
}
JSON
