@@ -42,7 +42,7 @@ This package supports Python 3.9 through 3.12 on Windows, Linux, and MacOS.
42
42
# Activate it in a Windows Powershell environment
43
43
.venv\S cripts\A ctivate.ps1
44
44
45
- #. Make sure you have the latest required build system and doc , testing, and CI tools:
45
+ #. Make sure you have the latest required build system and documentation , testing, and CI tools:
46
46
47
47
.. code :: bash
48
48
@@ -55,43 +55,43 @@ This package supports Python 3.9 through 3.12 on Windows, Linux, and MacOS.
55
55
56
56
#. Verify your development installation:
57
57
58
- .. code :: bash
58
+ .. code :: bash
59
59
60
- tox
60
+ tox
61
61
62
62
Testing
63
63
-------
64
64
65
- This project takes advantage of `tox `_. This tool allows you to automate common
66
- development tasks (similar to Makefile), but it is oriented towards Python
67
- development.
65
+ This project takes advantage of `tox `_. Similar to Makefile, this tool allows you to automate
66
+ common tasks, but it is oriented towards Python development.
68
67
69
68
Using ``tox ``
70
69
^^^^^^^^^^^^^
71
70
72
- As Makefile has rules, `tox `_ has environments. In fact, the tool creates its
71
+ While Makefile has rules, `tox ` has environments. In fact, the tool creates its
73
72
own virtual environment so anything being tested is isolated from the project
74
73
to guarantee the project's integrity. The following environments commands are provided:
75
74
76
75
- **tox -e style **: Checks for coding style quality.
77
- - **tox -e test **: Checks for unit tests. Replace X with the minor version of your Python environment.
78
- Pass `pytest <pytest _>`_ flags after the ``-- `` portion of the command. For example, use this
79
- ``pytest `` command to show the standard output: ``tox -e py3X -- -s ``.
76
+ - **tox -e test **: Checks for unit tests. Pass `pytest <pytest _>`_ flags after the
77
+ ``-- `` portion of the command. For example, use this ``pytest `` command to show the
78
+ standard output, replacing ``X `` with the minor version of your Python environment:
79
+ ``tox -e py3X -- -s ``.
80
80
- **tox -e coverage **: Checks for code coverage.
81
- - **tox -e doc **: Checks for the documentation-building process .
81
+ - **tox -e doc **: Checks for documentation building .
82
82
83
83
Raw testing
84
84
^^^^^^^^^^^
85
85
86
- If required, you can always call style commands , such as `black `_, `isort `_,
87
- and `flake8 `_, or unit testing ones , such as `pytest `_ from the command line.
88
- However, this does not guarantee that your project is being tested in an isolated
89
- environment, which is the reason why tools like `tox `_ exist .
86
+ If required, you can always call code style tools , such as `black `_, `isort `_,
87
+ and `flake8 `_, or unit testing tools , such as `pytest `_ from the command line.
88
+ However, using these tools do not guarantee that your project is being tested in an isolated
89
+ environment, which is the reason why a tool like `tox `_ exists .
90
90
91
91
Adhere to code style
92
92
--------------------
93
93
PyEDB-Core follows the PEP8 standard as indicated in `PEP 8 <dev_guide_pyansys_pep8 _>`_
94
- in the *PyAnsys developer's guide * and implements style checking using `pre-commit <pre-commit _>`_.
94
+ in the *PyAnsys developer's guide *. It also implements style checking using `pre-commit <pre-commit _>`_.
95
95
96
96
To ensure your code meets minimum code styling standards, run these commands:
97
97
@@ -106,7 +106,7 @@ You can also install this as a pre-commit hook by running this command:
106
106
107
107
pre-commit install
108
108
109
- This way, it's not possible for you to push code that fails the style checks:
109
+ This way, it's not possible for you to push code that fails the code style checks:
110
110
111
111
.. code :: text
112
112
0 commit comments