# flake8: noqa
# pylint: skip-file

DOCUMENTATION = '''
---
module: oc_image
short_description: Create, modify, and idempotently manage openshift images.
description:
  - Modify openshift images programmatically.
options:
  state:
    description:
    - State controls the action that will be taken with resource
    - present - will create the image. Does _not_ support update.
    - list - will read the images
    default: present
    choices: ["present", "list"]
    aliases: []
  kubeconfig:
    description:
    - The path for the kubeconfig file to use for authentication
    required: false
    default: /etc/origin/master/admin.kubeconfig
    aliases: []
  namespace:
    description:
    - The namespace where this object lives
    required: false
    default: default
    aliases: []
  debug:
    description:
    - Turn on debug output.
    required: false
    default: False
    aliases: []
  registry_url:
    description:
    - The url for the registry so that openshift can pull the image
    required: false
    default: None
    aliases: []
  image_name:
    description:
    - The name of the image being imported
    required: false
    default: False
    aliases: []
  image_tag:
    description:
    - The tag of the image being imported
    required: false
    default: None
    aliases: []
author:
- "Ivan Horvath<ihorvath@redhat.com>"
extends_documentation_fragment: []
'''

EXAMPLES = '''
- name: Get an imagestream
  oc_image:
    name: php55
    state: list
  register: imageout

- name: create an imagestream
  oc_image:
    state: present
    image_name: php55
    image_tag: int
    registry_url: registry.example.com
    namespace: default
  register: imageout
'''
