Ansys templates#
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 |
|
|
|
|||
pybasic |
|
|||||
pyansys |
|
|
|
|||
pyansys-advanced |
|
|
|
|
|
|
pyansys-openapi-client |
||||||
pyace |
|
|
|
|
|
|
pyace-fast |
|
|
|
|
|
|
pyace-flask |
|
|
|
|
|
|
pyace-grpc |
|
|
|
|
|
|
solution “*” |
|
|
|
|
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