Skip to main content

A Python package to recursively rename files, directories, and replace content.

Project description

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:
    pip install file-renamer
    
  2. Summon the renaming magic:
file-renamer

  1. 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!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

renamering-1.0.0.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

renamering-1.0.0-py3-none-any.whl (3.0 kB view details)

Uploaded Python 3

File details

Details for the file renamering-1.0.0.tar.gz.

File metadata

  • Download URL: renamering-1.0.0.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.2

File hashes

Hashes for renamering-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4a36f03bd1ecc2d2807cb728f90fcd0ff9d832b7a02fe1910e12261292a6718a
MD5 ce7c211b3f49180b3b364adc2ed62d4f
BLAKE2b-256 c1896188b7092fe838e7d7c1503ba0b8cabaad64e0644584db18e176e08d02b0

See more details on using hashes here.

File details

Details for the file renamering-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: renamering-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 3.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.2

File hashes

Hashes for renamering-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6db2f70906d8ed130c39d374456a6c16103aa5f951040c5cc659f289b0daa5a0
MD5 7b388816b11809e8bf397f72696dc182
BLAKE2b-256 7097a5d13855a0eec18bbecdf844d8e695a929c7914936735c888cbd69309abe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page