Before doing anything, please read Leapp framework documentation.
See the tutorial for creating the first actor.
Please read documentation about how to unit test actors.
Each actor can now have its own Makefile with the install-deps
target. This
takes care of installing any dependencies of your actor. If your actor has
any dependencies, include them in the Makefile.
See the testing actor's example here.
To install dependencies for all actors, run:
$ make install-deps
To run all tests from leapp-actors, run the following code from
the leapp-actors
directory:
$ make test
It is also possible to generate a report in a JUnit XML format:
$ make test REPORT=report.xml
When you want to execute actor with
$ snactor run my_actor
or run discover feature
$ snactor discover
it is good idea to register everything in repos
to avoid possible errors
with parsing repository metadata (NOTE: these errors can be sometimes
cryptic, but may look like: missing attribute name in .leapp/info
, etc.)
$ make register
where register
target will run snactor repo find --path repos
(you can verify if your repositories are registered in
~/.config/leapp/repos.json
).