PyAnsys developer’s guide#

The PyAnsys developer’s guide is the central document for:

  • Ansys developers who want to create and “own” PyAnsys libraries

  • Anyone in the Python community who wants to contribute to a PyAnsys library

  • Anyone who is interested in learning more about the PyAnsys project and PyAnsys libraries

This guide describes the PyAnsys project organization and administration. It also provides how-to information and summarizes packaging, coding, and documentation styles. It concludes with an abstractions section that explains how apps and complex services expose only functionalities that matter to users.

Start here#

What is PyAnsys?

An introduction to the PyAnsys project and its ecosystem.

Getting started
Project approval and release

Steps to authorize the public release of a PyAnsys library.

Project approval and public release

Build and maintain#

How-to

Step-by-step guidelines.

How-to
Abstractions

Explanations of the PyAnsys architecture.

Abstractions

Style reference#

Packaging style

Best practices for distributing Python code.

Packaging style
Coding style

Best practices for writing Python code.

Coding style
Documentation style

Best practices for writing documentation.

Documentation style

Contribute to the documentation#

Documentation for documentarians

Guidance for writing and revising PyAnsys documentation content.

Content writing
General examples

Gallery examples and templates used with Sphinx-Gallery documentation.

General example
Documentation for developers

Documentation setup, build, deployment, and maintenance workflows.

Documenting