# Python version(s) for custom plugins **URL:** \ **Category:** Get Help\ **Tags:** python, version, plugin\ **Created:** [December 12, 2023, 5:24pm UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872 "2023-12-12T17:24:08Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\ **Post date:** [December 12, 2023, 5:24pm UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872/1 "2023-12-12T17:24:08Z")
On the flip side — that is, from the custom content (plugin) creators’ perspective — and spurred by this discussion: [Maintain Ansible 9 for longer than 6 months](http://forum.ansible.com/t/maintain-ansible-9-for-longer-than-6-months/2574/10), I have a question. Maybe this is more a Python thing than a strictly Ansible thing, but since all my Python code is somehow Ansible related the two are seriously intertwingled in my head. Is there a process, tool, utility, etc. that a plugin creator can use to determine the minimum and maximum versions of Python required to safely run a particular `.py` file? I’m not seriously into the weeds on the differences between various Python versions. My pouring over Python change logs and release notes wouldn’t significantly increase my chances of catching a version related issue in one of my plugins anyway. If there were a tool I could point at a plugin and it would spit out an acceptable version spec, that would go a long way toward solving a problem I’ve simply ignored up until now. A huge bonus would be if such a tool could recommend specific changes, or point to docs about such, to help future-proof such code. I’m not _trying_ to be lazy — it comes naturally! — but life is short, and I’d rather not dedicate more than necessary to a task that a tool could do better and quicker than I could anyway. ---
**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\ **Post date:** [December 13, 2023, 6:27am UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872/2 "2023-12-13T06:27:35Z")
There isn’t a proper way to do that. You can mention in the plugin’s `DOCUMENTATION`’s `requirements` fields which version of Python you support, but that field is not machine-readable, so its more informational for users than anything else. If it’s a collection, you can indirectly do this by restricting the ansible-core version in meta/runtime.yml, which combined with [Releases and maintenance — Ansible Core Documentation](https://docs.ansible.com/ansible-core/devel/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix) restricts the set of Python versions. (It’s not a very precise way to restrict it though…) The only place where you can specify supported Python versions in a machine-readable way is the ansible-test configuration for a collection (template: [http://github.com/ansible/ansible/tree/devel/test/lib/ansible\_test/config/config.yml](http://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/config/config.yml)), which needs to be placed in `tests/config.yml` and restricts the Python version suppoted by modules to a specific set (or simply to `controller`). This only applies to modules, though, you cannot restrict the Python versions for plugins, they are always expected to support all Python versions the controller can run with. The best way is probably to have your plugin covered by unit tests and check for Python deprecation warnings in the `ansible-test units` output. Regarding the main part of your question, I unfortunately don’t have an idea. I hope someone else has 🙂 ---
**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\ **Post date:** [December 13, 2023, 10:48pm UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872/3 "2023-12-13T22:48:32Z")
> [@felixfontein](#): > > The best way is probably to have your plugin covered by unit tests and check for Python deprecation warnings in the `ansible-test units` output. From an Ansible perspective, that’s a reasonable way to go. Thanks. Alas, my “development process” is generously described as in the “hunter-gatherer” stage: snippets of indeterminate vintage code scoured from the internet, blended and tweaked to a purpose. I’d like to hope these tiny bundles of functionality age more like wine than milk for the sake of my teammates who will inherit them. I spent the first years of my career building stuff I thought would last forever. The next twenty were filled with re-implementing and decommissioning all of it. With 40 years in now, I’m not sure how I feel about leaving this stuff for others to ponder. Something that can spit out “Python deprecation warnings” — That’s an attractive prospect indeed. ---
**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\ **Post date:** [April 26, 2026, 4:59pm UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872/4 "2026-04-26T16:59:04Z")
_[In Inspector Clouseau voice: “A few years later…”]_ I just became aware of the [vermin](https://pypi.org/project/vermin/) utility. Point it at a `.py` file and it will report the minimum python version(s) required to run it. For example: ```txt utoddl@tango:~$ vermin --no-tips /home/utoddl/ansible/filter_plugins/int2sexagesimal.py Minimum required versions: 3.7 Incompatible versions: 2.x utoddl@tango:~$ vermin --no-tips /home/utoddl/ansible/filter_plugins/polymac.py Minimum required versions: 2.7, 3.1 ``` There are tons of options; the defaults meet my needs. ---
**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\ **Post date:** [May 26, 2026, 4:59pm UTC](https://forum.ansible.com/t/python-version-s-for-custom-plugins/2872/5 "2026-05-26T16:59:32Z")
This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.