[ { "path": ".gitattributes", "content": "*.py linguist-language=Python\n*.html linguist-language=Python" }, { "path": ".gitignore", "content": "# Created by .ignore support plugin (hsz.mobi)\n### Python template\n# Byte-compiled / optimized / DLL files\n__pycache__/\n*.py[cod]\n*$py.class\n\n# C extensions\n*.so\n# Distribution / packaging\n.Python\nbuild/\ndevelop-eggs/\ndist/\ndownloads/\neggs/\n.eggs/\nlib/\nlib64/\nparts/\nsdist/\nvar/\nwheels/\npip-wheel-metadata/\nshare/python-wheels/\n*.egg-info/\n.installed.cfg\n*.egg\nMANIFEST\n\n# PyInstaller\n# Usually these files are written by a python script from a template\n# before PyInstaller builds the exe, so as to inject date/other infos into it.\n*.manifest\n*.spec\n\n# Installer logs\npip-log.txt\npip-delete-this-directory.txt\n\n# Unit test / coverage reports\nhtmlcov/\n.tox/\n.nox/\n.coverage\n.coverage.*\n.cache\nnosetests.xml\ncoverage.xml\n*.cover\n.hypothesis/\n.pytest_cache/\n\n# Translations\n*.mo\n*.pot\n\n# Django stuff:\n*.log\nlocal_settings.py\ndb.sqlite3\n\n# Flask stuff:\ninstance/\n.webassets-cache\n\n# Scrapy stuff:\n.scrapy\n\n# Sphinx documentation\ndocs/_build/\n\n# PyBuilder\ntarget/\n\n# Jupyter Notebook\n.ipynb_checkpoints\n\n# IPython\nprofile_default/\nipython_config.py\n\n# pyenv\n.python-version\n\n# pipenv\n# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.\n# However, in case of collaboration, if having platform-specific dependencies or dependencies\n# having no cross-platform support, pipenv may install dependencies that don't work, or not\n# install all needed dependencies.\n#Pipfile.lock\n\n# celery beat schedule file\ncelerybeat-schedule\n\n# SageMath parsed files\n*.sage.py\n\n# Environments\n.env\n.venv\nenv/\nvenv/\nENV/\nenv.bak/\nvenv.bak/\n\n# Spyder project settings\n.spyderproject\n.spyproject\n\n# Rope project settings\n.ropeproject\n\n# mkdocs documentation\n/site\n\n# mypy\n.mypy_cache/\n.dmypy.json\ndmypy.json\n\n# Pyre type checker\n.pyre/\n\n.idea/*\n/.idea/*\nUntitled.ipynb\n/.ipynb_checkpoints/\n" }, { "path": "HTMLTestRunner_cn.py", "content": "#-*- coding: utf-8 -*-\n\"\"\"\nA TestRunner for use with the Python unit testing framework. It\ngenerates a HTML report to show the result at a glance.\n\nThe simplest way to use this is to invoke its main method. E.g.\n\n import unittest\n import HTMLTestRunner\n\n ... define your tests ...\n\n if __name__ == '__main__':\n HTMLTestRunner.main()\n\n\nFor more customization options, instantiates a HTMLTestRunner object.\nHTMLTestRunner is a counterpart to unittest's TextTestRunner. E.g.\n\n # output to a file\n fp = file('my_report.html', 'wb')\n runner = HTMLTestRunner.HTMLTestRunner(\n stream=fp,\n title='My unit test',\n description='This demonstrates the report output by HTMLTestRunner.'\n )\n\n # Use an external stylesheet.\n # See the Template_mixin class for more customizable options\n runner.STYLESHEET_TMPL = ''\n\n # run the test\n runner.run(my_test_suite)\n\n\n------------------------------------------------------------------------\nCopyright (c) 2004-2007, Wai Yip Tung\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n* Redistributions of source code must retain the above copyright notice,\n this list of conditions and the following disclaimer.\n* Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n* Neither the name Wai Yip Tung nor the names of its contributors may be\n used to endorse or promote products derived from this software without\n specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS\nIS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER\nOR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\"\"\"\n\n# URL: http://tungwaiyip.info/software/HTMLTestRunner.html\n\n__author__ = \"Wai Yip Tung\"\n__version__ = \"0.8.3\"\n\n\n\"\"\"\nChange History\nVersion 0.8.4 by GoverSky\n* Add sopport for 3.x\n* Add piechart for resultpiechart\n* Add Screenshot for selenium_case test\n* Add Retry on failed\n\nVersion 0.8.3\n* Prevent crash on class or module-level exceptions (Darren Wurf).\n\nVersion 0.8.2\n* Show output inline instead of popup window (Viorel Lupu).\n\nVersion in 0.8.1\n* Validated XHTML (Wolfgang Borgert).\n* Added description of test classes and test cases.\n\nVersion in 0.8.0\n* Define Template_mixin class for customization.\n* Workaround a IE 6 bug that it does not treat \n%(heading)s\n
\n
\n \n
\n
\n%(report)s\n%(ending)s\n\n\n\n\"\"\"\n # variables: (title, generator, stylesheet, heading, report, ending)\n\n\n # ------------------------------------------------------------------------\n # Stylesheet\n #\n # alternatively use a for external style sheet, e.g.\n # \n\n STYLESHEET_TMPL = \"\"\"\n\n\"\"\"\n\n # ------------------------------------------------------------------------\n # Heading\n #\n\n HEADING_TMPL = \"\"\"
\n

%(title)s

\n%(parameters)s\n

%(description)s

\n
\n\n\"\"\" # variables: (title, parameters, description)\n\n HEADING_ATTRIBUTE_TMPL = \"\"\"

%(name)s: %(value)s

\n\"\"\" # variables: (name, value)\n\n # ------------------------------------------------------------------------\n # Report\n #\n\n REPORT_TMPL = \"\"\"\n
\n概要[%(Pass_p).2f%%]\n通过[%(Pass)s]\n失败[%(fail)s]\n错误[%(error)s]\n跳过[%(skip)s]\n所有[%(total)s]\n
\n\n\n\n\n\n\n\n\n\n\n\n\n \n \n \n \n \n \n \n\n%(test_list)s\n\n \n \n \n \n \n \n \n\n
测试组/测试用例总数通过失败错误视图错误截图
统计%(count)s%(Pass)s%(fail)s%(error)s  
\n\n\"\"\"\n # variables: (test_list, count, Pass, fail, error)\n\n REPORT_CLASS_TMPL = r\"\"\"\n\n %(desc)s\n %(count)s\n %(Pass)s\n %(fail)s\n %(error)s\n 详情\n  \n\n\"\"\" # variables: (style, desc, count, Pass, fail, error, cid)\n\n REPORT_TEST_WITH_OUTPUT_TMPL = r\"\"\"\n\n
%(desc)s
\n \n\n \n \n \n %(status)s\n\n
\n
\n \n [x]\n
\n 
\n        %(script)s\n
\n
\n \n\n \n %(img)s\n\n\"\"\" # variables: (tid, Class, style, desc, status,img)\n\n REPORT_TEST_NO_OUTPUT_TMPL = r\"\"\"\n\n
%(desc)s
\n %(status)s\n %(img)s\n\n\"\"\" # variables: (tid, Class, style, desc, status,img)\n\n REPORT_TEST_OUTPUT_TMPL = r\"\"\"\n%(id)s: %(output)s\n\"\"\" # variables: (id, output)\n\n\n IMG_TMPL = r\"\"\"\n 显示截图\n
\n \n %(imgs)s\n
\n
\n \"\"\"\n # ------------------------------------------------------------------------\n # ENDING\n #\n\n ENDING_TMPL = \"\"\"
 
\"\"\"\n\n # -------------------- The end of the Template class -------------------\n\n def __getattribute__(self, item):\n value = object.__getattribute__(self, item)\n if PY3K:\n return value\n else:\n if isinstance(value, str):\n return value.decode(\"utf-8\")\n else:\n return value\n\n\nTestResult = unittest.TestResult\n\n\nclass _TestResult(TestResult):\n # note: _TestResult is a pure representation of results.\n # It lacks the output and reporting ability compares to unittest._TextTestResult.\n shouldStop=False\n def __init__(self, verbosity=1, retry=0,save_last_try=False):\n TestResult.__init__(self)\n\n self.stdout0 = None\n self.stderr0 = None\n self.success_count = 0\n self.failure_count = 0\n self.error_count = 0\n self.skip_count = 0\n self.verbosity = verbosity\n\n # result is a list of result in 4 tuple\n # (\n # result code (0: success; 1: fail; 2: error;3:skip),\n # TestCase object,\n # Test output (byte string),\n # stack trace,\n # )\n self.result = []\n self.retry = retry\n self.trys = 0\n self.status = 0\n\n self.save_last_try = save_last_try\n self.outputBuffer = StringIO.StringIO()\n\n def startTest(self, test):\n # test.imgs = []\n test.imgs = getattr(test, \"imgs\", [])\n # TestResult.startTest(self, test)\n self.outputBuffer.seek(0)\n self.outputBuffer.truncate()\n stdout_redirector.fp = self.outputBuffer\n stderr_redirector.fp = self.outputBuffer\n self.stdout0 = sys.stdout\n self.stderr0 = sys.stderr\n sys.stdout = stdout_redirector\n sys.stderr = stderr_redirector\n\n def complete_output(self):\n \"\"\"\n Disconnect output redirection and return buffer.\n Safe to call multiple times.\n \"\"\"\n if self.stdout0:\n sys.stdout = self.stdout0\n sys.stderr = self.stderr0\n self.stdout0 = None\n self.stderr0 = None\n return self.outputBuffer.getvalue()\n\n def stopTest(self, test):\n # Usually one of addSuccess, addError or addFailure would have been called.\n # But there are some path in unittest that would bypass this.\n # We must disconnect stdout in stopTest(), which is guaranteed to be called.\n if self.retry and self.retry>=1:\n if self.status == 1:\n self.trys += 1\n if self.trys <= self.retry:\n if self.save_last_try:\n t = self.result.pop(-1)\n if t[0]==1:\n self.failure_count -=1\n else:\n self.error_count -= 1\n test=copy.copy(test)\n sys.stderr.write(\"Retesting... \")\n sys.stderr.write(str(test))\n sys.stderr.write('..%d \\n' % self.trys)\n doc = getattr(test,'_testMethodDoc',u\"\") or u''\n if doc.find('_retry')!=-1:\n doc = doc[:doc.find('_retry')]\n desc =\"%s_retry:%d\" %(doc, self.trys)\n if not PY3K:\n if isinstance(desc, str):\n desc = desc.decode(\"utf-8\")\n test._testMethodDoc = desc\n test(self)\n else:\n self.status = 0\n self.trys = 0\n self.complete_output()\n\n def addSuccess(self, test):\n self.success_count += 1\n self.status = 0\n TestResult.addSuccess(self, test)\n output = self.complete_output()\n self.result.append((0, test, output, ''))\n if self.verbosity > 1:\n sys.stderr.write('P ')\n sys.stderr.write(str(test))\n sys.stderr.write('\\n')\n else:\n sys.stderr.write('P')\n\n def addFailure(self, test, err):\n self.failure_count += 1\n self.status = 1\n TestResult.addFailure(self, test, err)\n _, _exc_str = self.failures[-1]\n output = self.complete_output()\n self.result.append((1, test, output, _exc_str))\n if not getattr(test, \"driver\",\"\"):\n pass\n else:\n try:\n driver = getattr(test, \"driver\")\n test.imgs.append(driver.get_screenshot_as_base64())\n except Exception as e:\n pass\n if self.verbosity > 1:\n sys.stderr.write('F ')\n sys.stderr.write(str(test))\n sys.stderr.write('\\n')\n else:\n sys.stderr.write('F')\n\n def addError(self, test, err):\n self.error_count += 1\n self.status = 1\n TestResult.addError(self, test, err)\n _, _exc_str = self.errors[-1]\n output = self.complete_output()\n self.result.append((2, test, output, _exc_str))\n if not getattr(test, \"driver\",\"\"):\n pass\n else:\n try:\n driver = getattr(test, \"driver\")\n test.imgs.append(driver.get_screenshot_as_base64())\n except Exception:\n pass\n if self.verbosity > 1:\n sys.stderr.write('E ')\n sys.stderr.write(str(test))\n sys.stderr.write('\\n')\n else:\n sys.stderr.write('E')\n\n def addSkip(self, test, reason):\n self.skip_count += 1\n self.status = 0\n TestResult.addSkip(self, test,reason)\n output = self.complete_output()\n self.result.append((3, test, output, reason))\n if self.verbosity > 1:\n sys.stderr.write('K')\n sys.stderr.write(str(test))\n sys.stderr.write('\\n')\n else:\n sys.stderr.write('K')\n\nclass HTMLTestRunner(Template_mixin):\n def __init__(self, stream=sys.stdout, verbosity=1, title=None, description=None,is_thread=False, retry=0,save_last_try=True):\n self.stream = stream\n self.retry = retry\n self.is_thread=is_thread\n self.threads= 5\n self.save_last_try=save_last_try\n self.verbosity = verbosity\n self.run_times=0\n if title is None:\n self.title = self.DEFAULT_TITLE\n else:\n self.title = title\n if description is None:\n self.description = self.DEFAULT_DESCRIPTION\n else:\n self.description = description\n\n def run(self, test):\n \"Run the given test case or test suite.\"\n self.startTime = datetime.datetime.now()\n result = _TestResult(self.verbosity, self.retry, self.save_last_try)\n test(result)\n self.stopTime = datetime.datetime.now()\n self.run_times+=1\n self.generateReport(result)\n if PY3K:\n # for python3\n # print('\\nTime Elapsed: %s' % (self.stopTime - self.startTime),file=sys.stderr)\n output = '\\nTime Elapsed: %s' % (self.stopTime - self.startTime)\n sys.stderr.write(output)\n else:\n # for python2\n print >> sys.stderr, '\\nTime Elapsed: %s' % (self.stopTime - self.startTime)\n return result\n\n def sortResult(self, result_list):\n # unittest does not seems to run in any particular order.\n # Here at least we want to group them together by class.\n rmap = {}\n classes = []\n for n, t, o, e in result_list:\n cls = t.__class__\n if not cls in rmap:\n rmap[cls] = []\n classes.append(cls)\n rmap[cls].append((n, t, o, e))\n for cls in classes:\n rmap[cls].sort(key=cmp_to_key(lambda a,b:1 if a[1].id()>b[1].id() else ( 1 if a[1].id()==b[1].id() else -1)))\n r = [(cls, rmap[cls]) for cls in classes]\n # name = t.id().split('.')[-1]\n r.sort(key=cmp_to_key(lambda a, b: 1 if a[0].__name__ > b[0].__name__ else -1))\n return r\n\n def getReportAttributes(self, result):\n \"\"\"\n Return report attributes as a list of (name, value).\n Override this to add custom attributes.\n \"\"\"\n startTime = str(self.startTime)[:19]\n duration = str(self.stopTime - self.startTime)\n status = []\n if result.success_count:\n status.append(u'Pass:%s' % result.success_count)\n if result.failure_count:\n status.append(u'Failure:%s' % result.failure_count)\n if result.error_count:\n status.append(u'Error:%s' % result.error_count)\n if result.skip_count:\n status.append(u'Skip:%s' % result.skip_count)\n total = result.success_count+result.failure_count+result.error_count + result.skip_count\n if total>0:\n passed = result.success_count*1.000/total*100\n else:\n passed =0.0\n status.append(u'通过率:%.1f%%' % passed)\n if status:\n status = u' '.join(status)\n else:\n status = 'none'\n return [\n (u'开始时间', startTime),\n (u'耗时', duration),\n (u'状态', status),\n ]\n\n def generateReport(self, result):\n report_attrs = self.getReportAttributes(result)\n generator = 'HTMLTestRunner %s' % __version__\n stylesheet = self._generate_stylesheet()\n heading = self._generate_heading(report_attrs)\n report = self._generate_report(result)\n ending = self._generate_ending()\n output = self.HTML_TMPL % dict(\n title=saxutils.escape(self.title),\n generator=generator,\n stylesheet=stylesheet,\n heading=heading,\n report=report,\n ending=ending,\n channel=self.run_times,\n )\n if PY3K:\n self.stream.write(output.encode())\n else:\n self.stream.write(output.encode('utf8'))\n\n def _generate_stylesheet(self):\n return self.STYLESHEET_TMPL\n\n def _generate_heading(self, report_attrs):\n a_lines = []\n for name, value in report_attrs:\n line = self.HEADING_ATTRIBUTE_TMPL % dict(\n name=name,\n value=value,\n )\n a_lines.append(line)\n heading = self.HEADING_TMPL % dict(\n title=saxutils.escape(self.title),\n parameters=''.join(a_lines),\n description=saxutils.escape(self.description),\n )\n return heading\n\n def _generate_report(self, result):\n rows = []\n sortedResult = self.sortResult(result.result)\n for cid, (cls, cls_results) in enumerate(sortedResult):\n # subtotal for a class\n np = nf = ne = ns = 0\n for n, t, o, e in cls_results:\n if n == 0:\n np += 1\n elif n == 1:\n nf += 1\n elif n==2:\n ne += 1\n else:\n ns +=1\n\n # format class description\n if cls.__module__ == \"__main__\":\n name = cls.__name__\n else:\n name = \"%s.%s\" % (cls.__module__, cls.__name__)\n doc = cls.__doc__ and cls.__doc__.split(\"\\n\")[0] or \"\"\n desc = doc and '%s: %s' % (name, doc) or name\n if not PY3K:\n if isinstance(desc, str):\n desc = desc.decode(\"utf-8\")\n\n row = self.REPORT_CLASS_TMPL % dict(\n style=ne > 0 and 'errorClass' or nf > 0 and 'failClass' or 'passClass',\n desc=desc,\n count=np + nf + ne,\n Pass=np,\n fail=nf,\n error=ne,\n cid='c%s.%s' % (self.run_times,cid + 1),\n )\n rows.append(row)\n\n for tid, (n, t, o, e) in enumerate(cls_results):\n self._generate_report_test(rows, cid, tid, n, t, o, e)\n total = result.success_count + result.failure_count + result.error_count +result.skip_count\n report = self.REPORT_TMPL % dict(\n test_list=u''.join(rows),\n count=str(total),\n Pass=str(result.success_count),\n Pass_p=result.success_count*1.00/total*100 if total else 0.0,\n fail=str(result.failure_count),\n error=str(result.error_count),\n skip=str(result.skip_count),\n total=str(total),\n channel=str(self.run_times),\n )\n return report\n\n def _generate_report_test(self, rows, cid, tid, n, t, o, e):\n # e.g. 'pt1.1', 'ft1.1', etc\n has_output = bool(o or e)\n if n==0:\n tmp=\"p\"\n elif n==1:\n tmp=\"f\"\n elif n==2:\n tmp = \"e\"\n else:\n tmp = \"s\"\n tid = tmp + 't%d.%d.%d' % (self.run_times,cid + 1, tid + 1)\n name = t.id().split('.')[-1]\n if self.verbosity > 1:\n doc = getattr(t,'_testMethodDoc',\"\") or ''\n else:\n doc = \"\"\n\n desc = doc and ('%s: %s' % (name, doc)) or name\n if not PY3K:\n if isinstance(desc, str):\n desc = desc.decode(\"utf-8\")\n tmpl = has_output and self.REPORT_TEST_WITH_OUTPUT_TMPL or self.REPORT_TEST_NO_OUTPUT_TMPL\n\n # o and e should be byte string because they are collected from stdout and stderr?\n if isinstance(o, str):\n # uo = unicode(o.encode('string_escape'))\n if PY3K:\n uo = o\n else:\n uo = o.decode('utf-8', 'ignore')\n else:\n uo = o\n if isinstance(e, str):\n # ue = unicode(e.encode('string_escape'))\n if PY3K:\n ue = e\n elif e.find(\"Error\") != -1 or e.find(\"Exception\") != -1:\n es = e.decode('utf-8', 'ignore').split('\\n')\n try:\n if es[-2].find(\"\\\\u\") != -1 or es[-2].find('\"\\\\u') != -1:\n es[-2] = es[-2].decode('unicode_escape')\n except Exception:\n pass\n ue = u\"\\n\".join(es)\n else:\n ue = e.decode('utf-8', 'ignore')\n else:\n ue = e\n\n script = self.REPORT_TEST_OUTPUT_TMPL % dict(\n id=tid,\n output=saxutils.escape(uo + ue),\n )\n if getattr(t,'imgs',[]):\n # 判断截图列表，如果有则追加\n tmp = u\"\"\n for i, img in enumerate(t.imgs):\n if i==0:\n tmp+=\"\"\" \\n\"\"\" % img\n else:\n tmp+=\"\"\" \\n\"\"\" % img\n imgs = self.IMG_TMPL % dict(imgs=tmp)\n else:\n imgs = u\"\"\"无截图\"\"\"\n\n row = tmpl % dict(\n tid=tid,\n Class=(n == 0 and 'hiddenRow' or 'none'),\n style=n == 2 and 'errorCase' or (n == 1 and 'failCase' or 'passCase'),\n desc=desc,\n script=script,\n status=self.STATUS[n],\n img=imgs,\n )\n rows.append(row)\n if not has_output:\n return\n\n def _generate_ending(self):\n return self.ENDING_TMPL\n\n\n##############################################################################\n# Facilities for running tests from the command line\n##############################################################################\n\n# Note: Reuse unittest.TestProgram to launch test. In the future we may\n# build our own launcher to support more specific command line\n# parameters like test title, CSS, etc.\nclass TestProgram(unittest.TestProgram):\n \"\"\"\n A variation of the unittest.TestProgram. Please refer to the base\n class for command line parameters.\n \"\"\"\n\n def runTests(self):\n # Pick HTMLTestRunner as the default test runner.\n # base class's testRunner parameter is not useful because it means\n # we have to instantiate HTMLTestRunner before we know self.verbosity.\n if self.testRunner is None:\n self.testRunner = HTMLTestRunner(verbosity=self.verbosity)\n unittest.TestProgram.runTests(self)\n\n\nmain = TestProgram\n\n##############################################################################\n# Executing this module from the command line\n##############################################################################\n\nif __name__ == \"__main__\":\n main(module=None)\n" }, { "path": "README.md", "content": "# HTMLTestRunner 汉化版\n在原版的基础上进行扩展和改造\n\n# 当年改造初衷\n + 方便自己做汉化报告生成\n + 对自己积累知识的检验\n + 挑战下单文件报告都能做出什么花样\n 近两年不怎么搞UI自动化了，项目就一直没怎么更新（pytest香啊😅）\n\n# todo\n + 多线程/多进程执行用例（数据统计逻辑要重新设计，还有兼容性问题😑）\n + UI 美化 (通过CDN集成一些成熟的js库~然后加5毛钱特效😜)\n + 与ddt的集成（目测基本就把源码收进来😏）\n\n\n\n# 报告汉化，错误日志\n ![](./img/1.png)\n# selenium/appium 截图\n截图功能根据测试结果，当结果为fail或error时自动截图
\n截图方法在_TestResult 的测试结果收集中，报告使用的截图全部保存为base64编码，避免了报告图片附件的问题，可以根据自己使用的框架不同自行调整，selenium 使用的是get_screenshot_as_base64 方法获取页面截图的base64编码
\n![](./img/2.png)\n因为要提取用例中的driver变量获取webdriver对象，所以要实现截图功能必须定义在用例中定义webdriver 为driver\n```python\n def setUp(self):\n self.imgs=[] # （可选）初始化截图列表\n self.driver = webdriver.Chrome()\n```\n或者\n```python\n @classmethod\n def setUpClass(cls):\n cls.driver = webdriver.Chrome()\n```\n也可以在测试过程中某一步骤自定义添加截图,比如
\n![](./img/3.png)
\n生成报告后会统一进行展示
\n**Selenium截图轮播效果**
\n![](./img/4.gif)
\n**Appium效果轮播截图**
\n![](./img/5.gif)\n# 用例失败重试\n根据unittest的运行机制，在stopTest 中判断测试结果，如果失败或出错status为1，判断是否需要重试；
\n![](./img/5.png)\n\n在实例化HTMLTestRunner 对象时追加参数，retry，指定重试次数，如果save_last_try 为True ，一个用例仅显示最后一次测试的结果。\n```python\nHTMLTestRunner(title=\"带截图的测试报告\", description=\"小试牛刀\", stream=open(\"sample_test_report.html\", \"wb\"), verbosity=2, retry=2, save_last_try=True)\n```\n\n![](./img/6.png)\n如果save_last_try 为False，则显示所有重试的结果。\n```python\nHTMLTestRunner(title=\"带截图的测试报告\", description=\"小试牛刀\", stream=open(\"sample_test_report.html\", \"wb\"), verbosity=2, retry=2, save_last_try=False)\n```\n\n![](./img/7.png)\n运行中输出效果如下：
\n![](./img/8.png)\n\n`注意：在python3 中因为unittest运行机制变动，在使用setUp/tearDown中初始化/退出driver时，会出现用例执行失败没有截图的问题，所以推荐使用样例中setUpClass/tearDownClass的用法`\n" }, { "path": "changelog.md", "content": "# changelog\n\n+ 20170925\n - 测试报告完全汉化，包括错误日志的中文处理\n - 针对selenium UI测试增加失败自动截图功能，截图自动轮播\n - 增加失败自动重试功能\n - 增加饼图统计\n - 同时兼容python2.x 和3.x\n+ 20180402\n - 表格样式优化\n - 修复部分bug\n - 增加截图组，可展示多张截图，首次打开自动播放\n - 增加仅展示最后一次运行结果，多次重试时，每个测试用例仅展示一次\n+ 20181213\n - 增加分类标签、通过率等，优化样式\n - 修复部分框架在SetUP中失败导致测试中断的问题导致 ErrorHandle的问题\n - 修复部分编码Bug\n - 优化运行逻辑\n - 对js代码优化，修复部分多次运行run导致结果异常的bug\n \n+ 20200427\n - 修复页面小错误 (fzk27) \n \n+ 20200508\n - 开放跳过测试的统计，完善饼图统计" }, { "path": "sample_test_report.html", "content": "\n\n\n\n 带截图的测试报告\n \n \n \n\n\n\n\n\n
\n

带截图的测试报告

\n

开始时间: 2020-05-07 16:50:04

\n

耗时: 0:01:36.860445

\n

状态: Pass:4 Failure:2 Error:1 Skip:1 通过率:50.0%

\n\n

小试牛刀

\n
\n\n\n
\n
\n \n
\n
\n\n
\n概要[50.00%]\n通过[4]\n失败[2]\n错误[1]\n跳过[1]\n所有[8]\n
\n\n\n\n\n\n\n\n\n\n\n\n\n \n \n \n \n \n \n \n\n\n\n \n \n \n \n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n \n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n \n \n \n \n\n
测试组/测试用例总数通过失败错误视图错误截图
case_014121详情 
test_case1: 百度搜索\n 呵呵呵呵\n
\n\n \n \n \n 通过\n\n
\n
\n \n [x]\n
\n 
\n        \npt1.1.1: 本次校验没过？\n超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长超级长\n\n\n
\n
\n \n\n 		无截图
test_case2: 搜狗首页_retry:2
\n\n \n \n \n 失败\n\n
\n
\n \n [x]\n
\n 
\n        \nft1.1.2: 本次校验没过？\nTraceback (most recent call last):\n  File \"E:/HTMLTestRunner/test_screenshot_selenium.py\", line 61, in test_case2\n    self.assertTrue(False,\"这是相当的睿智了\")\nAssertionError: False is not true : 这是相当的睿智了\n\n\n
\n
\n \n\n 		\n 显示截图\n
\n \n \n\n
\n
\n
test_case3: QQ邮箱_retry:2
\n\n \n \n \n 失败\n\n
\n
\n \n [x]\n
\n 
\n        \nft1.1.3: 没法打印？\nTraceback (most recent call last):\n  File \"E:/HTMLTestRunner/test_screenshot_selenium.py\", line 68, in test_case3\n    self.assertIn(u\"中文\", u'中华','小当家？')\nAssertionError: '中文' not found in '中华' : 小当家？\n\n\n
\n
\n \n\n 		\n 显示截图\n
\n \n \n\n
\n
\n
test_case4: 淘宝_retry:2
\n\n \n \n \n 错误\n\n
\n
\n \n [x]\n
\n 
\n        \net1.1.4: Traceback (most recent call last):\n  File \"E:/HTMLTestRunner/test_screenshot_selenium.py\", line 73, in test_case4\n    raise Exception\nException\n\n\n
\n
\n \n\n 		\n 显示截图\n
\n \n \n\n
\n
\n
case_023300详情 
test_case1: 百度搜索\n 呵呵呵呵\n
\n\n \n \n \n 通过\n\n
\n
\n \n [x]\n
\n 
\n        \npt1.2.1: 校验了一下\n\n\n
\n
\n \n\n 		无截图
test_case2: 搜狗首页
\n\n \n \n \n 跳过\n\n
\n
\n \n [x]\n
\n 
\n        \nst1.2.2: 跳过\n\n
\n
\n \n\n 		无截图
test_case3: QQ邮箱
\n\n \n \n \n 通过\n\n
\n
\n \n [x]\n
\n 
\n        \npt1.2.3: 没法打印？\n\n\n
\n
\n \n\n 		无截图
test_case4: 淘宝
通过无截图
统计8421  
\n\n\n
 
\n\n\n\n" }, { "path": "sample_test_report_appium.html", "content": "\n\n\n\n 带截图的测试报告\n \n \n \n\n\n\n\n\n
\n

带截图的测试报告

\n

开始时间: 2018-12-13 11:34:08

\n

耗时: 0:00:36.348000

\n

状态: Pass:1 通过率:100.0%

\n\n

小试牛刀

\n
\n\n\n
\n
\n \n
\n
\n\n
\n概要[100.00%]\n通过[1]\n失败[0]\n错误[0]\n\n所有[1]\n
\n\n\n\n\n\n\n\n\n\n\n\n\n \n \n \n \n \n \n \n\n\n\n \n \n \n \n \n \n \n\n\n\n \n \n \n\n\n\n \n \n \n \n \n \n \n\n
测试组/测试用例总数通过失败错误视图错误截图
case_011100详情 
test_case1: 手机QQ截图
通过\n 显示截图\n
\n \n \n \n \n \n \n\n
\n
\n
统计1100  
\n\n\n
 
\n\n\n\n" }, { "path": "test_screenshot_appium.py", "content": "# -*- coding: utf-8 -*-\n# @Time : 2017/9/6 11:26\n# @File : aaa.py\n# @Author : 守望@天空~\n\"\"\"HTMLTestRunner 截图版示例 appium版\"\"\"\nfrom appium import webdriver\nimport unittest\nfrom HTMLTestRunner_cn import HTMLTestRunner\n\n\nclass case_01(unittest.TestCase):\n\n @classmethod\n def setUpClass(cls):\n desired_caps = {}\n desired_caps['platformName'] = 'Android'\n desired_caps['platformVersion'] = '4.4.2'\n desired_caps['deviceName'] = 'Android Emulator'\n desired_caps['app'] = 'com.tencent.mobileqq'\n desired_caps['appActivity'] = 'com.tencent.mobileqq.activity.SplashActivity'\n cls.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)\n\n @classmethod\n def tearDownClass(cls):\n cls.driver.quit()\n\n\n def add_img(self):\n # 在是python3.x 中，如果在这里初始化driver ，因为3.x版本 unittest 运行机制不同，会导致用力失败时截图失败\n self.imgs.append(self.driver.get_screenshot_as_base64())\n return True\n\n def setUp(self):\n self.imgs = []\n self.addCleanup(self.cleanup)\n\n def cleanup(self):\n pass\n\n\n def test_case1(self):\n \"\"\" 手机QQ截图\"\"\"\n self.add_img()\n self.add_img()\n self.add_img()\n self.add_img()\n self.add_img()\n\n\n\nif __name__ == \"__main__\":\n suite = unittest.TestLoader().loadTestsFromTestCase(case_01)\n runer = HTMLTestRunner(title=\"带截图的测试报告\", description=\"小试牛刀\", stream=open(\"sample_test_report_appium.html\", \"wb\"), verbosity=2, retry=1, save_last_try=True)\n runer.run(suite)\n" }, { "path": "test_screenshot_selenium.py", "content": "# -*- coding: utf-8 -*-\n# @Time : 2017/9/6 11:26\n# @File : aaa.py\n# @Author : 守望@天空~\n\"\"\"HTMLTestRunner 截图版示例 selenium 版\"\"\"\nfrom selenium import webdriver\nimport unittest\nimport time\nfrom HTMLTestRunner_cn import HTMLTestRunner\nimport sys\n\n\nclass case_01(unittest.TestCase):\n \"\"\"\n def setUp(cls):\n cls.driver = webdriver.Chrome()\n\n def tearDown(cls):\n cls.driver.quit()\n\n \"\"\"\n @classmethod\n def setUpClass(cls):\n cls.driver = webdriver.Chrome()\n\n @classmethod\n def tearDownClass(cls):\n cls.driver.quit()\n\n def add_img(self):\n # self.imgs.append(self.driver.get_screenshot_as_base64())\n return True\n\n def setUp(self):\n # 在python3.x 中，如果在这里初始化driver ，因为3.x版本 unittest 运行机制不同，会导致用例失败后截图失败\n self.imgs = []\n self.addCleanup(self.cleanup)\n\n def cleanup(self):\n pass\n\n\n def test_case1(self):\n \"\"\" 百度搜索\n 呵呵呵呵\n \"\"\"\n print(\"本次校验没过？\")\n print (\"超级长\"*66)\n self.driver.get(\"https://www.baidu.com\")\n self.add_img()\n self.driver.find_element_by_id('kw').send_keys(u'百度一下')\n self.add_img()\n self.driver.find_element_by_id('su').click()\n time.sleep(1)\n self.add_img()\n\n def test_case2(self):\n \"\"\"搜狗首页\"\"\"\n self.driver.get(\"http://www.sogou.com\")\n print(\"本次校验没过？\")\n self.assertTrue(False,\"这是相当的睿智了\")\n\n def test_case3(self):\n \"\"\" QQ邮箱\"\"\"\n self.driver.get(\"https://mail.qq.com\")\n # self.imgs.append(self.driver.get_screenshot_as_base64())\n print(\"没法打印？\")\n self.assertIn(u\"中文\", u'中华','小当家？')\n\n def test_case4(self):\n u\"\"\" 淘宝\"\"\"\n self.driver.get(\"http://www.taobao.com/\")\n raise Exception\n self.add_img()\n self.assertTrue(True)\n\n\nclass case_02(unittest.TestCase):\n \"\"\"\n def setUp(cls):\n cls.driver = webdriver.Chrome()\n\n def tearDown(cls):\n cls.driver.quit()\n\n \"\"\"\n @classmethod\n def setUpClass(cls):\n cls.driver = webdriver.Chrome()\n\n @classmethod\n def tearDownClass(cls):\n cls.driver.quit()\n\n def add_img(self):\n # self.imgs.append(self.driver.get_screenshot_as_base64())\n return True\n\n def setUp(self):\n # 在是python3.x 中，如果在这里初始化driver ，因为3.x版本 unittest 运行机制不同，会导致用力失败时截图失败\n self.imgs = []\n self.addCleanup(self.cleanup)\n\n def cleanup(self):\n pass\n\n\n def test_case1(self):\n \"\"\" 百度搜索\n 呵呵呵呵\n \"\"\"\n print(\"校验了一下\")\n self.driver.get(\"https://www.baidu.com\")\n self.add_img()\n self.driver.find_element_by_id('kw').send_keys(u'百度一下')\n self.add_img()\n self.driver.find_element_by_id('su').click()\n time.sleep(1)\n self.add_img()\n\n @unittest.skip('跳过')\n def test_case2(self):\n \"\"\"搜狗首页\"\"\"\n self.driver.get(\"http://www.sogou.com\")\n print(\"本次校验没过？\")\n self.assertTrue(False,\"这是相当的睿智了\")\n\n def test_case3(self):\n \"\"\" QQ邮箱\"\"\"\n self.driver.get(\"https://mail.qq.com\")\n # self.imgs.append(self.driver.get_screenshot_as_base64())\n print(\"没法打印？\")\n self.assertIn(u\"中文\", u'中文')\n\n def test_case4(self):\n u\"\"\" 淘宝\"\"\"\n self.driver.get(\"http://www.taobao.com/\")\n self.add_img()\n self.assertTrue(True)\n\n\nif __name__ == \"__main__\":\n from unittest import TestResult\n suite1 = unittest.TestLoader().loadTestsFromTestCase(case_01)\n suite2 = unittest.TestLoader().loadTestsFromTestCase(case_02)\n suites = unittest.TestSuite()\n suites.addTests([suite1,suite2])\n\n runer = HTMLTestRunner(title=\"带截图的测试报告\", description=\"小试牛刀\", stream=open(\"sample_test_report.html\", \"wb\"), verbosity=2, retry=2, save_last_try=True)\n runer.run(suites)\n" } ]