zip

Author: ignatandrei

v2/book/examples/Aigamo.MatchGenerator.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Transform enums into tagged unions -with error in Match !
+Generates exhaustive Match() extension methods for enums and abstract record hierarchies (tagged unions), ensuring compile-time safety — all cases must be handled.How to use 1. Add [GenerateMatch] attribute to an enum or abstract record: [GenerateMatch] public enum CarTypes { None, Dacia, Tesla, BMW, Mercedes } [GenerateMatch] abstract record MaritalStatus; sealed record Single : MaritalStatus; sealed record Married : MaritalStatus; 2. Use the generated .Match() method — all cases required (compile error if any missing): var msg = car.Match(     onBMW: () =&gt; &quot;this is bmw&quot;,     onDacia: () =&gt; &quot;this is dacia&quot;,     onMercedes: () =&gt; &quot;this is mercedes&quot;,     onNone: () =&gt; &quot;this is none&quot;,     onTesla: () =&gt; &quot;this is tesla&quot; );You can use for  Transforming enums/records into exhaustive pattern matching (discriminated unions style). If a case is missing in Match(), it&#x27;s a compile-time error
 
 <h2>
     How to use

v2/book/examples/AssemblyMetadata.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generate date time based metadata for assemblies.
+ Generates compile-time assembly metadata constants (build date, year, time, etc.) — access build info as typed properties without runtime reflection.How to use1. Add the package as an Analyzer (no runtime reference needed):```xml&lt;PackageReference Include=&quot;AssemblyMetadata&quot; Version=&quot;2.0.16&quot; PrivateAssets=&quot;all&quot;       OutputItemType=&quot;Analyzer&quot; ReferenceOutputAssembly=&quot;false&quot; /&gt;```2. Use the generated AssemblyMetadataInfo class directly:```csharpConsole.WriteLine(BenjaminAbt.AssemblyMetadata.AssemblyMetadataInfo.BuildInfo.BuildDateYear);```You can use for  Embedding build date/time metadata into assemblies as compile-time constants — useful for version screens, diagnostics, or &#x27;built on&#x27; display info without runtime I/O or reflection.
 
 <h2>
     How to use

v2/book/examples/Maestria.TypeProviders.html

@@ -0,0 +1,80 @@
+
+<h1>RSCG nr 267 :  Maestria.TypeProviders</h1>
+
+<h2>Info</h2>
+Nuget : <a href="https://www.nuget.org/packages/Maestria.TypeProviders/" target="_blank">https://www.nuget.org/packages/Maestria.TypeProviders/</a>
+
+<p>You can find more details at : <a href="https://github.com/MaestriaNet/TypeProviders" target="_blank"> https://github.com/MaestriaNet/TypeProviders</a></p>
+
+<p>Author :Fábio Monteiro Naspolini</p>
+
+<p>Source: <a href="https://github.com/MaestriaNet/TypeProviders" target="_blank">https://github.com/MaestriaNet/TypeProviders</a> </p>
+
+<h2>About</h2>
+
+Generating strong typed code from Excel.
+
+<h2>
+    How to use
+</h2>
+<h3>
+    Add reference to the  <a href="https://www.nuget.org/packages/Maestria.TypeProviders/" target="_blank">Maestria.TypeProviders</a> in the csproj
+</h3>
+<img src="images/Maestria.TypeProviders/DemoExcel.csproj.png" width="580" height="580" />
+
+<h3>This was for me the <b>starting</b> code</h3>
+
+        <br />
+        I have <b>coded</b> the file Program.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/csFiles/Program.cs.png" width="580" height="580" />
+    <hr />
+    
+        <br />
+        I have <b>coded</b> the file MyExcelPerson.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/csFiles/MyExcelPerson.cs.png" width="580" height="580" />
+    <hr />
+    
+        <br />
+        I have <b>coded</b> the file Person.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/csFiles/Person.cs.png" width="580" height="580" />
+    <hr />
+    <h3>And here are the <i>generated</i> files</h3>
+
+        <br />
+        The file <i>generated</i> is DemoExcel.MyExcelPerson.g.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/generated/DemoExcel.MyExcelPerson.g.cs.png" width="580" height="580" />
+    
+        <br />
+        The file <i>generated</i> is ExcelExtensions.g.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/generated/ExcelExtensions.g.cs.png" width="580" height="580" />
+    
+        <br />
+        The file <i>generated</i> is ExcelGeneratorException.g.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/generated/ExcelGeneratorException.g.cs.png" width="580" height="580" />
+    
+        <br />
+        The file <i>generated</i> is ExcelProviderAttribute.g.cs
+        <br />
+    <img src="images/Maestria.TypeProviders/generated/ExcelProviderAttribute.g.cs.png" width="580" height="580" />
+    
+<p>
+    You can download the code and this page as pdf from
+    <a target="_blank" href='https://ignatandrei.github.io/RSCG_Examples/v2/docs/Maestria.TypeProviders'>
+        https://ignatandrei.github.io/RSCG_Examples/v2/docs/Maestria.TypeProviders
+    </a>
+</p>
+
+
+<p>
+    You can see the whole list at 
+    <a target="_blank" href='https://ignatandrei.github.io/RSCG_Examples/v2/docs/List-of-RSCG'>
+        https://ignatandrei.github.io/RSCG_Examples/v2/docs/List-of-RSCG
+    </a>
+</p>
+

