ansys-templates 1.8.dev1

Creates Python projects according to PyAnsys guidelines

The ansys-templates repository holds a collection of useful templates compliant with PyAnsys guidelines. It also provides the ansys-templates command line tool for interactively generating new projects based on previous templates.

The main advantages of using this tool are:

• Building process is fully interactive. There is no need to manually modify files.

• Output of the project can easily be customized during the rendering process.

• Generated projects are compliant with PyAnsys Developer’s Guidelines.

For information on using this tool, see the Ansys Templates Documentation.

How to install

Users can install ansys-templates by running:

python -m pip install ansys-templates

The usage of pipx is encouraged too. See installing ansys-templates using pipx.

Basic commands

The following commands are provided with ansys-templates:

• ansys-templates --help: lists information about the tool.

• ansys-templates list: lists all available templates.

• ansys-templates new <template name>: creates a new project from template.

Available templates

Available templates in ansys-templates are:

• doc-project: Create a documentation project using Sphinx.

• pybasic: Create a basic Python Package.

• pyansys: Create a PyAnsys Python Package project.

• pyansys-advanced: Create an advanced PyAnsys Python Package project.

• pyansys-openapi-client: Create an OpenAPI Client Package project.

• pyace: Create a Python project for any method developers.

• pyace-flask: Create a Flask project initialized for any developer.

• pyace-grpc: Create gRPC project initialized for any developer.

• pyace-fast: Create a FastAPI project initialized for any developer.

• solution: Create a Solution based on the Solution Application Framework. For Ansys Internal Use Only

Template features

The following table summarizes the main properties for each of the templates available in ansys-templates:

Template	setup.py	pyproject.toml	Actions	tox.ini	requirements/	Docker
doc-project			X	X	X
pybasic	X
pyansys	X	X	X
pyansys-advanced	X	X	X	X	X
pyansys-openapi-client
pyace	X	X	X	X	X	X
pyace-fast	X	X	X	X	X	X
pyace-flask	X	X	X	X	X	X
pyace-grpc	X	X	X	X	X	X
solution “*”		X	X	X	X

Warning

“*” This template is for Ansys Internal Use Only.

Demo branches

To have a better idea on how each template will look once it gets rendered, see its corresponding demonstration branch.

• Demo branch for doc-project

• Demo branch for pybasic

• Demo branch for pyansys

• Demo branch for pyansys-advanced using flit

• Demo branch for pyansys-advanced using poetry

• Demo branch for pyansys-advanced using setuptools

• Demo branch for pyace

• Demo branch for pyace-fast

• Demo branch for pyace-flask

• Demo branch for pyace-grpc

• Demo branch for solution

• Demo branch for osl-solution