Skip to main content

Send test results to TeamCity continuous integration server from unittest, nose, py.test, twisted trial, behave (Python 2.6+)

Project description

Official JetBrains project Apache 2.0 license PyPI version
Python versions supported TeamCity Build Status

This package integrates Python with the TeamCity Continuous Integration (CI) server. It allows sending “service messages” from Python code. Additionally, it provides integration with the following testing frameworks and tools:


Install using pip:

pip install teamcity-messages

or from source:

python install


This package uses service messages to report the build status to TeamCity. See for more details


If you wish to use the Python default unittest framework, you should modify the Test runner, e.g.:

import unittest
from teamcity import is_running_under_teamcity
from teamcity.unittestpy import TeamcityTestRunner

class Test(unittest.TestCase):

if __name__ == '__main__':
    if is_running_under_teamcity():
        runner = TeamcityTestRunner()
        runner = unittest.TextTestRunner()

See examples/ for a full example.

If you are used to running unittest from the command line, instead of using python -m unittest, you could use python -m teamcity.unittestpy.


Test status reporting is enabled automatically under TeamCity build.


Test status reporting is enabled automatically under TeamCity build.


For Django 1.6+: Use the TeamcityDjangoRunner runner instead of the default DiscoverRunner by changing the following setting in your

TEST_RUNNER = "teamcity.django.TeamcityDjangoRunner"

If you are using another test runner, you should override the run_suite method or use the DiscoverRunner.test_runner property introduced in Django 1.7.


Test status reporting is enabled automatically under TeamCity build.


Add --output-format=teamcity.pylint_reporter.TeamCityReporter to the pylint command line.


Pass TEAMCITY_VERSION environment variable inside your test virtenv. TEAMCITY_VERSION environment variable exists during build on TeamCity. teamcity-messages uses it in order to enable reporting to TeamCity.


Twisted trial

Add --reporter=teamcity option to trial command line


For Behave 1.2.6:

from behave.formatter import _registry
from behave.configuration import Configuration
from behave.runner import Runner
from teamcity.jb_behave_formatter import TeamcityFormatter

_registry.register_as("TeamcityFormatter", TeamcityFormatter)
configuration = Configuration()
configuration.format = ["TeamcityFormatter"]
configuration.stdout_capture = False
configuration.stderr_capture = False

Python version compatibility

See for Python version compatibility


Apache, version 2.0

Change Log

Version 1.29 Fri Jun 25 2021
  • python: supported Python 3.9
  • support pylint >= 2.8 by @Tirzono #242
  • pytest: add an option to swap actual/expected in diff
Version 1.28 Thu Apr 30 2020
  • support coverage >= 5.0.1 by @enkelli #225 #218
  • python: dropped Python 2.6, 3.5 support. Latest version to support them is 1.27
  • python: supported Python 3.8
Version 1.27 Fri Nov 8 2019
  • pylint: more compatibility fixes #215
Version 1.26 Tue Nov 5 2019
  • drop Python 3.4 support
  • pylint: support pylint >= 2.3 by @PetrWolf #215
  • unittest: fix test hierarchy for subtests in tests with doc comments by @throwable-one #221
Version 1.25 Mon Apr 15 2019
  • pytest: fix comparing asserts by @ikonst #210
  • Retry writes to stream on a EAGAIN IOError by @morganwahl #213
Version 1.24 Mon Mar 18 2019
  • pylint: initial support by @PetrWolf #171 #200
Version 1.23 Sun Mar 10 2019
  • Correct supported python versions, description, keywords

Version 1.22 Sun Mar 10 2019

  • python: dropped Python 2.4, 2.5, 3.2, 3.3 support. Latest version to support them is 1.21
  • python: supported Python 3.6, 3.7
  • behave: initial support
  • unittest: subtests support
  • various unicode fixes
  • nose, unittest: correctly capture stdout to provide better test output
  • twisted: format twisted Failure objects by @jackrobison
  • various test infrastructure fixes by @sambrightman
  • flake8: correctly initialize options by @sambrightman
  • various fixes to use teamcity-messages code in JetBrains PyCharm IDE

Version 1.21 Mon Jan 2 2017

  • pytest: internal Error during test collection with pytest and teamcity-messages plugin #112
  • nose: support capturing test output from successful tests, #113
  • Fix possible error when joining bytes and unicode (Victor Makarov,

Version 1.20 Wed Aug 3 2016

Version 1.19 Sun Jun 26 2016

Version 1.18 Fri May 27 2016

Version 1.17 Sat Oct 17 2015

  • support coverage >= 4.0
  • automatically detect TeamCity in flake8 plugin (Marc Abramowitz,
  • more messages support (Marc Abramowitz, buildProblem, buildStatus, setParameter, importData, enableServiceMessages, disableServiceMessages etc

Version 1.16 Sat Sep 12 2015

Version 1.15 Fri Aug 28 2015

Version 1.14 Sat May 23 2015

Version 1.13 Sun Mar 29 2015

Version 1.12 Fri Jan 16 2015

  • unittest: fix 2.6 compat

Version 1.11 Fri Jan 16 2015

  • nose: handle errors/failures in teardown/setup
  • nose: support multiprocess mode
  • nose: correctly report captured output
  • unittest: support skipped tests in Python 2.6 (by unittest2)
  • unittest: support subtests (Python 3.4+)

Version 1.10 Fri Jan 09 2015

Version 1.9 Thu Jan 08 2015

  • Django support (Ralph Broenink,
  • Fix test hierarchies on nose and py.test
  • py.test: report errors in setup and teardown
  • py.test: report collect errors
  • py.test: support xfail
  • nose: support skipped tests
  • unittest: support skip, expected failure and unexpected success
  • Totally rewritten integration tests * Thanks to Ralph Broenink ( and Leonid Bushuev (

Version 1.8 Sat Feb 08 2014

  • extensive tests for nose integration (James Carpenter)
  • added timestamps to TeamCity service messages (James Carpenter)

Version 1.7 Sun Feb 03 2013

  • py.test support (Aaron Buchanan)
  • official Python 3 support

Version 1.6 Tue Dec 06 2011

  • Bundle forgotten examples/

Version 1.4 Tue Apr 27 2010

Version 1.3 Fri Apr 11 2008

Version 1.2 Thu Apr 10 2008

  • Fixed tests gold data

Version 1.1 Thu Apr 10 2008

  • Fixed README

Version 1.0 Tue Apr 08 2008

  • initial release

Project details

Download files

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

Files for teamcity-messages, version 1.29
Filename, size File type Python version Upload date Hashes
Filename, size teamcity_messages-1.29-py3-none-any.whl (32.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size teamcity-messages-1.29.tar.gz (33.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page