Direct Workflow bot
===================

Areas of responsibility
-----------------------

1. Keep ProjectGit in sync with packages in the organization
   * on pushes to package, updates the submodule commit id
     to the default branch HEAD (as configured in Gitea)
   * on repository adds, creates a new submodule (if non empty)
   * on repository removal, removes the submodule


Configuration
-------------

Uses `workflow.config` for configuration. Parameters

* _Workflows_: ["direct"] -- direct entry enables direct workflow. **Mandatory**
* _Organization_: organization that holds all the packages. **Mandatory**
* _Branch_: branch updated in repo's, or blank for default package branch
* _GitProjectName_: package in above org, or `org/package#branch` for PrjGit. By default assumes `_ObsPrj` with default branch and in the `Organization`

NOTE: `-rm`, `-removed`, `-deleted` are all removed suffixes used to indicate current branch is a placeholder for previously existing package. These branches will be ignored by the bot,  and if default, the package will be removed and will not be added to the project.

Running
-------

 * `GITEA_TOKEN` (required)
 * `AMQP_USERNAME` (required)
 * `AMQP_PASSWORD` (required)
 * `AUTOGITS_CONFIG` (required)
 * `AUTOGITS_URL` - default: https://src.opensuse.org
 * `AUTOGITS_RABBITURL` - default: amqps://rabbit.opensuse.org
 * `AUTOGITS_DEBUG` - disabled by default, set to any value to enable
 * `AUTOGITS_CHECK_ON_START` - disabled by default, set to any value to enable
 * `AUTOGITS_REPO_PATH` - default is temporary directory
 * `AUTOGITS_IDENTITY_FILE` - in case where we need explicit identify path for ssh specified

Target Usage
------------

Devel project, where direct pushes to package git are possible