57 uv package manager

.github/workflows/deploy-main-push.yml

@@ -40,19 +40,20 @@ jobs:
     - uses: actions/checkout@v4
     - name: Set environment variable
       run: echo "GITHUB_ACTIONS_UNITTEST_FLAG=1" >> $GITHUB_ENV
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v3
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install python dependencies
       run: |
-        python -m pip install --upgrade pip
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        uv sync
     - name: Test with unittest
       run: |
-        python -m unittest discover ./generator/unittests/utilities
-        python -m unittest discover ./generator/unittests/objects
-        python -m unittest discover ./generator/unittests/app
+        uv run python -m unittest discover ./generator/unittests/utilities
+        uv run python -m unittest discover ./generator/unittests/objects
+        uv run python -m unittest discover ./generator/unittests/app
 
   dockerhub-image-push:
     needs: [trivy-fs-scan, python-unittests]

.github/workflows/dev-pull-requests.yml

@@ -28,16 +28,17 @@ jobs:
     - uses: actions/checkout@v4
     - name: Set environment variable
       run: echo "GITHUB_ACTIONS_UNITTEST_FLAG=1" >> $GITHUB_ENV
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v3
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install python dependencies
       run: |
-        python -m pip install --upgrade pip
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        uv sync
     - name: Test with unittest
       run: |
-        python -m unittest discover ./generator/unittests/utilities
-        python -m unittest discover ./generator/unittests/objects
-        python -m unittest discover ./generator/unittests/app
+        uv run python -m unittest discover ./generator/unittests/utilities
+        uv run python -m unittest discover ./generator/unittests/objects
+        uv run python -m unittest discover ./generator/unittests/app

.python-version

@@ -0,0 +1 @@
+3.12

Dockerfile

@@ -11,6 +11,7 @@ ENV PYTHON_VERSION=${PYTHON_VERSION}
 # install required software and programmes for development environment
 RUN apt-get update
 RUN apt-get install -y apt-utils vim curl wget unzip tree htop adduser
+RUN apt-get install -y imagemagick=8:7.1.1.43+dfsg1-1+deb13u5 libssl-dev=3.5.4-1~deb13u2
 
 # set up home environment
 RUN adduser ${user}
@@ -19,11 +20,12 @@ RUN mkdir -p /home/${user} && chown -R ${user}: /home/${user}
 # copy repo
 COPY . /home/${user}/RandomTelecomPayments
 
-# install required python packages
-RUN python -m pip install -v -r /home/${user}/RandomTelecomPayments/requirements.txt
-
 # set working directory for random telecom payments app
 WORKDIR /home/${user}/RandomTelecomPayments
 
+# install required python packages
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+RUN uv sync
+
 EXPOSE 8000
-ENTRYPOINT  ["python", "generator/main.py"]
+ENTRYPOINT  ["uv", "run", "generator/main.py"]

README.md

@@ -68,7 +68,7 @@ docker cp rtp:/home/user/RandomTelecomPayments/data/RandomTelecomPayments.csv %u
 Alternatively, a FastApi interface has been configured within the docker image to allow for interaction with the Random Telecom Payments app via REST API calls. The FastApi interface can be accessed by publishing port 8000 when running the docker image as follows:
 
 ```
-docker run --name rtp --publish 8000:8000 --entrypoint fastapi --rm oislen/randomtelecompayments:latest run generator/api.py
+docker run --name rtp --publish 8000:8000 --entrypoint uv --rm oislen/randomtelecompayments:latest run fastapi run generator/api.py
 ```
 
 Once the web endpoint is running, navigate to localhost:8000/docs in your preferred browser to access the FastApi interface documentation and test the available API calls.

aws/exeRunEC2.cmd

@@ -1 +1 @@
-call python prg_run_ec2_instance.py --launch --terminate --describe --isFleet
+call uv run prg_run_ec2_instance.py --launch --terminate --describe --isFleet

config/uv/RandomTelecomPayments.cmd

@@ -0,0 +1,2 @@
+:: call powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+call uv add -r requirements.txt --link-mode=copy

generator/exeApi.cmd

@@ -1 +1 @@
-call fastapi run api.py
+call uv run fastapi run api.py

generator/exeApi.sh

@@ -1 +1 @@
-fastapi run api.py
+uv run fastapi run api.py

generator/exeGenNames.cmd

@@ -1 +1 @@
-call python -m pdb utilities\gen_user_names_file.py
+call uv run utilities\gen_user_names_file.py

generator/exeMain.cmd

@@ -1,2 +1,2 @@
-call python -m pdb main.py --n_users 100 --use_random_seed 1 --n_itr 1
-:: call python -m pdb main.py --n_users 13000 --use_random_seed 1 --n_itr 2
+call uv run main.py --n_users 100 --use_random_seed 1 --n_itr 1
+:: call uv run main.py --n_users 13000 --use_random_seed 1 --n_itr 2

generator/exeMain.sh

@@ -1,2 +1,2 @@
-python3 -m pdb main.py --n_users 100 --use_random_seed 1 --n_itr 1
-# python3 -m pdb main.py --n_users 13000 --use_random_seed 1 --n_itr 2
+uv run main.py --n_users 100 --use_random_seed 1 --n_itr 1
+# uv run main.py --n_users 13000 --use_random_seed 1 --n_itr 2

generator/exeUnittests.cmd

@@ -1,5 +1,5 @@
 call cd ..
-call python -m unittest discover generator\unittests\utilities
-call python -m unittest discover generator\unittests\objects
-call python -m unittest discover generator\unittests\app
+call uv run python -m unittest discover generator\unittests\utilities
+call uv run python -m unittest discover generator\unittests\objects
+call uv run python -m unittest discover generator\unittests\app
 call cd generator

generator/exeUnittests.sh

@@ -1,5 +1,5 @@
 cd ..
-python3 -m unittest discover unittests/utilities
-python3 -m unittest discover unittests/objects
-python3 -m unittest discover unittests/app
+uv run python3 -m unittest discover unittests/utilities
+uv run python3 -m unittest discover unittests/objects
+uv run python3 -m unittest discover unittests/app
 cd generator

pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "randomtelecompayments"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "beartype==0.19.0",
+    "boto3==1.36.12",
+    "fastapi[standard]==0.128.0",
+    "fastparquet==2024.11.0",
+    "ipykernel==6.29.5",
+    "networkx==3.4.2",
+    "numpy==2.0.2",
+    "pandas==2.2.3",
+    "pyarrow==18.1.0",
+    "scikit-learn==1.6.1",
+    "scipy==1.15.1",
+    "seaborn==0.13.2",
+    "shap==0.46.0",
+    "unidecode==1.3.8",
+]