v2/book/examples/NLog.Extensions.ThisClass.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generate the NLog register for a class.
+ Generates a strongly-typed NLog Logger property per class at compile time — no manual LogManager.GetCurrentClassLogger() boilerplate.How to use 1. Mark a partial class with [ClassLoggerLazy]:```charp [ClassLoggerLazy] partial class Person {     public string Name()     {         Logger.Error(&quot;This is an error message from the Name method.&quot;);         return $&quot;{FirstName} {LastName}&quot;;     } }``` 2. The generated Logger is lazily initialized and scoped to the class — use it directly:```charp var person = new Person { FirstName = &quot;Andrei&quot;, LastName = &quot;Ignat&quot; }; Console.WriteLine(person.Name()); // logs error, returns &quot;Andrei Ignat&quot;```You can use for  Auto-wiring NLog class loggers at compile time with zero boilerplate.
 
 <h2>
     How to use

v2/book/examples/Najlot.Audit.SourceGenerator.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generating audit code for classes with properties.
+Generates audit/change-tracking code at compile time — detects which properties changed between two snapshots of an object. How to use   1. Mark your entity and a partial provider with [AuditProvider]:```charp   [AuditProvider]   public partial class Person   {       public string FirstName { get; set; } = string.Empty;       public string LastName { get; set; } = string.Empty;       public int Id { get; set; }   }      [AuditProvider]   public partial class PersonAuditProvider   {       [AuditIgnore(nameof(Person.Id))]              public static partial IEnumerable&lt;PropertyValue&gt; GetPropertyValues(Person entity);   }```   2. Take a snapshot, mutate, then get changes:```charp   var audit = new Audit();   audit.RegisterProvider&lt;PersonAuditProvider&gt;();   var snapshot = audit.CreateSnapshot(p);      p.LastName = &quot;Ignat&quot;;      foreach (var change in snapshot.GetChanges())       Console.WriteLine($&quot;{change.Path}: {change.OldValue} → {change.NewValue}&quot;);```  You can use for  Property-level change tracking / audit logs at compile time.   Supports [AuditIgnore] to exclude properties.
 
 <h2>
     How to use

v2/book/examples/Pekspro.DataAnnotationValuesExtractor.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generating code to extract values from data annotations in C#.
+ Generates typed constants from DataAnnotations attributes ([Range], [StringLength], [Required], [Display]) at compile time — no reflection needed to read annotation values.How to use 1. Decorate your model with standard DataAnnotations:```charp partial class Person {     [Display(Name = &quot;First name&quot;)]     [StringLength(100, MinimumLength = 3)]     public string? FirstName { get; set; }      [Range(18, 200)]     public int Age { get; set; } }``` 2. Declare a partial extractor class targeting the model:```charp [DataAnnotationValuesOptions(StringLength = true, Range = true, Required = true, Display = true)] [DataAnnotationValuesToGenerate(typeof(Person))] partial class Values { }``` 3. Access generated constants:```charp Console.WriteLine(Person.Annotations.Age.Minimum);             // 18 Console.WriteLine(Person.Annotations.FirstName.MinimumLength); // 3 Console.WriteLine(Person.Annotations.FirstName.MaximumLength); // 100```You can use for  Reusing DataAnnotation constraint values (min/max lengths, ranges) in UI or validation logicwithout duplicating magic numbers or using reflection.
 
 <h2>
     How to use

