OneIO v0.19.0: Feature Simplification & New Capabilities

[digizeph]

Summary

This PR implements OneIO v0.19.0, a major release that significantly simplifies the codebase while adding powerful new features. The release follows a "dead simple" philosophy with cleaner APIs and better user experience.

🎯 Key Accomplishments

• Feature simplification: Flat, intuitive feature structure replacing complex nested hierarchy
• Error consolidation: Reduced from 10+ error variants to 3 essential types
• New progress tracking: Flexible callbacks that work with both known and unknown file sizes
• Async support: True streaming async I/O with automatic compression
• Enhanced safety: Eliminated unsafe operations and improved error handling
• Better testing: Feature-conditional tests work with any combination

🚨 Breaking Changes

Feature Flag Restructuring

• Before: ["lib-core", "rustls"]
• After: ["gz", "bz", "http"]

Error System Consolidation

• Before: 10+ specific error variants
• After: Io, Network, NotSupported

✨ Major New Features

Progress Tracking

let (reader, total_size) = oneio::get_reader_with_progress(
    "https://example.com/file.gz",
    |bytes_read, total_bytes| {
        if total_bytes > 0 {
            println\!("Progress: {:.1}%", (bytes_read as f64 / total_bytes as f64) * 100.0);
        } else {
            println\!("Downloaded: {} bytes", bytes_read);
        }
    }
)?;

Async Support (Feature: async)

// True streaming async I/O
let content = oneio::read_to_string_async("https://example.com/data.gz").await?;

// Async download
oneio::download_async("https://example.com/file.gz", "local.gz").await?;

🛠️ Major Improvements

• Simplified architecture: Removed OneIOCompression trait, build.rs, and complex feature nesting
• Enhanced safety: Fixed all unsafe unwrap() operations in path parsing
• Better async implementation: Removed over-engineered spawn_blocking patterns
• Improved testing: Feature-conditional tests support any combination including no features
• Bug fixes: Resolved S3 upload hanging issue (s3 upload stuck if local file does not exist #48) and doctest compilation problems

📊 Code Quality Metrics

• All tests passing: Unit, integration, and doc tests across all feature combinations
• No unsafe operations: All path parsing and file operations use safe alternatives
• Clean compilation: No clippy warnings or compilation issues
• Comprehensive documentation: Updated examples, README, and CHANGELOG

🔄 Migration Path

The migration is straightforward for most users:

1. Update feature flags to new flat structure
2. Handle consolidated error types (most existing error handling will work unchanged)
3. Consider adopting new progress tracking and async features

Test Plan

• All feature combinations tested (none, basic, async, all)
• Progress tracking works with known and unknown file sizes
• Async support properly handles supported/unsupported formats
• S3 upload early validation prevents hanging
• Feature-conditional tests pass without any features enabled
• Documentation examples compile and run correctly
• Migration from v0.18.x verified

This release maintains full backward compatibility for core functionality while providing a much cleaner, simpler, and more powerful API.

[digizeph]

This includes initial support for async (#56) and a fix for stuck issue (#48).

[Copilot]

Pull Request Overview

This PR implements OneIO v0.19.0, a major release that significantly simplifies the library's architecture while adding powerful new features like progress tracking and async support. The release adopts a "dead simple" philosophy with flat feature flags, consolidated error handling, and cleaner APIs.

• Feature simplification: Replaced complex nested features with flat structure (gz, bz, http vs lib-core, remote, compressions)
• Error consolidation: Reduced from 10+ error variants to 3 essential types (Io, Network, NotSupported)
• New capabilities: Added progress tracking, async support, and enhanced safety with early validation

Reviewed Changes

Copilot reviewed 22 out of 24 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/oneio_test.rs	Removed old monolithic test file
tests/basic_integration.rs	Added feature-conditional tests for core functionality
tests/async_integration.rs	Added async-specific integration tests
src/oneio/utils.rs	Moved JSON test to feature-conditional location
src/oneio/s3.rs	Enhanced with early validation and better error handling
src/oneio/remote.rs	Improved safety and TLS configuration
src/oneio/mod.rs	Added progress tracking and async support
src/oneio/compressions/*.rs	Removed trait-based system for direct functions
src/lib.rs	Updated documentation for v0.19 changes
src/error.rs	Simplified to 3 error variants with proper conversions
examples/	Added progress tracking example and fixed URLs
build.rs	Removed - no longer needed
README.md	Updated for v0.19 feature structure
Cargo.toml	Flat feature structure and dependency updates
CHANGELOG.md	Comprehensive v0.19.0 release notes
.github/workflows/rust.yml	Enhanced CI with comprehensive feature testing

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}