From 0834b63560018bb5d85b0243f265fa37d1c21d24 Mon Sep 17 00:00:00 2001 From: holger krekel Date: Fri, 24 Oct 2014 13:53:39 +0200 Subject: [PATCH] backport fixed issue620 (doc for genscript) --HG-- branch : pytest-2.6 --- CHANGELOG | 4 ++++ _pytest/standalonetemplate.py | 19 +++++++++++++++++++ 2 files changed, 23 insertions(+) diff --git a/CHANGELOG b/CHANGELOG index dcfd1496a..221666d6e 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -15,6 +15,10 @@ - fix issue604: Escape % character in the assertion message. +- fix issue620: add explanation in the --genscript target about what + the binary blob means. Thanks Dinu Gherman. + + 2.6.3 ----------- diff --git a/_pytest/standalonetemplate.py b/_pytest/standalonetemplate.py index b67bf20f3..46d5e41f4 100755 --- a/_pytest/standalonetemplate.py +++ b/_pytest/standalonetemplate.py @@ -1,5 +1,24 @@ #! /usr/bin/env python +# Hi There! +# You may be wondering what this giant blob of binary data here is, you might +# even be worried that we're up to something nefarious (good for you for being +# paranoid!). This is a base64 encoding of a zip file, this zip file contains +# a fully functional basic pytest script. +# +# Pytest is a thing that tests packages, pytest itself is a package that some- +# one might want to install, especially if they're looking to run tests inside +# some package they want to install. Pytest has a lot of code to collect and +# execute tests, and other such sort of "tribal knowledge" that has been en- +# coded in its code base. Because of this we basically include a basic copy +# of pytest inside this blob. We do this because it let's you as a maintainer +# or application developer who wants people who don't deal with python much to +# easily run tests without installing the complete pytest package. +# +# If you're wondering how this is created: you can create it yourself if you +# have a complete pytest installation by using this command on the command- +# line: ``py.test --genscript=runtests.py``. + sources = """ @SOURCES@"""