samkenxstream/turnkey-triumph-326606_ansible-collection-memsource

An Ansible collection to manage Memsource content

Ansible Collection - ansible.memsource

This collection aims to offer an Ansible native experience in order to interact and automate workflows with Memsouce. - "Helping global companies translate efficiently"

Included content

Modules

Name	Description
memsource_import_settings	Manage a Memsource import settings configuration
memsource_import_settings_info	List all available Memsource import settings configurations
memsource_job	Manage a Memsource job
memsource_job_info	List all Memsource job
memsource_job_targetfile	Download a Memsource job target file
memsource_project	Manage a Memsource project
memsource_project_info	List all Memsource projects available
memsource_project_template_info	List all Memsource project templates available

Roles

Name	Description
pre_translation	Role to extract strings from a project and upload to Memsource
post_translation	Role to pull translated strings from Memsource and push to the respective project

Note: Please read the requirements of each Role's README.md before executing the role

Installing this collection

You can install the memsource collection with the Ansible Galaxy CLI:

#> ansible-galaxy collection install ansible.memsource

To install directly from GitHub:

#> ansible-galaxy collection install [email protected]:ansible/ansible-collection-memsource.git

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: ansible.memsource

The python module dependencies are not installed by ansible-galaxy. They can be manually installed using pip:

#> pip install requirements.txt

or:

pip install python-memsource

Using this collection

You can either call modules by their Fully Qualified Collection Namespace (FQCN), such as ansible.memsource.memsource_project, or you can call modules by their short name if you list the ansible.memsource collection in the playbook's collections keyword:

---
  - name: Get recent project
    ansible.memsource.memsource_project_info:
      project_name: "Foo"
    register: project

Authentication

There are two supported ways for a user to authenticate with the Memsource API:

• Using the environment variables $MEMSOURCE_USERNAME and $MEMSOURCE_PASSWORD
• Using the per task level configuration modules memsource_username and memsource_password

Contributing to this collection

We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the Memsource collection repository.

See Contributing to Ansible-maintained collections for more details.