Added byte rate calculation functons, closes #296

src/Humanizer.Tests/Bytes/ByteRateTests.cs

@@ -0,0 +1,29 @@
+using System;
+using Humanizer.Bytes;
+using Xunit;
+using Xunit.Extensions;
+
+namespace Humanizer.Tests.Bytes
+{
+    public class ByteRateTests : AmbientCulture
+    {
+        public ByteRateTests() : base("en") { }
+
+        [Theory]
+        [InlineData(400, 1, "400 B/s")]
+        [InlineData(4 * 1024, 1, "4 KB/s")]
+        [InlineData(4 * 1024 * 1024, 1, "4 MB/s")]
+        [InlineData(4 * 2 * 1024 * 1024, 2, "4 MB/s")]
+        [InlineData(4 * 1024, 0.1, "40 KB/s")]
+        [InlineData(15 * 60 * 1024 * 1024, 60, "15 MB/s")]
+        public void HumanizesRates(long inputBytes, double perSeconds, string expectedValue)
+        {
+            var size = new ByteSize(inputBytes);
+            var interval = TimeSpan.FromSeconds(perSeconds);
+
+            var rate = size.Per(interval).ToRatePerSecond();
+
+            Assert.Equal(expectedValue, rate);
+        }
+    }
+}

src/Humanizer.Tests/Humanizer.Tests.csproj

@@ -56,6 +56,7 @@
     </Reference>
   </ItemGroup>
   <ItemGroup>
+    <Compile Include="Bytes\ByteRateTests.cs" />
     <Compile Include="Bytes\ComparingTests.cs" />
     <Compile Include="Bytes\CreatingTests.cs" />
     <Compile Include="Bytes\ByteSizeExtensionsTests.cs" />

src/Humanizer/Bytes/ByteRate.cs

@@ -0,0 +1,29 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+
+namespace Humanizer.Bytes
+{
+    public class ByteRate
+    {
+        public ByteSize size { get; private set;}
+
+        public TimeSpan interval { get; private set; }
+
+        public ByteRate(ByteSize size, TimeSpan interval)
+        {
+            this.size = size;
+            this.interval = interval;
+        }
+
+        /// <summary>
+        /// Return this rate as a string, EG "2 MB/s"
+        /// </summary>
+        /// <returns></returns>
+        public string ToRatePerSecond()
+        {
+            return (new ByteSize(size.Bytes / interval.TotalSeconds)).Humanize() + "/s";
+        }
+    }
+}

src/Humanizer/Bytes/ByteSizeExtensions.cs

@@ -1,4 +1,5 @@
-using Humanizer.Bytes;
+using System;
+using Humanizer.Bytes;
 
 // ReSharper disable once CheckNamespace
 namespace Humanizer
@@ -438,5 +439,16 @@ public static string Humanize(this ByteSize input, string format = null)
         {
             return string.IsNullOrWhiteSpace(format) ? input.ToString() : input.ToString(format);
         }
+
+        /// <summary>
+        /// Turns a quantity of bytes in a given interval into a rate that can be manipulated
+        /// </summary>
+        /// <param name="size">Quantity of bytes</param>
+        /// <param name="interval">Interval to create rate for</param>
+        /// <returns></returns>
+        public static ByteRate Per(this ByteSize size, TimeSpan interval)
+        {
+            return new ByteRate(size, interval);
+        }
     }
 }

src/Humanizer/Humanizer.csproj

@@ -49,6 +49,7 @@
     <AssemblyOriginatorKeyFile>Humanizer.snk</AssemblyOriginatorKeyFile>
   </PropertyGroup>
   <ItemGroup>
+    <Compile Include="Bytes\ByteRate.cs" />
     <Compile Include="CollectionHumanizeExtensions.cs" />
     <Compile Include="Configuration\CollectionFormatterRegistry.cs" />
     <Compile Include="Localisation\CollectionFormatters\DefaultCollectionFormatter.cs" />