python-coveralls


Namepython-coveralls JSON
Version 2.9.3 PyPI version JSON
download
home_pagehttp://github.com/z4r/python-coveralls
SummaryPython interface to coveralls.io API
upload_time2019-08-01 19:12:17
maintainer
docs_urlNone
authorAndrea De Marco
requires_python
licenseApache License 2.0
keywords coveralls.io
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            ====================================
Python interface to coveralls.io API
====================================

.. image:: https://api.travis-ci.org/z4r/python-coveralls.png?branch=master
    :target: http://travis-ci.org/z4r/python-coveralls
.. image:: https://coveralls.io/repos/z4r/python-coveralls/badge.png?branch=master
    :target: https://coveralls.io/r/z4r/python-coveralls
.. image:: https://img.shields.io/pypi/v/python-coveralls.svg
    :target: https://pypi.python.org/pypi/python-coveralls/
.. image:: https://img.shields.io/pypi/dm/python-coveralls.svg
    :target: https://pypi.python.org/pypi/python-coveralls/
.. image:: https://img.shields.io/pypi/wheel/python-coveralls.svg
    :target: https://pypi.python.org/pypi/python-coveralls/
    :alt: Wheel Status

This package provides a module to interface with the https://coveralls.io API.

INSTALLING THE PKG
==================
Using pip::

    $ pip install python-coveralls

...Or simply add it to your requirements.


