OpenLoom v1.0.0

🎉 OpenLoom v1.0.0 - Production Ready Java File I/O Library

The first stable release of OpenLoom is here! A lightweight, dependency-free Java file I/O toolkit that simplifies reading, writing, searching, and managing files.

---

🚀 What's New in 1.0.0

✨ Complete I/O Ecosystem

OpenLoom now offers four specialized managers for all your file operations:

• 🧠 ReadManager - Advanced file reading with multiple strategies
• ✍️ WriteManager - Reliable file writing and appending
• 🔍 SearchManager - Powerful text search and modification
• 📂 FileManager - Robust file system operations

🎯 Key Features That Set Us Apart

🔍 Advanced Search Capabilities

// Range-limited search (UNIQUE to OpenLoom)
List<String> results = loom.search().findLineInRange(file, "error", 100, 200);
List<String> regexResults = loom.search().findLineRegexInRange(file, "ERROR.*", 50, 150);

// Safe operations with automatic backups
loom.search().replaceTextSafe(file, "old", "new"); // Creates backup automatically

📦 Zero Dependencies, Maximum Power

• No external dependencies - Pure Java 11+

• Lightweight - Minimal footprint in your project

• Easy updates - No dependency conflicts

🛡️ Built-in Safety Features

• Recursion protection in directory operations

• Automatic validation with detailed error messages

• Atomic operations with proper fallback handling

🔄 Dual Input Support

// Works with both File and Path seamlessly
loom.read().read(new File("data.txt"));        // Traditional File API
loom.read().read(Paths.get("data.txt"));       // Modern Path API

##🏆 Why OpenLoom is Easier to Use

🎯 Single Entry Point

// One class for all file operations vs multiple utility classes
OpenLoom loom = new OpenLoom();
loom.read().read(file);
loom.write().write(file, content);
loom.search().findLine(file, "pattern");

###⚡ Simplified Complex Operations

// Before: Manual coding for advanced search
// Multiple loops, buffer management, error handling...

// After: One method call
List<String> results = loom.search().findLineRegexInRange(file, "pattern", start, end);

###🛡️ Built-in Safety

// Automatic backups for risky operations
loom.search().replaceTextSafe(file, "old", "new"); // No manual backup code needed

🔄 Flexible API

// Works with both File and Path without conversion
loom.file().copyFile(new File("src.txt"), Paths.get("dest.txt"));

⚡ Performance Highlights

• Memory-mapped I/O for large file handling

• Customizable buffers for optimal memory usage

• Efficient algorithms for fast search and replace

• Synchronous design for predictable performance

📥 Installation

Maven

<dependency>
    <groupId>io.github.raghul-tech</groupId>
    <artifactId>openloom</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle

implementation 'io.github.raghul-tech:openloom:1.0.0'

##🎯 Perfect For

🔧 Configuration Management - Safe updates to config files

• 📊 Log Processing - Advanced search and analysis

• 🗂️ Data Migration - Bulk file operations with safety

• 📝 Document Processing - Large-scale text manipulation

🔗 Links

📦 Maven Central

📚 Documentation: Javadocs

🐛 Issues: Report Bugs

📖 README: Getting Started Guide

Ready to simplify your file operations? Give OpenLoom a try today! 🚀