ByteFlow.Net

ByteFlow.Net — Convert bytes ⇄ human-readable formats with SI, IEC, culture-aware, and customizable units. Zero dependencies.

---

✨ Features

• Convert raw byte counts into human-readable strings (e.g. 1234567 → "1.23 MB")
• Parse human-readable strings back into bytes ("2.5 GB" → 2684354560)
• Safe parsing via TryParseHumanBytes (no exception)
• Support for both IEC (KiB, MiB, GiB) and SI (KB, MB, GB) unit standards
• Culture-aware parsing/formatting (e.g. "1,5 MB" for cultures with comma decimal separators)
• Customizable suffix sets (allow defining your own unit names/factors)
• Alignment/padding helpers for nicely formatted output in tables or logs
• Fully tested with 100% code coverage
• Zero external dependencies — pure C#

---

📦 Installation

Install via NuGet:

dotnet add package ByteFlow.Net

---

🚀 Usage

using ByteFlow; // Basic conversion long size = 1234567; Console.WriteLine(size.ToHumanBytes()); // e.g. "1.18 MB" (default settings) Console.WriteLine(size.ToHumanBytes(3)); // more decimals // Parsing string to bytes long bytes = "2.5 GB".ToBytes(); // default parsing (SI/IEC based on default) Console.WriteLine(bytes); // Safe parsing if ("10 MB".TryParseHumanBytes(out var val)) { Console.WriteLine(val); // prints bytes if successful } // Using IEC explicitly Console.WriteLine(1536L.ToHumanBytes(2, UnitStandard.IEC)); // "1.50 KiB" long val2 = "1.50 KiB".ToBytes(UnitStandard.IEC); // Culture-aware parsing/formatting var de = new System.Globalization.CultureInfo("de-DE"); Console.WriteLine((1500L).ToHumanBytes(2, UnitStandard.SI, de)); // "1,50 KB" long val3 = "1,50 KB".ToBytes(UnitStandard.SI, de); // Custom suffix sets var custom = new[] { ("X", 1d), ("KX", 1000d), ("MX", 1000000d) }; string customStr = 5000L.ToHumanBytes(2, UnitStandard.SI, null, custom); // "5.00 KX" long customBytes = "5 KX".ToBytes(UnitStandard.SI, null, custom);

---

🧪 Unit Tests & Code Coverage

Unit tests are under ByteFlow.Tests (xUnit).
Run them with:

dotnet test

Coverage is tracked via Codecov — current coverage: 100% ✅

---

🧭 Alternatives / Comparisons

While there are other “bytes to human readable” .NET libraries out there, very few (if any) offer the combined feature set that ByteFlow.Net does:

• Support for both IEC and SI
• Culture-aware parsing/formatting
• Fully customizable suffix sets
• Alignment/padding helpers
• Zero dependencies
• Complete test coverage

So this library aims to be a robust one-stop solution for byte-size formatting.

---

🤝 Contributing

Contributions, issues, and feature requests are always welcome!
Feel free to open a discussion or a pull request.

---

⭐ Support

If you enjoy using ByteFlow.Net, a GitHub star helps more than you’d think — it boosts visibility and helps others find it.

---

📄 License

Licensed under the MIT License — see LICENSE.txt for details.