Armory examples browser / github actions

[tong]

I've created a small web application for browsing the armory_examples and armory_templates:

• Application: https://disktree.net/app/armory_examples_browser/
• Source: https://github.com/tong/armory_examples_browser

Since we can now build armory projects from the command line using blenders background mode, i've automated the example build process using a haxe script. … but also created a github actions package to be used in the examples/templates repositories themselves, building all projects and pushing the results of the html5 target to gh-pages.

• Github actions package: https://github.com/tong/armory_gh_actions

The examples browser doesn't use the package for now, but has it's own config, since there are issues with the armory addon activation.

Anyhow, the intention for this is to automate the testing process of the armory project (and armory projects), make things break, measure build times, probably generate some fancy stats … ideas welcome!

[MoritzBrueckner]

This is awesome! We should definitely add some build tests to the Armory repository, or at least to the armsdk repo (if the tests are too slow and shouldn't run too often because of that). Examples and templates are probably one of the first things people new to Armory will see, and the first impression counts. If examples don't work, chances are high that people will go away again pretty fast so fixing the examples should have high priority.

Also, we should maybe add some regression tests for some issues to make sure that the fixed bug remains fixed in future versions. A while ago I started to build a small local test system that built some example files from various issues and later tested the generated output file for some conditions (e.g. some objects shouldn't occur twice which was the case in the original issue). But I don't know if there are license restrictions on files uploaded in Github issues, so it should be better to create minimal examples. However this is quite some work.

Build time stats would also be pretty cool to have, this would make it much easier to see if a certain commit made the build times slower. This would be a great step towards #870 (there is also #864 for unit tests).

@tong It could be a good idea to add a link to the examples browser to the wiki :)

@luboslenco Slightly offtopic regarding the linked issues above: there still exists the "2020" project on this repository which could potentially confuse a bit and might send the message that nobody is actively working on Armory. Should this be renamed to 2021? Should there be a new project/no project at all? There are a few issues in this project that probably aren't on this year's agenda for anyone involved in Armory development, so it might make sense to "replan" it a bit. Maybe you have some thoughts about it :)

[tong]

@luboslenco May we transfer the armory_gh_actions repository to the armory3d organization ?
I think it's the place to be for publishing it to the github marketplace.

[luboslenco]

Happy to take it in, thanks!

[tong]

I get: You don’t have the permission to create public repositories on armory3d
Maybe just clone it and add it manually.

[tong]

@luboslenco Do you want to transfer the armory_examples_browser (repo) too?
And/Or publish it at armory3d.org?

Personally i would like to have the features mentioned above too, but since my time is limited to work on this it might be a good idea to make visible what already exists (?).

[luboslenco]

Added a fork now, would be cool to publish it at armory3d.org as well.

[tong]

@luboslenco Can you please activate gh-pages for the forked repo?
I don't have permissions todo that.
An actual build is already here: https://github.com/armory3d/armory_examples_browser/tree/gh-pages

[luboslenco]

Done!

[tong]

Thanks! Works:
https://armory3d.github.io/armory_examples_browser/
Do you add it yourself to armory3d.org?

[tong]

It seems i don't have rights to publish armory_gh_actions to the marketplace, only have a Draft a release button.

@luboslenco can you check if you can publish it.

[luboslenco]

👍 👍 https://github.com/marketplace/actions/armory3d-setup