/usr/share/doc/python-pytest-doc/html/adopt.html is in python-pytest-doc 3.0.6-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>April 2015 is “adopt pytest month” — pytest documentation</title>
<link rel="stylesheet" href="_static/flasky.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '3.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="shortcut icon" href="_static/pytest1favi.ico"/>
<link rel="search" title="Search" href="search.html" />
<link rel="top" title="pytest documentation" href="contents.html" />
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9">
</head>
<body role="document">
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="nav-item nav-item-0"><a href="contents.html">pytest-3.0</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="april-2015-is-adopt-pytest-month">
<h1>April 2015 is “adopt pytest month”<a class="headerlink" href="#april-2015-is-adopt-pytest-month" title="Permalink to this headline">¶</a></h1>
<p>Are you an enthusiastic pytest user, the local testing guru in your workplace? Or are you considering using pytest for your open source project, but not sure how to get started? Then you may be interested in “adopt pytest month”!</p>
<p>We will pair experienced pytest users with open source projects, for a month’s effort of getting new development teams started with pytest.</p>
<p>In 2015 we are trying this for the first time. In February and March 2015 we will gather volunteers on both sides, in April we will do the work, and in May we will evaluate how it went. This effort is being coordinated by Brianna Laugher. If you have any questions or comments, you can raise them on the <a class="reference external" href="https://twitter.com/pytestdotorg">@pytestdotorg twitter account</a> the <a class="reference external" href="https://github.com/pytest-dev/pytest/issues/676">issue tracker</a> or the <a class="reference external" href="https://mail.python.org/mailman/listinfo/pytest-dev">pytest-dev mailing list</a>.</p>
<div class="section" id="the-ideal-pytest-helper">
<h2>The ideal pytest helper<a class="headerlink" href="#the-ideal-pytest-helper" title="Permalink to this headline">¶</a></h2>
<blockquote>
<div><ul class="simple">
<li>will be able to commit 2-4 hours a week to working with their particular project (this might involve joining their mailing list, installing the software and exploring any existing tests, offering advice, writing some example tests)</li>
<li>feels confident in using pytest (e.g. has explored command line options, knows how to write parametrized tests, has an idea about conftest contents)</li>
<li>does not need to be an expert in every aspect!</li>
</ul>
</div></blockquote>
<p><a class="reference external" href="http://goo.gl/forms/nxqAhqWt1P">Pytest helpers, sign up here</a>! (preferably in February, hard deadline 22 March)</p>
</div>
<div class="section" id="the-ideal-partner-project">
<h2>The ideal partner project<a class="headerlink" href="#the-ideal-partner-project" title="Permalink to this headline">¶</a></h2>
<blockquote>
<div><ul class="simple">
<li>is open source, and predominantly written in Python</li>
<li>has an automated/documented install process for developers</li>
<li>has more than one core developer</li>
<li>has at least one official release (e.g. is available on pypi)</li>
<li>has the support of the core development team, in trying out pytest adoption</li>
<li>has no tests... or 100% test coverage... or somewhere in between!</li>
</ul>
</div></blockquote>
<p><a class="reference external" href="http://goo.gl/forms/ZGyqlHiwk3">Partner projects, sign up here</a>! (by 22 March)</p>
</div>
<div class="section" id="what-does-it-mean-to-adopt-pytest">
<h2>What does it mean to “adopt pytest”?<a class="headerlink" href="#what-does-it-mean-to-adopt-pytest" title="Permalink to this headline">¶</a></h2>
<p>There can be many different definitions of “success”. Pytest can run many <a class="reference external" href="faq.html#how-does-pytest-relate-to-nose-and-unittest">nose and unittest</a> tests by default, so using pytest as your testrunner may be possible from day 1. Job done, right?</p>
<p>Progressive success might look like:</p>
<blockquote>
<div><ul class="simple">
<li>tests can be run (by pytest) without errors (there may be failures)</li>
<li>tests can be run (by pytest) without failures</li>
<li>test runner is integrated into CI server</li>
<li><dl class="first docutils">
<dt>existing tests are rewritten to take advantage of pytest features - this can happen in several iterations, for example:</dt>
<dd><ul class="first last">
<li>changing to native <a class="reference external" href="asserts.html">assert</a> statements (<a class="reference external" href="https://bitbucket.org/hpk42/pycmd/overview">pycmd</a> has a script to help with that, <code class="docutils literal"><span class="pre">pyconvert_unittest.py</span></code>)</li>
<li>changing <a class="reference external" href="xunit_setup.html">setUp/tearDown methods</a> to <a class="reference external" href="fixture.html">fixtures</a></li>
<li>adding <a class="reference external" href="markers.html">markers</a></li>
<li>other changes to reduce boilerplate</li>
</ul>
</dd>
</dl>
</li>
<li>assess needs for future tests to be written, e.g. new fixtures, <a class="reference external" href="xdist.html">distributed</a> testing tweaks</li>
</ul>
</div></blockquote>
<p>“Success” should also include that the development team feels comfortable with their knowledge of how to use pytest. In fact this is probably more important than anything else. So spending a lot of time on communication, giving examples, etc will probably be important - both in running the tests, and in writing them.</p>
<p>It may be after the month is up, the partner project decides that pytest is not right for it. That’s okay - hopefully the pytest team will also learn something about its weaknesses or deficiencies.</p>
</div>
<div class="section" id="other-ways-to-help">
<h2>Other ways to help<a class="headerlink" href="#other-ways-to-help" title="Permalink to this headline">¶</a></h2>
<p>Promote! Do your favourite open source Python projects use pytest? If not, why not tell them about this page?</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="contents.html">
<img class="logo" src="_static/pytest1.png" alt="Logo"/>
</a></p><h3><a href="contents.html">Table Of Contents</a></h3>
<ul>
<li><a href="index.html">Home</a></li>
<li><a href="contents.html">Contents</a></li>
<li><a href="getting-started.html">Install</a></li>
<li><a href="example/index.html">Examples</a></li>
<li><a href="customize.html">Customize</a></li>
<li><a href="contact.html">Contact</a></li>
<li><a href="talks.html">Talks/Posts</a></li>
<li><a href="changelog.html">Changelog</a></li>
<li><a href="license.html">License</a></li>
</ul>
<hr>
<ul>
<li><a class="reference internal" href="#">April 2015 is “adopt pytest month”</a><ul>
<li><a class="reference internal" href="#the-ideal-pytest-helper">The ideal pytest helper</a></li>
<li><a class="reference internal" href="#the-ideal-partner-project">The ideal partner project</a></li>
<li><a class="reference internal" href="#what-does-it-mean-to-adopt-pytest">What does it mean to “adopt pytest”?</a></li>
<li><a class="reference internal" href="#other-ways-to-help">Other ways to help</a></li>
</ul>
</li>
</ul>
<h3>Related Topics</h3>
<ul>
<li><a href="contents.html">Documentation overview</a><ul>
</ul></li>
</ul><h3>Useful Links</h3>
<ul>
<li><a href="index.html">The pytest Website</a></li>
<li><a href="contributing.html">Contribution Guide</a></li>
<li><a href="https://pypi.python.org/pypi/pytest">pytest @ PyPI</a></li>
<li><a href="https://github.com/pytest-dev/pytest/">pytest @ GitHub</a></li>
<li><a href="http://plugincompat.herokuapp.com/">3rd party plugins</a></li>
<li><a href="https://github.com/pytest-dev/pytest/issues">Issue Tracker</a></li>
<li><a href="https://media.readthedocs.org/pdf/pytest/latest/pytest.pdf">PDF Documentation</a>
</ul>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
© Copyright 2017, holger krekel and pytest-dev team.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a>.
</div>
</body>
</html>
|