Where is the doc/spec for the `task` object that gets provided to `CallbackModule#v2_playbook_on_task`_start in callback plugins?

Archives Ansible Project
1

Developing a callback plugin and need to recognize when a particular task come through. I did some Google’n but didn’t find anything…

I’m guessing it’s an instance of Task from lib/ansible/playbook/task.py?

Does Ansible have API docs? From looking at the source there doesn’t seem to be much in there to generate them off…

2

There are some docs on developing callback plugins, but not a lot, and nothing that dives into
the API: http://docs.ansible.com/ansible/latest/dev_guide/developing_plugins.html#callback-plugins

The callback API is a little bit fuzzy. The callback names and method signatures are pretty stable, but the internals of the objects

passed in (like the Task) aren’t really documented and don’t really guarantee API stability.

For v2_on_task_start (https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/callback/init.py#L339) the ‘task’ arg there is an instance of

an ansible.playbook.task.Task (https://github.com/ansible/ansible/blob/devel/lib/ansible/playbook/task.py#L49)

3

Yup, I found / figured out all those guys. Thanks anyways though.

Yeah… so… callback names and method signatures are pretty stable, just not the arguments they’re called with.

What’s in a Task? I don’t know. You don’t know. Hell, maybe no one knows.