Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 26 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# RSCG - 249 Examples of Roslyn Source Code Generators / 16 created by Microsoft /
# RSCG - 250 Examples of Roslyn Source Code Generators / 16 created by Microsoft /

The RSCG_Examples repository is a comprehensive documentation system that automatically processes and showcases 249 Roslyn Source Code Generator (RSCG) examples. The system transforms individual RSCG projects into structured documentation with code examples and cross-referenced content with a searchable website and code example exports.
The RSCG_Examples repository is a comprehensive documentation system that automatically processes and showcases 250 Roslyn Source Code Generator (RSCG) examples. The system transforms individual RSCG projects into structured documentation with code examples and cross-referenced content with a searchable website and code example exports.

This system serves as both a learning resource for .NET developers interested in source generators and an automated pipeline for maintaining up-to-date documentation about the RSCG ecosystem

## Latest Update : 2025-12-16 => 16 December 2025
## Latest Update : 2025-12-17 => 17 December 2025

If you want to see examples with code, please click ***[List V2](https://ignatandrei.github.io/RSCG_Examples/v2/docs/List-of-RSCG)***

Expand All @@ -24,8 +24,30 @@ If you want to be notified each time I add a new RSCG example , please click htt

## Content

Those are the 249 Roslyn Source Code Generators that I have tested you can see and download source code example.
Those are the 250 Roslyn Source Code Generators that I have tested you can see and download source code example.
( including 16 from Microsoft )
### 250. [Facet.Search](https://ignatandrei.github.io/RSCG_Examples/v2/docs/Facet.Search) , in the [Database](https://ignatandrei.github.io/RSCG_Examples/v2/docs/rscg-examples#database) category

Generated on : 2025-12-17 => 17 December 2025

<details>
<summary>Expand</summary>



Author: Tim Maes

Compile-time faceted search generation - attributes and source generators

Nuget: [https://www.nuget.org/packages/Facet.Search/](https://www.nuget.org/packages/Facet.Search/)


Link: [https://ignatandrei.github.io/RSCG_Examples/v2/docs/Facet.Search](https://ignatandrei.github.io/RSCG_Examples/v2/docs/Facet.Search)

Source: [https://github.com/Tim-Maes/Facet.Search](https://github.com/Tim-Maes/Facet.Search)

</details>

### 249. [Silhouette](https://ignatandrei.github.io/RSCG_Examples/v2/docs/Silhouette) , in the [Profiler](https://ignatandrei.github.io/RSCG_Examples/v2/docs/rscg-examples#profiler) category

Generated on : 2025-12-16 => 16 December 2025
Expand Down
2 changes: 1 addition & 1 deletion later.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Just later

## Latest Update : 2025-12-16 => 16 December 2025
## Latest Update : 2025-12-17 => 17 December 2025



Expand Down
54 changes: 54 additions & 0 deletions v2/.tours/Facet.Search.tour
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@

{
"$schema": "https://aka.ms/codetour-schema",
"title": "Facet.Search",
"steps":
[
{
"file": "rscg_examples/Facet.Search/src/SearchDemo/SearchDemo.csproj",
"description": "First, we add Nuget [Facet.Search](https://www.nuget.org/packages/Facet.Search/) in csproj ",
"pattern": "Facet.Search"
}

,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/Person.cs",
"description": "File Person.cs ",
"pattern": "this is the code"
}

,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/Program.cs",
"description": "File Program.cs \r\n>> dotnet run --project rscg_examples/Facet.Search/src/SearchDemo/SearchDemo.csproj ",
"pattern": "this is the code"
}


,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/obj/GX/Facet.Search.Generators/Facet.Search.Generators.FacetSearchGenerator/PersonSearchMetadata.g.cs",
"description": "Generated File 4 from 4 : PersonSearchMetadata.g.cs ",
"line": 1
}

,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/obj/GX/Facet.Search.Generators/Facet.Search.Generators.FacetSearchGenerator/PersonSearchFilter.g.cs",
"description": "Generated File 3 from 4 : PersonSearchFilter.g.cs ",
"line": 1
}

,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/obj/GX/Facet.Search.Generators/Facet.Search.Generators.FacetSearchGenerator/PersonSearchExtensions.g.cs",
"description": "Generated File 2 from 4 : PersonSearchExtensions.g.cs ",
"line": 1
}

,{
"file": "rscg_examples/Facet.Search/src/SearchDemo/obj/GX/Facet.Search.Generators/Facet.Search.Generators.FacetSearchGenerator/PersonFacetAggregations.g.cs",
"description": "Generated File 1 from 4 : PersonFacetAggregations.g.cs ",
"line": 1
}

],

