---
properties:
  - name: action
    description: |
      Git action to execute.

      Supported actions: `clone | commit | push | pages`. Specified actions are executed in the specified order

      - **clone:** Clones the repository in `remote_url` and checks out the `branch` to `path`.
      - **commit:** Adds a commit to the default repository or the repository in `remote_url`.
      - **push:** Pushes all commits to the default repository or the repository set in `remote_url`.
      - **pages:** The `pages` action is a special action that cannot be combined with other actions. It is intended for use for
        GitHub pages. It synchronizes the contents of `pages_directory` with the target `branch` using `rsync` and pushes the changes automatically.
    type: list
    required: true

  - name: author_email
    description: |
      Git author email.
    type: string
    required: true

  - name: author_name
    description: |
      Git author name.
    type: string
    required: true

  - name: branch
    description: |
      Name of the git source branch.
    type: string
    defaultvalue: "main"
    required: false

  - name: empty_commit
    description: |
      Allow empty commits.

      Usually recording a commit that has the exact same tree as its sole parent commit is a mistake,
      and those commits are not allowed by default.
    type: bool
    defaultvalue: false
    required: false

  - name: followtags
    description: |
      Follow tags for pushes to remote repository.

      Push all the `refs` that would be pushed without this option, and also push annotated tags
      in `refs/tags` that are missing from the remote.
    type: bool
    defaultvalue: false
    required: false

  - name: force
    description: |
      Enable force push to remote repository.
    type: bool
    defaultvalue: false
    required: false

  - name: insecure_skip_ssl_verify
    description: |
      Skip ssl verification of the remote machine.

      Activating this option is insecure and should be avoided in most cases.
    type: bool
    defaultvalue: false
    required: false

  - name: message
    description: |
      Commit message.
    type: string
    defaultvalue: "[skip ci] commit dirty state"
    required: false

  - name: netrc_machine
    description: |
      Netrc remote machine name.
    type: string
    defaultvalue: "github.com"
    required: false

  - name: netrc_password
    description: |
      Netrc login password on the remote machine.
    type: string
    required: false

  - name: netrc_username
    description: |
      Netrc login user on the remote machine.
    type: string
    defaultvalue: "token"
    required: false

  - name: no_verify
    description: |
      Bypass the pre-commit and commit-msg hooks.
    type: bool
    defaultvalue: false
    required: false

  - name: pages_delete
    description: |
      Add delete flag to pages rsync command.

      When set to `true`, the `--delete` flag is added to the rsync command to remove files
      from the branch that do not exist in the `pages_directory` either.
    type: bool
    defaultvalue: true
    required: false

  - name: pages_directory
    description: |
      Source directory to be synchronized with the pages branch.
    type: string
    defaultvalue: "docs/"
    required: false

  - name: pages_exclude
    description: |
      Files or directories to exclude from the pages rsync command.
    type: list
    required: false

  - name: path
    description: |
      Path to clone git repository.
    type: string
    required: false

  - name: remote_url
    description: |
      Url of the remote repository.
    type: string
    required: false

  - name: ssh_key
    description: |
      Ssh private key for the remote repository.
    type: string
    required: false