|
|
|
|
@ -5,32 +5,36 @@ from __future__ import (absolute_import, division, print_function)
|
|
|
|
|
__metaclass__ = type
|
|
|
|
|
|
|
|
|
|
DOCUMENTATION = """
|
|
|
|
|
lookup: url
|
|
|
|
|
author: Brian Coca <bcoca@ansible.com>
|
|
|
|
|
version_added: "1.9"
|
|
|
|
|
short_description: return contents from URL
|
|
|
|
|
description:
|
|
|
|
|
_terms:
|
|
|
|
|
description: urls to query
|
|
|
|
|
validate_certs:
|
|
|
|
|
description: Flag to control SSL certificate validation
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
split_lines:
|
|
|
|
|
description: Flag to control if content is returned as a list of lines or as a single text blob
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
use_proxy:
|
|
|
|
|
description: Flag to control if the lookup will observe HTTP proxy environment variables when present.
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
lookup: url
|
|
|
|
|
author: Brian Coca (@bcoca)
|
|
|
|
|
version_added: "1.9"
|
|
|
|
|
short_description: return contents from URL
|
|
|
|
|
description:
|
|
|
|
|
- Returns the content of the URL requested to be used as data in play.
|
|
|
|
|
options:
|
|
|
|
|
_terms:
|
|
|
|
|
description: urls to query
|
|
|
|
|
validate_certs:
|
|
|
|
|
description: Flag to control SSL certificate validation
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
split_lines:
|
|
|
|
|
description: Flag to control if content is returned as a list of lines or as a single text blob
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
use_proxy:
|
|
|
|
|
description: Flag to control if the lookup will observe HTTP proxy environment variables when present.
|
|
|
|
|
type: boolean
|
|
|
|
|
default: True
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
EXAMPLES = """
|
|
|
|
|
- name: url lookup splits lines by default
|
|
|
|
|
debug: msg="{{item}}"
|
|
|
|
|
with_url:
|
|
|
|
|
- 'https://github.com/gremlin.keys'
|
|
|
|
|
loop: "{{ lookup('url', 'https://github.com/gremlin.keys', wantlist=True) }}"
|
|
|
|
|
|
|
|
|
|
- name: display ip ranges
|
|
|
|
|
debug: msg="{{ lookup('url', 'https://ip-ranges.amazonaws.com/ip-ranges.json', splitlines=False) }}"
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
RETURN = """
|
|
|
|
|
|