---
id: polarion
version: "1.4.0"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# polarion — Polarion client for Python

License: permissive · Maintenance: dormant · Downloads: 110.3K/mo

## What it is and what it does

Polarion is a Python wrapper around the Polarion SOAP API that lets you programmatically interact with a Polarion work-item and test-management system. It abstracts the underlying SOAP services (TrackerWebService, PlanningWebService, TestManagementWebService) into Python objects that behave like native Python types—you fetch a workitem, modify its properties, and changes are persisted back to Polarion. The package supports creating and editing workitems, test runs, plans, and documents; managing attachments and custom fields; and adding comments and hyperlinks.

The package is built on zeep (SOAP client), lxml (XML processing), and texttable (output formatting). It requires Python 3.7 or later and is tested through Python 3.12. The project is classified as Alpha and has not seen a release in over two years, though the repository remains public and unarchived.

Use it for:

- Automate bulk creation or modification of Polarion workitems from external data sources or CI/CD pipelines.
- Programmatically update test run results and record outcomes after automated test execution.
- Query and export Polarion plans and workitems for reporting or integration with other tools.
- Add comments and attachments to workitems and test runs without manual UI interaction.
- Manage workitem-to-plan associations and document custom fields in batch operations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client for interacting with Polarion work-item management and test-management systems via SOAP API, allowing you to read, create, and modify workitems, test runs, plans, and documents.

Yes, if you need to automate Polarion interactions and your Polarion instance is stable. The package has low install friction, no known security vulnerabilities, and permissive licensing. However, the dormant maintenance status (no releases in 813 days) means you should verify compatibility with your Polarion version and be prepared to fork or patch if issues arise.

## Install

pip install polarion
uv add polarion
poetry add polarion

## Installing polarion

Before you install: Low install friction with a pure-Python wheel and three stable runtime dependencies. The project is dormant (no releases in 813 days), but the repository remains active and the package is tested through Python 3.12.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart:

pip install polarion

from polarion import polarion
client = polarion.Polarion('http://example.com/polarion', 'user', 'password')
project = client.getProject('Python')
workitem = project.getWorkitem('PYTH-510')

Requires a running Polarion instance accessible at the provided URL and valid credentials.

Verify before relying:

- Whether the package works reliably with Polarion versions released after May 2024.
- Current status of the known issues listed in the documentation (test run statuses, document reference deletion).

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 110.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

polarion client python, polarion workitem management, polarion test run automation, polarion soap api wrapper, polarion plan document access, polarion-integration, test-management, soap-client

[View on SkillFed](https://skillfed.io/packages/polarion) · [View on PyPI](https://pypi.org/project/polarion/)