mirror of
https://github.com/kevin1024/vcrpy.git
synced 2025-12-08 16:53:23 +00:00
cc752cf790
* Collect and aggregate code coverage across all test environments Add Coveralls badge to readme Try CodeCov integration Setup coverage badge for CodeCov Fix CodeCov Badge * Set code coverage regression threshold Attempt to cache bust some boto3 issues on TravisCI * Disable legacy secure strings * Skip boto3 tests on TRAVIS_PULL_REQUEST due to credentials being unavailable Address flake8 issues Debug TRAVIS_PULL_REQUEST ENV Var Trying to get boto3 tests to skip on forked PRs boto3 is not an allowed failure remove TRAVIS ENV debugging * remove pytest skipif that wasn't working * Ignore coverage files
63 lines
2.3 KiB
ReStructuredText
63 lines
2.3 KiB
ReStructuredText
|PyPI| |Python versions| |Build Status| |CodeCov| |Gitter|
|
|
|
|
VCR.py
|
|
======
|
|
|
|
.. image:: https://raw.github.com/kevin1024/vcrpy/master/vcr.png
|
|
:alt: vcr.py
|
|
|
|
This is a Python version of `Ruby's VCR
|
|
library <https://github.com/vcr/vcr>`__.
|
|
|
|
Source code
|
|
https://github.com/kevin1024/vcrpy
|
|
|
|
Documentation
|
|
https://vcrpy.readthedocs.io/
|
|
|
|
Rationale
|
|
---------
|
|
|
|
VCR.py simplifies and speeds up tests that make HTTP requests. The
|
|
first time you run code that is inside a VCR.py context manager or
|
|
decorated function, VCR.py records all HTTP interactions that take
|
|
place through the libraries it supports and serializes and writes them
|
|
to a flat file (in yaml format by default). This flat file is called a
|
|
cassette. When the relevant piece of code is executed again, VCR.py
|
|
will read the serialized requests and responses from the
|
|
aforementioned cassette file, and intercept any HTTP requests that it
|
|
recognizes from the original test run and return the responses that
|
|
corresponded to those requests. This means that the requests will not
|
|
actually result in HTTP traffic, which confers several benefits
|
|
including:
|
|
|
|
- The ability to work offline
|
|
- Completely deterministic tests
|
|
- Increased test execution speed
|
|
|
|
If the server you are testing against ever changes its API, all you need
|
|
to do is delete your existing cassette files, and run your tests again.
|
|
VCR.py will detect the absence of a cassette file and once again record
|
|
all HTTP interactions, which will update them to correspond to the new
|
|
API.
|
|
|
|
License
|
|
=======
|
|
|
|
This library uses the MIT license. See `LICENSE.txt <LICENSE.txt>`__ for
|
|
more details
|
|
|
|
.. |PyPI| image:: https://img.shields.io/pypi/v/vcrpy.svg
|
|
:target: https://pypi.python.org/pypi/vcrpy
|
|
.. |Python versions| image:: https://img.shields.io/pypi/pyversions/vcrpy.svg
|
|
:target: https://pypi.python.org/pypi/vcrpy
|
|
.. |Build Status| image:: https://secure.travis-ci.org/kevin1024/vcrpy.svg?branch=master
|
|
:target: http://travis-ci.org/kevin1024/vcrpy
|
|
.. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg
|
|
:alt: Join the chat at https://gitter.im/kevin1024/vcrpy
|
|
:target: https://gitter.im/kevin1024/vcrpy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
|
|
.. |CodeCov| image:: https://codecov.io/gh/kevin1024/vcrpy/branch/master/graph/badge.svg
|
|
:target: https://codecov.io/gh/kevin1024/vcrpy
|
|
:alt: Code Coverage Status
|
|
|