This project automates downloading, extracting, processing, and saving the Visier application definition data using Playwright and Pandas. Follow the steps below to set up and run the project.
project_folder/
│-- zip/ # Store tenant Application definition ZIP files here
│-- extract/ # Extracted unzipped files will be saved here
│-- logs/ # Log files will be stored here
│-- my_utils/ # Utility Python functions
│-- output/ # Final processed files will be saved here
│-- config.yml # Configuration file for settings
│-- requirements.txt # Dependencies list
│-- visier_object_inheritance_tracing.py # Main Python script
│-- run.bat # Batch file to execute the script in windows
Ensure you have the following installed on your system:
- Python 3.8+ (Check with
python --version
) - pip (Check with
pip --version
)
Download and install Python from https://www.python.org/downloads/. Ensure to check the option "Add Python to PATH" during installation.
Open a terminal or command prompt and navigate to the project folder:
cd path\to\project_folder
Create a virtual environment named visier-object-trace
:
python -m venv visier-object-trace
Activate the virtual environment:
- Windows:
visier-object-trace\Scripts\activate
- Mac/Linux:
source visier-object-trace/bin/activate
Once the virtual environment is activated, install dependencies:
pip install -r requirements.txt
Edit config.yml
and update your credentials and settings (for augeointegration and augeo environments):
general:
default_env: augeointegration
augeointegration:
credentials:
username: your_username
password: your_password
settings:
tenants: tenant1,tenant2
vanity_name: augeointegration
headless: true
browser_type: chrome
Execute the batch file to run the Python script:
run.bat
This will:
- Create the virtual environment if not present.
- Activate the virtual environment
- Run the
visier_object_inheritance_tracing.py
- Log messages will be displayed in the terminal and saved in
logs/
After running the script, you can deactivate the virtual environment:
deactivate
- If you encounter issues with dependencies, try running
pip install --upgrade pip
before installing requirements. - Logs are saved in the
logs/
folder. Check them for debugging issues.