CUL Wiki & Documentation Rss Feed

Updated Wiki: Home

JaCraig — Wed, 30 Jan 2013 20:21:41 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

Follow progress of the Next Version
For the next version of CUL, I want you to be able to see what I'm working on and be able to give feedback. In order to help with this, I've set up a board on Trello that will allow you to see the items that I'm currently working on, what's done, and what is still in the planning stages. It should be public and you should have the ability to comment on every card and vote for items (more popular an item is, the more likely I am to push it forward faster). The board itself can be found here: https://trello.com/b/CLOTGldq.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.3.0002 [issue with auto numbering adds the 0002 even though it's actually straight 3.3]). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Version 3.3
Version 3.3 contains a number of changes. In fact if you pull it into an existing project, you may be wondering where everything went. For instance:

The Exchange code has been removed (If you're using the Appointment class, you should use the new AppointmentSender in the Web.Email.SMTP namespace or VCalendar class in the FileFormats namespace).
The Bing, Craigslist, Ebay, Hulu, Netflix, OAuth, OpenID, OpenSearch, and Twitter classes have been removed for different reasons (Mostly because I haven't used them in over a year, they weren't as great as some of the other libraries out there, and some of the formats have changed OAuth and I haven't kept up with it).
Events namespace has been removed and merged into DataTypes (Utilities.DataTypes.EventArgs and Utilities.DataTypes.ExtensionMethods). The Raise functions should now be easier to call as they are simply extension methods now.
Error namespace has been removed. Items from this namespace were moved to other locations (Web received anything based on HttpContext, Request, etc. Reflection received anything based on Assemblies. Environment received anything based on Processes.)
CodeGen namespace has been removed. Items from this namespace have been made more generic and added to the DataTypes namespace in various forms (StringTemplate and FormatString extensions).

On top of that many extension methods and classes have been modified or combined in some way. The big items are Validation, Serialization, and SQLHelper. That said, there are a number of other changes:

Switched ThrowIfTrue and ThrowIfFalse to ThrowIf and ThrowIfNot to be in line, from a naming standpoint, with the other extension methods. (Utilities.DataTypes.ExtensionMethods)
Improved VCalendar code to hold more info.
Switched ORM's Setup function to actually save the generated classes from the AOP (will change the code a bit more so this can be saved as a DLL).
Made AOPManager get rid of its handle on the assembly builder once it's saved (to allow the data to be garbage collected)
Made EmailSender IDisposable so that the attachments and embedded resources can be disposed of properly.
Realized that the profiler is a bit too slow at present and working towards speeding it up.
Trying to speed up SQLHelper a bit more (now faster than BLToolkit, slower than PetaPoco though...)
Fixed IO extensions that took ~ to identify the app's location.
Finished updates to SQLHelper such that batching and MicroORM items are now a part of it.
Changed DbCommand's BeginTransaction to actually store the transaction in the command...
Added ParameterBase class
Created StringParameter and Parameter classes.
Switched DbDataReader extensions to IDataReader.
Modified Database code. It now holds a bit more info and can pull connection string info from the config file.
Updated Database class to hold more information (DbType and Profile) and changed it to be a bit more thread safe (mappings has been changed to ConcurrentDictionary).
Updated SQLHelper a bit more. It now stores database information so connection strings only need to be entered once, Profile info has been moved to the Database object, moved the database type info to the Database object, etc.
Modified AddParameter extension method for DbCommand so that it no longer requires a length (it now uses the length of the value passed in for input parameters and nvarchar(max) for output parameters).
Made DbCommandExtensions a bit more fluent in nature.
Added a check to DirectoryInfo.SetAttributes for a null directory.
Save extension method now takes a FileMode enum to specify how to handle creating/opening the file. (Utilities.IO.ExtensionMethods)
All serialization functions have been condensed down to 4 functions (Serialize,Deserialize,SerializeBinary,DeserializeBinary). These functions now allow you to specify the serializer to use on the fly (so if you want to user JSON.Net, etc., you just need to create the serializer object and feed it into the function). I'm not 100% happy with this and may change in the future. (Utilities.IO.ExtensionMethods)
- To go with this, serializers were created for binary, JSON, SOAP, and XML (more will be created as I go along and I plan to create a library to add external DLLs/libraries also).
Fixed Median extension in Utilities.Math.ExtensionMethods
Modified IObject in the ORM so that it started using new validation namespace.
Modified ObjectBaseClass in the ORM so that it uses the new validation extension methods.
Started updating validation section to use DataAnnotations.
Moved a couple extension methods (Clamp, Min, and Max) from Math to DataTypes. (Utilities.DataTypes.ExtensionMethods)
Switched Median to IEnumerable from List (Utilities.Math.ExtensionMethods)
Moved ASCIIArt, BumpMap, MotionDetection, NormalMap, and OilPainting to extension methods. (Utilities.Media.Image.ExtensionMethods)
Modified cache to use ConcurrentDictionary (should be faster).
Modified Profiler class a bit so that it can track where the item was called from (Class/Method)
Added a profiling option to MicroORM and SQLHelper (off by default)
Simplified profiler a bit. It no longer uses ProfilerManager and is instead all in Profiler class.
Profiler now allows sub items for timing purposes.
Due to people actually asking to help or make changes, I've switched to xUnit.Net for unit testing to make things easier (still getting odd file issues at the moment) and I've switched to using Mighty Moose/AutoTest.Net to help speed up the testing (usually takes 3 minutes each time I run all the tests).
Modified Array extension Combine to allow multiple arrays to specified.
Chain, Do, and Return were all very similar. As such they were combined. Chain is temporarily the function name. It now has a default return value (which is returned if the object or the function are null or the returned value from the function is null) and default object value (which replaces the object prior to running the function if the object is null).
If and NotIf extension was incorrectly returning the default value if the object was null. It now automatically returns null if the predicate is null.
AddRange has been renamed Add and an Extension for Add that takes any number of items as params was added (parameters were reordered for this purpose).
AddIf and AddIfUnique was modified to take any number of items as params (parameters were reordered for this purpose).
RemoveRange was renamed to Remove.
IDictionary's Sort extension has been added that now has the ability to specify how to sort (the default Sort is still available).
A number of IEnumerable extensions were simplified.
Modified FormatString extension. You can now specify a string formatter to be used.
IsNullOrDBNull has been merged into IsNull (IsNull now checks for DBNull).
NullCheck now uses IsNull (and thus will check for null or DBNull).
ThrowIfNullOrDBNull has been removed (use ThrowIfNull instead).
Fixed issue with ManyToOne mappings in the ORM if they are of the same type. Before it was saving to the join table multiple entries for each item without having a decisive parent/child relationship.

So if you're upgrading a project, it may take some time. However if you are starting a new project, the changes should make things a lot easier going forward. There have also been a large number of additions:

Added IsAnagram extension method. (Utilities.DataTypes.ExtensionMethods)
Added Exp, Log, and Log10 extension methods. (Utilities.Math.ExtensionMethods)
Added a number of predicate extension methods that treat them as sets (AddToSet, CartesianProduct, Difference, Intersect, RelativeComplement, RemoveFromSet, and Union). (Utilities.Math.ExtensionMethods)
Added a couple geometry classes (Circle, Rectangle, and Point).
Added version of NullCheck that takes a Func instead of the object (for instances where it may take a while to create the object and/or it may be less likely that the object is null). (Utilities.DataTypes.ExtensionMethods)
Added some ThrowIfNot* type extension methods. (Utilities.DataTypes.ExtensionMethods)
Created a basic SQLCommand class for building SQL commands on the fly (will expand on this in the future).
Added AppointmentSender class to Utilities.Web.SMTP that contains a VCalendar object and can send it using SMTP appropriately.
Added per query caching to SQLHelper
Added PositionOf extension for IEnumerable (Utilities.DataTypes.ExtensionMethods)
Added Enums to ToDbType extension (Utilities.DataTypes.ExtensionMethods)
Added GetOrCreateParameter to DbCommand (Utilities.SQL.ExtensionMethods)
Added SetValue to IDictionary extensions.
Added extension methods that will take a string as the file location and will save/read the corresponding file (instead of using FileInfo). This function also takes into account '~' and maps that to the path for the application/website. So you can do "~/Data/File.txt".Save("Content"); now. (Utilities.IO.ExtensionMethods)
Added GetValue function for IDictionary types. (Utilities.DataTypes.ExtensionMethods)
Added the ability to recursively find all group members in LDAP code and added FindGroup code (based off of cn field).
Finished adding profiling to ORM and simplified creation a bit (will be going further with this to make things as simple as possible).
Finished IsCreditCard extension method for strings (Utilities.DataTypes.ExtensionMethods)
Modified/Added new validation attributes: Cascade, Contains, DoesNotContain, Empty, MaxLength, MinLength, NotEmpty, NotInRange, Compare (which takes the place of Equal, GreaterThan, etc), CompareTo, Is (which is similar to DataType, but can check for valid decimals, integers, credit cards, and domains), and Between.
Finished adding comments to code.
Added ToExpando (converts an object to an ExpandoObject) and version of TryTo that works with ExpandoObjects. (Utilities.DataTypes.ExtensionMethods)
Added extension methods for caching data (allows for caching to multiple ASP.Net locations as well as the cache internal to CUL. Useful if your code may be run from a web app or windows app.) (Utilities.Caching.ExtensionMethods)
Added methods for StackTrace and StackFrame for getting method information a bit easier. (Utilities.Environment.ExtensionMethods)
Added Fraction class to Utilities.Math namespace.
Added Salt extension that can be used to salt a string/byte array. (Utilities.Encryption.ExtensionMethods)
Added Timing related extensions (allows easy timing of Funcs/Actions) (Utilities.Profiler.ExtensionMethods)
Added AppendLineFormat extension for StringBuilder (Utilities.DataTypes.ExtensionMethods)
Added 2 FormatString extensions that can be used to treat a string as a template (one uses an object and replaces the name of the property in the string with the value of the property. The other takes a series of key/value pairs and replaces the values in the string accordingly) (Utilities.DataTypes.ExtensionMethods)
Added IsNotNullOrEmpty extension. (Utilities.DataTypes.ExtensionMethods)
Added various static char predicates, such as IsWhiteSpace (char.IsWhiteSpace) (Utilities.DataTypes.ExtensionMethods)
Added ToString extension for Exceptions. It exports exception text, type, data, stack trace, source, target site, and any/all inner exceptions. (Utilities.DataTypes.ExtensionMethods)
Added StringTemplate class that treats a string as a template (think mail merges, etc) and allows the addition/removal/changing of data between uses. (Utilities.DataTypes)
Added TagDictionary class. This class acts as a dictionary but associates multiple keys with a single object (Think blog post as the object and cloud tags as the key) (Utilities.DataTypes)
Added TaskQueue class. This class is designed to help in producer/consumer situations where actions need to be done in parallel but will arrive in sporadic intervals. (Utilities.DataTypes.Threading)

That concludes the changes in this release. Going forward I will be looking towards MVC specific code, speed increases to existing code, etc.

Updated Wiki: Home

JaCraig — Fri, 18 Jan 2013 19:58:00 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

See Into The Future And Let Your Voice Be Heard
For the next version of CUL, I'm working towards a portable library version of as much code that I can pull over as I can. On top of that, I want you to be able to see what I'm working on and be able to give feedback. In order to help with this, I've set up a board on Trello that will allow you to see the items that I'm currently working on, what's done, and what is still in the planning stages. It should be public and you should have the ability to comment on every card and vote for items (more popular an item is, the more likely I am to push it forward faster). The board itself can be found here: https://trello.com/b/P80lDDnb. I'm starting with the Lite version but if this works out, I will expand this board to be both Lite and Full versions.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.3.0002 [issue with auto numbering adds the 0002 even though it's actually straight 3.3]). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Version 3.3
Version 3.3 contains a number of changes. In fact if you pull it into an existing project, you may be wondering where everything went. For instance:

The Exchange code has been removed (If you're using the Appointment class, you should use the new AppointmentSender in the Web.Email.SMTP namespace or VCalendar class in the FileFormats namespace).
The Bing, Craigslist, Ebay, Hulu, Netflix, OAuth, OpenID, OpenSearch, and Twitter classes have been removed for different reasons (Mostly because I haven't used them in over a year, they weren't as great as some of the other libraries out there, and some of the formats have changed OAuth and I haven't kept up with it).
Events namespace has been removed and merged into DataTypes (Utilities.DataTypes.EventArgs and Utilities.DataTypes.ExtensionMethods). The Raise functions should now be easier to call as they are simply extension methods now.
Error namespace has been removed. Items from this namespace were moved to other locations (Web received anything based on HttpContext, Request, etc. Reflection received anything based on Assemblies. Environment received anything based on Processes.)
CodeGen namespace has been removed. Items from this namespace have been made more generic and added to the DataTypes namespace in various forms (StringTemplate and FormatString extensions).

Switched ThrowIfTrue and ThrowIfFalse to ThrowIf and ThrowIfNot to be in line, from a naming standpoint, with the other extension methods. (Utilities.DataTypes.ExtensionMethods)
Improved VCalendar code to hold more info.
Switched ORM's Setup function to actually save the generated classes from the AOP (will change the code a bit more so this can be saved as a DLL).
Made AOPManager get rid of its handle on the assembly builder once it's saved (to allow the data to be garbage collected)
Made EmailSender IDisposable so that the attachments and embedded resources can be disposed of properly.
Realized that the profiler is a bit too slow at present and working towards speeding it up.
Trying to speed up SQLHelper a bit more (now faster than BLToolkit, slower than PetaPoco though...)
Fixed IO extensions that took ~ to identify the app's location.
Finished updates to SQLHelper such that batching and MicroORM items are now a part of it.
Changed DbCommand's BeginTransaction to actually store the transaction in the command...
Added ParameterBase class
Created StringParameter and Parameter classes.
Switched DbDataReader extensions to IDataReader.
Modified Database code. It now holds a bit more info and can pull connection string info from the config file.
Updated Database class to hold more information (DbType and Profile) and changed it to be a bit more thread safe (mappings has been changed to ConcurrentDictionary).
Updated SQLHelper a bit more. It now stores database information so connection strings only need to be entered once, Profile info has been moved to the Database object, moved the database type info to the Database object, etc.
Modified AddParameter extension method for DbCommand so that it no longer requires a length (it now uses the length of the value passed in for input parameters and nvarchar(max) for output parameters).
Made DbCommandExtensions a bit more fluent in nature.
Added a check to DirectoryInfo.SetAttributes for a null directory.
Save extension method now takes a FileMode enum to specify how to handle creating/opening the file. (Utilities.IO.ExtensionMethods)
All serialization functions have been condensed down to 4 functions (Serialize,Deserialize,SerializeBinary,DeserializeBinary). These functions now allow you to specify the serializer to use on the fly (so if you want to user JSON.Net, etc., you just need to create the serializer object and feed it into the function). I'm not 100% happy with this and may change in the future. (Utilities.IO.ExtensionMethods)
- To go with this, serializers were created for binary, JSON, SOAP, and XML (more will be created as I go along and I plan to create a library to add external DLLs/libraries also).
Fixed Median extension in Utilities.Math.ExtensionMethods
Modified IObject in the ORM so that it started using new validation namespace.
Modified ObjectBaseClass in the ORM so that it uses the new validation extension methods.
Started updating validation section to use DataAnnotations.
Moved a couple extension methods (Clamp, Min, and Max) from Math to DataTypes. (Utilities.DataTypes.ExtensionMethods)
Switched Median to IEnumerable from List (Utilities.Math.ExtensionMethods)
Moved ASCIIArt, BumpMap, MotionDetection, NormalMap, and OilPainting to extension methods. (Utilities.Media.Image.ExtensionMethods)
Modified cache to use ConcurrentDictionary (should be faster).
Modified Profiler class a bit so that it can track where the item was called from (Class/Method)
Added a profiling option to MicroORM and SQLHelper (off by default)
Simplified profiler a bit. It no longer uses ProfilerManager and is instead all in Profiler class.
Profiler now allows sub items for timing purposes.
Due to people actually asking to help or make changes, I've switched to xUnit.Net for unit testing to make things easier (still getting odd file issues at the moment) and I've switched to using Mighty Moose/AutoTest.Net to help speed up the testing (usually takes 3 minutes each time I run all the tests).
Modified Array extension Combine to allow multiple arrays to specified.
Chain, Do, and Return were all very similar. As such they were combined. Chain is temporarily the function name. It now has a default return value (which is returned if the object or the function are null or the returned value from the function is null) and default object value (which replaces the object prior to running the function if the object is null).
If and NotIf extension was incorrectly returning the default value if the object was null. It now automatically returns null if the predicate is null.
AddRange has been renamed Add and an Extension for Add that takes any number of items as params was added (parameters were reordered for this purpose).
AddIf and AddIfUnique was modified to take any number of items as params (parameters were reordered for this purpose).
RemoveRange was renamed to Remove.
IDictionary's Sort extension has been added that now has the ability to specify how to sort (the default Sort is still available).
A number of IEnumerable extensions were simplified.
Modified FormatString extension. You can now specify a string formatter to be used.
IsNullOrDBNull has been merged into IsNull (IsNull now checks for DBNull).
NullCheck now uses IsNull (and thus will check for null or DBNull).
ThrowIfNullOrDBNull has been removed (use ThrowIfNull instead).
Fixed issue with ManyToOne mappings in the ORM if they are of the same type. Before it was saving to the join table multiple entries for each item without having a decisive parent/child relationship.

Added IsAnagram extension method. (Utilities.DataTypes.ExtensionMethods)
Added Exp, Log, and Log10 extension methods. (Utilities.Math.ExtensionMethods)
Added a number of predicate extension methods that treat them as sets (AddToSet, CartesianProduct, Difference, Intersect, RelativeComplement, RemoveFromSet, and Union). (Utilities.Math.ExtensionMethods)
Added a couple geometry classes (Circle, Rectangle, and Point).
Added version of NullCheck that takes a Func instead of the object (for instances where it may take a while to create the object and/or it may be less likely that the object is null). (Utilities.DataTypes.ExtensionMethods)
Added some ThrowIfNot* type extension methods. (Utilities.DataTypes.ExtensionMethods)
Created a basic SQLCommand class for building SQL commands on the fly (will expand on this in the future).
Added AppointmentSender class to Utilities.Web.SMTP that contains a VCalendar object and can send it using SMTP appropriately.
Added per query caching to SQLHelper
Added PositionOf extension for IEnumerable (Utilities.DataTypes.ExtensionMethods)
Added Enums to ToDbType extension (Utilities.DataTypes.ExtensionMethods)
Added GetOrCreateParameter to DbCommand (Utilities.SQL.ExtensionMethods)
Added SetValue to IDictionary extensions.
Added extension methods that will take a string as the file location and will save/read the corresponding file (instead of using FileInfo). This function also takes into account '~' and maps that to the path for the application/website. So you can do "~/Data/File.txt".Save("Content"); now. (Utilities.IO.ExtensionMethods)
Added GetValue function for IDictionary types. (Utilities.DataTypes.ExtensionMethods)
Added the ability to recursively find all group members in LDAP code and added FindGroup code (based off of cn field).
Finished adding profiling to ORM and simplified creation a bit (will be going further with this to make things as simple as possible).
Finished IsCreditCard extension method for strings (Utilities.DataTypes.ExtensionMethods)
Modified/Added new validation attributes: Cascade, Contains, DoesNotContain, Empty, MaxLength, MinLength, NotEmpty, NotInRange, Compare (which takes the place of Equal, GreaterThan, etc), CompareTo, Is (which is similar to DataType, but can check for valid decimals, integers, credit cards, and domains), and Between.
Finished adding comments to code.
Added ToExpando (converts an object to an ExpandoObject) and version of TryTo that works with ExpandoObjects. (Utilities.DataTypes.ExtensionMethods)
Added extension methods for caching data (allows for caching to multiple ASP.Net locations as well as the cache internal to CUL. Useful if your code may be run from a web app or windows app.) (Utilities.Caching.ExtensionMethods)
Added methods for StackTrace and StackFrame for getting method information a bit easier. (Utilities.Environment.ExtensionMethods)
Added Fraction class to Utilities.Math namespace.
Added Salt extension that can be used to salt a string/byte array. (Utilities.Encryption.ExtensionMethods)
Added Timing related extensions (allows easy timing of Funcs/Actions) (Utilities.Profiler.ExtensionMethods)
Added AppendLineFormat extension for StringBuilder (Utilities.DataTypes.ExtensionMethods)
Added 2 FormatString extensions that can be used to treat a string as a template (one uses an object and replaces the name of the property in the string with the value of the property. The other takes a series of key/value pairs and replaces the values in the string accordingly) (Utilities.DataTypes.ExtensionMethods)
Added IsNotNullOrEmpty extension. (Utilities.DataTypes.ExtensionMethods)
Added various static char predicates, such as IsWhiteSpace (char.IsWhiteSpace) (Utilities.DataTypes.ExtensionMethods)
Added ToString extension for Exceptions. It exports exception text, type, data, stack trace, source, target site, and any/all inner exceptions. (Utilities.DataTypes.ExtensionMethods)
Added StringTemplate class that treats a string as a template (think mail merges, etc) and allows the addition/removal/changing of data between uses. (Utilities.DataTypes)
Added TagDictionary class. This class acts as a dictionary but associates multiple keys with a single object (Think blog post as the object and cloud tags as the key) (Utilities.DataTypes)
Added TaskQueue class. This class is designed to help in producer/consumer situations where actions need to be done in parallel but will arrive in sporadic intervals. (Utilities.DataTypes.Threading)

That concludes the changes in this release. Going forward I will be looking towards MVC specific code, speed increases to existing code, etc.

Updated Wiki: Home

JaCraig — Wed, 02 Jan 2013 00:45:38 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. For version 3.0 on up, I've been bored and started looking at Ruby and Python for ideas (I've used Python for scripting in the past and Ruby in a couple of just hacked together fun projects). Basically I took a bunch of their built in functions and classes and built a number of C# equivalents. I plan on doing this with other languages in the future, so if you have any suggestions of languages or standard libraries to look at, let me know.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.3.0002 [issue with auto numbering adds the 0002 even though it's actually straight 3.3]). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Version 3.3
Version 3.3 contains a number of changes. In fact if you pull it into an existing project, you may be wondering where everything went. For instance:

The Exchange code has been removed (If you're using the Appointment class, you should use the new AppointmentSender in the Web.Email.SMTP namespace or VCalendar class in the FileFormats namespace).
The Bing, Craigslist, Ebay, Hulu, Netflix, OAuth, OpenID, OpenSearch, and Twitter classes have been removed for different reasons (Mostly because I haven't used them in over a year, they weren't as great as some of the other libraries out there, and some of the formats have changed OAuth and I haven't kept up with it).
Events namespace has been removed and merged into DataTypes (Utilities.DataTypes.EventArgs and Utilities.DataTypes.ExtensionMethods). The Raise functions should now be easier to call as they are simply extension methods now.
Error namespace has been removed. Items from this namespace were moved to other locations (Web received anything based on HttpContext, Request, etc. Reflection received anything based on Assemblies. Environment received anything based on Processes.)
CodeGen namespace has been removed. Items from this namespace have been made more generic and added to the DataTypes namespace in various forms (StringTemplate and FormatString extensions).

Switched ThrowIfTrue and ThrowIfFalse to ThrowIf and ThrowIfNot to be in line, from a naming standpoint, with the other extension methods. (Utilities.DataTypes.ExtensionMethods)
Improved VCalendar code to hold more info.
Switched ORM's Setup function to actually save the generated classes from the AOP (will change the code a bit more so this can be saved as a DLL).
Made AOPManager get rid of its handle on the assembly builder once it's saved (to allow the data to be garbage collected)
Made EmailSender IDisposable so that the attachments and embedded resources can be disposed of properly.
Realized that the profiler is a bit too slow at present and working towards speeding it up.
Trying to speed up SQLHelper a bit more (now faster than BLToolkit, slower than PetaPoco though...)
Fixed IO extensions that took ~ to identify the app's location.
Finished updates to SQLHelper such that batching and MicroORM items are now a part of it.
Changed DbCommand's BeginTransaction to actually store the transaction in the command...
Added ParameterBase class
Created StringParameter and Parameter classes.
Switched DbDataReader extensions to IDataReader.
Modified Database code. It now holds a bit more info and can pull connection string info from the config file.
Updated Database class to hold more information (DbType and Profile) and changed it to be a bit more thread safe (mappings has been changed to ConcurrentDictionary).
Updated SQLHelper a bit more. It now stores database information so connection strings only need to be entered once, Profile info has been moved to the Database object, moved the database type info to the Database object, etc.
Modified AddParameter extension method for DbCommand so that it no longer requires a length (it now uses the length of the value passed in for input parameters and nvarchar(max) for output parameters).
Made DbCommandExtensions a bit more fluent in nature.
Added a check to DirectoryInfo.SetAttributes for a null directory.
Save extension method now takes a FileMode enum to specify how to handle creating/opening the file. (Utilities.IO.ExtensionMethods)
All serialization functions have been condensed down to 4 functions (Serialize,Deserialize,SerializeBinary,DeserializeBinary). These functions now allow you to specify the serializer to use on the fly (so if you want to user JSON.Net, etc., you just need to create the serializer object and feed it into the function). I'm not 100% happy with this and may change in the future. (Utilities.IO.ExtensionMethods)
- To go with this, serializers were created for binary, JSON, SOAP, and XML (more will be created as I go along and I plan to create a library to add external DLLs/libraries also).
Fixed Median extension in Utilities.Math.ExtensionMethods
Modified IObject in the ORM so that it started using new validation namespace.
Modified ObjectBaseClass in the ORM so that it uses the new validation extension methods.
Started updating validation section to use DataAnnotations.
Moved a couple extension methods (Clamp, Min, and Max) from Math to DataTypes. (Utilities.DataTypes.ExtensionMethods)
Switched Median to IEnumerable from List (Utilities.Math.ExtensionMethods)
Moved ASCIIArt, BumpMap, MotionDetection, NormalMap, and OilPainting to extension methods. (Utilities.Media.Image.ExtensionMethods)
Modified cache to use ConcurrentDictionary (should be faster).
Modified Profiler class a bit so that it can track where the item was called from (Class/Method)
Added a profiling option to MicroORM and SQLHelper (off by default)
Simplified profiler a bit. It no longer uses ProfilerManager and is instead all in Profiler class.
Profiler now allows sub items for timing purposes.
Due to people actually asking to help or make changes, I've switched to xUnit.Net for unit testing to make things easier (still getting odd file issues at the moment) and I've switched to using Mighty Moose/AutoTest.Net to help speed up the testing (usually takes 3 minutes each time I run all the tests).
Modified Array extension Combine to allow multiple arrays to specified.
Chain, Do, and Return were all very similar. As such they were combined. Chain is temporarily the function name. It now has a default return value (which is returned if the object or the function are null or the returned value from the function is null) and default object value (which replaces the object prior to running the function if the object is null).
If and NotIf extension was incorrectly returning the default value if the object was null. It now automatically returns null if the predicate is null.
AddRange has been renamed Add and an Extension for Add that takes any number of items as params was added (parameters were reordered for this purpose).
AddIf and AddIfUnique was modified to take any number of items as params (parameters were reordered for this purpose).
RemoveRange was renamed to Remove.
IDictionary's Sort extension has been added that now has the ability to specify how to sort (the default Sort is still available).
A number of IEnumerable extensions were simplified.
Modified FormatString extension. You can now specify a string formatter to be used.
IsNullOrDBNull has been merged into IsNull (IsNull now checks for DBNull).
NullCheck now uses IsNull (and thus will check for null or DBNull).
ThrowIfNullOrDBNull has been removed (use ThrowIfNull instead).
Fixed issue with ManyToOne mappings in the ORM if they are of the same type. Before it was saving to the join table multiple entries for each item without having a decisive parent/child relationship.

Added IsAnagram extension method. (Utilities.DataTypes.ExtensionMethods)
Added Exp, Log, and Log10 extension methods. (Utilities.Math.ExtensionMethods)
Added a number of predicate extension methods that treat them as sets (AddToSet, CartesianProduct, Difference, Intersect, RelativeComplement, RemoveFromSet, and Union). (Utilities.Math.ExtensionMethods)
Added a couple geometry classes (Circle, Rectangle, and Point).
Added version of NullCheck that takes a Func instead of the object (for instances where it may take a while to create the object and/or it may be less likely that the object is null). (Utilities.DataTypes.ExtensionMethods)
Added some ThrowIfNot* type extension methods. (Utilities.DataTypes.ExtensionMethods)
Created a basic SQLCommand class for building SQL commands on the fly (will expand on this in the future).
Added AppointmentSender class to Utilities.Web.SMTP that contains a VCalendar object and can send it using SMTP appropriately.
Added per query caching to SQLHelper
Added PositionOf extension for IEnumerable (Utilities.DataTypes.ExtensionMethods)
Added Enums to ToDbType extension (Utilities.DataTypes.ExtensionMethods)
Added GetOrCreateParameter to DbCommand (Utilities.SQL.ExtensionMethods)
Added SetValue to IDictionary extensions.
Added extension methods that will take a string as the file location and will save/read the corresponding file (instead of using FileInfo). This function also takes into account '~' and maps that to the path for the application/website. So you can do "~/Data/File.txt".Save("Content"); now. (Utilities.IO.ExtensionMethods)
Added GetValue function for IDictionary types. (Utilities.DataTypes.ExtensionMethods)
Added the ability to recursively find all group members in LDAP code and added FindGroup code (based off of cn field).
Finished adding profiling to ORM and simplified creation a bit (will be going further with this to make things as simple as possible).
Finished IsCreditCard extension method for strings (Utilities.DataTypes.ExtensionMethods)
Modified/Added new validation attributes: Cascade, Contains, DoesNotContain, Empty, MaxLength, MinLength, NotEmpty, NotInRange, Compare (which takes the place of Equal, GreaterThan, etc), CompareTo, Is (which is similar to DataType, but can check for valid decimals, integers, credit cards, and domains), and Between.
Finished adding comments to code.
Added ToExpando (converts an object to an ExpandoObject) and version of TryTo that works with ExpandoObjects. (Utilities.DataTypes.ExtensionMethods)
Added extension methods for caching data (allows for caching to multiple ASP.Net locations as well as the cache internal to CUL. Useful if your code may be run from a web app or windows app.) (Utilities.Caching.ExtensionMethods)
Added methods for StackTrace and StackFrame for getting method information a bit easier. (Utilities.Environment.ExtensionMethods)
Added Fraction class to Utilities.Math namespace.
Added Salt extension that can be used to salt a string/byte array. (Utilities.Encryption.ExtensionMethods)
Added Timing related extensions (allows easy timing of Funcs/Actions) (Utilities.Profiler.ExtensionMethods)
Added AppendLineFormat extension for StringBuilder (Utilities.DataTypes.ExtensionMethods)
Added 2 FormatString extensions that can be used to treat a string as a template (one uses an object and replaces the name of the property in the string with the value of the property. The other takes a series of key/value pairs and replaces the values in the string accordingly) (Utilities.DataTypes.ExtensionMethods)
Added IsNotNullOrEmpty extension. (Utilities.DataTypes.ExtensionMethods)
Added various static char predicates, such as IsWhiteSpace (char.IsWhiteSpace) (Utilities.DataTypes.ExtensionMethods)
Added ToString extension for Exceptions. It exports exception text, type, data, stack trace, source, target site, and any/all inner exceptions. (Utilities.DataTypes.ExtensionMethods)
Added StringTemplate class that treats a string as a template (think mail merges, etc) and allows the addition/removal/changing of data between uses. (Utilities.DataTypes)
Added TagDictionary class. This class acts as a dictionary but associates multiple keys with a single object (Think blog post as the object and cloud tags as the key) (Utilities.DataTypes)
Added TaskQueue class. This class is designed to help in producer/consumer situations where actions need to be done in parallel but will arrive in sporadic intervals. (Utilities.DataTypes.Threading)

That concludes the changes in this release. Going forward I will be looking towards MVC specific code, speed increases to existing code, etc.

Version 3.2 Additions
The largest addition this release is a much more robust randomization set of classes and extension methods. It adds the ability to randomly generate company names, male/female names, cities, states, zip codes, phone numbers, even entire data classes by simply calling either the Next<T>(...) or NextClass<T>(...) extension methods that were added. In fact the Next generic extension method has built in generators for bool, decimal, double, float, byte, char, int, long, sbyte, short, uint, ulong, ushort, DateTime, TimeSpan, Color, and string (with a ton of other string generators). In fact with the new classes and extension methods you can do something like this:

    public class RandomTestClass
    {
        [IntGenerator]
        public int A { get; set; }

        [LoremIpsumGenerator]
        public string B { get; set; }

        [FloatGenerator]
        public float C { get; set; }

        [IntGenerator(1, 100)]
        public int D { get; set; }
    }

And call NextClass and have a newly generated RandomTestClass object given to you.

Past the new randomization classes/extension methods, a number of updates, speed increases, and fixes were implemented on the SQLHelper, MicroORM, and ORM classes. For example, you can now add parameters in batch to the SQLHelper class by simply calling the AddParameter function. (For example if you have "SELECT * FROM Table WHERE ID=@0 and Value=@1" and you used AddParameter(10, "This is a string") then it would put the value 10 in for @0 and "This is a string" for @1 (note that it would do that as a parameter, it doesn't do string concat).

On top of that a number of extensions to make life easier were added, such as Times which will run a function/action the specified number of times, so 100.Times(x=>x) creates a list of integers going from 1 to 100. A RingBuffer class has been added, a Google API class for pulling static maps, added a LevenshteinDistance extension for strings, extension method to convert Dictionary and NameValueCollections classes to query strings, UserIPAddress and IfModifiedSince extension methods for HttpRequest, RelativeTime extension which expresses the difference between a DateTime and some Epoch as a string, updated the BlogML code to allow exporting, added ReadAll and ReadAllBinary extensions for Stream objects, and a number of other items.

New Comment on "Documentation"

JaCraig — Tue, 02 Oct 2012 14:07:33 GMT

Actually I'm slowly going through and beefing up/modifying the code/documentation for this next version. However, what do you mean by background articles? Examples?

New Comment on "Documentation"

remkovanbrakel — Tue, 02 Oct 2012 09:54:17 GMT

First of all I think it is a great library with a lot of use in the field. However in some cases I miss some background information. E.g the encryption extension. I see the properties which I can change, however it would be nice to have some background information. Would it be possible to reference some background articles?

Updated Wiki: List of Features

JaCraig — Sat, 01 Sep 2012 02:32:20 GMT

Craig's Utility Library is one of the largest collections of extension methods and various helper classes out there. It has gotten to the point where if you can think it, it's probably already in there (and if not, put a message on the Issue Tracker and I'll add it when I get bored, which is often). So how much is in there, well let's start with the extension methods:
Utilities.DataTypes.ExtensionMethods

Array extensions
- Clear
- Combine
DateTime extensions
- DaysInMonth
- DaysLeftInMonth
- DaysLeftInYear
- FirstDayOfMonth
- FirstDayOfWeek
- FromUnixTime (actually extension for int and long values)
- IsInFuture
- IsInPast
- IsWeekDay
- IsWeekEnd
- LastDayOfMonth
- LastDayOfWeek
- ToUnix
- FirstDayOfQuarter
- FirstDayOfYear
- LastDayOfQuarter
- LastDayOfYear
- ConvertToTimeZone (assumes that times are in UTC time)
- LocalTimeZone
- AddWeeks
- Age
- BeginningOfDay
- EndOfDay
- IsToday
- SetTime
- UTCOffset
Generic object extensions
- If
- NotIf
- Return
- Chain
- Do
- Execute
- ThrowIfTrue
- ThrowIfFalse
ICollection extensions
- AddAndReturn
- AddRange
- AddIf
- AddIfUnique
- Remove
- RemoveRange
IComparable extensions
- Between
IDictionary extensions
- Sort
- SortByValue
IEnumerable extensions
- Exists
- For
- ForEach
- ForParallel
- ForEachParallel
- IsNullOrEmpty
- RemoveDefaults
- ToArray
- ToString
- TrueForAll
- TryAll
- TryAllParallel
- FalseForAll
- FalseForAny
- TrueForAll
- TrueForAny
- ThrowIfFalseForAll
- ThrowIfFalseForAny
- ThrowIfTrueForAll
- ThrowIfTrueForAny
- ElementsBetween
- First
- Last
- ToDataTable
- ToCSV
- ToDelimitedFile
MatchCollection extensions
- Where
string extensions
- Encode
- FromBase64
- Left
- Right
- ToBase64
- ToByteArray
- ToFirstCharacterUpperCase
- ToSentenceCapitalize
- ToTitleCase
- NumberTimesOccurs
- Reverse
- FilterOutText
- KeepFilterText
- AlphaNumericOnly
- AlphaCharactersOnly
- NumericOnly
- IsUnicode
- FormatString
- RegexFormat
- ExpandTabs
- StripLeft
- StripRight
- Pluralize
- Singularize
- Center
- MaskLeft
- MaskRight
- UrlDecode
- UrlEncode
Various type conversion/type checking extensions
- FormatToString
- IsNotDefault
- IsDefault
- IsNotNull
- IsNull
- IsNotNullOrDBNull
- IsNullOrDBNull
- NullCheck
- ThrowIfDefault
- ThrowIfNullOrEmpty
- ThrowIfNullOrDBNull
- ToSQLDbType
- ToDbType
- ToType
- TryTo
Various value type extensions
- ToBool (int)
- ToInt (bool)
- ToBase64String (byte array)
- ToEncodedString (byte array)
- IsUnicode (byte array)
TimeSpan Extensions
- Years
- Months
- DaysRemainder
DataTable Extensions
- ToList
- ToCSV
- ToDelimitedFile

Utilities.Math.ExtensionMethods

Math extensions
- Between
- Clamp
- Factorial
- Max
- Median
- Min
- Mode
- Pow
- Round
- StandardDeviation
- Sqrt
- Variance
- Permute

Utilities.SQL.ExtensionMethods

DbCommand extensions
- AddParameter
- BeginTransaction
- ClearParameters
- Close
- Commit
- ExecuteDataSet
- ExecuteScalar
- GetOutputParameter
- Open
- Rollback
DbDataReader extensions
- GetParameter

Utilities.Compression.ExtensionMethods

Compress (both byte arrays and strings)
Decompress (both byte arrays and strings)

Utilities.Encryption.ExtensionMethods

Hash (Now handles all hash algorithms in one function for both byte arrays and strings)
Encrypt (Handles any symmetric encryption algorithm inside .Net)
Decrypt (Handles any symmetric encryption algorithm inside .Net)

Utilities.IO.ExtensionMethods

DirectoryInfo extensions
- CopyTo
- DeleteAll
- DeleteFiles
- DeleteFilesNewerThan
- DeleteFilesOlderThan
- Size
- SetAttribute
- DriveInfo
- DeleteDirectoriesNewerThan
- DeleteDirectoriesOlderThan
FileInfo extensions
- Append
- CompareTo
- Read
- ReadBinary
- Save
- SaveAsync
- SetAttributes
- DriveInfo
- Execute
String extensions
- RemoveIllegalDirectoryNameCharacters
- RemoveIllegalFileNameCharacters
Serialization extensions
- ToBinary
- ToJSON
- ToSOAP
- ToXML
- ToObject
- JSONToObject
- SOAPToObject
- XMLToObject
Uri extensions
- Read
- ReadBinary
- Execute

Utilities.Web.ExtensionMethods

Web related extensions
- AbsoluteRoot
- AddScriptFile
- ContainsHTML
- HTTPCompress
- IsEncodingAccepted
- RelativeRoot
- RemoveURLIllegalCharacters
- SetEncoding
- StripHTML
IPAddress extensions
- GetHostName
Minification
- Combine (can be used for HTML,JavaScript, or CSS)
- Minify (can be used for HTML, JavaScript, or CSS)
HttpRequest extensions
- IsMobile

Utilities.Image.ExtensionMethods

All Bitmap functions were moved
- Added ToBase64 extension method
- Added DrawRoundedRectangle extension
Screen extensions
- TakeScreenShot

Utilities.Error.ExtensionMethods

Various error related extensions
- DumpApplicationState
- DumpCache
- DumpCookies
- DumpRequestVariable
- DumpResponseVariable
- DumpServerVars
- DumpSession

Utilities.Reflection.ExtensionMethods

Various reflection related extensions
- CallMethod
- CreateInstance
- DumpProperties
- GetAttribute
- GetAttributes
- GetName
- GetObjects
- GetProperty
- GetPropertyGetter
- GetPropertyName
- GetPropertyType
- GetPropertySetter
- GetTypes
- IsIEnumerable
- IsOfType
- Load
- LoadAssemblies
- MarkedWith
- MakeShallowCopy
- SetProperty
- ToLongVersionString
- ToShortVersionString

Utilities.Environment.ExtensionMethods

Process related extensions
- KillProcessAsync
- GetInformation

On top of that there are a number of helper classes for a number of various tasks including (note that there are actually more, this is what I can remember off the top of my head):

Email
- Pop3 client (SSL capable)
- MIME parser
- SMTP email sending (SSL capable)
- Exchange inbox email retrieval
Image manipulation (one of the larger collections of functions dealing in image manipulation out there)
- Most image functions are multithreaded and thus act extremely quickly.
- Cropping, resizing, rotating, flipping
- To black and white or sepia tone
- Threshold and edge detection (including Sobel and Laplace)
- Text drawing, watermarks, object drawing helpers
- Taking a screenshot which spans monitors
- RGB Histograms
- Various convolution filters such as sharpen, sobel emboss, etc. along with the ability to create your own easily.
- Various other filters such as "jitter", pixelate, sin wave, median filter, and dilation, red/green/blue filters,
- Multiple blurring techniques including box blur, Gaussian blur, Kuwahara, and Symmetric Nearest Neighbor blur
- Bump map and Normal map helpers
- ASCII art generator
- Adjust brightness, gamma, and contrast
Active Directory querying
- Includes functions for active users, all users, all groups, active members in groups, etc.
Exchange querying
- Free/Busy data
- Get next/previous available time for appointments
- Get contacts
- Get appointments/events
- Get emails
- Get the GAL
SQL query helper (which includes bulk copying functionality)
MicroORM
ORM (which includes lazy loading, etc.)
SQL Server structural analysis helpers
File formats/Microformats
- XMDP
- RSS (with iTunes/Zune information embedded for podcasts)
- vCard/hCard
- vCalendar/hCalendar
- iCalendar (with email sending capabilities, cancellation, and automatically putting it in Exchange)
- APML
- OPML
- XFN
- CSV (really any delimited file) with functions to convert it to a list of objects or a DataTable
- RSD
- BlogML
- INI
Cisco phone app helpers
WMI query helpers
Code to render a web page to BMP file
Icon extraction from a file
WebBrowser control cache clearing class
Helper classes for simplifying System.Reflection.Emit namespace
Randomization
- Completely generic, using Next<T>() and NextClass<T>() extensions.
- Has generators for all basic .Net data types (int, long, float, double, DateTime, TimeSpan, Color, etc.)
- Multiple string generators (Ipsum Lorem, company name, male/female names, patterns, phone numbers, zip codes, city names, etc).
- Includes thread safe randomization function.
Environment information
Process management
Error/Information gathering
Math related classes
- Matrix
- Vector3
- Set
- Factorial
- Permutation
Data types
- Vector
- Bag
- List
- ListMapping
- Priority Queue
- BTree
- DateSpan
Base classes for various patterns including
- Singleton
- Factory
OAuth helper class
Code for setting up an OpenID relay
REST helper class
Classes to help with various media services/websites including
- Twitter
- Hulu
- Netflix
- Craigslist
- eBay
Naive Bayes classifier
Validation classes
Caching helper classes
Logging helper classes
Configuration helper classes
AOP helper classes

On top of that I add new code, bug fixes, etc. quite frequently through the code repository.

Updated Wiki: Home

JaCraig — Sat, 01 Sep 2012 02:25:43 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. For version 3.0 on up, I've been bored and started looking at Ruby and Python for ideas (I've used Python for scripting in the past and Ruby in a couple of just hacked together fun projects). Basically I took a bunch of their built in functions and classes and built a number of C# equivalents. I plan on doing this with other languages in the future, so if you have any suggestions of languages or standard libraries to look at, let me know.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.2.0002 [issue with auto numbering adds the 0002 even though it's actually straight 3.2]). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Version 3.2 Additions
The largest addition this release is a much more robust randomization set of classes and extension methods. It adds the ability to randomly generate company names, male/female names, cities, states, zip codes, phone numbers, even entire data classes by simply calling either the Next<T>(...) or NextClass<T>(...) extension methods that were added. In fact the Next generic extension method has built in generators for bool, decimal, double, float, byte, char, int, long, sbyte, short, uint, ulong, ushort, DateTime, TimeSpan, Color, and string (with a ton of other string generators). In fact with the new classes and extension methods you can do something like this:

    public class RandomTestClass
    {
        [IntGenerator]
        public int A { get; set; }

        [LoremIpsumGenerator]
        public string B { get; set; }

        [FloatGenerator]
        public float C { get; set; }

        [IntGenerator(1, 100)]
        public int D { get; set; }
    }

Updated Wiki: Home

JaCraig — Sat, 01 Sep 2012 01:57:01 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. For version 3.0 on up, I've been bored and started looking at Ruby and Python for ideas (I've used Python for scripting in the past and Ruby in a couple of just hacked together fun projects). Basically I took a bunch of their built in functions and classes and built a number of C# equivalents. I plan on doing this with other languages in the future, so if you have any suggestions of languages or standard libraries to look at, let me know.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.2.0002 [issue with auto numbering adds the 0002 even though it's actually straight 3.2]). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Updated Wiki: Home

JaCraig — Sat, 01 Sep 2012 01:56:27 GMT

List of Features

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 4.0 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. For version 3.0 on up, I've been bored and started looking at Ruby and Python for ideas (I've used Python for scripting in the past and Ruby in a couple of just hacked together fun projects). Basically I took a bunch of their built in functions and classes and built a number of C# equivalents. I plan on doing this with other languages in the future, so if you have any suggestions of languages or standard libraries to look at, let me know.

Download
The easiest way to get CUL is to simply use NuGet:

There are also individual DLLs for each namespace available through NuGet. Whenever a new update is added to the library, a nightly build uploads a new version to NuGet. As such you're getting the latest version as soon as possible (or just download version 3.2.0002 issue with auto numbering adds the 0002 even though it's actually straight 3.2). Or if you can't use NuGet or simply aren't a fan, you can still download it here.

Source Code Repository
The repository here is Mercurial. Also note that there are repository mirrors available on Bitbucket and Github: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Updated Wiki: Home

JaCraig — Sat, 01 Sep 2012 01:47:16 GMT

Updated Wiki: Home

JaCraig — Fri, 23 Mar 2012 17:35:36 GMT

Updated Wiki: List of Features

JaCraig — Fri, 23 Mar 2012 17:23:50 GMT

Array extensions
- Clear
- Combine
DateTime extensions
- DaysInMonth
- DaysLeftInMonth
- DaysLeftInYear
- FirstDayOfMonth
- FirstDayOfWeek
- FromUnixTime (actually extension for int and long values)
- IsInFuture
- IsInPast
- IsWeekDay
- IsWeekEnd
- LastDayOfMonth
- LastDayOfWeek
- ToUnix
- FirstDayOfQuarter
- FirstDayOfYear
- LastDayOfQuarter
- LastDayOfYear
- ConvertToTimeZone (assumes that times are in UTC time)
- LocalTimeZone
- AddWeeks
- Age
- BeginningOfDay
- EndOfDay
- IsToday
- SetTime
- UTCOffset
Generic object extensions
- If
- NotIf
- Return
- Chain
- Do
- Execute
- ThrowIfTrue
- ThrowIfFalse
ICollection extensions
- AddAndReturn
- AddRange
- AddIf
- AddIfUnique
- Remove
- RemoveRange
IComparable extensions
- Between
IDictionary extensions
- Sort
- SortByValue
IEnumerable extensions
- Exists
- For
- ForEach
- ForParallel
- ForEachParallel
- IsNullOrEmpty
- RemoveDefaults
- ToArray
- ToString
- TrueForAll
- TryAll
- TryAllParallel
- FalseForAll
- FalseForAny
- TrueForAll
- TrueForAny
- ThrowIfFalseForAll
- ThrowIfFalseForAny
- ThrowIfTrueForAll
- ThrowIfTrueForAny
- ElementsBetween
- First
- Last
- ToDataTable
- ToCSV
- ToDelimitedFile
MatchCollection extensions
- Where
string extensions
- Encode
- FromBase64
- Left
- Right
- ToBase64
- ToByteArray
- ToFirstCharacterUpperCase
- ToSentenceCapitalize
- ToTitleCase
- NumberTimesOccurs
- Reverse
- FilterOutText
- KeepFilterText
- AlphaNumericOnly
- AlphaCharactersOnly
- NumericOnly
- IsUnicode
- FormatString
- RegexFormat
- ExpandTabs
- StripLeft
- StripRight
- Pluralize
- Singularize
- Center
- MaskLeft
- MaskRight
- UrlDecode
- UrlEncode
Various type conversion/type checking extensions
- FormatToString
- IsNotDefault
- IsDefault
- IsNotNull
- IsNull
- IsNotNullOrDBNull
- IsNullOrDBNull
- NullCheck
- ThrowIfDefault
- ThrowIfNullOrEmpty
- ThrowIfNullOrDBNull
- ToSQLDbType
- ToDbType
- ToType
- TryTo
Various value type extensions
- ToBool (int)
- ToInt (bool)
- ToBase64String (byte array)
- ToEncodedString (byte array)
- IsUnicode (byte array)
TimeSpan Extensions
- Years
- Months
- DaysRemainder
DataTable Extensions
- ToList
- ToCSV
- ToDelimitedFile

Utilities.Math.ExtensionMethods

Math extensions
- Between
- Clamp
- Factorial
- Max
- Median
- Min
- Mode
- Pow
- Round
- StandardDeviation
- Sqrt
- Variance
- Permute

Utilities.SQL.ExtensionMethods

DbCommand extensions
- AddParameter
- BeginTransaction
- ClearParameters
- Close
- Commit
- ExecuteDataSet
- ExecuteScalar
- GetOutputParameter
- Open
- Rollback
DbDataReader extensions
- GetParameter

Utilities.Compression.ExtensionMethods

Compress (both byte arrays and strings)
Decompress (both byte arrays and strings)

Utilities.Encryption.ExtensionMethods

Hash (Now handles all hash algorithms in one function for both byte arrays and strings)
Encrypt (Handles any symmetric encryption algorithm inside .Net)
Decrypt (Handles any symmetric encryption algorithm inside .Net)

Utilities.IO.ExtensionMethods

DirectoryInfo extensions
- CopyTo
- DeleteAll
- DeleteFiles
- DeleteFilesNewerThan
- DeleteFilesOlderThan
- Size
- SetAttribute
- DriveInfo
- DeleteDirectoriesNewerThan
- DeleteDirectoriesOlderThan
FileInfo extensions
- Append
- CompareTo
- Read
- ReadBinary
- Save
- SaveAsync
- SetAttributes
- DriveInfo
- Execute
String extensions
- RemoveIllegalDirectoryNameCharacters
- RemoveIllegalFileNameCharacters
Serialization extensions
- ToBinary
- ToJSON
- ToSOAP
- ToXML
- ToObject
- JSONToObject
- SOAPToObject
- XMLToObject
Uri extensions
- Read
- ReadBinary
- Execute

Utilities.Web.ExtensionMethods

Web related extensions
- AbsoluteRoot
- AddScriptFile
- ContainsHTML
- HTTPCompress
- IsEncodingAccepted
- RelativeRoot
- RemoveURLIllegalCharacters
- SetEncoding
- StripHTML
IPAddress extensions
- GetHostName
Minification
- Combine (can be used for HTML,JavaScript, or CSS)
- Minify (can be used for HTML, JavaScript, or CSS)
HttpRequest extensions
- IsMobile

Utilities.Image.ExtensionMethods

All Bitmap functions were moved
- Added ToBase64 extension method
- Added DrawRoundedRectangle extension
Screen extensions
- TakeScreenShot

Utilities.Error.ExtensionMethods

Various error related extensions
- DumpApplicationState
- DumpCache
- DumpCookies
- DumpRequestVariable
- DumpResponseVariable
- DumpServerVars
- DumpSession

Utilities.Reflection.ExtensionMethods

Various reflection related extensions
- CallMethod
- CreateInstance
- DumpProperties
- GetAttribute
- GetAttributes
- GetName
- GetObjects
- GetProperty
- GetPropertyGetter
- GetPropertyName
- GetPropertyType
- GetPropertySetter
- GetTypes
- IsIEnumerable
- IsOfType
- Load
- LoadAssemblies
- MarkedWith
- MakeShallowCopy
- SetProperty
- ToLongVersionString
- ToShortVersionString

Utilities.Environment.ExtensionMethods

Process related extensions
- KillProcessAsync
- GetInformation

On top of that there are a number of helper classes for a number of various tasks including (note that there are actually more, this is what I can remember off the top of my head):

Email
- Pop3 client (SSL capable)
- MIME parser
- SMTP email sending (SSL capable)
- Exchange inbox email retrieval
Image manipulation (one of the larger collections of functions dealing in image manipulation out there)
- Most image functions are multithreaded and thus act extremely quickly.
- Cropping, resizing, rotating, flipping
- To black and white or sepia tone
- Threshold and edge detection (including Sobel and Laplace)
- Text drawing, watermarks, object drawing helpers
- Taking a screenshot which spans monitors
- RGB Histograms
- Various convolution filters such as sharpen, sobel emboss, etc. along with the ability to create your own easily.
- Various other filters such as "jitter", pixelate, sin wave, median filter, and dilation, red/green/blue filters,
- Multiple blurring techniques including box blur, Gaussian blur, Kuwahara, and Symmetric Nearest Neighbor blur
- Bump map and Normal map helpers
- ASCII art generator
- Adjust brightness, gamma, and contrast
Active Directory querying
- Includes functions for active users, all users, all groups, active members in groups, etc.
Exchange querying
- Free/Busy data
- Get next/previous available time for appointments
- Get contacts
- Get appointments/events
- Get emails
- Get the GAL
SQL query helper (which includes bulk copying functionality)
MicroORM
ORM (which includes lazy loading, etc.)
SQL Server structural analysis helpers
File formats/Microformats
- XMDP
- RSS (with iTunes/Zune information embedded for podcasts)
- vCard/hCard
- vCalendar/hCalendar
- iCalendar (with email sending capabilities, cancellation, and automatically putting it in Exchange)
- APML
- OPML
- XFN
- CSV (really any delimited file) with functions to convert it to a list of objects or a DataTable
- RSD
- BlogML
- INI
Cisco phone app helpers
WMI query helpers
Code to render a web page to BMP file
Icon extraction from a file
WebBrowser control cache clearing class
Helper classes for simplifying System.Reflection.Emit namespace
Randomization
- Including string randomization based on allowable characters, date randomization, Color, Enum, TimeSpan, and Lorem Ipsum generation.
- Includes thread safe randomization function.
Environment information
Process management
Error/Information gathering
Math related classes
- Matrix
- Vector3
- Set
- Factorial
- Permutation
Data types
- Vector
- Bag
- List
- ListMapping
- Priority Queue
- BTree
- DateSpan
Base classes for various patterns including
- Singleton
- Factory
OAuth helper class
Code for setting up an OpenID relay
REST helper class
Classes to help with various media services/websites including
- Twitter
- Hulu
- Netflix
- Craigslist
- eBay
Naive Bayes classifier
Validation classes
Caching helper classes
Logging helper classes
Configuration helper classes
AOP helper classes

On top of that I add new code, bug fixes, etc. quite frequently through the code repository.

New Comment on "List of Features"

reiniero — Sun, 08 Jan 2012 08:20:33 GMT

Awesome list of features. Love the "off the top of my head" remark ;) I'll be sure to have a look whenever I need to code in .Net again...

Updated Wiki: List of Features

JaCraig — Thu, 15 Dec 2011 19:03:06 GMT

Array extensions
- Clear
- Combine
DateTime extensions
- DaysInMonth
- DaysLeftInMonth
- DaysLeftInYear
- FirstDayOfMonth
- FirstDayOfWeek
- FromUnixTime (actually extension for int and long values)
- IsInFuture
- IsInPast
- IsWeekDay
- IsWeekEnd
- LastDayOfMonth
- LastDayOfWeek
- ToUnix
Generic object extensions
- If
- NotIf
- Return
- Chain
- Do
- Execute
ICollection extensions
- AddAndReturn
- AddRange
- AddIf
- AddIfUnique
- Remove
- RemoveRange
IComparable extensions
- Between
IDictionary extensions
- Sort
- SortByValue
IEnumerable extensions
- Exists
- For
- ForEach
- ForParallel
- ForEachParallel
- IsNullOrEmpty
- RemoveDefaults
- ToArray
- ToString
- TrueForAll
- TryAll
- TryAllParallel
MatchCollection extensions
- Where
string extensions
- Encode
- FromBase64
- Left
- Right
- ToBase64
- ToByteArray
- ToFirstCharacterUpperCase
- ToSentenceCapitalize
- ToTitleCase
- NumberTimesOccurs
- Reverse
- FilterOutText
- KeepFilterText
- AlphaNumericOnly
- AlphaCharactersOnly
- NumericOnly
- IsUnicode
- FormatString
- RegexFormat
Various type conversion/type checking extensions
- FormatToString
- IsNotDefault
- IsDefault
- IsNotNull
- IsNull
- IsNotNullOrDBNull
- IsNullOrDBNull
- NullCheck
- ThrowIfDefault
- ThrowIfNullOrEmpty
- ThrowIfNullOrDBNull
- ToSQLDbType
- ToDbType
- ToType
- TryTo
Various value type extensions
- ToBool (int)
- ToInt (bool)
- ToBase64String (byte array)
- ToEncodedString (byte array)
- IsUnicode (byte array)

Utilities.IO.ExtensionMethods

Serialization extensions
- ToBinary
- ToJSON
- ToSOAP
- ToXML
- ToObject
- JSONToObject
- SOAPToObject
- XMLToObject
Uri extensions
- Read
- ReadBinary
Math extensions
- Betweek
- Clamp
- Factorial
- Max
- Median
- Min
- Mode
- Pow
- Round
- StandardDeviation
- Sqrt
- Variance
- Permute

Utilities.SQL.ExtensionMethods

DbCommand extensions
- AddParameter
- BeginTransaction
- ClearParameters
- Close
- Commit
- ExecuteDataSet
- ExecuteScalar
- GetOutputParameter
- Open
- Rollback
DbDataReader extensions
- GetParameter

Utilities.Compression.ExtensionMethods

Compress (both byte arrays and strings)
Decompress (both byte arrays and strings)

Utilities.Encryption.ExtensionMethods

Hash (Now handles all hash algorithms in one function for both byte arrays and strings)
Encrypt (Handles any symmetric encryption algorithm inside .Net)
Decrypt (Handles any symmetric encryption algorithm inside .Net)

Utilities.IO.ExtensionMethods

DirectoryInfo extensions
- CopyTo
- DeleteAll
- DeleteFiles
- DeleteFilesNewerThan
- DeleteFilesOlderThan
- Size
- SetAttribute
FileInfo extensions
- Append
- CompareTo
- Read
- ReadBinary
- Save
- SaveAsync
- SetAttributes
String extensions
- RemoveIllegalDirectoryNameCharacters
- RemoveIllegalFileNameCharacters

Utilities.Web.ExtensionMethods

Web related extensions
- AbsoluteRoot
- AddScriptFile
- ContainsHTML
- HTTPCompress
- IsEncodingAccepted
- RelativeRoot
- RemoveURLIllegalCharacters
- SetEncoding
- StripHTML
IPAddress extensions
- GetHostName
Minification
- Combine (can be used for HTML,JavaScript, or CSS)
- Minify (can be used for HTML, JavaScript, or CSS)
HttpRequest extensions
- IsMobile

Utilities.Image.ExtensionMethods

All Bitmap functions were moved
- Added ToBase64 extension method
- Added DrawRoundedRectangle extension
Screen extensions
- TakeScreenShot

Utilities.Error.ExtensionMethods

Various error related extensions
- DumpApplicationState
- DumpCache
- DumpCookies
- DumpRequestVariable
- DumpResponseVariable
- DumpServerVars
- DumpSession

Utilities.Reflection.ExtensionMethods

Various reflection related extensions
- CallMethod
- CreateInstance
- DumpProperties
- GetAttribute
- GetAttributes
- GetName
- GetObjects
- GetProperty
- GetPropertyGetter
- GetPropertyName
- GetPropertyType
- GetPropertySetter
- GetTypes
- IsIEnumerable
- IsOfType
- Load
- LoadAssemblies
- MarkedWith
- MakeShallowCopy
- SetProperty
- ToLongVersionString
- ToShortVersionString

Utilities.Environment.ExtensionMethods

Process related extensions
- KillProcessAsync
- GetInformation

On top of that there are a number of helper classes for a number of various tasks including (note that there are actually more, this is what I can remember off the top of my head):

Email
- Pop3 client (SSL capable)
- MIME parser
- SMTP email sending (SSL capable)
- Exchange inbox email retrieval
Image manipulation (one of the larger collections of functions dealing in image manipulation out there)
- Cropping, resizing, rotating, flipping
- To black and white or sepia tone
- Threshold and edge detection (including Sobel and Laplace)
- Text drawing, watermarks, object drawing helpers
- Taking a screenshot which spans monitors
- RGB Histograms
- Various convolution filters such as sharpen, sobel emboss, etc. along with the ability to create your own easily.
- Various other filters such as "jitter", pixelate, sin wave, median filter, and dilation, red/green/blue filters,
- Multiple blurring techniques including box blur, Gaussian blur, Kuwahara, and Symmetric Nearest Neighbor blur
- Bump map and Normal map helpers
- ASCII art generator
- Adjust brightness, gamma, and contrast
Active Directory querying
- Includes functions for active users, all users, all groups, active members in groups, etc.
Exchange querying
- Free/Busy data
- Get next/previous available time for appointments
- Get contacts
- Get appointments/events
- Get emails
- Get the GAL
SQL query helper
MicroORM
ORM (which includes lazy loading, etc.)
SQL Server structural analysis helpers
File formats/Microformats
- XMDP
- RSS (with iTunes/Zune information embedded for podcasts)
- vCard/hCard
- vCalendar/hCalendar
- iCalendar (with email sending capabilities, cancellation, and automatically putting it in Exchange)
- APML
- OPML
- XFN
- CSV
- RSD
- BlogML
- INI
Cisco phone app helpers
WMI query helpers
Code to render a web page to BMP file
Icon extraction from a file
WebBrowser control cache clearing class
Helper classes for simplifying System.Reflection.Emit namespace
Randomization
- Including string randomization based on allowable characters, date randomization, Color, Enum, TimeSpan, and Lorem Ipsum generation.
Environment information
Process management
Error/Information gathering
Math related classes
- Matrix
- Vector3
- Set
- Factorial
- Permutation
Data types
- Vector
- Bag
- List
- ListMapping
- Priority Queue
- BTree
Base classes for various patterns including
- Singleton
- Factory
OAuth helper class
Code for setting up an OpenID relay
REST helper class
Classes to help with various media services/websites including
- Twitter
- Hulu
- Netflix
- Craigslist
- eBay
Naive Bayes classifier
Validation classes
Caching helper classes
Logging helper classes
Configuration helper classes
AOP helper classes

On top of that I add new code, bug fixes, etc. quite frequently through the code repository.

Updated Wiki: Home

JaCraig — Thu, 15 Dec 2011 18:46:25 GMT

Updated Wiki: Home

JaCraig — Wed, 17 Aug 2011 15:18:22 GMT

List of Features | Road to 3.0

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 3.5 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. Also if you are interested in the future of this project, please look at the Road to 3.0 page.

Source Code Repository
The repository has been updated now to Mercurial. Once again thank you Wade/guy whom I can't remember the name of and I deleted the email so I can't look it up again... Especially you, guy who I can't remember, you rock most of all (in all seriousness, I can't remember your name but thank you). Anyway, to everyone else, feel free to start downloading the changes that have been made since the request went in as I've merged (as best as I can) the changes from the bitbucket/github repositories. Either that or simply use the other repositories if you're already using them: Bitbucket and GitHub repositories. I'll be updating all three with changes as I make them.

Updated Wiki: Home

JaCraig — Wed, 10 Aug 2011 14:23:32 GMT

List of Features | Road to 3.0

Project Description
Craig's Utility Library (or CUL, as in cull because I'm not that creative), was initially designed through a number of projects that I've worked on. Over time I assembled a number of classes to handle various tasks and continue to add a number of items in my spare time. The library is written in C# and uses .Net 3.5 but many of the classes are usable in lower versions. More code can be found on my website: http://www.gutgames.com.

For a list of features, take a look at the List of Features page. Also if you are interested in the future of this project, please look at the Road to 3.0 page.

Source Code Repository
I've put in a couple requests to the people at Codeplex to switch this over to using Mercurial (it's been a little over a month now since the first request). In the mean time, if you want to get the latest updates, please use either the Bitbucket or GitHub repositories. Until the switch is made, I will not be uploading new code in the repository here (However I will still do new releases here as well as NuGet, but hopefully the switch will happen before then).

Updated Wiki: MicroORM Example

JaCraig — Sat, 23 Jul 2011 16:11:30 GMT

Below is a short example of using the MicroORM code:

            Utilities.SQL.MicroORM.MicroORM.Database("YourConnectionString");                       //Sets the default connection string
            Utilities.SQL.MicroORM.MicroORM.Database("YourConnectionString","Database2");           //Sets the connection string. Saving it to Database2.
            Utilities.SQL.MicroORM.MicroORM.Map<MyClass>("Table to map to", "ID")                   //Sets the table name, and tells the mapping that the ID field is the primary key
                .Map(x => x.ID)                                                                     //Maps the ID field
                .Map(x => x.Name, Length: 100)                                                      //Maps the name field, telling the mapping it uses a length of 100
                .Map(x => x.Something, DatabasePropertyName: "someThing", DefaultValue: 10.0f);     //Maps the something field, sets the field name in the database and
                                                                                                    //sets the default value that is returned if the database returns DBNull.
            using (Utilities.SQL.MicroORM.MicroORM ORM = new Utilities.SQL.MicroORM.MicroORM())
            {
                //Loads All
                IEnumerable<MyClass> AllItems = ORM.Map<MyClass>().All();
                
                //Loads All using constraints (Only loads first 10 items [only loading the IDs], sorted by the Name in ascending order, using the ObjectCreator Func to create each item)
                AllItems = ORM.Map<MyClass>().All(Columns: "ID", Limit: 10, OrderBy: "Name ASC", ObjectCreator: () => new MyClass(DateTime.Now));

                //Inserts an item and populates the ID field with the newly created ID (since our primary key is autoincrement)
                foreach (MyClass Item in AllItems)
                    ORM.Map<MyClass>().Insert<int>(Item, new Parameter<string>("Value to send to the database", "NameOfDatabaseField"));

                //Updates an item in the database
                foreach (MyClass Item in AllItems)
                    ORM.Map<MyClass>().Update(Item);

                //Inserts or Updates an item based on a number of criteria (see code comments to see the logic it uses)
                ORM.Map<MyClass>().Save<int>(AllItems);

                //Deletes a list of items from the database
                ORM.Map<MyClass>().Delete(AllItems);
            }

            //Uses the connection string saved at Database2
            using (Utilities.SQL.MicroORM.MicroORM ORM = new Utilities.SQL.MicroORM.MicroORM("Database2"))
            {
                //Can also drop down to straight SQL queries that return datasets, etc.

                //Sets the command
                ORM.Command = "CommandToRun";
                //Sets the command type
                ORM.CommandType = CommandType.StoredProcedure;
                //Adds the parameter to send to the database
                ORM.AddParameter("ParameterName", 2);
                //Executes a read based query
                ORM.ExecuteReader();
                //Goes to the next record
                while (ORM.Read())
                {
                    //Gets the SomeReturnedValue that was returned.
                    string SomeReturnedValue = ORM.GetParameter("SomeReturnedValue", "This is the default value if the database returns DBNull");
                }
            }

Updated Wiki: Documentation

JaCraig — Sat, 23 Jul 2011 16:03:00 GMT

Documentation is included in the main download or can be generated using DOxygen or other documentation generator.

Examples:
MicroORM Example

Updated Wiki: MicroORM Example

JaCraig — Sat, 23 Jul 2011 16:02:29 GMT

Below is a short example of using the MicroORM code:

            Utilities.SQL.MicroORM.MicroORM.Database("YourConnectionString");                       //Sets the default connection string
            Utilities.SQL.MicroORM.MicroORM.Database("YourConnectionString","Database2");           //Sets the connection string. Saving it to Database2.
            Utilities.SQL.MicroORM.MicroORM.Map<MyClass>("Table to map to", "ID")                   //Sets the table name, and tells the mapping that the ID field is the primary key
                .Map(x => x.ID)                                                                     //Maps the ID field
                .Map(x => x.Name, Length: 100)                                                      //Maps the name field, telling the mapping it uses a length of 100
                .Map(x => x.Something, DatabasePropertyName: "someThing", DefaultValue: 10.0f);     //Maps the something field, sets the field name in the database and
                                                                                                    //sets the default value that is returned if the database returns DBNull.
            using (Utilities.SQL.MicroORM.MicroORM ORM = new Utilities.SQL.MicroORM.MicroORM())
            {
                //Loads All
                IEnumerable<MyClass> AllItems = ORM.Map<MyClass>().All();
                
                //Loads All using constraints (Only loads first 10 items [only loading the IDs], sorted by the Name in ascending order, using the ObjectCreator Func to create each item)
                AllItems = ORM.Map<MyClass>().All(Columns: "ID", Limit: 10, OrderBy: "Name ASC", ObjectCreator: () => new MyClass(DateTime.Now));

                //Inserts an item and populates the ID field with the newly created ID (since our primary key is autoincrement)
                foreach (MyClass Item in AllItems)
                    ORM.Map<MyClass>().Insert<int>(Item, new Parameter<string>("Value to send to the database", "NameOfDatabaseField"));

                //Updates an item in the database
                foreach (MyClass Item in AllItems)
                    ORM.Map<MyClass>().Update(Item);

                //Inserts or Updates an item based on a number of criteria (see code comments to see the logic it uses)
                ORM.Map<MyClass>().Save<int>(AllItems);

                //Deletes a list of items from the database
                ORM.Map<MyClass>().Delete(AllItems);
            }

            //Uses the connection string saved at Database2
            using (Utilities.SQL.MicroORM.MicroORM ORM = new Utilities.SQL.MicroORM.MicroORM("Database2"))
            {
                //Sets the command
                ORM.Command = "CommandToRun";
                //Sets the command type
                ORM.CommandType = CommandType.StoredProcedure;
                //Adds the parameter to send to the database
                ORM.AddParameter("ParameterName", 2);
                //Executes a read based query
                ORM.ExecuteReader();
                //Goes to the next record
                while (ORM.Read())
                {
                    //Gets the SomeReturnedValue that was returned.
                    string SomeReturnedValue = ORM.GetParameter("SomeReturnedValue", "This is the default value if the database returns DBNull");
                }
            }