Fixes #186 - Adds f.Image.PicsumUrl https://picsum.photos service.

HISTORY.md

@@ -1,5 +1,6 @@
 ## v24.3.1
-* `tr` - Turkish locale first/last names updated. Lorem data set updated. Thanks ahmetcanaydemir! 
+* `tr` - Turkish locale first/last names updated. Lorem data set updated. Thanks ahmetcanaydemir!
+* Added `f.Image.PicsumUrl` (https://picsum.photos) service as faster alternative to Lorem Pixel. 
 
 ## v24.3.0
 * Data / feature parity with faker.js @ 9dd5a52

README.md

@@ -342,6 +342,7 @@ public void Using_FakerT_Inheritance()
 	* `Technics` - Get a technology related image.
 	* `Transport` - Get a transportation related image.
 	* `DataUri` - Get a SVG data URI image with a specific width and height.
+	* `PicsumUrl` - Get an image from the https://picsum.photos service.
 * **`Internet`**
 	* `Avatar` - Generates a legit Internet URL avatar from twitter accounts.
 	* `Email` - Generates an email address.

Source/Bogus.Tests/DataSetTests/ImageTest.cs

@@ -71,5 +71,15 @@ public void url_generated_should_have_https()
       {
          image.Sports(https: true).Should().StartWith("https://");
       }
+
+      [Fact]
+      public void can_use_picsum_Url()
+      {
+         var url = image.PicsumUrl(200, 300);
+         url.Should().Be("https://picsum.photos/200/300/?image=654");
+
+         url = image.PicsumUrl(300, 200, true, true);
+         url.Should().Be("https://picsum.photos/g/300/200/?image=119&blur");
+      }
    }
 }

Source/Bogus/DataSets/Images.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Text;
 
 namespace Bogus.DataSets
 {
@@ -222,5 +223,38 @@ public string DataUri(int width, int height, string htmlColor = "grey")
 
          return rawPrefix + Uri.EscapeDataString(svgString);
       }
+
+      /// <summary>
+      /// Get an image from the https://picsum.photos service.
+      /// </summary>
+      /// <param name="width">Width of the image.</param>
+      /// <param name="height">Height of the image.</param>
+      /// <param name="grayscale">Grayscale (no color) image.</param>
+      /// <param name="blur">Blurry image.</param>
+      /// <param name="imageId">Optional Image ID found here https://picsum.photos/images</param>
+      public string PicsumUrl(int width = 640, int height = 480, bool grayscale = false, bool blur = false, int? imageId = null )
+      {
+         const string Url = "https://picsum.photos";
+
+         var sb = new StringBuilder();
+
+         if (grayscale)
+         {
+            sb.Append("/g");
+
+         }
+
+         sb.Append($"/{width}/{height}");
+
+         var n = imageId ?? this.Random.Number(0, 1084);
+         sb.Append($"/?image={n}");
+
+         if (blur)
+         {
+            sb.Append("&blur");
+         }
+
+         return Url + sb;
+      }
    }
 }