Skip to main content

Tool to sync work items from Azure DevOps to Asana

Project description

ado-asana-sync

Test and Lint Quality Gate Status Coverage

Release PyPI - Version

Open in Visual Studio Code

This project aims to synchronize work items between Azure DevOps (ADO) and Asana. It's currently in development and not ready for use. Breaking changes will occur as needed.

How to use

  • Get the latest container image from the Github Container Registry.
  • Configure the environment variables with the relevant values:
    • ADO_PAT - Your Personal Access Token for ADO to accesst the work items.
    • ADO_URL - The full URL of your Azure DevOps instance.
    • ASANA_TOKEN - Your Personal Access Token for Asana to access the work items.
    • ASANA_WORKSPACE_NAME - Name of the Asana workspace to sync with.
    • CLOSED_STATES - Comma separated list of states that will be considered closed.
    • THREAD_COUNT - Number of projects to sync in parallel. Must be a positive integer.
    • SLEEP_TIME - Duration in seconds to sleep between sync runs. Must be a positive integer.
    • SYNCED_TAG_NAME - Name of the tag in Asana to append to all synced items. Must be a valid Asana tag name.
  • Run the container with the configured environment variables.
  • The application will start syncing work items between ADO and Asana based on the configured settings.

Development

Commit message style

This repo uses Conventional Commits to ensure the build numbering is generated correctly

Manual testing

To test the application manually, you can use the following steps:

  1. Create new ADO work item and ensure it is synced to Asana.
  2. Rename Asana task and ensure it is reverted back to the ADO name.
  3. Rename ADO task and ensure it is synced to Asana.
  4. Remove Synced tag from item in Asana and ensure it is replaced.
  5. Delete synced tag from Asana workspace and from appdata.json file and ensure it is re-created and assigned to all synced tasks.
  6. Mark Asana task as complete and ensure it is re-opened.
  7. Mark ADO task as complete and ensure it is marked as complete in Asana.
  8. Re-open ADO task and ensure it is re-opened in Asana.

Reference

ADO

Asana

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ado_asana_sync-1.6.0.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

ado_asana_sync-1.6.0-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

Details for the file ado_asana_sync-1.6.0.tar.gz.

File metadata

  • Download URL: ado_asana_sync-1.6.0.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ado_asana_sync-1.6.0.tar.gz
Algorithm Hash digest
SHA256 aa1e3ca00b103685cc6452564fd97d1a0124c8bd8e98a97e2dcd2850eeaabc28
MD5 9a2f637e97e70474246843a4e4e10ece
BLAKE2b-256 a379c0a4fd93b2c40121e254785da2aedb76c4ccb03108b160d4740c5f10590c

See more details on using hashes here.

File details

Details for the file ado_asana_sync-1.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ado_asana_sync-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d04c4dcb8babbd0950b3073d3d7a79310585e9f463aa876662f5dae62af2188
MD5 33cc4e4e5e5b6ec5aa6f0155735210cb
BLAKE2b-256 7c07ab8725743057950543b495416b6fd208d5d36e1509a320bf2cc8f5acd34c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page