v2/book/examples/REslava.ResultFlow.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Functional Code as Mermaid diagrams
+ Generates Mermaid flowchart diagrams at compile time from fluent Result pipeline methods — visualize functional code flows as diagrams runtime overhead.How to use 1. Decorate a fluent Result method with [ResultFlow]:```charp [REslava.ResultFlow.ResultFlow] public static Result&lt;int&gt; GetValueFromConsole() {     return Result&lt;string&gt;.Ok(value)         .Ensure(s =&gt; !string.IsNullOrWhiteSpace(s), new Error(&quot;Input cannot be empty&quot;))         .Map(s =&gt; s.ToUpper())         .Tap(s =&gt; Console.WriteLine($&quot;Processed: {s}&quot;))         .Ensure(s =&gt; int.TryParse(s, out _), new Error(&quot;Input must be a valid integer&quot;))         .Map(s =&gt; int.Parse(s)); }``` 2. Access the generated Mermaid diagram as a compile-time const string:```charp Console.WriteLine(Generated.ResultFlow.Helpers_Flows.GetValueFromConsole); // outputs a Mermaid flowchart of the pipeline```You can use for  Auto-generating up-to-date Mermaid pipeline diagrams from functional Result code at compile time — ideal for documentation, design reviews, or visualizing complex flows without manual diagram maintenance.
 
 <h2>
     How to use

v2/book/examples/SvgIconGenerator.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generating classes from SVG icons to be used in C# projects.
+ Generates strongly-typed C# classes from SVG icon files at compile time — access SVG icons as typed properties with no runtime file I/O.How to use1. Add SVG files as AdditionalFiles in .csproj:```xml  &lt;ItemGroup&gt;      &lt;AdditionalFiles Include=&quot;Icons/*.svg&quot; /&gt;  &lt;/ItemGroup&gt;```  3. Declare a partial static class with [GenerateIcons]:```charp  [GenerateIcons()]  internal static partial class MyIcons;```  3. Access icons as typed members (one per SVG file):```charp  Console.WriteLine(MyIcons.Circle.Name);        // &quot;Circle&quot;  Console.WriteLine(MyIcons.Rect.InnerContent);  // SVG inner XML``` You can use for  Embedding SVG icons as compile-time constants with typed access — no file paths, no reflection, no runtime loading.
 
 <h2>
     How to use

v2/book/examples/TaggedEnum.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generate dictionary from enumAlso retrieved enum by value or name.And an extension method JSON serializer for enum.
+ Generates dictionary-based lookup, fast string conversion, and name/value retrieval for enums with custom data tags — like tagged unions for enums.How to use1. Decorate with Tagged and attach Data to each member:```csharp[Tagged]public enum CarTypes{    [Data(&quot;this is none&quot;)]    None,    [Data(&quot;this is dacia&quot;)]   Dacia,    [Data(&quot;this is bmw&quot;)]     BMW,    [Data(&quot;this is mercedes&quot;)]Mercedes,}```2 Use generated extensions:```charpCarTypes.None.ToStringFast();  // &quot;None&quot;CarTypes.None.Data;            // &quot;this is none&quot;EnumDemoCarTypesExtension.TryGetValueByName(&quot;None&quot;, out _); // true```You can use for  Fast ToString() without reflection, attaching metadata to enum values via [Data], name-based lookup, and JSON serializer extensions for enums.
 
 <h2>
     How to use

v2/book/examples/TypedPaths.html

@@ -12,7 +12,7 @@ <h2>Info</h2>
 
 <h2>About</h2>
 
-Generating strongly-typed paths for file system operations in C# projects.
+ Turns a folder tree into strongly-typed path constants at compile time — access file/folder paths as typed properties instead of magic strings.How to use 1. Declare which folder to scan in .csproj:```xml &lt;ItemGroup&gt;     &lt;PackageReference Include=&quot;TypedPaths.Generator&quot; Version=&quot;1.3.0&quot; /&gt; &lt;/ItemGroup&gt; &lt;ItemGroup&gt;     &lt;TypedPathsFolder Include=&quot;a&quot; ClassName=&quot;Src&quot; /&gt; &lt;/ItemGroup&gt;``` 2. Access generated typed path constants:```charp Console.WriteLine(TypedPaths.Src.Andrei.Value); // strongly-typed path to the &quot;Andrei&quot; entry under folder &quot;a&quot; (e.g. &quot;a/Andrei&quot; or &quot;a\Andrei&quot; depending on OS)   ```You can use for  Eliminating magic path strings for file system operations — folder/file paths become compile-time constants with IntelliSense and refactoring safety.
 
 <h2>
     How to use