"ref": "main"

}
1 change: 1 addition & 0 deletions v2/Generator/all.csv
Original file line number Diff line number Diff line change
Expand Up @@ -248,3 +248,4 @@ Nr,Key,Source,Category
247,BlazorOcticons, https://github.com/BlazorOcticons/BlazorOcticons,Blazor
248,docopt.net, https://github.com/docopt/docopt.net,CommandLine
249,Silhouette, https://github.com/kevingosse/Silhouette,Profiler
250,Facet.Search, https://github.com/Tim-Maes/Facet.Search,Database
6 changes: 6 additions & 0 deletions v2/RSCGExamplesData/GeneratorDataRec.json
Original file line number Diff line number Diff line change
Expand Up @@ -1509,5 +1509,11 @@
"Category": 44,
"dtStart": "2025-12-16T00:00:00",
"show": true
},
{
"ID":"Facet.Search",
"Category": 14,
"dtStart": "2025-12-17T00:00:00",
"show": true
}
]
74 changes: 74 additions & 0 deletions v2/book/examples/Facet.Search.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@

<h1>RSCG nr 250 : Facet.Search</h1>

<h2>Info</h2>
Nuget : <a href="https://www.nuget.org/packages/Facet.Search/" target="_blank">https://www.nuget.org/packages/Facet.Search/</a>

<p>You can find more details at : <a href="https://github.com/Tim-Maes/Facet.Search" target="_blank"> https://github.com/Tim-Maes/Facet.Search</a></p>

<p>Author :Tim Maes</p>

<p>Source: <a href="https://github.com/Tim-Maes/Facet.Search" target="_blank">https://github.com/Tim-Maes/Facet.Search</a> </p>

<h2>About</h2>

Generating search from C# clasess and propertiesIntegrating search in .NET applications
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix typo: "clasess" → "classes".

🔎 Proposed fix
-Generating search from C# clasess and propertiesIntegrating search in .NET applications
+Generating search from C# classes and properties. Integrating search in .NET applications.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Generating search from C# clasess and propertiesIntegrating search in .NET applications
Generating search from C# classes and properties. Integrating search in .NET applications.
🤖 Prompt for AI Agents
In v2/book/examples/Facet.Search.html around line 15, there's a typo: "clasess"
should be "classes"; update the text to read "Generating search from C# classes
and propertiesIntegrating search in .NET applications" (or if intended as two
sentences, add appropriate punctuation/spaces: "Generating search from C#
classes and properties. Integrating search in .NET applications").


<h2>
How to use
</h2>
<h3>
Add reference to the <a href="https://www.nuget.org/packages/Facet.Search/" target="_blank">Facet.Search</a> in the csproj
</h3>
<img src="images/Facet.Search/SearchDemo.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/Facet.Search/csFiles/Program.cs.png" width="580" height="580" />
<hr />

<br />
I have <b>coded</b> the file Person.cs
<br />
<img src="images/Facet.Search/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 PersonFacetAggregations.g.cs
<br />
<img src="images/Facet.Search/generated/PersonFacetAggregations.g.cs.png" width="580" height="580" />

<br />
The file <i>generated</i> is PersonSearchExtensions.g.cs
<br />
<img src="images/Facet.Search/generated/PersonSearchExtensions.g.cs.png" width="580" height="580" />

