|
1 | 1 | # DeepConvert |
2 | 2 |
|
3 | | -Converts a data type to another data type, including collections and their items. With special support for DateTime conversions. |
| 3 | +Converts a data type to another data type, smarter than the standard Convert class, including collections and their items as well as object properties (duck typing). |
| 4 | +With special support for DateTime conversions. |
4 | 5 |
|
5 | 6 | [](https://www.nuget.org/packages/Unclassified.DeepConvert) |
6 | 7 |
|
7 | 8 | Supports **.NET Standard 2.0** and **.NET Framework 4.5**. |
8 | 9 |
|
9 | 10 | ## Description |
10 | 11 |
|
11 | | -The `System.Convert` class provides methods to convert values from one type into another. This is restricted to the `IConvertible` interface which mainly covers basic numeric types and a few more like boolean, string or DateTime. Its efforts in trying to convert more obscure are very limited. Collections of values are completely unsupported by that class. |
| 12 | +The `System.Convert` class provides methods to convert values from one type into another. |
| 13 | +This is restricted to the `IConvertible` interface which mainly covers basic numeric types and a few more like boolean, string or DateTime. |
| 14 | +Its efforts in trying more complex conversions are very limited. |
| 15 | +Collections of values are completely unsupported by that class. |
12 | 16 |
|
13 | | -Serialisation and deserialisation libraries provide data in a very specific structure that may not match the program’s requirements. Converting an array of integer values into a list of long values or the like often require manual copy implementations. It gets even more complicated when mapping a dictionary with objects to one with strings, or even a flat list with key/value pairs to a dictionary. |
| 17 | +Serialisation and deserialisation libraries provide data in a very specific structure that may not match the program’s requirements. |
| 18 | +Converting an array of integer values into a list of long values or the like often require manual copy implementations. |
| 19 | +It gets even more complicated when mapping a dictionary with objects to one with strings, or even a flat list with key/value pairs to a dictionary. |
14 | 20 |
|
15 | | -The `DeepConvert` class solves all these problems by supporting a larger number of basic data types and many collections thereof. Its special tricks include understanding localised boolean values and extended parsing and converting of time-based values. This also allows conversions between .NET ticks, UNIX timestamp seconds or JavaScript timestamp milliseconds. |
| 21 | +The `DeepConvert` class solves all these problems by supporting a larger number of basic data types and many collections thereof. |
| 22 | +Its special tricks include understanding localised boolean values and extended parsing and converting of time-based values. |
| 23 | +This also allows conversions between .NET ticks, UNIX timestamp seconds or JavaScript timestamp milliseconds. |
16 | 24 |
|
17 | 25 | ## Tests |
18 | 26 |
|
19 | | -This library is covered by some unit tests but has no near full code coverage yet. The unit tests can be used to get an overview of supported conversions until a more detailed documentation is available. |
| 27 | +This library is covered by some unit tests but has no near full code coverage yet. |
| 28 | +The unit tests can be used to get an overview of supported conversions until a more detailed documentation is available. |
| 29 | +It should also be easy to follow the IntelliSense documentation of static method lists and parameter descriptions. |
20 | 30 |
|
21 | 31 | ## License |
22 | 32 |
|
|
0 commit comments