Added readme; Added LICENSE notes;

Author: hidegh

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 by Bal�zs HIDEGH�TY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

NPOI.Extensions.sln

@@ -7,7 +7,13 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NPOI.Extensions", "NPOI.Ext
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NPOI.Extensions.XUnitTest", "NPOI.Extensions.Tests\NPOI.Extensions.XUnitTest.csproj", "{26500AE4-4542-4CD9-9311-643B12A9573B}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NPOI.Extensions.Samples", "NPOI.Extensions.Samples\NPOI.Extensions.Samples.csproj", "{25A62B77-F2E9-4942-AA0D-DF5CDABED4E0}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NPOI.Extensions.Samples", "NPOI.Extensions.Samples\NPOI.Extensions.Samples.csproj", "{25A62B77-F2E9-4942-AA0D-DF5CDABED4E0}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "root", "root", "{7C91185C-55C9-48AF-A655-10C7A1265A36}"
+	ProjectSection(SolutionItems) = preProject
+		LICENSE = LICENSE
+		readme.md = readme.md
+	EndProjectSection
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

NPOI.Extensions/GetValueExtensions.cs

@@ -35,7 +35,7 @@ public static T GetValue<T>(this IRow row, int columnIndex)
                 var formatter = new DataFormatter();
                 var formattedValue = formatter.FormatCellValue(cell);
 
-                // replace non-breakign space with regular space
+                // replace non-breakign space with regular space (nbsp were uses with numeric formatting)
                 formattedValue = formattedValue.Replace(Convert.ToChar(160), ' ');
 
                 return (T) (object) formattedValue;

NPOI.Extensions/Utils/TypeUtilsExtensions.cs

@@ -7,6 +7,7 @@ namespace NPOI.Extensions.Utils
     /// <summary>
     /// Original implementation from TypeUtils.cs (ILSpy);
     /// Some methods were changed to extension methods;
+    /// Some additional functions were introduced;
     /// </summary>
     public static class TypeUtilsExtensions
     {

notes.txt

@@ -0,0 +1,2 @@
+https://resources.whitesourcesoftware.com/blog-whitesource/open-source-licenses-explained
+https://snyk.io/blog/mit-apache-bsd-fairest-of-them-all/

readme.md

@@ -0,0 +1,42 @@
+# NPOI.Extensions
+This package is an extension to the https://github.com/tonyqus/npoi, as I found reading excel values with the basic interface a bit cumbersome.
+
+> On my pet projects I used less flexible helper functions for reading excel cell values. They always adressed just the needs of a given use-case and were not tested for flexibility and corner-case cenarios.
+
+**My goal with this library is to have a stable, reliable, simple (unified) way to read values from excel cell.**
+To ensure this, project includes unit tests for the GetValue extension method, covering most of the situations a developer might need in an enterprise solution.
+
+
+## This library currently
+
+- **simplifies & unifies reading cell values into typed variables**
+- adds support to **map a sheet into a typed list** - *simple approach with 100% control over the mapping*
+
+*NOTE:*
+
+There's also a project (https://github.com/donnytian/Npoi.Mapper) which addresses mapping sheet to typed list, which requires a major change in the Map and ShouldMap function to be more widely usable (see: https://github.com/donnytian/Npoi.Mapper/issues/45).
+
+## Major extension functions
+
+**public T GetValue<T>(this IRow, index)**
+- **unifies access to cell value regardless of it's type**
+- allows to read into a typed output variable in a simple way
+- does a **safe null/blank cell access**, is able to map cell value (being it null or not) to Nullable&lt;&gt; types
+- allows to **read any cell as a formatted string** (the formatted content - that is shown inside the excel cell - is returned as a string)
+- handles reading of **formula results** into typed variable (we usually are interested in the result, not in the formula)
+
+---
+**public List<T> MapTo<T>(this ISheet sheet, bool firstRowIsHeader, Func<ExcelRowMapper, T> rowMapper)**
+- **simplifies mapping the excel content into a typed list**
+- the rowMapperFunction allows to **get cell content by column header (title)**: rowMapper.GetValue&lt;DateTime&gt;("Order Date")
+
+
+## Getting started
+
+There's a **sample project** (and sample excel workbooks) for the mappign extensions, where also the GetValue<T> is used.
+
+The **XUnitTest** for the GetValueExtensions contains tests for all the functionality the GetValue<T> is intended to support.
+
+## License
+https://opensource.org/licenses/MIT, Copyright (c) 2020 by Balázs HIDEGHÉTY
+