Metadata-Version: 2.4 Name: ansys-grantami-dataflow-extensions Version: 0.3.0rc0 Summary: Productivity package for use with Granta MI Dataflow. Author-email: "ANSYS, Inc." Maintainer-email: "ANSYS, Inc." License-Expression: MIT License-File: AUTHORS License-File: LICENSE Classifier: Development Status :: 5 - Production/Stable Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: Microsoft :: Windows Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Programming Language :: Python :: 3.14 Requires-Python: >=3.10 Requires-Dist: ansys-openapi-common<3,>=2.3.0 Requires-Dist: requests-negotiate-sspi>=0.5.2 Requires-Dist: requests<3,>=2.23 Description-Content-Type: text/x-rst |pyansys| |python| |pypi| |GH-CI| |codecov| |MIT| |ruff| .. |pyansys| image:: https://img.shields.io/badge/Py-Ansys-ffc107.svg?labelColor=black&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAABDklEQVQ4jWNgoDfg5mD8vE7q/3bpVyskbW0sMRUwofHD7Dh5OBkZGBgW7/3W2tZpa2tLQEOyOzeEsfumlK2tbVpaGj4N6jIs1lpsDAwMJ278sveMY2BgCA0NFRISwqkhyQ1q/Nyd3zg4OBgYGNjZ2ePi4rB5loGBhZnhxTLJ/9ulv26Q4uVk1NXV/f///////69du4Zdg78lx//t0v+3S88rFISInD59GqIH2esIJ8G9O2/XVwhjzpw5EAam1xkkBJn/bJX+v1365hxxuCAfH9+3b9/+////48cPuNehNsS7cDEzMTAwMMzb+Q2u4dOnT2vWrMHu9ZtzxP9vl/69RVpCkBlZ3N7enoDXBwEAAA+YYitOilMVAAAAAElFTkSuQmCC :target: https://docs.pyansys.com/ :alt: PyAnsys .. |python| image:: https://img.shields.io/pypi/pyversions/ansys-grantami-dataflow-extensions?logo=pypi :target: https://pypi.org/project/ansys-grantami-dataflow-extensions/ :alt: Python .. |pypi| image:: https://img.shields.io/pypi/v/ansys-grantami-dataflow-extensions.svg?logo=python&logoColor=white :target: https://pypi.org/project/ansys-grantami-dataflow-extensions :alt: PyPI .. |codecov| image:: https://codecov.io/gh/ansys/grantami-dataflow-extensions/branch/main/graph/badge.svg :target: https://codecov.io/gh/ansys/grantami-dataflow-extensions :alt: Codecov .. |GH-CI| image:: https://github.com/ansys/grantami-dataflow-extensions/actions/workflows/ci_cd.yml/badge.svg :target: https://github.com/ansys/grantami-dataflow-extensions/actions/workflows/ci_cd.yml :alt: GH-CI .. |MIT| image:: https://img.shields.io/badge/License-MIT-yellow.svg :target: https://opensource.org/licenses/MIT :alt: MIT .. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff PyGranta Data Flow Extensions ============================= .. _after-badges The PyGranta Data Flow Extensions package provides easy interoperability between Granta MI Data Flow and Python scripts that implement custom business logic. This package streamlines the interaction with Granta MI™ systems using other PyGranta packages and with the Granta MI Scripting Toolkit. Dependencies ------------ .. readme_software_requirements To use the PyGranta Data Flow Extensions package, you need access to a deployment of Granta MI 2023 R2 or later with an MI Data Flow Advanced edition license. Python must be installed system-wide, as opposed to a per-user installation. This option is available during Python installation, and can only be modified by uninstalling and reinstalling Python. .. readme_software_requirements_end Installation ------------ .. readme_installation System-wide ########### Install the package system-wide on the Granta MI application server for production use or for integration testing. To install `the latest release `_ as a system-wide package, run this command as an administrator:: python -m pip install ansys-grantami-dataflow-extensions .. note:: To install packages into the system-wide Python installation directly, you **must** run the preceding command with administrator rights. Otherwise, ``pip install`` will install the package for the current user only and will display the warning: Defaulting to user installation because normal site-packages is not writeable A common symptom of this issue is a script that works when testing outside of Data Flow, but fails with an import error when running from within Data Flow. There are three options to address this issue: - Re-run the command above as a user with administrator privileges. This will ensure the package is installed system-wide. - Re-run the command as the same user that runs MI Data Flow. This will install the package such that the Data Flow user can access it, and will suppress the user installation warning. - Follow the instructions in the Virtual environment to use a `Virtual environment`_. Virtual environment ################### Install the package in a virtual environment: * On a local development environment, for script development and debugging * On the Granta MI application server, when it is not possible to install system-wide packages To install the package in a virtual environment, first create a new virtual environment:: python -m venv C:\path\to\my\venv Where ``C:\path\to\my\venv`` is the path to the location where you would like the venv to be located. This should be a location that all users can access. Then activate the virtual environment and install the packages:: C:\path\to\my\venv\Scripts\activate pip install ansys-grantami-dataflow-extensions If installing in a virtual environment on the Granta MI application server, Data Flow must be configured with details of the virtual environment to be used: #. Create a backup copy of the ``web.config`` file. By default, this file is located at ``C:\inetpub\wwwroot\mi_dataflow``. #. Open the ``web.config`` file in a text editor, and find the line ```` #. Replace the string ``python.exe`` with ``C:\path\to\my\venv\Scripts\python.exe``, where ``C:\path\to\my\venv`` is the path to the virtual environment specified above. #. Save the modified ``web.config`` file. If you see a permissions error, you may need to open the text editor with administrator privileges. #. Reload the Data Flow worker process in IIS Manager. Warning: This stops any running Workflow processes. Installing a development version ################################ To install the latest release from the `PyGranta Data Flow Extensions repository `_, run this command:: python -m pip install git+https://github.com/ansys/grantami-dataflow-extensions.git To install a local *development* version with Git and Poetry, run these commands:: git clone https://github.com/ansys/grantami-dataflow-extensions cd grantami-dataflow-extensions poetry install The preceding commands install the package in development mode so that you can modify it locally. Your changes are reflected in your Python setup after restarting the Python kernel. This option should only be used when making changes to this package, and should not be used when developing code based on this package. .. readme_installation_end