Brian Coca
fe09f7ee49
clarify that requirements are on host that runs it
...
fixes http://github.com/ansible/ansible-modules-core/issues/3061
9 years ago
Brian Coca
6414c967e4
now check for description and listify if needed
...
fixes #14371
9 years ago
Toshio Kuratomi
5cd3f71792
Handle utf-8 in module short desc
9 years ago
Jeremy Audet
5cac8efd73
Make "make webdocs" compatible with Python 3
...
The `webdocs` make target fails under Python 3. It fails due to a variety of
syntax errors, such as the use of `except Foo, e` and `print 'foo'`. Fix #13463
by making code compatible with both Python 2 and 3.
9 years ago
Patrik Lundin
9f9944e355
Replace -delete with portable -exec rm {} \;
...
Needed on OpenBSD which does not support -delete.
9 years ago
Alberto Gireud
52ded67db5
Update check mode argument
9 years ago
Brian Coca
4a206cdde9
force egg deletion
9 years ago
Brian Coca
5719912e7f
added a skip for the test dir in module repos
9 years ago
Toshio Kuratomi
4203850d1a
Break apart a looped dependency to show a warning when parsing playbooks
...
Display a warning when a dict key is overwritten by pyyaml
Fixes #12888
9 years ago
Toshio Kuratomi
baa309309d
Bundle a new version of python-six for compatibility along with some code to make it easy for distributions to override the bunndled copy if they have a new enough version.
9 years ago
Brian Coca
3a0bf55ae3
better error catching for doc build
9 years ago
James Cammarata
a431121f9f
Tweak to hacking path fix to go back to subshell use
9 years ago
EC
bcdb4e78ae
Allow env-setup to use spaces in full path
9 years ago
Marius Gedminas
823677b490
Replace .iteritems() with six.iteritems()
...
Replace .iteritems() with six.iteritems() everywhere except in
module_utils (because there's no 'six' on the remote host). And except
in lib/ansible/galaxy/data/metadata_template.j2, because I'm not sure
six is available there.
9 years ago
Luke Rohde
cba4642d8d
Use find ... -delete instead of non-portable globbing
9 years ago
Luke Rohde
647e48f776
Delete all compiled python files when running hacking/env-setup
9 years ago
Kevin Houdebert
b8c9391d0c
Change to python3 syntax
9 years ago
Jody Frankowski
bc1e1d2cdc
Fix rm call in hacking/env-setup. Since it is sourced from a user shell,
...
rm can have an alias to 'rm -i', which will make sourcing hang when '-q'
is enabled.
9 years ago
Abhijit Menon-Sen
114070c226
Add missing $
9 years ago
Brian Coca
636f88fd31
Merge pull request #9438 from binarytemple/patch-1
...
export ANSIBLE_HOME so it can be used in scripts
9 years ago
Toshio Kuratomi
53ae326603
Port some things in test-module to v2.
...
In particular, fix arg parsing
Fixes #11820
9 years ago
Brian Coca
f5c8055879
removed debug stuff
9 years ago
Brian Coca
a78fdde32c
better handling for weird doc corner cases (abscense of options, bad text objects, etc)
...
also updated extras to get some docfixes on the module side
9 years ago
bryan hunt
7a76fcb159
merged
9 years ago
Sheldon Hearn
c800a1c68a
Preserve OLDPWD
9 years ago
Brian Coca
ae54792a35
Merge pull request #11688 from amenonsen/8935-rebase
...
8935 rebase: add «-o outputfile» and -n(oexec) options to hacking/test-module
9 years ago
Brian Coca
d3fe9b3194
Merge pull request #11084 from echiu64/devel
...
More complex example of using test-module
9 years ago
Abhijit Menon-Sen
8342cc6b61
Fix existing typo, remove trailing space added by PR commit
9 years ago
Will Thames
b05485d4b3
Add options to control output and execution of test-module
...
test-module is useful but sometimes you want to edit the
result before running it to e.g. set a debug point.
Added a noexecute option (i.e. just create the module script, don't
run it) and an output option to choose the filename of the result.
9 years ago
Brian Coca
c40541964b
Merge pull request #11637 from bcoca/moar_docs
...
Moar docs
9 years ago
Brian Coca
740f15cb0d
just remove version_added when to old, not the whole option!
9 years ago
Brian Coca
9de086d16d
removed merges from count
9 years ago
Brian Coca
173f27531c
moar docs
...
added docs for new v2 features
restructures modules bar and core/extras info into their own pages
changed templates to refer to the new pages
added some missing ansible.cfg options
more info on gathering setting
9 years ago
Brian Coca
6ba706f753
minor doc reformatting
...
now version_added < 1.3 does not get shown, up from 1.0
option's version_added is also now filterd against this threshold
module version_added is more prominent
exaples now uses pure rst instead of intermingled with html formatting
aliases now shown in description for options
bad version fields now throw warnings instead of exceptions
ansible-doc errors now show traceback in very very verbose mode, for easier debugging
9 years ago
Brian Coca
811b10d132
docs will not mention versions older than 1.5
9 years ago
Brian Coca
1aeb66148b
actually now does what it says as it was just sorting by name
9 years ago
Gerard Lynch
2f51f3bbc5
updated to use new loader
9 years ago
Brian Coca
95bf78d0e7
Merge pull request #11618 from halberom/test-module
...
hacking/test-module, updated to new location and non-classness of module_common
9 years ago
Gerard Lynch
3c7a502c50
updated to new location and non-classness of module_common
9 years ago
Brian Coca
f146c7680f
Merge pull request #10928 from gimoh/test-module-default-python
...
Use same interpreter for test-module and module it runs
9 years ago
Marc Abramowitz
3b0524e67d
hacking/test-module: Style nit
10 years ago
Marc Abramowitz
5466ff8907
hacking/test-module: Deal with move of parse_kv
10 years ago
Marc Abramowitz
ea6ec3bf2c
Make test-module work in v2
...
- `jsonify` moved from `ansible.utils` to `ansible.parsing.utils.jsonify`
- I don't see `ansible.utils.parse_json` anymore so I used `json.loads`.
10 years ago
Brian Coca
0826106441
minor docs reformat
...
- clearer 'version added' for module options, now it sits under the option name
- made notes a section, so it now appears in toc
- moved requirements and made it a list, more prominent and more readable
10 years ago
James Cammarata
2bad888f28
Merge branch 'v2_final' into devel_switch_v2
...
Conflicts:
lib/ansible/inventory/__init__.py
lib/ansible/modules/core
lib/ansible/utils/__init__.py
lib/ansible/utils/module_docs.py
10 years ago
Edwin Chiu
aef76cc701
More complex example of using test-module
10 years ago
Florian Apolloner
3010190592
Fixing up the hacking module_formatter code for v2
10 years ago
Michael Scherer
85aa984340
Fix error in the column name in the doc
10 years ago
gimoh
5489d172de
Use same interpreter for test-module and module it runs
...
Default python interpreter to the same interpreter the test-module
script is executed with. This is so that the interpreter doesn't have
to be specified twice in the command when using non-default python
(e.g. ``/path/to/python ./hacking/test-module -I python=/path/to/python ...``)
10 years ago
Toshio Kuratomi
4c8d27f7bb
Make module formatting into links to the other module docs
10 years ago
Matt Martz
104b2036f7
egg_info is now written directly to lib
10 years ago
Brian Coca
b6ec502983
added missing element to make google groups link a actual link
10 years ago
Ján Dzurek
cf6155f1c2
rst.j2 template better core module source wording
10 years ago
Brian Coca
c3076b8478
added module returnval documentation to web docs
10 years ago
Brian Coca
2cacac4b23
minor adjustments to formatting
10 years ago
Brian Coca
94909bd4a2
Added return values documentation to modules
10 years ago
Toshio Kuratomi
caf2a96ef9
Merge pdksh fix to v2
10 years ago
Patrik Lundin
731b268cd6
env-setup: Don't use ${.sh.file} if shell is pdksh
...
The default ksh in OpenBSD throws the following error:
===
$ . hacking/env-setup
ksh: hacking/env-setup[23]: ${.sh.file}": bad substitution
[...]
===
The same error can be seen on Linux if pdksh is used.
10 years ago
bmoar
1eaa9d4a08
fix path in Test-module example
10 years ago
Brian Coca
68a06e542d
Merge pull request #9666 from follower/patch-8
...
Correct typo of "actively" (Attempt #2 )
10 years ago
Brian Coca
ee08448b2e
now module_formatter handles new expanded return values from the module_docs (still does not thing with new return value docs)
10 years ago
Alexey Shamrin
b950a38e30
fix links to ansible-devel in documentation pages
10 years ago
Toshio Kuratomi
7c86db3187
Add KSH compat
...
cherry picked from https://github.com/ansible/ansible/pull/6899
10 years ago
ZhiFeng Hu
e63c03d60f
Move update.sh to hacking repository ,see #10081
10 years ago
rpe-github
0a73067153
Use basename -- $0 in case $0 starts with a dash.
...
For example, pdksh $0 contains '-ksh'.
10 years ago
Marco Ippolito
23da2f6415
Redundant file descriptor specifier
10 years ago
Marco Ippolito
4cd5be396d
BUG! Incorrect order of redirection AND incorrect redirection syntax
...
The replaced code only created a text file called `1' in the
current directory, it did *not* redirect output.
10 years ago
Marco Ippolito
bc0f0f838e
More elegant output using here-document syntax
...
POSIX section 2.7.4 defines here-documents.
10 years ago
Marco Ippolito
7eb278e797
Identified two verbosity levels: info, silent
...
Conflicts:
hacking/env-setup
10 years ago
Marco Ippolito
9bc1e1a4a0
Reserve capitalised identifiers for system variables
...
Conflicts:
hacking/env-setup
10 years ago
Marco Ippolito
53fadd371b
No need to prepend `.' to a relative path
10 years ago
Toshio Kuratomi
566a8d1b9d
Fix issue with mixing quoting and glo9bbing.
10 years ago
Toshio Kuratomi
365af69c3e
More quotes and reimplement without pushd/popd
10 years ago
Toshio Kuratomi
dde32a826f
Set default values for shell variables that we use
...
Fixes #9991
10 years ago
Toshio Kuratomi
09e556e9a4
Get rid of bash compound command to make more portable
10 years ago
Toshio Kuratomi
245f934629
Remove shebang and execute perms for env-setup since it must be sourced
10 years ago
Marco Ippolito
b688570380
Corrected quoting of parameter expansions in hacking/env-setup
...
Conflicts:
hacking/env-setup
10 years ago
Marco Ippolito
b8921706f8
Prefer modern-style Bash command substitution in hacking/env-setup
...
Conflicts:
hacking/env-setup
10 years ago
Marco Ippolito
31c8523371
Updated shebang from #!/bin/bash to #!/usr/bin/env bash (more flexible)
10 years ago
Brian Coca
88443d6dcf
Merge pull request #7306 from abadger/feature/egg-info
...
Feature/egg info
10 years ago
Veres Lajos
bf5d8ee678
typofixes - https://github.com/vlajos/misspell_fixer
10 years ago
follower
8b278fee51
Correct typo of "actively" (Attempt #2 )
10 years ago
follower
a1c5294882
Fix misspelled "necessarily"
10 years ago
Brian Coca
339d1ccc8b
fixed issue with subclasses across the repos clobbering each other, they
...
now merge
10 years ago
Brian Coca
2ba5c3c66b
added blank line before section to avoid sphinx warnings
10 years ago
Michael DeHaan
c551fe8b50
Clarify module list footer.
10 years ago
Brian Coca
12393a4b47
subcategories are now Title case and _ gets changed to a space
10 years ago
Brian Coca
5f1ad79cd3
now correctly flags and sorts subcategory modules
10 years ago
Brian Coca
650048f7dd
now displays subcategories correctly
10 years ago
Brian Coca
7bd2c945a7
now doc generation does not ignore subdirs of cloud
10 years ago
Brian Coca
80b1365d53
now correctly processes modules when in subdirs of cloud
10 years ago
Brian Coca
f6d9aa7a8f
corrected text/flag
10 years ago
Brian Coca
023f5fd7e0
Added note explaning the module tagging
10 years ago
Brian Coca
44f0279d0a
Now adds flags for non core and deprecated modules in listing
10 years ago
Brian Coca
86de59235f
bypass core/extras text when module is deprecated
10 years ago
Brian Coca
8b5b97d066
now docs handle deprecated modules but still ignore aliases
10 years ago
Brian Coca
27d741102c
Created Deprecated module category that only appears when there is
...
something to show
10 years ago
Bryan Hunt
e5f651c458
export ANSIBLE_HOME so it can be used in scripts
...
In order that scripts like this can work
```
#!/bin/bash
ansible -vvvv tag_instance_type_foo-training -i "${ANSIBLE_HOME}/plugins/inventory/ec2.py" --private-key=~/Downloads/foo-training.pem -u ec2-user -m ping
```
10 years ago
Brian Coca
5ab4467708
module formatter skips modules with leading underscore to avoid
...
documenting them. Soon will be patched to recognize them as either
deprecated or an alias
10 years ago
Toshio Kuratomi
1e12d3028c
Merge pull request #9384 from insaneirish/devel
...
Change "usuable" to "usable".
10 years ago
insaneirish
3d257bc695
Change "usuable" to "usable".
10 years ago
Igor Vuk
e19f3f8a5c
Typo: greatful -> grateful
10 years ago
Baptiste Mathus
2845f0c455
Typo: recieve -> receive.
10 years ago
Michael DeHaan
2211ae113c
Update rst.j2
...
typo fix
10 years ago
Martin Ueding
dc750e6526
Fix link in reST template
...
There was a missing trailing underscore (`_`) that would have marked the
content in the backticks as a link. This adds it and fixes the link on
every core module page.
10 years ago
Michael DeHaan
ffee9a8fe0
Docsite formatting
10 years ago
Michael DeHaan
7f6ab89b5b
hacking/env-setup no longer needs to set library since modules appear as git submodules.
10 years ago
Michael DeHaan
e8fe306cef
Some various comments about the new repos, more to likely come.
10 years ago
Michael DeHaan
bceb0026a5
Updating the module formatter to deal with the new repo structure.
10 years ago
Michael DeHaan
b818fbb305
Modules are almost always written now by mutliple authors, so don't show this field on website, since it grows obsolete and does not take into account all contributors.
...
Contributors are still listed on github module source and in repo, and original authors still in the file for when development questions arise, but want
to funnel support questions to the mailing list versus directly to them.
10 years ago
Michael Salmon
e827ec702e
Fix issue #8578 . Setting envvar in ""'s ensures the PYTHONPATH is set to
...
include the lib/ directory.
Before - PYTHONPATH is empty.. ansible fails to run
$ source hacking/env-setup.fish
Appending PYTHONPATH
Setting up Ansible to run out of checkout...
PATH=/Volumes/opt/src/ansible/bin /usr/local/share/python3 /usr/local/bin
/usr/bin /bin /usr/sbin /sbin /usr/local/bin /opt/X11/bin /usr/bin /sbin
/usr/local/bin /Users/ms/bin/
PYTHONPATH=
ANSIBLE_LIBRARY=/Volumes/opt/src/ansible/library
...
Traceback (most recent call last):
File "/Volumes/opt/src/ansible/bin/ansible", line 25, in <module>
from ansible.runner import Runner
ImportError: No module named ansible.runner
After change - it's set.. ansible runs.
source hacking/env-setup.fish
Appending PYTHONPATH
Setting up Ansible to run out of checkout...
PATH=/Volumes/opt/src/ansible/bin /usr/local/share/python3 /usr/local/bin
/usr/bin /bin /usr/sbin /sbin /usr/local/bin /opt/X11/bin /usr/bin /sbin
/usr/local/bin /Users/ms/bin/
PYTHONPATH=/Volumes/opt/src/ansible/lib:
ANSIBLE_LIBRARY=/Volumes/opt/src/ansible/library
....
$ ansible
Usage: ansible <host-pattern> [options]
10 years ago
Hector Acosta
b8cbf1370f
Add checkmode support for test-module script
...
Signed-off-by: Hector Acosta <hector.acosta@gmail.com>
10 years ago
Michael DeHaan
dfd4f18095
Docsite things.
11 years ago
Toshio Kuratomi
6a6060ac55
Teach env-setup how to create egg-info for ansible so that pkg_resources works
11 years ago
Felix Kaiser
3b06ab84e3
Make test-module interpret --args='{...' as yaml
11 years ago
Max Riveiro
9f7342d46d
Add tesing deps installation into hacking/README
...
Signed-off-by: Max Riveiro <kavu13@gmail.com>
11 years ago
Cristian Ciupitu
0749112286
Micro-optimization: replace s.find(x)!=-1 with x in s
...
timeit shows a speedup of ~3x on Python 2.7.5 x86_64.
It also makes the code a bit shorter.
11 years ago
Lukáš Lalinský
95d102f5e4
Remove obsolete module development docs
11 years ago
willthames
e2d04f7e96
Allow hacking/env-setup module path to use config file library path
...
hacking/env-setup now adds the configured library path in ANSIBLE_CONFIG
to the ANSIBLE_LIBRARY environment variable in addition to the previous
default of ANSIBLE_HOME/library.
This replaces #5950 .
11 years ago
Matt Martz
dbed05caec
Support for -a to accept a file with test-module
...
If the CLI value for -a starts with an @, treat it like a file, and dump the contents into complex_args
This supports yaml or json.
11 years ago
jctanner
7fa0d8bdd3
Merge pull request #5461 from sivel/test-module-interpreter
...
Add -I/--interpreter argument to test-module
11 years ago
Michael DeHaan
3b8fd62ff9
More site rename things.
11 years ago
Michael DeHaan
c4a8a6d3c2
Add an "all" category so all modules show up uncategorized there.
11 years ago
Michael DeHaan
2f811c40d7
Basic docsite formatting fixups
11 years ago
Matt Martz
e50c2bccb8
Add -I/--interpreter argument to test-module
11 years ago
Mikhail Sobolev
84948292f3
include short_description in the module page's title
11 years ago
Michael DeHaan
83d298accc
Add note about how to submit doc changes to generated module docs, limit TOC depth for module category list.
11 years ago
Mikhail Sobolev
fce90e0370
use rst formatting for sphinx part
11 years ago
Mikhail Sobolev
1713013dba
provide sections and local TOC for module documentation
11 years ago
Mikhail Sobolev
7965d331f3
do not produce too deep toc for category lists
11 years ago
Mikhail Sobolev
af1f8db51d
remove trailing whitespaces
11 years ago
Michael DeHaan
a5e8e10bb0
Removed unused things.
11 years ago
Michael DeHaan
f4aa6c53bd
Format module requirements as notes in Sphinx
11 years ago
Michael DeHaan
eb0509fce7
Update the styling for the module pages slightly.
11 years ago
Michael DeHaan
35ec9f81ae
Further modifications to the module formatter to adjust to the new theme, and some misc docs text corrections.
11 years ago
Michael DeHaan
fe2d00d9d3
WIP on refactoring the module formatter code that we use to build the doc site with.
11 years ago
Michael DeHaan
31d0060de8
Standardized on yml suffix, so fix this example content filename.
11 years ago
Michael DeHaan
10009b0d3f
Starting to refactor module formatter script.
...
Rename "jpfunc" to something more explanatory
11 years ago
Jens Rantil
2096c669d9
`env-setup` fix for zsh <= 4.3.10
...
This fixes issue #5026 . It used to work. The regression was
introduced in 2b3381de7c
.
11 years ago
Michael DeHaan
40429ee64e
Code to limit display of version_added attributions in modules for modules that are too old to call out this information.
...
This does not generically apply to new arguments added to existing modules, just the version_added attribute on the top level modules.
11 years ago
Michael DeHaan
51e6f411f2
Docs: Fix the module formatter code that is intended to remove the 'historical' variable from showing up in version_added information (RST)
11 years ago
phy1729
2b3381de7c
Add zsh support for working dir independant sourcing
11 years ago
Michael DeHaan
f7c3975f21
Add version_added to all modules missing version_added information, the docs formatter will now
...
raise errors when omitted, updated changelog with new modules.
11 years ago
jctanner
b6c1574f5c
Merge pull request #4765 from mvo5/bugfix/fix-man-template
...
Fixes in the man template
11 years ago
Michael Vogt
b8e641136a
make comment lines in troff start with .\" and add a .SH EXAMPLES to the PLAINEXAMPLES section
11 years ago
Michael DeHaan
d34a26e307
Undo an inadvertant revert from template changes so we still allow pythonic imports in module land.
11 years ago
Alan Fairless
af40b19a2d
Fix format string typo
11 years ago
James Tanner
d154bf8781
Revert templating enhancements from 73dbab70
e6c28658
d409352c
9858b1f2
4587528b
9b1fe455
214b0b05
8d3db803
7f9504d1
5031104c
35cb9dc2
2bd8cb57
1e85c754
11 years ago
Michael DeHaan
9858b1f2f3
Enable imports to work on a snippet based system, allowing for instance a library of common EC2 functions
...
to be reused between modules. See library/system/service and library/system/ping for initial examples. Can
work the old way to just import 'basic', or can import the new way to import multiple pieces of code from
module_utils/.
11 years ago
Jharrod LaFon
996f87d898
Fixed usage comment to fish syntax for sourcing a file
11 years ago