source: general/prog/python-modules/pytest.xml@ 72b95598

lazarus trunk
Last change on this file since 72b95598 was 72b95598, checked in by Xi Ruoyao <xry111@…>, 6 weeks ago

pytest: Fix test instruction and dependencies

  • Property mode set to 100644
File size: 5.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../../general.ent">
5 %general-entities;
6
7 <!ENTITY pytest-download-http "https://files.pythonhosted.org/packages/source/p/pytest/pytest-&pytest-version;.tar.gz">
8 <!ENTITY pytest-download-ftp " ">
9 <!ENTITY pytest-md5sum "&pytest-md5sum;">
10 <!ENTITY pytest-size "1.3 MB">
11 <!ENTITY pytest-buildsize "42 MB (with tests)">
12 <!ENTITY pytest-time "1.2 SBU (with tests)">
13]>
14
15 <sect2 id="pytest" xreflabel="pytest-&pytest-version;">
16
17 <title>Pytest-&pytest-version;</title>
18
19 <indexterm zone="pytest">
20 <primary sortas="a-pytest">pytest</primary>
21 </indexterm>
22
23 <sect3 role="package">
24 <title>Introduction to Pytest Module</title>
25
26 <para>
27 The <application>Pytest</application> framework makes it easy to
28 write small, readable tests, and can scale to support complex
29 functional testing for applications and libraries.
30 </para>
31
32 &lfs121_checked;
33
34 <bridgehead renderas="sect4">Package Information</bridgehead>
35 <itemizedlist spacing="compact">
36 <listitem>
37 <para>
38 Download (HTTP): <ulink url="&pytest-download-http;"/>
39 </para>
40 </listitem>
41 <listitem>
42 <para>
43 Download (FTP): <ulink url="&pytest-download-ftp;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download MD5 sum: &pytest-md5sum;
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download size: &pytest-size;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Estimated disk space required: &pytest-buildsize;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated build time: &pytest-time;
64 </para>
65 </listitem>
66 </itemizedlist>
67
68 <bridgehead renderas="sect4">Pytest Dependencies</bridgehead>
69
70 <bridgehead renderas="sect5">Required</bridgehead>
71 <para role="required">
72 <xref linkend="iniconfig"/>,
73 <xref linkend="packaging"/>, and
74 <xref linkend="pluggy"/>
75 </para>
76
77 <bridgehead renderas="sect5">Recommended</bridgehead>
78 <para role="recommended">
79 <xref linkend="setuptools_scm"/>
80 </para>
81
82 <bridgehead renderas="sect5">Optional (for testing)</bridgehead>
83 <para role="optional">
84 <xref linkend="attrs"/>,
85 <xref linkend="pygments"/>,
86 <xref linkend="requests"/>,
87 <ulink url="https://pypi.org/project/argcomplete/">argcomplete</ulink>,
88 <ulink url="https://pypi.org/project/hypothesis/">hypothesis</ulink>,
89 <ulink url="https://pypi.org/project/mock/">mock</ulink>,
90 <ulink url="https://pypi.org/project/xmlschema/">xmlschema</ulink>
91 </para>
92
93 </sect3>
94
95 <sect3 role="installation">
96 <title>Installation of Pytest</title>
97
98 <para> Build the module: </para>
99
100&build-wheel;
101
102 <para>
103 Now, as the <systemitem class="username">root</systemitem> user:
104 </para>
105
106<screen role="root"><userinput>&install-wheel; pytest</userinput></screen>
107
108 <para>
109 The installation can be tested with the following commands:
110 </para>
111
112<screen remap="test"><userinput>python3 -m venv --system-site-packages testenv &amp;&amp;
113source testenv/bin/activate &amp;&amp;
114pip3 install pytest[dev] &amp;&amp;
115python3 /usr/bin/pytest<!-- no && because of a possible error -->
116deactivate</userinput></screen>
117
118 <para>
119 One test, testing/test_pathlib.py, is known to fail.
120 </para>
121
122 </sect3>
123
124 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
125 href="../../../xincludes/pip3-cmd-explain.xml"/>
126
127 <sect3 role="content">
128 <title>Contents</title>
129
130 <segmentedlist>
131 <segtitle>Installed Programs</segtitle>
132 <segtitle>Installed Libraries</segtitle>
133 <segtitle>Installed Directories</segtitle>
134
135 <seglistitem>
136 <seg>
137 pytest and py.test (different files but with same content)
138 </seg>
139 <seg>None</seg>
140 <seg>
141 /usr/lib/python&python3-majorver;/site-packages/_pytest,
142 /usr/lib/python&python3-majorver;/site-packages/pytest, and
143 /usr/lib/python&python3-majorver;/site-packages/pytest-&pytest-version;.dist-info
144 </seg>
145 </seglistitem>
146 </segmentedlist>
147
148 <variablelist>
149 <bridgehead renderas="sect5">Short Descriptions</bridgehead>
150 <?dbfo list-presentation="list"?>
151 <?dbhtml list-presentation="table"?>
152
153 <varlistentry id="pytest-prog">
154 <term><command>pytest</command></term>
155 <listitem>
156 <para>
157 sets up, manages, and/or runs test in python module source
158 directories
159 </para>
160 <indexterm zone="pytest pytest-prog">
161 <primary sortas="b-pytest-prog">pytest</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 </variablelist>
167
168 </sect3>
169
170 </sect2>
Note: See TracBrowser for help on using the repository browser.