<commit_before>Start and Step
======================

.. contents:: Topics

This shows a few special ways to run playbooks, very useful for testing and debugging.


.. _start_at_task

Start-at-task
`````````````
.. versionadded:: 1.2

If you want to start executing your playbook at a particular task, you can do so
with the ``--start-at`` option::

    ansible-playbook playbook.yml --start-at="install packages"

The above will start executing your playbook at a task named "install packages".


.. _step

Step
````
.. versionadded:: 1.1


Playbooks can also be executed interactively with ``--step``::

    ansible-playbook playbook.yml --step

This will cause ansible to stop on each task, and ask if it should execute that task.<commit_msg>removed version added info, too old to matter small rephrasing for clarification<commit_after>Start and Step
======================

This shows a few alternative ways to run playbooks. These modes are very useful for testing new plays or debugging.


.. _start_at_task

Start-at-task
`````````````
If you want to start executing your playbook at a particular task, you can do so with the ``--start-at`` option::

    ansible-playbook playbook.yml --start-at="install packages"

The above will start executing your playbook at a task named "install packages".


.. _step

Step
````

Playbooks can also be executed interactively with ``--step``::

    ansible-playbook playbook.yml --step

This will cause ansible to stop on each task, and ask if it should execute that task.
{'fraction_non_alphanumeric': 0.12187088274044795, 'fraction_numerical': 0.002635046113306983, 'mean_word_length': 3.9640522875816995, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6421550', 'n_tokens_mistral': 441, 'n_tokens_neox': 407, 'n_words': 195}