Python Virtual Environments

The Python Virtual Environments feature in Gathr allows you to create and store isolated Python environments within the application. These environments can be seamlessly utilized within Python processors when developing ETL applications, ensuring consistency in dependencies and package management.

This feature is available on a request basis. Please email Gathr Support to enable the Python Processor and Python Virtual Environments feature.

To create and manage Python virtual environments, navigate to the Environments page from the main menu.

Python Virtual Environment home page

Any updates made to an environment, whether from the Environments page or during Python processor configuration are automatically synchronized across both sections.


Create Python Virtual Environment

  1. Click the Create Python Virtual Environment button.

    pve-02-create-env

  2. Enter an environment name to create a new environment, for example: Staging.

    Ensure that the environment name is unique. A notification will be shown if a duplicate name exists.

  3. Provide an optional description for the Python virtual environment.

  4. Define the environment scope to customize their accessibility.

  • Project: Accessible to organization users limited to projects that are specified by the environment owner for usage in Python processor.

  • Organization: Accessible to organization users across all Gathr projects for usage in Python processor.

  1. Enter Python package names separated by newlines or upload a package list. Download a sample package list for reference.

  2. Click on Create Environment once the configuration fields are set.

    pve-03-create-env-in-progress

    The creation of a Python virtual environment may take some time, depending on the selected packages. You can monitor its progress using the Get Status option.

    pve-04-create-env-status

    After the environment is successfully created, a confirmation message will be displayed.

    pve-05-created-successfully

  3. Important: Ensure that you SAVE the Python Virtual Environment to complete the creation process. Once saved, you will be redirected to the listing page.

    pve-06-listing-page

  4. Users in projects within the defined scope of the created environment can utilize it in their Python processors.

    pve-08-use-in-pipeline


Manage Python Virtual Environments

Manage Python virtual environments from the listing page, where you can:

  • Edit or Delete an environment

  • Download the Package List

  • View versions of the environment

    pve-07-listing-actions

  • Check all details, including the list of ETL applications using the environment

    pve-09-used-in-apps

    Environment Usage Summary

    pve-10-usage-summary

Manage Python Virtual Environment Versions

When editing a Python virtual environment, you can either modify an existing version or create a new one. In both cases, a new environment must be created and saved as outlined in the Create Python Virtual Environment steps.

pve-10-create-versions

The new version will be displayed on the listing page.

Top