Initial commit: code migration.

Author: tusmester

.gitattributes

@@ -0,0 +1,63 @@
+###############################################################################
+# Set default behavior to automatically normalize line endings.
+###############################################################################
+* text=auto
+
+###############################################################################
+# Set default behavior for command prompt diff.
+#
+# This is need for earlier builds of msysgit that does not have it on by
+# default for csharp files.
+# Note: This is only used by command line
+###############################################################################
+#*.cs     diff=csharp
+
+###############################################################################
+# Set the merge driver for project and solution files
+#
+# Merging from the command prompt will add diff markers to the files if there
+# are conflicts (Merging from VS is not affected by the settings below, in VS
+# the diff markers are never inserted). Diff markers may cause the following 
+# file extensions to fail to load in VS. An alternative would be to treat
+# these files as binary and thus will always conflict and require user
+# intervention with every merge. To do so, just uncomment the entries below
+###############################################################################
+#*.sln       merge=binary
+#*.csproj    merge=binary
+#*.vbproj    merge=binary
+#*.vcxproj   merge=binary
+#*.vcproj    merge=binary
+#*.dbproj    merge=binary
+#*.fsproj    merge=binary
+#*.lsproj    merge=binary
+#*.wixproj   merge=binary
+#*.modelproj merge=binary
+#*.sqlproj   merge=binary
+#*.wwaproj   merge=binary
+
+###############################################################################
+# behavior for image files
+#
+# image files are treated as binary by default.
+###############################################################################
+#*.jpg   binary
+#*.png   binary
+#*.gif   binary
+
+###############################################################################
+# diff behavior for common document formats
+# 
+# Convert binary document formats to text before diffing them. This feature
+# is only available from the command line. Turn it on by uncommenting the 
+# entries below.
+###############################################################################
+#*.doc   diff=astextplain
+#*.DOC   diff=astextplain
+#*.docx  diff=astextplain
+#*.DOCX  diff=astextplain
+#*.dot   diff=astextplain
+#*.DOT   diff=astextplain
+#*.pdf   diff=astextplain
+#*.PDF   diff=astextplain
+#*.rtf   diff=astextplain
+#*.RTF   diff=astextplain

README.md

@@ -1,2 +1,61 @@
-# sn-tools
-General .Net tools that can be used even in SenseNet-independent projects.
+# SenseNet Tools
+This library contains useful tools for developers ranging from tasks as small as retrying an operation multiple times to a robust trace component.
+
+The library is **independent from SenseNet ECM** and it does not have any SenseNet-related dependencies. It is the other way around: SenseNet ECM relies heavily on the tools published in this library.
+
+You can even use it in your custom project that has nothing to do with SenseNet!
+
+This is a constantly evolving component, we plan to add new features to it as needed. Feel free to contribute or make suggestions on how to improve it!
+
+## Retrier
+This is a lightweight but powerful **API for retrying operations** that should be executed even if some kind of an exception is thrown for the first time.
+
+If no error occurs, the operation will be executed only once of course. After retrying for the given number of times - if the error still occurs - the exception will be thrown for the caller to catch. 
+
+Only trhe provided exception type is monitored and suppressed. All other exceptions are thrown immediately.
+
+````csharp
+// retry something maximum 3 times, waiting 10 milliseconds in between
+Retrier.Retry(3, 10, typeof(InvalidOperationException), () =>
+{
+   // execute something that may throw an invalid operation exception
+   DoSomething();
+});
+
+// retrying an async operation with return value
+var result = await Retrier.RetryAsync<int>(3, 10, async () =>
+{
+   return await DoSomethingAsync();
+},
+(r, i, e) => e == null);
+````
+
+## Diagnostics
+In this namespace you'll find easy-to-use and extendable tracing and logging components. We build on them extensively in the core SenseNet project but they can also be used in any kind of tool or application as a lightweight logging technology.
+
+```csharp
+SnLog.WriteInformation("ContentTypeManager loaded.");
+```
+
+See details [here](src/SenseNet.Tools/Diagnostics/Readme.md).
+
+## Command line arguments
+The classes in this namespace provide an easy way for developers to create **command line tools** that can be invoked with rich command line arguments.
+
+See details [here](src/SenseNet.Tools/Tools/CommandLineArguments/Readme.md).
+
+## Asynchronous ForEach
+This API allows you to **execute an async operation on a list in parallel**, with defining the maximum number of parallel operations. This feature is currently missing from the .Net Framework TPL/PLINQ and is useful when you have to execute a large number of operations but have to prevent resource overload - for example when calling a web service.
+````csharp
+await myList.ForEachAsync(parallelCount, async i =>
+{
+   await DoSomethingAsync();
+})
+````
+
+## TypeResolver
+This is a simple API for loading types from the current app domain or a custom execution directory and creating object instances. Loaded types are cached and can be used in an IoC/DI scenario, or when working with pinned object instances.
+````csharp
+var types = TypeResolver.GetTypesByInterface(typeof(ICustomInterface));
+var dbProvider = TypeResolver.CreateInstance<DbProvider>("MyNamespace.MyDbProvider");
+````