Contribute

Overall guidance on contributing to a PyAnsys library appears in the Contributing topic in the PyAnsys developer’s guide. Ensure that you are thoroughly familiar with this guide before attempting to contribute to DYNA-Lib.

The following contribution information is specific to DYNA-Lib.

Developer installation

Installing the dynalib package in developer mode allows you to modify the source and enhance it.

This package supports Python 3.9 through 3.12 on Windows, Linux, and MacOS.

You can install the dynalib package with this command:

pip install dynalib

Alternatively, you can install the latest version from the DYNA-Lib repository with this command:

pip install git+https://github.com/ansys/dynalib

For a local development version, you can create a new virtual environment with this command:

python -m venv .venv

You can then activate the virtual environment with the command appropriate for your operating system.

On Windows:

D.\.venv\Scripts\activate

On Linux and MacOS:

source .venv/bin/activate

Next, install the development version of the project with these commands:

git clone https://github.com/ansys/dynalib
cd dynalib
pip install -e .

Testing

Once DYNA-Lib is installed in developer mode, you can install testing requirements and use pytest to run unit tests with these commands:

pip install .[test]
pytest

Documentation

To install the required dependencies for the documentation, run this command:

pip install .[doc]

To build the documentation, run the usual rules provided in the Sphinx Makefile for your operating system.

On Windows:

.\doc\make.bat html
.\doc\build\html\index.html

On Linux and MacOS:

make -C doc/ html && your_browser_name doc/build/html/index.html

Post issues

Use the DYNA-Lib Issues page to create issues to report bugs and request new features.. When possible, use these issue templates:

• Bug report template

• Feature request template

• Documentation issue template

• Example request template

If your issue does not fit into one of these categories, create your own issue.

To reach the PyAnsys support team, email pyansys.core@ansys.com.

Testing

You can install the dependencies required for testing with this command:

pip install .[tests]

You can then run the tests via pytest with this command:

pytest -v

Adhere to code style

DYNA-Lib follows the PEP8 standard as indicated in PEP 8 in the PyAnsys developer’s guide and implements style checking using pre-commit.

To ensure your code meets minimum code styling standards, run these commands:

pip install pre-commit
pre-commit run --all-files

You can also install this as a pre-commit hook by running this command:

pre-commit install

This way, it’s not possible for you to push code that fails the style checks:

$ git commit -am "added my cool feature"
black....................................................................Passed
blacken-docs.............................................................Passed
isort....................................................................Passed
flake8...................................................................Passed
docformatter.............................................................Passed
codespell................................................................Passed
check for merge conflicts................................................Passed
debug statements (python)................................................Passed
check yaml...............................................................Passed
trim trailing whitespace.................................................Passed
Add License Headers......................................................Passed
Validate GitHub Workflows................................................Passed