🛠️ fara — Find And Replace App

fara stands for Find And Replace App — a fast and flexible command-line tool to search and replace text across files and folders.

✨ Features

• 🔍 Find text in files or entire folders.
• ✏️ Replace text easily and quickly.
• 🎯 Target specific files, directories, or use glob patterns like **/*.rs.
• 🔡 Case-insensitive search with --ignore-case.
• 📝 Optional regex support for advanced matching.
• 💾 Backup files with --backup (if needed).
• 🚫 Dry run option to preview changes.

🧱 Installation

You can install fara using Cargo:

cargo install fara

Alternatively, clone the repository and build it manually:

git clone https://github.com/ibilalkayy/fara.git
cd fara
cargo build && cargo install --path .

🚀 Usage

Basic Example

fara --find "Foo" --replace "Bar" --target "./src/**/*.rs"

This will search for "Foo" in all .rs files under ./src/ and replace it with "Bar".

🔧 Options

📂 Example Commands

Replace "Hello" with "Hi" in all .txt files in a folder:

fara --find "Hello" --replace "Hi" --target "./notes/**/*.txt" --confirm

Use regex to replace digits with a dash:

fara --regex "\d+" --replace "-" --target "./data/*.csv"  --confirm

Case-insensitive replace:

fara --find "welcome" --replace "Hello" --target "main.rs" --ignore-case

🤝 Contributing

We welcome contributions! If you find a bug, want to request a feature, or contribute code, feel free to open an issue or submit a pull request.

📄 License

Licensed under the Apache-2.0 License.