# flake8: noqa
# pylint: skip-file

DOCUMENTATION = '''
---
module: oc_edit
short_description: Modify, and idempotently manage openshift objects.
description:
  - Modify openshift objects programmatically.
options:
  state:
    description:
    - Currently present is only supported state.
    required: true
    default: present
    choices: ["present"]
    aliases: []
  kubeconfig:
    description:
    - The path for the kubeconfig file to use for authentication
    required: false
    default: /etc/origin/master/admin.kubeconfig
    aliases: []
  debug:
    description:
    - Turn on debug output.
    required: false
    default: False
    aliases: []
  name:
    description:
    - Name of the object that is being queried.
    required: false
    default: None
    aliases: []
  namespace:
    description:
    - The namespace where the object lives.
    required: false
    default: str
    aliases: []
  kind:
    description:
    - The kind attribute of the object.
    required: True
    default: None
    choices:
    - bc
    - buildconfig
    - configmaps
    - dc
    - deploymentconfig
    - imagestream
    - imagestreamtag
    - is
    - istag
    - namespace
    - project
    - projects
    - node
    - ns
    - persistentvolume
    - pv
    - rc
    - replicationcontroller
    - routes
    - scc
    - secret
    - securitycontextconstraints
    - service
    - svc
    aliases: []
  file_name:
    description:
    - The file name in which to edit
    required: false
    default: None
    aliases: []
  file_format:
    description:
    - The format of the file being edited.
    required: false
    default: yaml
    aliases: []
  content:
    description:
    - Content of the file
    required: false
    default: None
    aliases: []
  force:
    description:
    - Whether or not to force the operation
    required: false
    default: None
    aliases: []
  separator:
    description:
    - The separator format for the edit.
    required: false
    default: '.'
    aliases: []
author:
- "Kenny Woodson <kwoodson@redhat.com>"
extends_documentation_fragment: []
'''

EXAMPLES = '''
oc_edit:
  kind: rc
  name: hawkular-cassandra-rc
  namespace: openshift-infra
  content:
    spec.template.spec.containers[0].resources.limits.memory: 512
    spec.template.spec.containers[0].resources.requests.memory: 256
'''
