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! 🚀

OpenLoom v0.0.2

🧵 OpenLoom v0.0.2 — Packaging Fix Release 📦

This minor release fixes a key packaging issue from v0.0.1, ensuring the artifact is recognized properly in IDEs and dependency managers.

---

🔧 Fixes

• ✅ Proper JAR Packaging
  • The library is now published correctly as a .jar file (not shown as a folder) when added via Maven or Gradle.
  • Resolves IDE issues where the dependency was not recognized as a compiled JAR.

---

📦 Dependency Example

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

🔗 Quick Links

📦 Maven Central

📚 Javadoc

🔍 Source Code

💡 Examples Folder

☕ Support OpenLoom

✅ Requirements

Java 8 or above (JDK 17+ recommended)

🔖 Version: v0.0.2

📅 Release Date: 2025-06-19

OpenLoom v0.0.1

🧵 OpenLoom v0.0.1 — First Official Release 🎉

• Say hello to OpenLoom, a modern and lightweight Java library for smart file reading — built to make working with files effortless and fast 🚀.

✨ Highlights

• 📄 Read Files Easily – Read files with File or Path using a clean API.

• 🧠 Adaptive Engine – Automatically chooses the best read strategy (BufferedReader, NIO, or Memory-Mapped) based on file size.

• ⚡ Asynchronous Support – Read files asynchronously using CompletableFuture.

• 🔁 Line-by-Line Streaming – Stream lines in both sync and async modes.

• 🌐 Multi-Charset Support – Read files with UTF-8, ISO-8859-1, UTF-16, and more.

• ⚙️ Zero Config – Just drop it in. No setup needed.

🧪 Example Usage

OpenLoom reader = new OpenLoom();
StringBuilder content = reader.read(new File("data.txt"));
System.out.println(content);

reader.readAsync(new File("large.txt")).thenAccept(content -> {
    System.out.println("First 100 chars: " + content.substring(0, 100));
});

🔗 Quick Links

📦 Maven Central

📚 Javadoc

🔍 Source Code

💡 Examples Folder

☕ Support OpenLoom

✅ Requirements

Java 8 or above (JDK 17+ recommended)

🔖 Version: v0.0.1

📅 Release Date: 2025-06-17