#!/usr/bin/python
# -*- coding: utf-8 -*-

from ansible.module_utils.openshift_common import OpenShiftAnsibleModule, OpenShiftAnsibleException

DOCUMENTATION = '''
module: openshift_v1beta1_event_list
short_description: OpenShift EventList
description:
- Retrieve a list of events. List operations provide a snapshot read of the underlying
  objects, returning a resource_version representing a consistent version of the listed
  objects.
version_added: 2.3.0
author: OpenShift (@openshift)
options:
  api_key:
    description:
    - Token used to connect to the API.
  cert_file:
    description:
    - Path to a certificate used to authenticate with the API.
    type: path
  context:
    description:
    - The name of a context found in the Kubernetes config file.
  debug:
    description:
    - Enable debug output from the OpenShift helper. Logging info is written to KubeObjHelper.log
    default: false
    type: bool
  force:
    description:
    - If set to C(True), and I(state) is C(present), an existing object will updated,
      and lists will be replaced, rather than merged.
    default: false
    type: bool
  host:
    description:
    - Provide a URL for acessing the Kubernetes API.
  key_file:
    description:
    - Path to a key file used to authenticate with the API.
    type: path
  kubeconfig:
    description:
    - Path to an existing Kubernetes config file. If not provided, and no other connection
      options are provided, the openshift client will attempt to load the default
      configuration file from I(~/.kube/config.json).
    type: path
  password:
    description:
    - Provide a password for connecting to the API. Use in conjunction with I(username).
  resource_definition:
    description:
    - Provide the YAML definition for the object, bypassing any modules parameters
      intended to define object attributes.
    type: dict
  src:
    description:
    - Provide a path to a file containing the YAML definition of the object. Mutually
      exclusive with I(resource_definition).
    type: path
  ssl_ca_cert:
    description:
    - Path to a CA certificate used to authenticate with the API.
    type: path
  state:
    description:
    - Determines if an object should be created, patched, or deleted. When set to
      C(present), the object will be created, if it does not exist, or patched, if
      parameter values differ from the existing object's attributes, and deleted,
      if set to C(absent). A patch operation results in merging lists and updating
      dictionaries, with lists being merged into a unique set of values. If a list
      contains a dictionary with a I(name) or I(type) attribute, a strategic merge
      is performed, where individual elements with a matching I(name_) or I(type)
      are merged. To force the replacement of lists, set the I(force) option to C(True).
    default: present
    choices:
    - present
    - absent
  username:
    description:
    - Provide a username for connecting to the API.
  verify_ssl:
    description:
    - Whether or not to verify the API server's SSL certificates.
    type: bool
requirements:
- openshift == 0.4.0.a1
'''

EXAMPLES = '''
'''

RETURN = '''
api_version:
  description: Requested API version
  type: string
event_list:
  type: complex
  returned: when I(state) = C(present)
  contains:
    api_version:
      description:
      - APIVersion defines the versioned schema of this representation of an object.
        Servers should convert recognized schemas to the latest internal value, and
        may reject unrecognized values.
      type: str
    items:
      description:
      - Items is a list of schema objects.
      type: list
      contains:
        action:
          description:
          - What action was taken/failed regarding to the regarding object.
          type: str
        api_version:
          description:
          - APIVersion defines the versioned schema of this representation of an object.
            Servers should convert recognized schemas to the latest internal value,
            and may reject unrecognized values.
          type: str
        deprecated_count:
          description:
          - Deprecated field assuring backward compatibility with core.v1 Event type
          type: int
        deprecated_first_timestamp:
          description:
          - Deprecated field assuring backward compatibility with core.v1 Event type
          type: complex
          contains: {}
        deprecated_last_timestamp:
          description:
          - Deprecated field assuring backward compatibility with core.v1 Event type
          type: complex
          contains: {}
        deprecated_source:
          description:
          - Deprecated field assuring backward compatibility with core.v1 Event type
          type: complex
        event_time:
          description:
          - Required. Time when this Event was first observed.
          type: complex
          contains: {}
        kind:
          description:
          - Kind is a string value representing the REST resource this object represents.
            Servers may infer this from the endpoint the client submits requests to.
            Cannot be updated. In CamelCase.
          type: str
        metadata:
          description: []
          type: complex
        note:
          description:
          - Optional. A human-readable description of the status of this operation.
            Maximal length of the note is 1kB, but libraries should be prepared to
            handle values up to 64kB.
          type: str
        reason:
          description:
          - Why the action was taken.
          type: str
        regarding:
          description:
          - The object this Event is about. In most cases it's an Object reporting
            controller implements. E.g. ReplicaSetController implements ReplicaSets
            and this event is emitted because it acts on some changes in a ReplicaSet
            object.
          type: complex
        related:
          description:
          - Optional secondary object for more complex actions. E.g. when regarding
            object triggers a creation or deletion of related object.
          type: complex
        reporting_controller:
          description:
          - Name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.
          type: str
        reporting_instance:
          description:
          - ID of the controller instance, e.g. `kubelet-xyzf`.
          type: str
        series:
          description:
          - Data about the Event series this event represents or nil if it's a singleton
            Event.
          type: complex
        type:
          description:
          - Type of this event (Normal, Warning), new types could be added in the
            future.
          type: str
    kind:
      description:
      - Kind is a string value representing the REST resource this object represents.
        Servers may infer this from the endpoint the client submits requests to. Cannot
        be updated. In CamelCase.
      type: str
    metadata:
      description:
      - Standard list metadata.
      type: complex
'''


def main():
    try:
        module = OpenShiftAnsibleModule('event_list', 'v1beta1')
    except OpenShiftAnsibleException as exc:
        # The helper failed to init, so there is no module object. All we can do is raise the error.
        raise Exception(exc.message)

    try:
        module.execute_module()
    except OpenShiftAnsibleException as exc:
        module.fail_json(msg="Module failed!", error=str(exc))


if __name__ == '__main__':
    main()
