Skip to content

ignatandrei/BlocklyAutomation

Repository files navigation

VisualAPI - Add ( to your | inside your ) application LowCode Macros for YOUR API / HTTP Calls

All Contributors

Blockly Automation : is a tool for LowCode / automation of sites (Swagger / OpenAPI / RPA ) and PC made of Blockly.

How to use if you are

a backend developer with an REST / OpenAPI / Swagger enabled site and I want to show the use of my site

Use the appropiate package:

NetCore , made by Andrei Ignat

.NET Core: Nuget

More details at https://github.com/ignatandrei/netcoreblockly/

Java , Full example by Emanuel Ciuca

Java Spring : Maven Central

The Maven is https://central.sonatype.com/artifact/io.github.eciuca.blockly/blockly-automation-starter-webmvc-ui/

The repo with example is https://github.com/eciuca/blockly-automation-starter-webmvc-ui

Node , made by Andrei Ignat

Node: npm

More details at https://github.com/ignatandrei/BlocklyAutomation/wiki/node

PHP , made by Carol Pelu

Packagist : php

More details at https://github.com/Tynael/laravel-blockly-automation

Docker Extension

https://open.docker.com/extensions/marketplace?extensionId=ignatandrei/blockly-automation

Manual

Download the HTML release BlocklyAutomation .

Follow the instructions in the wiki file.

Manual Java , Manual example by Cosmin Popescu

Example by Cosmin Popescu at https://github.com/cosminpopescu14/math-operations-swagger

a frontend developer that finds a bug in a REST / OpenAPI / Swagger enabled site

You want to show to the backend developer how to reproduce the problem .

If you control the site , then you can use the BlocklyAutomation to reproduce the problem.

Follow the instructions in the wiki file.

If you do not control the site, then install the application from http://ba.serviciipeweb.ro/ and then use it to reproduce the problem. ( wiki site coming with details)

a web site application tester

If you control the site , then can use the https://github.com/ignatandrei/BlocklyAutomation/releases/latest/download/releaseBlocklyAutomation.zip/ and then use it to reproduce the problem. ( wiki site coming with details) .

If you does not control the site, then install the application from http://ba.serviciipeweb.ro/ and then use it to make test cases. ( wiki site coming with details)

Please see Docker Extension See

not a programmer. I want to automate/gather data from several sites ( public or private )

You want to obtain some data from the web. For example, extract the exchange between EUR / RON .

Install the application from http://ba.serviciipeweb.ro/ .

Follow the instructions in the wiki file.

not a programmer andI want to automate things on my PC.

You want to obtain some data from your PC. For example, extract and export to CSV the Chrome Bookmarks.

Install the application from http://ba.serviciipeweb.ro/ .

Follow the instructions in the wiki file.

Suggest a public API for BlocklyAutomation

If you have a public API/site that you want to automate, please send file an issue at https://github.com/ignatandrei/BlocklyAutomation/issues

How to see a preview

To see the whole potential , please go to http://ba.serviciipeweb.ro/ and click Launch .

If you want to see some web Demo , please go to https://ignatandrei.github.io/BlocklyAutomation/ and test various HTTP request, Swaggers and more

How to install on your PC

See releases tab

You can find the

  1. Angular site , ready to be deployed to any server
  2. IIS site , ready to be deployed on IIS
  3. A .NET Core site, ready to be deployed on Linux or Windows, standalone ( as a service )

You have a site with OpenAPI / Swagger. What should I do ?

Download from releases tab the Angular site. Put index.html and all other files into a BLocklyAutomation folder inside your wwwroot folder ( or in your project root ) and you are good to go.

  1. It could be an idea to map everything that start with /BlocklyAutomation to /BlocklyAutomation/index.html - see src\Loaders\SimpleSite to have an C# example

  2. Modify assets/settings.json to change the name and the starting blocks

  3. Modify assets/loadAtStartup/swaggers.json to add your swaggers

  4. Modify assets/showUsage/demoBlocks/all.txt to add your demo for the blocks . ( You can construct and then download and save as files)

  5. Send me an email to help you if something is not working.

How to customize

To customize the title , introduction and start blocks , see assets/settings.json

To load swaggers at startup, see assets/loadAtStartup/swaggers.json

To customize demo blocks,download your blocks, put the txt file in assets/showUsage/demoBlocks/ and modify assets/showUsage/demoBlocks/all.txt

How to contribute

If you are a beginner to blockly, see

https://github.com/ignatandrei/BlocklyAutomation/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

GitHub issues by-label

You will be mentioned below ;-)

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Bogdan Bobe

🎨 💻

Adrian Badulescu

💡

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