PyAnsys Shared Components#
As part of the PyAnsys project to enable the usage of Ansys products through Python, we have created shared components that are reusable across the different packages.
These shared components are not interfaces to specific products nor single-purpose tools. They are libraries to facilitate code-sharing within the PyAnsys project.
These are expanding and developing libraries. Feel free to post issues on the various GitHub pages referenced at the end of this document. For additional support, contact PyAnsys Support, who will correctly route your requests to the appropriate development teams.
OpenAPI Common Library#
The openapi-common
repository provides the source code for
authentication-aware clients for OpenAPI client libraries.
The PyAnsys Open API Common library is intended for use with the custom code generation template in the PyAnsys project. This library currently supports authentication with Basic, Negotiate, NTLM, and OpenID Connect. Most features of the underlying requests session are exposed for use. Some basic configuration is also provided by default.
Installation#
Install openapi-common
with:
pip install ansys-openapi-common
Usage#
The package exposes several classes, including a client
ApiClient
and a builder
ApiClientFactory
that allow a client library
to configure a connection to an API.
The ApiClient
class is intended to be wrapped
by code that implements a client library.
Authentication is configured through the
ApiClientFactory
object and its
with_credentials()
,
with_autologon()
, and
with_oidc()
methods. If no
authentication is required, you can use the
with_anonymous()
method. You can
provide additional configuration with the
SessionConfiguration
object.
>>> from ansys.openapi.common import ApiClientFactory
>>> session = ApiClientFactory('https://my-api.com/v1.svc')
... .with_autologon()
... .connect()
<ApiClient url: https://my-api.com/v1.svc>
Resources and Links#
For more information, see: