add - doc - Added a way to get the blob stream

---

We've added a method that allows you to get a stream from a blob. Doesn't support URLs or non-BASE64 blobs.

---

Type: add
Breaking: False
Doc Required: True
Backport Required: False
Part: 1/1

VisualCard.ShowContacts/Program.cs

@@ -19,6 +19,7 @@
 
 using System;
 using System.Diagnostics;
+using System.IO;
 using System.Linq;
 using Terminaux.Colors.Data;
 using Terminaux.Writer.ConsoleWriters;

VisualCard/Parsers/VcardParserTools.cs

@@ -351,5 +351,28 @@ internal static bool IsEncodingBlob(string[] args, string keyEncoded)
                 encoding.Equals("BASE64", StringComparison.OrdinalIgnoreCase) ||
                 encoding.Equals("BLOB", StringComparison.OrdinalIgnoreCase);
         }
+
+        internal static Stream GetBlobData(string[] args, string keyEncoded)
+        {
+            if (IsEncodingBlob(args, keyEncoded))
+            {
+                bool isValidUri = Uri.TryCreate(keyEncoded, UriKind.Absolute, out Uri uri);
+                string dataStr;
+                if (isValidUri)
+                {
+                    if (uri.Scheme == "data")
+                        dataStr = uri.AbsolutePath.Substring(uri.AbsolutePath.IndexOf(",") + 1);
+                    else
+                        throw new InvalidDataException("Contains a valid URL; you should fetch that URL manually and convert the response to the stream.");
+                }
+                else
+                    dataStr = keyEncoded;
+                byte[] dataBytes = Convert.FromBase64String(dataStr);
+                Stream blobStream = new MemoryStream(dataBytes);
+                return blobStream;
+            }
+            else
+                throw new InvalidOperationException("Not a blob. You should somehow handle it.");
+        }
     }
 }

VisualCard/Parts/Implementations/KeyInfo.cs

@@ -82,6 +82,13 @@ internal override BaseCardPartInfo FromStringVcardInternal(string value, string[
             return _key;
         }
 
+        /// <summary>
+        /// Gets a stream representing the key data
+        /// </summary>
+        /// <returns>A stream that contains key data</returns>
+        public Stream GetStream() =>
+            VcardParserTools.GetBlobData(Arguments, KeyEncoded);
+
         /// <inheritdoc/>
         public override bool Equals(object obj) =>
             Equals((KeyInfo)obj);

VisualCard/Parts/Implementations/LogoInfo.cs

@@ -82,6 +82,13 @@ internal override BaseCardPartInfo FromStringVcardInternal(string value, string[
             return _logo;
         }
 
+        /// <summary>
+        /// Gets a stream representing the logo data
+        /// </summary>
+        /// <returns>A stream that contains logo data</returns>
+        public Stream GetStream() =>
+            VcardParserTools.GetBlobData(Arguments, LogoEncoded);
+
         /// <inheritdoc/>
         public override bool Equals(object obj) =>
             Equals((LogoInfo)obj);

VisualCard/Parts/Implementations/PhotoInfo.cs

@@ -82,6 +82,13 @@ internal override BaseCardPartInfo FromStringVcardInternal(string value, string[
             return _photo;
         }
 
+        /// <summary>
+        /// Gets a stream representing the image data
+        /// </summary>
+        /// <returns>A stream that contains image data</returns>
+        public Stream GetStream() =>
+            VcardParserTools.GetBlobData(Arguments, PhotoEncoded);
+
         /// <inheritdoc/>
         public override bool Equals(object obj) =>
             Equals((PhotoInfo)obj);

VisualCard/Parts/Implementations/SoundInfo.cs

@@ -82,6 +82,13 @@ internal override BaseCardPartInfo FromStringVcardInternal(string value, string[
             return _sound;
         }
 
+        /// <summary>
+        /// Gets a stream representing the sound data
+        /// </summary>
+        /// <returns>A stream that contains sound data</returns>
+        public Stream GetStream() =>
+            VcardParserTools.GetBlobData(Arguments, SoundEncoded);
+
         /// <inheritdoc/>
         public override bool Equals(object obj) =>
             Equals((SoundInfo)obj);