From c3b7fe6ca1a88e1f6348a743fd5481c9b1555d74 Mon Sep 17 00:00:00 2001 From: Alexei Znamensky Date: Tue, 16 Apr 2024 19:34:54 +1200 Subject: [PATCH 1/3] django_manage: improve docs for release 9.0.0 --- plugins/modules/django_manage.py | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/plugins/modules/django_manage.py b/plugins/modules/django_manage.py index d22b7da4ee6..1577288cb6a 100644 --- a/plugins/modules/django_manage.py +++ b/plugins/modules/django_manage.py @@ -34,9 +34,10 @@ - V(loaddata) - Searches for and loads the contents of the named O(fixtures) into the database. - V(migrate) - Synchronizes the database state with models and migrations. - V(test) - Runs tests for all installed apps. - - Other commands can be entered, but will fail if they are unknown to Django. Other commands that may + - Other commands can be entered, but will fail if they are unknown to Django. Other commands that may prompt for user input should be run with the C(--noinput) flag. - Support for the values V(cleanup), V(syncdb), V(validate) was removed in community.general 9.0.0. + See note about supported versions of Django. type: str required: true project_path: @@ -131,13 +132,17 @@ version_added: 5.8.0 notes: + - > + B(ATTENTION): Support for Django releases older than 4.1 has been removed in + community.general version 9.0.0. While the module allows for free-form commands + does not verify the version of Django being used, it is B(strongly recommended) + to use a more recent version of Django. + - Please notice that Django 4.1 requires Python 3.8 or greater. - This module will not create a virtualenv if the O(virtualenv) parameter is specified and a virtual environment does not already exist at the given location. This behavior changed in community.general version 9.0.0. - The recommended way to create a virtual environment in Ansible is by using M(ansible.builtin.pip). - This module assumes English error messages for the V(createcachetable) command to detect table existence, unfortunately. - - To be able to use the V(migrate) command with django versions < 1.7, you must have C(south) installed and added - as an app in your settings. - To be able to use the V(collectstatic) command, you must have enabled staticfiles in your settings. - Your C(manage.py) application must be executable (C(rwxr-xr-x)), and must have a valid shebang, for example C(#!/usr/bin/env python), for invoking the appropriate Python interpreter. From 6f28a4275897c397d3880e8c9f5e768b5f1deed9 Mon Sep 17 00:00:00 2001 From: Alexei Znamensky Date: Tue, 16 Apr 2024 19:46:14 +1200 Subject: [PATCH 2/3] markup --- plugins/modules/django_manage.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plugins/modules/django_manage.py b/plugins/modules/django_manage.py index 1577288cb6a..352bfe4b503 100644 --- a/plugins/modules/django_manage.py +++ b/plugins/modules/django_manage.py @@ -143,7 +143,7 @@ - The recommended way to create a virtual environment in Ansible is by using M(ansible.builtin.pip). - This module assumes English error messages for the V(createcachetable) command to detect table existence, unfortunately. - - To be able to use the V(collectstatic) command, you must have enabled staticfiles in your settings. + - To be able to use the V(collectstatic) command, you must have enabled C(staticfiles) in your settings. - Your C(manage.py) application must be executable (C(rwxr-xr-x)), and must have a valid shebang, for example C(#!/usr/bin/env python), for invoking the appropriate Python interpreter. seealso: From 0990769ce6c97bd54623b42441551ab5c5e4a4e0 Mon Sep 17 00:00:00 2001 From: Alexei Znamensky Date: Tue, 16 Apr 2024 20:33:07 +1200 Subject: [PATCH 3/3] fix doc notes in cpanm --- plugins/modules/cpanm.py | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/plugins/modules/cpanm.py b/plugins/modules/cpanm.py index 257ebec5b42..302f995932b 100644 --- a/plugins/modules/cpanm.py +++ b/plugins/modules/cpanm.py @@ -81,12 +81,16 @@ notes: - Please note that U(http://search.cpan.org/dist/App-cpanminus/bin/cpanm, cpanm) must be installed on the remote host. - "This module now comes with a choice of execution O(mode): V(compatibility) or V(new)." - - "O(mode=compatibility): When using V(compatibility) mode, the module will keep backward compatibility. This is the default mode. + - > + O(mode=compatibility): When using V(compatibility) mode, the module will keep backward compatibility. + This was the default mode before community.general 9.0.0. O(name) must be either a module name or a distribution file. If the perl module given by O(name) is installed (at the exact O(version) when specified), then nothing happens. Otherwise, it will be installed using the C(cpanm) executable. O(name) cannot be an URL, or a git URL. - C(cpanm) version specifiers do not work in this mode." - - "O(mode=new): When using V(new) mode, the module will behave differently. The O(name) parameter may refer to a module name, a distribution file, - a HTTP URL or a git repository URL as described in C(cpanminus) documentation. C(cpanm) version specifiers are recognized." + C(cpanm) version specifiers do not work in this mode. + - > + O(mode=new): When using V(new) mode, the module will behave differently. The O(name) parameter may refer to a module name, a distribution file, + a HTTP URL or a git repository URL as described in C(cpanminus) documentation. C(cpanm) version specifiers are recognized. + This is the default mode from community.general 9.0.0 onwards. author: - "Franck Cuny (@fcuny)" - "Alexei Znamensky (@russoz)"