pymsteams-workflow 1.0.2

Description:

pymsteamsworkflow 1.0.2

pymsteams
Python Wrapper Library to send requests to Microsoft Teams via Microsoft Power Automate workflows.
I have created this library because the Microsoft Teams Webhook is being retired. Retirement of Office 365 connectors within Microsoft Teams
Overview
This library allows sending messages with rich formatting to Microsoft Teams by utilizing Power Automate workflows. Messages can include simple text, titles, link buttons, and more. You can also use asynchronous operations to send messages in parallel.
Installation
Install with pip:
pip install pymsteams

Usage
Creating ConnectorCard Messages
Below is a basic example demonstrating how to send a message using a Power Automate workflow URL:
from pymsteams import connectorcard

# You must create the connectorcard object with the Power Automate URL
myTeamsMessage = connectorcard("<Power Automate URL>")

# Add text to the message
myTeamsMessage.text("This is my text")

# Send the message
myTeamsMessage.send()

Asynchronous ConnectorCard Messages
You can send messages asynchronously using async_connectorcard. This is useful when sending multiple messages or performing other asynchronous tasks.
import asyncio
from pymsteams import async_connectorcard

loop = asyncio.get_event_loop()

# The async_connectorcard object is used for asynchronous operations
myTeamsMessage = async_connectorcard("<Power Automate URL>")

# Add text to the message
myTeamsMessage.text("This is my async message")

# Send the message asynchronously
loop.run_until_complete(myTeamsMessage.send())

Optional Formatting Methods
Add a Title
You can add a title to the message, which will be displayed prominently:
myTeamsMessage.title("This is my message title")

Add a Link Button
Add a link button to your message to redirect users to a specific URL:
myTeamsMessage.addLinkButton("This is the button Text", "https://example.com")

Example: Sending a Message with a Title and Link Button
Here's a complete example of sending a message with both a title and a link button:
from your_module import connectorcard # Replace 'your_module' with your module name

webhook_url = "<Power Automate URL>"

# Create the connector card
card = connectorcard(webhook_url)
card.title("Important Notification")
card.text("Please review the latest updates.")
card.addLinkButton("Review Updates", "https://example.com/updates")

# Send the message
card.send()

Exception Handling
If the call to the Power Automate service fails, a TeamsWebhookException will be thrown. Ensure you handle this exception in your code:
try:
card.send()
except TeamsWebhookException as e:
print(f"Failed to send message: {e}")

Testing
In order to test in your environment with pytest, set the environment variable MS_TEAMS_WORKFLOW to the Power Automate workflow URL you would like to use.
Then, from the root of the repo, install the requirements and run pytest.
pip install -r dev-requirements.txt
MS_TEAMS_WORKFLOW=<PowerAutomateURL>
export MS_TEAMS_WORKFLOW
pytest --cov=./your_module --cov-report=term-missing --cov-branch # Replace 'your_module' with your module name

Docs

Send a message in Teams using Power Automate
apprise Notify_workflows
Retirement of Office 365 connectors within Microsoft Teams