Configuring a New Project

Configuring and Using PyCharm

Workspace

• On your PC, create a folder named ConnectX that will contain all your projects.

Using Python Commands

• Inside PyCharm, there is a console available which can be opened from the menu at the bottom left.

Creating a New Project

Template / Starter Pack

Downloading the Project

• Download the project (template or starter pack) into a separate directory:

  • For Sugar practice only:
    https://gitext.opensymbol.it/dev/connectx-starterpack-sugar.git
  • For all other practices (excluding Sugar):
    https://gitext.opensymbol.it/dev/connectx-template.git

• Inside the new project, copy files/folders from the template while keeping the folder structure.

---

Installing ConnectX Core Framework

Linux

• Inside the PyCharm console, run the following command:

pip install git+https://gitlab.impresoftengage.com/connectx/core.git

• If the command above returns an error:
  • Run:

sudo apt-get install python3-dev default-libmysqlclient-dev build-essential pkg-config

- Then rerun:

pip install git+https://gitlab.impresoftengage.com/connectx/core.git

Windows

• Inside the PyCharm console, run:

py.exe -m pip install git+https://gitlab.impresoftengage.com/connectx/core.git

Notes

• Python and the ETL project must be on the same drive (e.g., C:\) for proper password encryption.
• The ConnectX core installation already contains all dependent libraries like Polars.

Updating or Reinstalling ConnectX Core

• To get the latest version after a fix:

pip uninstall connectx
pip install git+https://gitlab.impresoftengage.com/connectx/core.git

• To install a specific version:

pip uninstall connectx
pip install git+https://gitlab.impresoftengage.com/connectx/core.git@X.Y.Z