Skip to content

Conversation

@justin-f-perez
Copy link
Contributor

resolves #3445

@justin-f-perez
Copy link
Contributor Author

justin-f-perez commented Feb 15, 2022

A few notes:
This PR assumes ansible-lint was removed from molecule altogether as a dependency so users who would like it need to install it separately.

The changes in setup.cfg and the init command are the important ones. The setup.cfg comment is the one that led me to believe pip install molecule[lint] (or even pip install molecule) would give me ansible-lint too. The change to init command corrects a documentation bug.

The rest of the changes below I would consider 'optional', and am happy to remove any or all of them.

in docs/configuration.rst I changed 'is' to 'was' to clarify that this code is not literally reused from ansible-lint in the sense that it's a dependency, but rather that it was copied

For the docs, I updated in the 3 places I thought most relevant:

  1. someone installing molecule (could be a newbie, could be a vet with a foggy memory regarding extras)
  2. someone just getting started for the first time
  3. someone updating their lint config

@ssbarnea ssbarnea added the bug label Feb 22, 2022

.. code-block:: bash
$ python3 -m pip install --user "molecule[lint] ansible-lint"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove lint extra from here, it is used only internally.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahh... maybe this is where all of the confusion originally stems from? The current documentation instructs users to install via:

$ python3 -m pip install --user "molecule[lint]"

If I understand correctly, molecule[lint] shouldn't be referenced in the user documentation at all. Is this correct? If so, I'll double check that there are no other references to it in the user docs and fix them all in this PR.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You are right, that's mostly for internal use. There are no direct imports from molecule itself to any stuff inside lint exta.

* The :ref:`lint` command. Molecule can call external commands to ensure
that best practices are encouraged.
that best practices are encouraged. Note: `ansible-lint` is not included with
molecule or molecule[lint].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove mention of extra.

@ssbarnea ssbarnea merged commit 3b09ce5 into ansible:main Feb 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

remnants of ansible-lint in molecule docs

2 participants