Source Code Generator

[iammukeshm]

It will be nice to have a feature to generate code and further reduce the time taken by a developer.

The scope -

DomainEntities and related configurations
Service Layers
Validators
Generic Specification
Mediatr handlers / Dtos
Controller

All these files should be generated on the basis of a new entity.

Should be under src/Utils/SourceGenerator
with assembly name as FSH.WebApi.SourceGenerator

[frankyjquintero]

Initially snippets could be created
https://code.visualstudio.com/docs/editor/userdefinedsnippets

https://docs.microsoft.com/en-us/visualstudio/ide/code-snippets?view=vs-2022

[CanMehmetK]

@frankyjquintero snippets is nice for many requirement

roslyn-sdk this guy is reflecting whenever your model changed
to avoid boiling ..

as you can see in samples as easy as preparing snipped and in some senarios compile time is faster then written code
roslyn-sdk SourceGenerators samples

[xlogex]

Initially snippets could be created https://code.visualstudio.com/docs/editor/userdefinedsnippets

https://docs.microsoft.com/en-us/visualstudio/ide/code-snippets?view=vs-2022

https://github.com/ivanpaulovich/CleanArchitectureVSCodeSnippets

[12dollar]

I'm so looking forward to that one as I'm pissed writing repeating code over and over again :)

[PedroVentura235]

Hi, as an temporary alternative we can use this : #598

[Stonne]

I Followed the suggestions of Mukesh

Should be under src/Utils/SourceGenerator
with assembly name as FSH.WebApi.SourceGenerator

The code is based on the product and brand entities
I used the same approach as I did some years ago so bear with me should the whole thing is well 'not that modern' .
But at the end of the 'run' all the files are created.
After a rerun fullstackhero sets the permissions (as it does now) .

with the new directories in place (and if not completely integrated in fullstackhero)
Add a reference to the Utils project in the host project

in program.cs
Add 'using FSH.WebApi.Utils;'
Add 'builder.Services.AddUtils(builder.Configuration);'
Add 'await app.Services.InitializeGenerateSources();' '

approach :
I transformed the classes to text files.
the entityrelated words are replaced with specific "terms"
With System.IO when creating the files the terms are replaced with the new entityrelated words.
(in i.e. productdto product is replaced with <&Entity&> : <& will not be accepted when creating a new entity )
All these files reside in a subfolder of Sourcegenerator => Basicsources
These text files are based on the brand and product ones (The image in product.cs is left out in the newly created class).
The different classes to generate the sourcefiles reside in SourceGenerator => SourceGeneratorClasses
The main program is GenerateSources
To give developers the opportunity to change foldernames etc There is a settings file called GenerateSourceSettings.cs.
First I had a json file but the sourcesettings.cs was needed anyway so I skipped json and added the settings values directly.

How it works.
After the creation of a new entity (see product.cs or brand.cs) Add a migration, run it and update database.

If you restart the program
If => await app.Services.InitializeGenerateSources(); is commented out in program.cs it does not run
A secondary check is in the generatesourcessettings.cs.

The code will get the entityTypes from EF-Core
and will foreach through the entitylist and check if it is one of the entities in created in FSH.WebApi.Domain.Catalog.
THose are the entities we are interested in.
Then the code will check if the directory for the entity exists in : FSH.WebApi.Application.Catalog
If not the sources are generated.
the permission file is adapted
the controllers are made.

for the validators a validation as in createproductsrequestvalidator is made but commented out so the appropriate fieldname(s) can be copied in and code eventually adapted.

If any alterations are made to an entity and a new migration is run, delete the appropriate entity folder in FSH.WebApi.Application.Catalog.
Restart the program and the altered sourcefiles are made.
the same goes if one of the class code is changed and accordingly a new txtfile is created : delete the contents of the entities folder in FSH.WebApi.Application.Catalog

<&Entity&> : the entity
<&EntityToLower&> : lowercaes entity (could be replaced with <&Entity&>.ToLower()
<&theusings&> : generated usings path
<&EventsPath&> : path to the Event (using <&EventsPath&>)
<&StringNameSpace&> : namespace
<&PropertyLines&> : the properties from the entity in & object
<&RelationalLines&> : the relation in the entity in object
<&DetailLines&> : the detail lines as used in the DTO
<&ReadRepository&> : the repository object
<&validator_name&> : validator name as in the validator code
<&validator_length&>: length as used in the validator code.
<&childEntity&> : name of the child (deletion check for parent)
<&childEntityPLural&>: plural
<&Parent&> : Parent entity
<&ParentToLower&> : Parent to lower

[Stonne]

Code is in my github Repository Name : FSH.WebApi

[Stonne]

Working on some bugs my repository generates some errors in the end result... Sorry

[PedroVentura235]

It looks like a very good start, probbably create a PR, to get more opinions, but nice work

[Stonne]

Thx wIll do so asap. But first I'm still working on the validator stuff (getting close).

[Julianh9]

iammukeshm and @Stonne
This is amazing.
I have used Blazor Hero so far and I am really looking forward to using FSH.
Best regards to you both and thanks for your tireless work.