#region Disclaimer / License // Copyright (C) 2011, Kenneth Skovhede // http://www.hexad.dk, opensource@hexad.dk // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either // version 2.1 of the License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA // using System.Text.RegularExpressions; using System.Linq; #endregion using System; using System.Collections.Generic; using System.Text; namespace Duplicati.Library.Utility { public static class Utility { /// /// Size of buffers for copying stream /// public static long DEFAULT_BUFFER_SIZE = 64 * 1024; /// /// A value indicating if the current process is running in 64bit mode /// public static readonly bool Is64BitProcess = IntPtr.Size == 8; /// /// Gets the hash algorithm used for calculating a hash /// public static string HashAlgorithm { get { return "SHA256"; } } /// /// The EPOCH offset (unix style) /// public static readonly DateTime EPOCH = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc); /// /// The attribute value used to indicate error /// public const System.IO.FileAttributes ATTRIBUTE_ERROR = (System.IO.FileAttributes)(1 << 30); /// /// The callback delegate type used to collecting file information /// /// The path that the file enumeration started at /// The current element /// The attributes of the element /// A value indicating if the folder should be recursed, ignored for other types public delegate bool EnumerationFilterDelegate(string rootpath, string path, System.IO.FileAttributes attributes); /// /// Copies the content of one stream into another /// /// The stream to read from /// The stream to write to public static void CopyStream(System.IO.Stream source, System.IO.Stream target) { CopyStream(source, target, true); } /// /// Copies the content of one stream into another /// /// The stream to read from /// The stream to write to /// True if an attempt should be made to rewind the source stream, false otherwise public static void CopyStream(System.IO.Stream source, System.IO.Stream target, bool tryRewindSource) { if (tryRewindSource && source.CanSeek) try { source.Position = 0; } catch { } byte[] buf = new byte[DEFAULT_BUFFER_SIZE]; int read; while ((read = source.Read(buf, 0, buf.Length)) != 0) target.Write(buf, 0, read); } /// /// These are characters that must be escaped when using a globbing expression /// private static readonly string BADCHARS = "\\" + string.Join("|\\", new string[] { "\\", "+", "|", "{", "[", "(", ")", "]", "}", "^", "$", "#", "." }); /// /// Most people will probably want to use fileglobbing, but RegExp's are more flexible. /// By converting from the weak globbing to the stronger regexp, we support both. /// /// /// public static string ConvertGlobbingToRegExp(string globexp) { //First escape all special characters globexp = Regex.Replace(globexp, BADCHARS, "\\$&"); //Replace the globbing expressions with the corresponding regular expressions globexp = globexp.Replace('?', '.').Replace("*", ".*"); return globexp; } /// /// Returns a list of all files found in the given folder. /// The search is recursive. /// /// The folder to look in /// The filter to apply. /// A list of the full filenames public static IEnumerable EnumerateFiles(string basepath) { return EnumerateFiles(basepath, null); } /// /// Returns a list of folder names found in the given folder. /// The search is recursive. /// /// The folder to look in /// A list of the full paths public static IEnumerable EnumerateFolders(string basepath) { return EnumerateFolders(basepath, null); } /// /// Returns a list of all files and subfolders found in the given folder. /// The search is recursive. /// /// The folder to look in. /// A list of the full filenames and foldernames. Foldernames ends with the directoryseparator char public static IEnumerable EnumerateFileSystemEntries(string basepath) { return EnumerateFileSystemEntries(basepath, (IFilter)null); } /// /// Returns a list of all files found in the given folder. /// The search is recursive. /// /// The folder to look in /// The filter to apply. /// A list of the full filenames public static IEnumerable EnumerateFiles(string basepath, IFilter filter) { return EnumerateFileSystemEntries(basepath, filter).Where(x => !x.EndsWith(DirectorySeparatorString)); } /// /// Returns a list of folder names found in the given folder. /// The search is recursive. /// /// The folder to look in /// The filter to apply. /// A list of the full paths public static IEnumerable EnumerateFolders(string basepath, IFilter filter) { return EnumerateFileSystemEntries(basepath, filter).Where(x => x.EndsWith(DirectorySeparatorString)); } /// /// Returns a list of all files and subfolders found in the given folder. /// The search is recursive. /// /// The folder to look in. /// The filter to apply. /// A list of the full filenames and foldernames. Foldernames ends with the directoryseparator char public static IEnumerable EnumerateFileSystemEntries(string basepath, IFilter filter) { IFilter match; filter = filter ?? new FilterExpression(); return EnumerateFileSystemEntries(basepath, (rootpath, path, attributes) => { bool result; if (!filter.Matches(path, out result, out match)) result = true; return result; }); } /// /// A callback delegate used for applying alternate enumeration of filesystems /// /// The path to return data from /// A list of paths public delegate string[] FileSystemInteraction(string path); /// /// A callback delegate used for extracting attributes from a file or folder /// /// The path to return data from /// Attributes for the file or folder public delegate System.IO.FileAttributes ExtractFileAttributes(string path); /// /// Returns a list of all files found in the given folder. /// The search is recursive. /// /// The folder to look in /// An optional filter to apply to the filenames /// The function to call with the filenames /// A list of the full filenames public static IEnumerable EnumerateFileSystemEntries(string rootpath, EnumerationFilterDelegate callback) { return EnumerateFileSystemEntries(rootpath, callback, new FileSystemInteraction(System.IO.Directory.GetDirectories), new FileSystemInteraction(System.IO.Directory.GetFiles)); } /// /// Returns a list of all files found in the given folder. /// The search is recursive. /// /// The folder to look in /// The function to call with the filenames /// A function to call that lists all folders in the supplied folder /// A function to call that lists all files in the supplied folder /// A list of the full filenames public static IEnumerable EnumerateFileSystemEntries(string rootpath, EnumerationFilterDelegate callback, FileSystemInteraction folderList, FileSystemInteraction fileList) { return EnumerateFileSystemEntries(rootpath, callback, folderList, fileList, null); } /// /// Returns a list of all files found in the given folder. /// The search is recursive. /// /// The folder to look in /// The function to call with the filenames /// A function to call that lists all folders in the supplied folder /// A function to call that lists all files in the supplied folder /// A function to call that obtains the attributes for an element, set to null to avoid reading attributes /// A list of the full filenames public static IEnumerable EnumerateFileSystemEntries(string rootpath, EnumerationFilterDelegate callback, FileSystemInteraction folderList, FileSystemInteraction fileList, ExtractFileAttributes attributeReader) { Stack lst = new Stack(); var isFolder = false; try { if (attributeReader == null) isFolder = true; else isFolder = (attributeReader(rootpath) & System.IO.FileAttributes.Directory) == System.IO.FileAttributes.Directory; } catch { } if (isFolder) { rootpath = AppendDirSeparator(rootpath); try { System.IO.FileAttributes attr = attributeReader == null ? System.IO.FileAttributes.Directory : attributeReader(rootpath); if (callback(rootpath, rootpath, attr)) lst.Push(rootpath); } catch (System.Threading.ThreadAbortException) { throw; } catch (Exception) { callback(rootpath, rootpath, ATTRIBUTE_ERROR | System.IO.FileAttributes.Directory); } while (lst.Count > 0) { string f = AppendDirSeparator(lst.Pop()); yield return f; try { foreach(string s in folderList(f)) { var sf = AppendDirSeparator(s); System.IO.FileAttributes attr = attributeReader == null ? System.IO.FileAttributes.Directory : attributeReader(sf); if (callback(rootpath, sf, attr)) lst.Push(sf); } } catch (System.Threading.ThreadAbortException) { throw; } catch (Exception) { callback(rootpath, f, ATTRIBUTE_ERROR | System.IO.FileAttributes.Directory); } string[] files = null; if (fileList != null) try { files = fileList(f); } catch (System.Threading.ThreadAbortException) { throw; } catch (Exception) { callback(rootpath, f, ATTRIBUTE_ERROR); } if (files != null) foreach(var s in files) { try { System.IO.FileAttributes attr = attributeReader == null ? System.IO.FileAttributes.Normal : attributeReader(s); if (!callback(rootpath, s, attr)) continue; } catch (System.Threading.ThreadAbortException) { throw; } catch (Exception) { callback(rootpath, s, ATTRIBUTE_ERROR); continue; } yield return s; } } } else { try { System.IO.FileAttributes attr = attributeReader == null ? System.IO.FileAttributes.Normal : attributeReader(rootpath); if (!callback(rootpath, rootpath, attr)) yield break; } catch (System.Threading.ThreadAbortException) { throw; } catch (Exception) { callback(rootpath, rootpath, ATTRIBUTE_ERROR); yield break; } yield return rootpath; } } /// /// Calculates the size of files in a given folder /// /// The folder to examine /// A filter to apply /// The combined size of all files that match the filter public static long GetDirectorySize(string folder, IFilter filter) { return EnumerateFolders(folder, filter).Sum((path) => new System.IO.FileInfo(path).Length); } /// /// A cached instance of the directory separator as a string /// public static readonly string DirectorySeparatorString = System.IO.Path.DirectorySeparatorChar.ToString(); /// /// Appends the appropriate directory separator to paths, depending on OS. /// Does not append the separator if the path already ends with it. /// /// The path to append to /// The path with the directory separator appended public static string AppendDirSeparator(string path) { if (!path.EndsWith(DirectorySeparatorString)) return path += DirectorySeparatorString; else return path; } /// /// Some streams can return a number that is less than the requested number of bytes. /// This is usually due to fragmentation, and is solved by issuing a new read. /// This function wraps that functionality. /// /// The stream to read /// The buffer to read into /// The amout of bytes to read /// The actual number of bytes read public static int ForceStreamRead(System.IO.Stream stream, byte[] buf, int count) { int a; int index = 0; do { a = stream.Read(buf, index, count); index += a; count -= a; } while (a != 0 && count > 0); return index; } /// /// Compares two streams to see if they are binary equals /// /// One stream /// Another stream /// True if the length of the two streams should be compared /// True if they are equal, false otherwise public static bool CompareStreams(System.IO.Stream stream1, System.IO.Stream stream2, bool checkLength) { if (checkLength) { try { if (stream1.Length != stream2.Length) return false; } catch { //We must read along, trying to determine if they are equals } } int longSize = BitConverter.GetBytes((long)0).Length; byte[] buf1 = new byte[longSize * 512]; byte[] buf2 = new byte[buf1.Length]; int a1, a2; while ((a1 = ForceStreamRead(stream1, buf1, buf1.Length)) == (a2 = ForceStreamRead(stream2, buf2, buf2.Length))) { int ix = 0; for(int i = 0; i < a1 / longSize; i++) if (BitConverter.ToUInt64(buf1, ix) != BitConverter.ToUInt64(buf2, ix)) return false; else ix += longSize; for(int i = 0; i < a1 % longSize; i++) if (buf1[ix] != buf2[ix]) return false; else ix++; if (a1 == 0) break; } return a1 == a2; } /// /// Calculates the hash of a given file, and returns the results as an base64 encoded string /// /// The path to the file to calculate the hash for /// The base64 encoded hash public static string CalculateHash(string path) { using(System.IO.FileStream fs = System.IO.File.Open(path, System.IO.FileMode.Open, System.IO.FileAccess.Read, System.IO.FileShare.Read)) return CalculateHash(fs); } /// /// Calculates the hash of a given stream, and returns the results as an base64 encoded string /// /// The stream to calculate the hash for /// The base64 encoded hash public static string CalculateHash(System.IO.Stream stream) { return Convert.ToBase64String(System.Security.Cryptography.HashAlgorithm.Create(HashAlgorithm).ComputeHash(stream)); } /// /// Reads a file, attempts to detect encoding /// /// The path to the file to read /// The file contents public static string ReadFileWithDefaultEncoding(string filename) { // Since StreamReader defaults to UTF8 and most text files will NOT be UTF8 without BOM, // we need to detect the encoding (at least that it's not UTF8). // So we read the first 4096 bytes and try to decode them as UTF8. byte[] buffer = new byte[4096]; using(System.IO.FileStream file = new System.IO.FileStream(filename, System.IO.FileMode.Open)) file.Read(buffer, 0, 4096); Encoding enc = Encoding.UTF8; try { // this will throw an error if not really UTF8 new UTF8Encoding(false, true).GetString(buffer); } catch (Exception) { enc = Encoding.Default; } // This will load the text using the BOM, or the detected encoding if no BOM. using(System.IO.StreamReader reader = new System.IO.StreamReader(filename, enc, true)) { // Remove all \r from the file and split on \n, then pass directly to ExtractOptions return reader.ReadToEnd(); } } /// /// Formats a size into a human readable format, eg. 2048 becomes "2 KB". /// /// The size to format /// A human readable string representing the size public static string FormatSizeString(long size) { if (size >= 1024 * 1024 * 1024 * 1024L) return string.Format(Strings.Utility.FormatStringTB, (double)size / (1024 * 1024 * 1024 * 1024L)); else if (size >= 1024 * 1024 * 1024) return string.Format(Strings.Utility.FormatStringGB, (double)size / (1024 * 1024 * 1024)); else if (size >= 1024 * 1024) return string.Format(Strings.Utility.FormatStringMB, (double)size / (1024 * 1024)); else if (size >= 1024) return string.Format(Strings.Utility.FormatStringKB, (double)size / 1024); else return string.Format(Strings.Utility.FormatStringB, size); } public static System.Threading.ThreadPriority ParsePriority(string value) { if (string.IsNullOrEmpty(value) || value.Trim().Length == 0) return System.Threading.ThreadPriority.Normal; switch (value.ToLower().Trim()) { case "+2": case "high": case "highest": return System.Threading.ThreadPriority.Highest; case "+1": case "abovenormal": case "above normal": return System.Threading.ThreadPriority.AboveNormal; case "-1": case "belownormal": case "below normal": return System.Threading.ThreadPriority.BelowNormal; case "-2": case "low": case "lowest": case "idle": return System.Threading.ThreadPriority.Lowest; default: return System.Threading.ThreadPriority.Normal; } } /// /// Parses a string into a boolean value /// /// The value to parse /// The default value, in case the string is not a valid boolean value /// The parsed value or the default value public static bool ParseBool(string value, bool @default) { if (value == null) value = ""; switch (value.Trim().ToLower()) { case "1": case "on": case "true": case "yes": return true; case "0": case "off": case "false": case "no": return false; default: return @default; } } /// /// Parses an option from the option set, using the convention that if the option is set, it is true unless it parses to false, and false otherwise /// /// The set of options to look for the setting in /// The value to look for in the settings /// public static bool ParseBoolOption(IDictionary options, string value) { string opt; if (options.TryGetValue(value, out opt)) return ParseBool(opt, true); else return false; } /// /// A helper for converting byte arrays to hex, vice versa /// private const string HEX_DIGITS_UPPER = "0123456789ABCDEF"; /// /// Converts the byte array to hex digits /// /// The data to convert /// The data as a string of hex digits public static string ByteArrayAsHexString(byte[] data) { if (data == null || data.Length == 0) return ""; StringBuilder sb = new StringBuilder(); foreach(byte b in data) { sb.Append(HEX_DIGITS_UPPER[(b >> 4) & 0xF]); sb.Append(HEX_DIGITS_UPPER[b & 0xF]); } return sb.ToString(); } /// /// Converts the given hex string into a byte array /// /// The hex string /// A pre-allocated output data array, or null /// The byte array public static byte[] HexStringAsByteArray(string hex, byte[] data = null) { if (string.IsNullOrEmpty(hex)) return new byte[0]; hex = hex.Trim().ToUpper(); if (hex.Length % 2 != 0) throw new Exception(Strings.Utility.InvalidHexStringLengthError); if (data == null) data = new byte[hex.Length / 2]; else if (data.Length < hex.Length / 2) throw new ArgumentOutOfRangeException("data"); for(int i = 0; i < hex.Length; i+= 2) { int upper = HEX_DIGITS_UPPER.IndexOf(hex[i]); int lower = HEX_DIGITS_UPPER.IndexOf(hex[i + 1]); if (upper < 0) throw new Exception(string.Format(Strings.Utility.InvalidHexDigitError, hex[i])); if (lower < 0) throw new Exception(string.Format(Strings.Utility.InvalidHexDigitError, hex[i + 1])); data[i % 2] = (byte)((upper << 4) | lower); } return data; } private static string UNAME; /// /// Gets or sets a value indicating if the client is running OSX /// public static bool IsClientOSX { get { if (!IsClientLinux) return false; try { if (UNAME == null) { var psi = new System.Diagnostics.ProcessStartInfo("uname"); psi.RedirectStandardOutput = true; psi.UseShellExecute = false; var pi = System.Diagnostics.Process.Start(psi); pi.WaitForExit(5000); if (pi.HasExited) UNAME = pi.StandardOutput.ReadToEnd().Trim(); } } catch { } return "Darwin".Equals(UNAME); } } /// /// Gets the output of "uname -a" on Linux, or null on Windows /// public static string UnameAll { get { if (!IsClientLinux) return null; try { var psi = new System.Diagnostics.ProcessStartInfo("uname", "-a"); psi.RedirectStandardOutput = true; psi.UseShellExecute = false; var pi = System.Diagnostics.Process.Start(psi); pi.WaitForExit(5000); if (pi.HasExited) return pi.StandardOutput.ReadToEnd().Trim(); } catch { } return null; } } /// /// Gets or sets a value indicating if the client is Linux/Unix based /// public static bool IsClientLinux { get { #if __MonoCS__ if (Environment.OSVersion.Platform == PlatformID.Unix || (int)Environment.OSVersion.Platform == 6) return true; #else if (Environment.OSVersion.Platform == PlatformID.Unix || Environment.OSVersion.Platform == PlatformID.MacOSX) return true; #endif return false; } } /// /// Returns a value indicating if the filesystem, is case sensitive /// public static bool IsFSCaseSensitive { get { //TODO: This should probably be determined by filesystem rather than OS, // OSX can actually have the disks formated as Case Sensitive, but insensitive is default return IsClientLinux && !IsClientOSX; } } /// /// Returns a value indicating if the app is running under Mono /// public static bool IsMono { get { return Type.GetType("Mono.Runtime") != null; } } /// /// Gets the current Mono runtime version, will return 0.0 if not running Mono /// public static Version MonoVersion { get { try { var v = MonoDisplayVersion; if (v != null) { var regex = new System.Text.RegularExpressions.Regex(@"\d+\.\d+(\.\d+)?(\.\d+)?"); var match = regex.Match(v); if (match.Success) return new Version(match.Value); } } catch { } return new Version(); } } /// /// Gets the Mono display version, or null if not running Mono /// public static string MonoDisplayVersion { get { try { Type t = Type.GetType("Mono.Runtime"); if (t != null) { System.Reflection.MethodInfo mi = t.GetMethod("GetDisplayName", System.Reflection.BindingFlags.Static | System.Reflection.BindingFlags.NonPublic); if (mi != null) return (string)mi.Invoke(null, null); } } catch { } return null; } } /// /// Gets the users default UI language /// public static System.Globalization.CultureInfo DefaultCulture { get { System.Threading.Thread t = new System.Threading.Thread(new System.Threading.ThreadStart(DummyMethod)); return t.CurrentUICulture; } } //Unused function, used to create a dummy thread private static void DummyMethod() { } /// /// Gets a string comparer that matches the client filesystems case sensitivity /// public static StringComparer ClientFilenameStringComparer { get { return Utility.IsFSCaseSensitive ? StringComparer.CurrentCulture : StringComparer.CurrentCultureIgnoreCase; } } /// /// Gets the string comparision that matches the client filesystems case sensitivity /// public static StringComparison ClientFilenameStringComparision { get { return Utility.IsFSCaseSensitive ? StringComparison.CurrentCulture : StringComparison.CurrentCultureIgnoreCase; } } /// /// Searches the system paths for the file specified /// /// The file to locate /// The full path to the file, or null if the file was not found public static string LocateFileInSystemPath(string filename) { try { if (System.IO.Path.IsPathRooted(filename)) return System.IO.File.Exists(filename) ? filename : null; try { filename = System.IO.Path.GetFileName(filename); } catch { } string homedir = System.IO.Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location) + System.IO.Path.PathSeparator.ToString(); //Look in application base folder and all system path folders foreach(string s in (homedir + Environment.GetEnvironmentVariable("PATH")).Split(System.IO.Path.PathSeparator)) if (!string.IsNullOrEmpty(s) && s.Trim().Length > 0) try { foreach(string sx in System.IO.Directory.GetFiles(Environment.ExpandEnvironmentVariables(s), filename)) return sx; } catch { } } catch { } return null; } /// /// Checks that a hostname is valid /// /// The hostname to verify /// True if the hostname is valid, false otherwise public static bool IsValidHostname(string hostname) { try { return System.Uri.CheckHostName(hostname) != UriHostNameType.Unknown; } catch { return false; } } /// /// Returns a string representation of a in UTC format /// /// The instance /// A string representing the time public static string SerializeDateTime(DateTime dt) { //Note: Actually the K should be Z which is more correct as it is forced to be Z, but Z as a format specifier is fairly undocumented return dt.ToUniversalTime().ToString("yyyyMMdd'T'HHmmssK"); } /// /// Parses a serialized instance /// /// The string to parse /// The parsed instance public static DateTime DeserializeDateTime(string str) { DateTime dt; if (!DateTime.TryParseExact(str, "yyyyMMdd'T'HHmmssK", null, System.Globalization.DateTimeStyles.AssumeUniversal, out dt)) throw new Exception(string.Format(Strings.Utility.InvalidDateError, str)); return dt; } /// /// Helper method that replaces one file with another /// /// The file to replace /// The file to replace with public static void ReplaceFile(string target, string sourcefile) { if (System.IO.File.Exists(target)) System.IO.File.Delete(target); //Nasty workaround for the fact that a recently deleted file occasionally blocks a new write long i = 5; do { try { System.IO.File.Move(sourcefile, target); break; } catch (Exception ex) { if (i == 0) throw new Exception(string.Format("Failed to replace the file \"{0}\" volume with the \"{1}\", error: {2}", target, sourcefile, ex.Message)); System.Threading.Thread.Sleep(250); } } while (i-- > 0); } // // Returns the entry assembly or reasonable approximation if no entry assembly is available. // This is the case in NUnit tests. The following approach does not work w/ Mono due to unimplemented members: // http://social.msdn.microsoft.com/Forums/nb-NO/clr/thread/db44fe1a-3bb4-41d4-a0e0-f3021f30e56f // so this layer of indirection is necessary // // entry assembly or reasonable approximation public static System.Reflection.Assembly getEntryAssembly() { return System.Reflection.Assembly.GetEntryAssembly() ?? System.Reflection.Assembly.GetExecutingAssembly(); } /// /// Converts a Base64 encoded string to "base64 for url" /// See https://en.wikipedia.org/wiki/Base64#URL_applications /// /// The base64 encoded string /// The base64 for url encoded string public static string Base64PlainToBase64Url(string data) { return data.Replace('+', '-').Replace('/', '_'); } /// /// Converts a "base64 for url" encoded string to a Base64 encoded string. /// See https://en.wikipedia.org/wiki/Base64#URL_applications /// /// The base64 for url encoded string /// The base64 encoded string public static string Base64UrlToBase64Plain(string data) { return data.Replace('-', '+').Replace('_', '/'); } /// /// Encodes a byte array into a "base64 for url" encoded string. /// See https://en.wikipedia.org/wiki/Base64#URL_applications /// /// The data to encode /// The base64 for url encoded string public static string Base64UrlEncode(byte[] data) { return Base64PlainToBase64Url(Convert.ToBase64String(data)); } /// /// Decodes a "base64 for url" encoded string into the raw byte array. /// See https://en.wikipedia.org/wiki/Base64#URL_applications /// /// The data to decode /// The raw data public static byte[] Base64UrlDecode(string data) { return Convert.FromBase64String(Base64UrlToBase64Plain(data)); } /// /// Prints the object to a stream, which can be used for display or logging /// /// The serialized object /// The object to serialize public static void PrintSerializeObject(object item, System.IO.TextWriter writer, Func filter = null) { foreach(var p in item.GetType().GetProperties()) { if (filter != null && !filter(p)) continue; if (p.PropertyType.IsPrimitive || p.PropertyType == typeof(string)) { writer.WriteLine("{0}: {1}", p.Name, p.GetValue(item, null)); } else if (typeof(System.Collections.IEnumerable).IsAssignableFrom(p.PropertyType)) { var enumerable = (System.Collections.IEnumerable)p.GetValue(item, null); if (enumerable != null) { var enumerator = enumerable.GetEnumerator(); if (enumerator != null) { writer.Write("{0}: [", p.Name); if (enumerator.MoveNext()) { writer.Write(enumerator.Current); while (enumerator.MoveNext()) { writer.Write(", "); writer.Write(enumerator.Current); } } writer.WriteLine("]"); } } } } writer.Flush(); } /// /// Returns a string representing the object, which can be used for display or logging /// /// The serialized object /// The object to serialize public static StringBuilder PrintSerializeObject(object item, StringBuilder sb = null, Func filter = null) { sb = sb ?? new StringBuilder(); using(var sw = new System.IO.StringWriter(sb)) PrintSerializeObject(item, sw); return sb; } /// /// Repeatedly hash a value with a salt. /// This effectively masks the original value, /// and destroys lookup methods, like rainbow tables /// /// The data to hash /// The salt to apply /// The number of times to repeat the hashing /// The salted hash public static byte[] RepeatedHashWithSalt(string data, string salt, int repeats = 1200) { return RepeatedHashWithSalt( System.Text.Encoding.UTF8.GetBytes(data ?? ""), System.Text.Encoding.UTF8.GetBytes(salt ?? ""), repeats); } /// /// Repeatedly hash a value with a salt. /// This effectively masks the original value, /// and destroys lookup methods, like rainbow tables /// /// The data to hash /// The salt to apply /// The salted hash public static byte[] RepeatedHashWithSalt(byte[] data, byte[] salt, int repeats = 1200) { // We avoid storing the passphrase directly, // instead we salt and rehash repeatedly using(var h = System.Security.Cryptography.SHA256.Create()) { h.Initialize(); h.TransformBlock(salt, 0, salt.Length, salt, 0); h.TransformFinalBlock(data, 0, data.Length); var buf = h.Hash; for(var i = 0; i < repeats; i++) { h.Initialize(); h.TransformBlock(salt, 0, salt.Length, salt, 0); h.TransformFinalBlock(buf, 0, buf.Length); buf = h.Hash; } return buf; } } } }