|
1 | 1 | # Contribute
|
2 | 2 |
|
3 | 3 | Overall guidance on contributing to a PyAnsys library appears in the
|
4 |
| -[Contributing] topic in the *PyAnsys developer's guide*. Ensure that you |
| 4 | +*Contributing* topic in the *[PyAnsys developer's guide]*. Ensure that you |
5 | 5 | are thoroughly familiar with this guide before attempting to contribute to
|
6 |
| -allie-flowkit-python. |
| 6 | +allie-flowkit-python. For contributing to this project, please refer to the |
| 7 | +[Contributing] section of this project's documentation. |
7 | 8 |
|
8 |
| -The following contribution information is specific to *Allie Flowkit Python*. |
9 |
| - |
10 |
| -[Contributing]: https://dev.docs.pyansys.com/how-to/contributing.html |
11 |
| - |
12 |
| -## Clone the repository |
13 |
| - |
14 |
| -To clone and install the latest *Allie Flowkit Python* release in development mode, run |
15 |
| -these commands: |
16 |
| - |
17 |
| -```bash |
18 |
| -git clone https://github.com/ansys/allie-flowkit-python/ |
19 |
| -cd allie-flowkit-python |
20 |
| -python -m pip install --upgrade pip |
21 |
| -pip install -e . |
22 |
| -``` |
23 |
| - |
24 |
| -## Adhere to code style |
25 |
| - |
26 |
| -*Allie Flowkit Python* follows the PEP8 standard as outlined in PEP 8 in the PyAnsys Developer’s Guide and implements style checking using pre-commit. |
27 |
| - |
28 |
| -To ensure your code meets minimum code styling standards, run these commands: |
29 |
| - |
30 |
| -```bash |
31 |
| -pip install pre-commit |
32 |
| -pre-commit run --all-files |
33 |
| -``` |
34 |
| - |
35 |
| -You can also install this as a pre-commit hook by running this command: |
36 |
| - |
37 |
| -```bash |
38 |
| -pre-commit install |
39 |
| -``` |
40 |
| - |
41 |
| -## Run the tests |
42 |
| - |
43 |
| -Prior to running the tests, you must run this command to install the test dependencies: |
44 |
| - |
45 |
| -```bash |
46 |
| -pip install -e .[tests] |
47 |
| -``` |
48 |
| - |
49 |
| -To run the tests, navigate to the root directory of the repository and run this command: |
50 |
| - |
51 |
| -```bash |
52 |
| -pytest |
53 |
| -``` |
54 |
| - |
55 |
| - |
56 |
| -## Build the documentation |
57 |
| - |
58 |
| -Prior to building the documentation, you must run this command to install the documentation dependencies: |
59 |
| - |
60 |
| -```bash |
61 |
| -pip install -e .[doc] |
62 |
| -``` |
63 |
| - |
64 |
| -To build the documentation, run the following commands: |
65 |
| - |
66 |
| -```bash |
67 |
| -cd doc |
68 |
| - |
69 |
| -# On linux |
70 |
| -make html |
71 |
| - |
72 |
| -# On windows |
73 |
| -./make.bat html |
74 |
| -``` |
75 |
| - |
76 |
| -The documentation is built in the `docs/_build/html` directory. |
| 9 | +[PyAnsys Developer's Guide]: https://dev.docs.pyansys.com/index.html |
| 10 | +[Contributing]: expert-adventure-nvnoo1y.pages.github.io/dev/contributing.html |
0 commit comments