CONFIGURATION
=============
If you're not using Travis, Coveralls for Python uses a ``.coveralls.yml`` file at the root level of your repository to configure options.
The only required option is ``repo_token`` (found on your repository's page on Coveralls) to specify which project on Coveralls your project maps to.
Another important option is is ``service_name`` which allows you to specify where Coveralls should look to find additional information about your builds. This can be any string, but using travis-ci or travis-pro will allow Coveralls to fetch branch data, comment on pull requests, and more.
A ``.coveralls.yml`` file configured for Travis Pro:

.. code-block:: yaml

    repo_token: abcdef1234569abdcef
    service_name: travis-pro
    parallel: true # if the CI is running your build in parallel

if you don't want the ``repo_token`` under source control, set it in your ``coveralls`` command::

    COVERALLS_REPO_TOKEN=abcdef1234569abdcef coveralls

TRAVIS.YML
==========
Create a ``.coverage`` file and you can use `coverage <https://pypi.python.org/pypi/coverage>`_,
`pytest-cov <https://pypi.python.org/pypi/pytest-cov>`_, or
`nosexcover <https://pypi.python.org/pypi/nosexcover>`_.
Then you can add in the **after_success** step::

    coveralls

It should look like something like:

.. code-block:: yaml

    language: python
    python:
      - "2.6"
      - "2.7"
    install:
      - pip install -e . --use-mirrors
    before_script:
      - pip install -r test_requirements.txt --use-mirrors
      - git clone https://github.com/z4r/python-coveralls-example.git
      - cd python-coveralls-example
      - git checkout -qf 17b8119796516195527dcb4f454a2ebd41d60244
      - py.test example/tests.py --cov=example
      - cd -
    script:
      - py.test coveralls/tests.py --doctest-modules --pep8 coveralls -v --cov coveralls --cov-report term-missing
    after_success:
      - coveralls

COVERALLS OPTIONS
=================
You probably don't need to configure anything, but if you customize some option of `coverage` you would add it to `coveralls` too::

    $ coveralls -h
    usage: coveralls [-h] [--coveralls_url COVERALLS_URL] [--base_dir BASE_DIR]
                     [--data_file DATA_FILE] [--config_file CONFIG_FILE]
                     [--coveralls_yaml COVERALLS_YAML] [--ignore-errors]
                     [--merge_file MERGE_FILE] [--nogit]

    optional arguments:
      -h, --help            show this help message and exit
      --coveralls_url COVERALLS_URL, -u COVERALLS_URL
                            coveralls.io api url
      --base_dir BASE_DIR, -b BASE_DIR
                            project root directory
      --data_file DATA_FILE, -d DATA_FILE
                            coverage file name
      --config_file CONFIG_FILE, -c CONFIG_FILE
                            coverage config file name
      --coveralls_yaml COVERALLS_YAML, -y COVERALLS_YAML
                            coveralls yaml file name
      --ignore-errors, -i   ignore errors while reading source files
      --merge_file MERGE_FILE, -m MERGE_FILE
                            json file containing coverage data to be merged (for
                            merging javascript coverage)
      --nogit               do not gather git repo info




.. image:: https://d2weczhvl823v0.cloudfront.net/z4r/python-coveralls/trend.png
   :alt: Bitdeli badge
   :target: https://bitdeli.com/free

            

Raw data

            {
    "_id": null,
    "home_page": "http://github.com/z4r/python-coveralls",
    "name": "python-coveralls",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "coveralls.io",
    "author": "Andrea De Marco",
    "author_email": "24erre@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/a2/55/9db73eeecbb832252e763dc66aa60551fb4560deffda493b56e83602429c/python-coveralls-2.9.3.tar.gz",
    "platform": "",
    "description": "====================================\nPython interface to coveralls.io API\n====================================\n\n.. image:: https://api.travis-ci.org/z4r/python-coveralls.png?branch=master\n    :target: http://travis-ci.org/z4r/python-coveralls\n.. image:: https://coveralls.io/repos/z4r/python-coveralls/badge.png?branch=master\n    :target: https://coveralls.io/r/z4r/python-coveralls\n.. image:: https://img.shields.io/pypi/v/python-coveralls.svg\n    :target: https://pypi.python.org/pypi/python-coveralls/\n.. image:: https://img.shields.io/pypi/dm/python-coveralls.svg\n    :target: https://pypi.python.org/pypi/python-coveralls/\n.. image:: https://img.shields.io/pypi/wheel/python-coveralls.svg\n    :target: https://pypi.python.org/pypi/python-coveralls/\n    :alt: Wheel Status\n\nThis package provides a module to interface with the https://coveralls.io API.\n\nINSTALLING THE PKG\n==================\nUsing pip::\n\n    $ pip install python-coveralls\n\n...Or simply add it to your requirements.\n\n\nCONFIGURATION\n=============\nIf you're not using Travis, Coveralls for Python uses a ``.coveralls.yml`` file at the root level of your repository to configure options.\nThe only required option is ``repo_token`` (found on your repository's page on Coveralls) to specify which project on Coveralls your project maps to.\nAnother important option is is ``service_name`` which allows you to specify where Coveralls should look to find additional information about your builds. This can be any string, but using travis-ci or travis-pro will allow Coveralls to fetch branch data, comment on pull requests, and more.\nA ``.coveralls.yml`` file configured for Travis Pro:\n\n.. code-block:: yaml\n\n    repo_token: abcdef1234569abdcef\n    service_name: travis-pro\n    parallel: true # if the CI is running your build in parallel\n\nif you don't want the ``repo_token`` under source control, set it in your ``coveralls`` command::\n\n    COVERALLS_REPO_TOKEN=abcdef1234569abdcef coveralls\n\nTRAVIS.YML\n==========\nCreate a ``.coverage`` file and you can use `coverage <https://pypi.python.org/pypi/coverage>`_,\n`pytest-cov <https://pypi.python.org/pypi/pytest-cov>`_, or\n`nosexcover <https://pypi.python.org/pypi/nosexcover>`_.\nThen you can add in the **after_success** step::\n\n    coveralls\n\nIt should look like something like:\n\n.. code-block:: yaml\n\n    language: python\n    python:\n      - \"2.6\"\n      - \"2.7\"\n    install:\n      - pip install -e . --use-mirrors\n    before_script:\n      - pip install -r test_requirements.txt --use-mirrors\n      - git clone https://github.com/z4r/python-coveralls-example.git\n      - cd python-coveralls-example\n      - git checkout -qf 17b8119796516195527dcb4f454a2ebd41d60244\n      - py.test example/tests.py --cov=example\n      - cd -\n    script:\n      - py.test coveralls/tests.py --doctest-modules --pep8 coveralls -v --cov coveralls --cov-report term-missing\n    after_success:\n      - coveralls\n\nCOVERALLS OPTIONS\n=================\nYou probably don't need to configure anything, but if you customize some option of `coverage` you would add it to `coveralls` too::\n\n    $ coveralls -h\n    usage: coveralls [-h] [--coveralls_url COVERALLS_URL] [--base_dir BASE_DIR]\n                     [--data_file DATA_FILE] [--config_file CONFIG_FILE]\n                     [--coveralls_yaml COVERALLS_YAML] [--ignore-errors]\n                     [--merge_file MERGE_FILE] [--nogit]\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --coveralls_url COVERALLS_URL, -u COVERALLS_URL\n                            coveralls.io api url\n      --base_dir BASE_DIR, -b BASE_DIR\n                            project root directory\n      --data_file DATA_FILE, -d DATA_FILE\n                            coverage file name\n      --config_file CONFIG_FILE, -c CONFIG_FILE\n                            coverage config file name\n      --coveralls_yaml COVERALLS_YAML, -y COVERALLS_YAML\n                            coveralls yaml file name\n      --ignore-errors, -i   ignore errors while reading source files\n      --merge_file MERGE_FILE, -m MERGE_FILE\n                            json file containing coverage data to be merged (for\n                            merging javascript coverage)\n      --nogit               do not gather git repo info\n\n\n\n\n.. image:: https://d2weczhvl823v0.cloudfront.net/z4r/python-coveralls/trend.png\n   :alt: Bitdeli badge\n   :target: https://bitdeli.com/free\n",
    "bugtrack_url": null,
    "license": "Apache License 2.0",
    "summary": "Python interface to coveralls.io API\n",
    "version": "2.9.3",
    "split_keywords": [
        "coveralls.io"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "148c5358f5f9151706aa4a1acf9522c4",
                "sha256": "fb0ff49bb1551dac10b06bd55e9790287d898a0f1e2c959802235cae08dd0bff"
            },
            "downloads": -1,
            "filename": "python_coveralls-2.9.3-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "148c5358f5f9151706aa4a1acf9522c4",
            "packagetype": "bdist_wheel",
            "python_version": "2.7",
            "requires_python": null,
            "size": 9878,
            "upload_time": "2019-08-01T19:12:20",
            "upload_time_iso_8601": "2019-08-01T19:12:20.159405Z",
            "url": "https://files.pythonhosted.org/packages/3b/2d/8c4cefb1de18817d9e05552e29b3780a713122d6fff6c535461836c90186/python_coveralls-2.9.3-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "5334bf80c510a15f59e530210c6df367",
                "sha256": "bfaf7811e7dc5628e83b6b162962a4e2485dbff184b30e49f380374ed1bcee55"
            },
            "downloads": -1,
            "filename": "python-coveralls-2.9.3.tar.gz",
            "has_sig": false,
            "md5_digest": "5334bf80c510a15f59e530210c6df367",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 9036,
            "upload_time": "2019-08-01T19:12:17",
            "upload_time_iso_8601": "2019-08-01T19:12:17.540957Z",
            "url": "https://files.pythonhosted.org/packages/a2/55/9db73eeecbb832252e763dc66aa60551fb4560deffda493b56e83602429c/python-coveralls-2.9.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2019-08-01 19:12:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "z4r",
    "github_project": "python-coveralls",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": false,
    "appveyor": true,
    "test_requirements": [
        {
            "name": "pytest",
            "specs": []
        },
        {
            "name": "pytest-pep8",
            "specs": []
        },
        {
            "name": "pytest-cov",
            "specs": []
        },
        {
            "name": "httpretty",
            "specs": []
        }
    ],
    "lcname": "python-coveralls"
}
        
Elapsed time: 0.01581s