francoishill / NETCoreBlockly

.NET Core API to Blockly - generate from WebAPI, Swagger, OData, GraphQL =>

Home Page:https://netcoreblockly.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

NETCore2Blockly

All Contributors

Build Status GitHub license NuGet Generate Thanks Outdated Licenses

What it does

NETCore2Blockly generates Blockly blocks for each of your controller actions.

Demo at https://netcoreblockly.herokuapp.com/ ( play with the links from the bottom)

Demo Video at https://www.youtube.com/watch?v=GptkNWjmCzk

Sample Project is TestBlocklyHtml from this repository

How to install NETCore2Blockly in a .NET Core 3.1 WebAPI / MVC application

Step 1:

Install https://www.nuget.org/packages/NetCore2Blockly/ by running the following command in the Package Manager Console:

Install-Package NetCore2Blockly

Step 2:

Modify Startup.cs by adding

public void ConfigureServices(IServiceCollection services)
        {
            //last line
            services.AddBlockly();
        }
public void Configure(IApplicationBuilder app, IWebHostEnvironment env){
        //if you plan to use as html, do not forget app.UseStaticFiles
        //last line
        app.UseBlockly(); 
}

Step 3:

To see the UI , please add

public void Configure(IApplicationBuilder app, IWebHostEnvironment env){
       
       app.UseBlocklyUI(); // you can customize (with BlocklyUIOptions argument )header name, start blocks, others... 
       //you can add  storage like local storage or sqlite 
       //app.UseBlocklyLocalStorage();
       //app.UseBlocklySqliteStorage() ; // other nuget package
       app.UseBlockly();
}

For Swagger ( local or remote - CORS activated if remote)

app.UseBlocklySwagger("petstore", "https://petstore.swagger.io/v2/swagger.json")

For ODATA ( local or remote - CORS activated if remote)

app.UseBlocklyOData("OdataV4", "https://services.odata.org/TripPinRESTierService/");

For GraphQL (local or remote - CORS activated if remote)- Work In progress

app.UseBlocklyGraphQL("localGraphql", "/graphql");

For authentication

See links 22 for JWT and 31 for Auth0 from https://netcoreblockly.herokuapp.com/

Also, it works with AD enabled - see Authentication group.

Step 4:

Run the application and browse to /blockly.html

That's all!

More information

Download the source code, run the TestBlocklyHtml project ( in the test folder ).

See there

region blockly needed

and

region blockly optional

and follow the code.

All other code is just boilerplate for Swagger, OData,GraphQL that are mandataory for demo'ing the application, not for Blockly2NetCore itself.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

If you want to contribute, that is plenty of work to be done -see issues tab .


Cosmin Popescu

💻

Adrian Nasui

📖

Tudor Iliescu

💻

robertszabobv

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

About

.NET Core API to Blockly - generate from WebAPI, Swagger, OData, GraphQL =>

https://netcoreblockly.herokuapp.com/

License:MIT License


Languages

Language:JavaScript 67.5%Language:C# 20.7%Language:HTML 11.2%Language:CSS 0.4%Language:PowerShell 0.3%Language:Dockerfile 0.1%