Skip to content

ansible/ansible-collection-memsource

Repository files navigation

Ansible Collection - ansible.memsource

License GitHub Linter

This collection aims to offer an Ansible native experience in order to interact and automate workflows with Memsource. - "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 git@github.com: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 -r 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.