<br />
The file <i>generated</i> is PersonSearchFilter.g.cs
<br />
<img src="images/Facet.Search/generated/PersonSearchFilter.g.cs.png" width="580" height="580" />

<br />
The file <i>generated</i> is PersonSearchMetadata.g.cs
<br />
<img src="images/Facet.Search/generated/PersonSearchMetadata.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/Facet.Search'>
https://ignatandrei.github.io/RSCG_Examples/v2/docs/Facet.Search
</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>

2 changes: 1 addition & 1 deletion v2/book/examples/RSCG_ExportDiagram.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ <h2>Info</h2>

<p>You can find more details at : <a href="RSCG_ExportDiagram" target="_blank"> RSCG_ExportDiagram</a></p>

<p>Author :AndreiIgnat</p>
<p>Author :Ignat Andrei</p>

<p>Source: <a href="https://github.com/ignatandrei/RSCG_ExportDiagram" target="_blank">https://github.com/ignatandrei/RSCG_ExportDiagram</a> </p>

Expand Down
6 changes: 6 additions & 0 deletions v2/book/examples/Silhouette.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,12 @@ <h3>This was for me the <b>starting</b> code</h3>
I have <b>coded</b> the file Program.cs
<br />
<img src="images/Silhouette/csFiles/Program.cs.png" width="580" height="580" />
<hr />

<br />
I have <b>coded</b> the file MyProfiler.cs
<br />
<img src="images/Silhouette/csFiles/MyProfiler.cs.png" width="580" height="580" />
<hr />
<h3>And here are the <i>generated</i> files</h3>

Expand Down
6 changes: 5 additions & 1 deletion v2/book/list.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
</head>
<body>
<h1>
This is the list of 249 RSCG with examples =>
This is the list of 250 RSCG with examples =>
</h1>

<table >
Expand Down Expand Up @@ -1022,6 +1022,10 @@ <h1>
<td>249</td>
<td><a href="examples/Silhouette.html">Silhouette</a></td>
</tr>
<tr>
<td>250</td>
<td><a href="examples/Facet.Search.html">Facet.Search</a></td>
</tr>
</table>


Expand Down
1 change: 1 addition & 0 deletions v2/book/pandocHTML.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -263,6 +263,7 @@ input-files:
- examples/BlazorOcticons.html
- examples/docopt.net.html
- examples/Silhouette.html
- examples/Facet.Search.html

# or you may use input-file: with a single value
# defaults:
Expand Down
22 changes: 22 additions & 0 deletions v2/rscg_examples/Facet.Search/description.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
{
"generator":{
"name":"Facet.Search",
"nuget":[
"https://www.nuget.org/packages/Facet.Search/"
],
"link":"https://github.com/Tim-Maes/Facet.Search",
"author":"Tim Maes",
"source":"https://github.com/Tim-Maes/Facet.Search"
},
"data":{
"goodFor":["Generating search from C# clasess and properties","Integrating search in .NET applications"],
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix typo: "clasess" → "classes".

There's a typo in the goodFor description.

🔎 Proposed fix
-      "goodFor":["Generating search from C# clasess and properties","Integrating search in .NET applications"],
+      "goodFor":["Generating search from C# classes and properties","Integrating search in .NET applications"],
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
"goodFor":["Generating search from C# clasess and properties","Integrating search in .NET applications"],
"goodFor":["Generating search from C# classes and properties","Integrating search in .NET applications"],
🤖 Prompt for AI Agents
In v2/rscg_examples/Facet.Search/description.json around line 12, the string in
the goodFor array contains a typo: "clasess" should be "classes"; update that
entry to "Generating search from C# classes and properties" (preserve
surrounding punctuation and JSON formatting).

"csprojDemo":"SearchDemo.csproj",
"csFiles":["Program.cs","Person.cs"],
"excludeDirectoryGenerated":[""],
"includeAdditionalFiles":[""]
},
"links":{
"blog":"",
"video":""
}
}
1 change: 1 addition & 0 deletions v2/rscg_examples/Facet.Search/nuget.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Compile-time faceted search generation - attributes and source generators
Loading