azrdev
6487a239c0
developing_inventory sample code: fix undefined var "results" if get_option(cache)=False ( #72977 )
...
if user_cache_setting == False, then the previous code didn't parse the inventory source
2020-12-16 10:51:58 -05:00
Alicia Cozine
e5ccd18be4
Wording changes to docs ( #70082 )
2020-12-08 16:46:34 -05:00
Evgeni Golov
57c2cc7c77
correct the reST rendering of the R() note ( #72896 )
2020-12-08 16:46:09 +01:00
Andrew Klychkov
0a7fcd135c
Docsite: update "Migrating Ansible content to a different collection" info ( #72710 )
...
* add a reminder about ignore-*.txt entries, fix formatting, add symlink removal note
* Update docs/docsite/rst/dev_guide/developing_collections.rst
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: David Moreau Simard <moi@dmsimard.com>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
2020-12-03 13:29:01 -06:00
Abhijeet Kasurde
a57539f764
Update VMware module development ( #72603 )
...
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2020-11-23 09:35:27 -05:00
Marco Lembo
1937dd5e9c
Update developing_plugins.rst ( #72305 )
...
##### SUMMARY
ansible_date_time returns utc time. datetime.utcnow() rather than datetime.now()
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
2020-11-17 21:45:03 +01:00
Matthew Davis
ddad9930aa
Clarify collection paths in docs ( #72510 )
...
* Clarify collection paths in docs, fix rst syntax, rephrase docs about using collection from folder/local git
Co-authored-by: Felix Fontein <felix@fontein.de>
2020-11-10 16:19:43 -06:00
Felix Fontein
da1c1e8bb8
Add info on how to contribute to **community**-maintained collections as well. ( #72494 )
2020-11-05 16:07:45 -05:00
Felix Fontein
01d207a3e3
Improve argument spec documentation ( #72335 )
...
* Link to argument spec documentation from 'Creating a module'.
* Use items instead of sub-headings.
* Update deprecation information.
* Document conditional requirements.
* Document supports_check_mode and add_file_common_args.
* Add deprecation examples.
* Re-add word.
* Improve title.
* Fix RST formatting, add conditional dependency section starter.
2020-11-04 18:17:46 +01:00
Nathan Scott
c20329a0f6
Update migrating_roles.rst ( #72260 )
...
Fix a typo in the sample spec file Source0 line
2020-10-20 13:19:45 -05:00
Ronald Eddy Jr
d18901dd4a
Update HTTP -> HTTPS ( #72244 )
...
Co-authored-by: Ronald Eddy Jr <ron@Ronalds-MacBook-Pro.local>
2020-10-19 15:57:20 -04:00
Jordan Borean
caba47dd3f
Add support for GSSAPI/Kerberos to urls.py ( #72113 )
...
* Add support for GSSAPI/Kerberos to urls.py
* Test out changes with the latest test container
* Get remote hosts working
* Fix up httptester_krb5_password reader
* Fix tests for opensuse and macOS
* Hopefully last lot of testing changes
* Dont do CBT on macOS
* Fixes from review
2020-10-13 14:16:07 +10:00
Erik Zettel
2b79cd2c0f
Fix typos ( #72072 )
2020-10-02 10:32:03 -04:00
Felix Fontein
a077bca5d5
ansible-test: improve version number validation, validate some semantic versioning properties ( #71679 )
...
* Validate removal versions.
* Validate that removal collection versions and version_added collection versions conform to semver spec.
* Validate removal version numbers in meta/runtime.yml.
* Stricter validation for isodates (f.ex. YYYY-M-D is not allowed).
* Improve error reporting.
* Validate removal collection versions.
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
2020-09-29 13:33:45 -07:00
Jorge Vallecillo
94522b7c10
Fix typos ( #71970 )
2020-09-28 14:33:24 -04:00
Gonéri Le Bouder
c1005147e0
doc: add vmware_rest_guidelines
...
Add the development guidelines for the vmware_rest collection.
2020-09-25 12:24:48 -04:00
Abhijeet Kasurde
4f990e7615
dev_guide: Add Pygments Lexer examples ( #71458 )
...
* dev_guide: Add Pygments Lexer examples
Fixes : #51307
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
* adds ansible-output lexer, remmoves unsupported lexers
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
2020-09-24 15:00:17 -05:00
Andrew Klychkov
2655fc0c23
Docsite: update Migrating Ansible content to a different collection ( #71854 )
...
Co-authored-by: Felix Fontein <felix@fontein.de>
2020-09-24 14:19:04 -04:00
Andrew Klychkov
a80131a283
Docsite: misc fixes ( #71697 )
2020-09-15 16:01:49 -04:00
Sloane Hertel
7048542199
Fix passing the connection timeout to connection plugins ( #71722 )
...
* Fix passing the connection timeout to connection plugins
2020-09-15 11:34:11 -04:00
Amin Vakil
7a0e545700
Add how to run unit test link in testing_units_modules doc ( #71523 )
...
* Add how to run unit test link in testing_units_modules
* Fix sanity test
2020-09-10 15:21:01 -05:00
Guillaume Vincent
1a06587f3b
Fix typo in the documentation ( #71701 )
...
Fix typo in the documentation: casting instead of casing
2020-09-10 10:49:59 -05:00
Andrew Klychkov
73bed95ead
Docsite: add reference to Style guide ( #71694 )
2020-09-10 10:17:13 -04:00
esmersmith
a34043c6be
Changed all_modules references to list_of_collections in the documentation ( #71656 )
2020-09-09 11:43:40 -05:00
Zois Pagoulatos
1ad0f666d5
Fix typo in documentation ( #71652 )
...
Fix typo on the page about unit testing modules,
2020-09-09 11:41:43 -05:00
Sandra McCann
bbd4ec13f1
clarify that collection names use same requirements as namespaces ( #71639 )
2020-09-04 14:37:44 -05:00
Andrew Klychkov
7bfeed3e24
Docsite: replace Latin phrases to English ( #71588 )
...
Replace Latin phrases like "e.g." and "i.e." and "etc." with English phrases.
* Update docs/docsite/rst/community/committer_guidelines.rst
* Update docs/docsite/rst/dev_guide/developing_modules_documenting.rst
* Update docs/docsite/rst/dev_guide/developing_program_flow_modules.rst
* Update docs/docsite/rst/dev_guide/module_lifecycle.rst
* Update docs/docsite/rst/user_guide/intro_inventory.rst
* Update docs/docsite/rst/user_guide/playbooks_loops.rst
* Update docs/docsite/rst/user_guide/playbooks_reuse.rst
* Update docs/docsite/rst/dev_guide/platforms/aws_guidelines.rst
* Update docs/docsite/rst/dev_guide/testing.rst
* Update docs/docsite/rst/dev_guide/testing_integration.rst
* Update docs/docsite/rst/porting_guides/porting_guide_2.5.rst
* Update docs/docsite/rst/reference_appendices/faq.rst
2020-09-03 14:47:57 -05:00
Andrew Klychkov
bfba0ffc45
Docsite: improve developing_modules_documenting.rst ( #71590 )
...
* Docsite: improve developing_modules_documenting.rst
* add necessary dots to returns descriptions
2020-09-02 09:26:42 -04:00
Andrew Klychkov
cda5854099
Docsite: improve spelling_word_choice.rst ( #71592 )
2020-09-02 09:24:53 -04:00
Alicia Cozine
29b20bd1b1
DOCS: Mentions ansible-base, adds collections pointers to Community and Dev Guides ( #71480 )
2020-09-01 12:25:37 -04:00
Andrew Klychkov
56423b1648
testing_sanity.rst: add argument for running in docker ( #71223 )
2020-09-01 12:00:13 -04:00
Amin Vakil
bc6461432e
Add --allow-disabled to sanity docs ( #71524 )
2020-08-31 10:46:03 -05:00
Sandra McCann
addee0699e
quick update to changelog instructins ( #71492 )
2020-08-27 11:05:35 -05:00
Patrick Reader
2b7461eb52
fix broken links due to master -> main branch rename ( #71426 )
2020-08-24 15:39:21 -04:00
Andrew Klychkov
5498b0bb71
Documentation: improve dev_guide/testing_integration.rst ( #71370 )
2020-08-20 15:24:22 -04:00
Andrew Klychkov
b82889eef5
Add note about integration tests for new modules to the dev guide ( #71345 )
2020-08-20 10:15:08 -04:00
Sandra McCann
74f88c56a5
quick fix to change main back to devel ( #71342 )
...
* quick fix to change main back to devel
* Update docs/docsite/rst/dev_guide/developing_collections.rst
Co-authored-by: Felix Fontein <felix@fontein.de>
2020-08-19 15:26:12 -05:00
Rick Elrod
ea58d7c233
Make it so callback plugins can act on implicit/explicit meta tasks ( #71009 )
...
Change:
- Now sends meta tasks to the task start callback
- Lets callback plugins opt-in to receiving implicit tasks
Test Plan:
- New integration tests
Tickets:
- Indirectly fixes #71007 by allowing custom callbacks with this data
Signed-off-by: Rick Elrod <rick@elrod.me>
2020-08-18 16:56:48 -05:00
Abhijeet Kasurde
4f993922c8
Add documentation about info/facts module development ( #71250 )
...
Fixes : #40151
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2020-08-18 15:56:43 -04:00
Andrew Klychkov
180507c62b
dev_guide: improve developing_collections.rst ( #71332 )
2020-08-18 12:07:27 -04:00
Abhijeet Kasurde
606604bb97
Add warning about copyright year change ( #71251 )
...
To simplify project administration and avoid any legal issues,
add a warning in the docs. This reflects - https://github.com/ansible/ansible/issues/45989#issuecomment-423635622 and fixes : #45989
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2020-08-17 15:44:06 -05:00
Sayee
ecd3b52ad7
Writing style updates to Developing dynamic inventory topic ( #71245 )
...
* modified the writing style
* incorporated peer feedback
2020-08-17 14:16:19 -05:00
Abhijeet Kasurde
ecea018506
Fix 404 links ( #71256 )
...
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2020-08-17 13:52:45 -04:00
Andrew Klychkov
a496b89d6f
overview_architecture.rst: fix playbook example ( #71303 )
2020-08-17 13:44:05 -04:00
Andrew Klychkov
9296ee9329
developing_modules_in_groups.rst: add note about releasing ( #71305 )
2020-08-17 13:43:15 -04:00
Sayee
7195788ffe
updates per writing style ( #70978 )
...
* updated to follow IBM and Ansible style guides
* modified heading underlines
* incorporated peer review feedback
2020-08-10 17:39:34 -05:00
Toshio Kuratomi
fb144c4414
Update ansible doc formats ( #71070 )
...
* Fix tty_ify bugs and refactor
* Move tty_ify() and supporting attributes to the DocCLI class as that's
the only thing using it.
* Add unittest for the code.
* Fix a bug where the substitution macros can be detected when they are
a part of another word.
* Add support for L(), R(), and HORIZONTALLINE which were added to the
website docs many years ago.
* Update test/units/cli/test_doc.py
Co-authored-by: Matt Clay <matt@mystile.com>
Co-authored-by: Matt Clay <matt@mystile.com>
2020-08-05 10:53:25 -07:00
Sloane Hertel
a9eb8b0488
Add some documentation for the format of meta/runtime.yml ( #71035 )
...
* Document the format of meta/runtime.yml
* Document multiple Ansible versions
Clarify difference between deprecation and tombstone fields
* add note
2020-08-04 11:25:08 -04:00
Rick Elrod
7f62a9d7b5
Make cache adjudicator's flush call plugin flush ( #70987 )
...
Change:
- Previously CachePluginAdjudicator#flush only removed entries from the
cache backend that it knew about by using them earlier. Now it calls
the underlying plugin's flush() method.
Test Plan:
- New unit tests
Tickets:
- Fixes #68770
Signed-off-by: Rick Elrod <rick@elrod.me>
2020-08-03 17:16:15 -05:00
EthanHur
0c855dc70b
Guide users to use ansible-runner ( #71063 )
...
Update the docs to guide users to use `ansible-runner` instead of using Python API directly. In many use cases, executing Ansible playbooks are sufficient. In those use cases, `ansible-runner` is easier and much stable to use comparing with Python API, but there is no mention of it.
2020-08-03 10:15:37 -05:00