Modules for interacting with Atlassian products.
Project description
Jira Helper Module
This Python module provides easy and concise methods to interact with Atlassian Jira. With this module, you can:
- Create a Jira ticket.
- Delete a Jira ticket.
- Transition a Jira ticket.
Getting Started
Connectivity to Atlassian Jira
To initialize a connection to Jira, instantiate the JiraHelper
class with your Jira URL, email, and API token:
from atlassian_modules import JiraHelper
jira_helper = JiraHelper(JIRA_URL, EMAIL, API_TOKEN)
Features
1. Create a Jira Ticket
- You can create a new Jira ticket using the
create_ticket
method:
from atlassian_modules import JiraHelper
jira_helper.create_ticket("XX", "Test Issue", "This is a test issue created from main.py", "Task")
Parameters:
project_key
: The key of the project in which the ticket should be created.summary
: A brief summary of the issue.description
: A detailed description of the issue.issue_type
: The type of the issue (e.g., "Task", "Bug", etc.).
2. Delete a Jira Ticket
- To delete a ticket, use the
delete_ticket
method:
from atlassian_modules import JiraHelper
jira_helper.delete_ticket("XX-1234")
Parameter:
ticket_key
: The unique key of the ticket you want to delete.
3. Transition a Jira Ticket
- To transition a ticket to a different status, use the
transition_ticket
method:
from atlassian_modules import JiraHelper
jira_helper.transition_ticket("XX-1234", "In Progress")
Parameters:
ticket_key
: The unique key of the ticket you want to transition.transition_name
: The name of the transition you want to apply. This is not a case sensitive.
Data Privacy Note
🔒 We respect your privacy: This module does not store any of your data anywhere. It simply interacts with the Atlassian Jira API to perform the requested operations. Ensure you manage your connection details securely.
Future Developments
In upcoming releases, I am working to add below functions...
if_exist_ticket
jql_ticket
Please keep an eye on the repository's release notes for the latest updates and feature rollouts.
Release 0.2
- Transition a Jira ticket (Can pass transition ID too)
- Modified README.md for clarity use of this module
Release 0.1
- Create a Jira ticket
- Delete a Jira ticket
- Transition a Jira ticket (Strict to Transition Name)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for atlassian_modules-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52051f728ac5b670b29069d2491db7a238953c5e7221d4c1f80890ee6f965c08 |
|
MD5 | 0987d8f201a0cc7e7a83f500782723f1 |
|
BLAKE2b-256 | 67b381fd83d7700c45a19ecda402314de28adaea7e5a41f087d32a2c5e21f9bd |