ansible/docs/docsite/rst/dev_guide
Felix Fontein ea04e0048d
Allow to deprecate options and aliases by date (#68177)
* Allow to deprecate options and aliases by date instead of only by version.

* Update display.deprecate().

* Adjust behavior to conform to tested behavior, extend tests, and improve C# style.

* Parse date and fail on invalid date.

This is mainly to make sure that people start using invalid dates, and we eventually have a mess to clean up.

* C# code: improve validation and update/extend tests.

* Make sure that deprecate() is not called with both date and version.

* Forgot to remove no longer necessary formatting.

* Adjust order of warnings in C# code.

* Adjust unrelated test.

* Fix grammar (and make that test pass).

* Don't parse date, and adjust message to be same as in #67684.

* Sanity tests: disable date in past test.

* Validate-modules: validate ISO 8601 date format.

* Validate-modules: switch schema declaration for deprecated_aliases to improve error messages for invalid dates.

* Use DateTime instead of string for date deprecation.

* Validate that date in deprecated_aliases is actually a DateTime.

* Fix tests.

* Fix rebasing error.

* Adjust error codes for pylint, and add removed_at_date and deprecated_aliases.date checks to validate-modules.

* Make deprecation date in the past error codes optional.

* Make sure not both version and date are specified for AnsibleModule.deprecate() calls.

* Stop using Python 3.7+ API.

* Make sure errors are actually reported. Re-add 'ansible-' prefix.

* Avoid crashing when 'name' isn't there.

* Linting.

* Update lib/ansible/module_utils/csharp/Ansible.Basic.cs

Co-authored-by: Jordan Borean <jborean93@gmail.com>

* Adjust test to latest change.

* Prefer date over version if both end up in Display.deprecated().

Co-authored-by: Jordan Borean <jborean93@gmail.com>
2020-05-26 20:23:56 -04:00
..
platforms vmware: example should use FQCN (#69351) 2020-05-11 16:27:20 -04:00
shared_snippets Clarify that GPLv3+ module_utils need core team approval (#56740) 2019-05-21 15:15:55 -05:00
style_guide added guidelines for seo; (#66431) 2020-01-13 15:46:44 -06:00
testing/sanity remove azure extras and extras_require support (#67822) 2020-03-23 13:07:33 -07:00
debugging.rst Correct debugging modules documentation (#69245) 2020-05-06 12:20:47 -05:00
developing_api.rst removes last :doc: links in the dev guide (#58417) 2019-06-26 14:59:33 -04:00
developing_collections.rst Document how to migrate a standalone role to a collection (#68687) 2020-05-04 15:59:54 -05:00
developing_core.rst removes last :doc: links in the dev guide (#58417) 2019-06-26 14:59:33 -04:00
developing_inventory.rst Fix cache example (#64600) 2019-11-08 16:16:45 -05:00
developing_locally.rst Update local module options (#57553) 2019-06-17 15:22:50 -05:00
developing_module_utilities.rst fixed some broken links (#66182) 2020-01-06 10:24:07 -06:00
developing_modules.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
developing_modules_best_practices.rst dev_guide/developing_modules_best_practices.rst: fix typo (#67639) 2020-02-21 10:56:35 +00:00
developing_modules_checklist.rst This was changed to python 2.7 but should have remained python 2.6 (#66836) 2020-01-28 09:32:03 -06:00
developing_modules_documenting.rst Link the testing documentation to the module documenting page (#67248) 2020-02-10 15:30:04 -05:00
developing_modules_general.rst doc: Fix tiny typo in example: change --> changed (#66835) 2020-01-28 10:34:36 +01:00
developing_modules_general_aci.rst fix make webdocs warnings (#68411) 2020-03-25 13:13:56 -05:00
developing_modules_general_windows.rst fix last 7 docs errors on post-migration test runs (#68115) 2020-03-23 11:14:21 -05:00
developing_modules_in_groups.rst This was changed to python 2.7 but should have remained python 2.6 (#66836) 2020-01-28 09:32:03 -06:00
developing_plugins.rst Update inventory caching documentation (#69100) 2020-05-05 15:10:57 -05:00
developing_program_flow_modules.rst doc: explain default "required" value for argument_spec (#68678) 2020-04-06 16:07:30 -04:00
developing_python_3.rst Update developing_python_3.rst (#66249) 2020-01-13 15:40:37 -05:00
developing_rebasing.rst Update developing_rebasing.rst (#51650) 2019-02-08 13:29:39 -06:00
index.rst Document how to migrate a standalone role to a collection (#68687) 2020-05-04 15:59:54 -05:00
migrating_roles.rst Document how to migrate a standalone role to a collection (#68687) 2020-05-04 15:59:54 -05:00
module_lifecycle.rst rewrite of the developer guide, part 1 (#45179) 2018-09-07 08:57:36 -05:00
overview_architecture.rst Docs: edits & expands module_utils & search path info in dev guide (#55931) 2019-05-01 07:52:34 -05:00
testing.rst Extend dev guide for collection testing and collection hacking (#68899) 2020-04-15 15:51:19 -05:00
testing_compile.rst Extend dev guide for collection testing and collection hacking (#68899) 2020-04-15 15:51:19 -05:00
testing_documentation.rst dev_guide: Correct path to ansible-test requirements files (#66626) 2020-01-21 10:16:48 -05:00
testing_httptester.rst removes last :doc: links in the dev guide (#58417) 2019-06-26 14:59:33 -04:00
testing_integration.rst Dev guide: add notes about different image types for integration and unit/sanity tests (#68663) 2020-04-07 09:17:44 -05:00
testing_integration_legacy.rst restores legacy testing file (#46095) 2018-09-25 08:52:47 -04:00
testing_pep8.rst Remove obsolete docs on pep8 sanity test. 2019-08-01 22:34:09 -07:00
testing_running_locally.rst fixes link, makes intrapage TOC local (#67664) 2020-02-24 14:29:22 -05:00
testing_sanity.rst Dev guide: add notes about different image types for integration and unit/sanity tests (#68663) 2020-04-07 09:17:44 -05:00
testing_units.rst Dev guide: add notes about different image types for integration and unit/sanity tests (#68663) 2020-04-07 09:17:44 -05:00
testing_units_modules.rst fixes import paths for ansible unit testing (#65775) 2019-12-16 11:07:26 -06:00
testing_validate-modules.rst Allow to deprecate options and aliases by date (#68177) 2020-05-26 20:23:56 -04:00