Introduce Python virtual environments for PEP-668 compliance

.gitignore

@@ -55,6 +55,7 @@ Temporary Items
 # Build Outputs
 # =========================
 
+.venv/
 *.gba
 *.elf
 *.map

Makefile

@@ -11,6 +11,11 @@ UNAME := $(shell uname)
 TOOLCHAIN ?= $(DEVKITARM)
 PREFIX ?= arm-none-eabi-
 
+VENV ?= .venv
+VENV_ACTIVATE := $(VENV)/bin/activate
+VENV_PYTHON := $(VENV)/bin/python
+VENV_PIP := $(VENV)/bin/pip
+
 export PATH := $(TOOLCHAIN)/bin:$(PATH)
 
 ifeq ($(UNAME),Darwin)
@@ -22,6 +27,7 @@ AS := $(PREFIX)as$(EXE)
 LD := $(PREFIX)ld$(EXE)
 OBJCOPY := $(PREFIX)objcopy$(EXE)
 STRIP := $(PREFIX)strip$(EXE)
+PYTHON := python3
 
 CC1     := tools/agbcc/bin/agbcc$(EXE)
 CC1_OLD := tools/agbcc/bin/old_agbcc$(EXE)
@@ -33,8 +39,8 @@ AIF2PCM    := tools/aif2pcm/aif2pcm$(EXE)
 MID2AGB    := tools/mid2agb/mid2agb$(EXE)
 TEXTENCODE := tools/textencode/textencode$(EXE)
 JSONPROC   := tools/jsonproc/jsonproc$(EXE)
-FETSATOOL  := scripts/gfxtools/tsa_generator.py
-MARTOMAP   := scripts/mar_to_map.py
+FETSATOOL  := $(VENV_PYTHON) scripts/gfxtools/tsa_generator.py
+MARTOMAP   := $(VENV_PYTHON) scripts/mar_to_map.py
 
 ifeq ($(UNAME),Darwin)
 	SED := sed -i ''
@@ -126,19 +132,26 @@ tag:
 
 .PHONY: tag
 
+venv: $(VENV_ACTIVATE)
+
+$(VENV_ACTIVATE):
+	$(PYTHON) -m venv $(VENV)
+	. $(VENV_ACTIVATE)
+	$(VENV_PIP) install -r requirements.txt
+
 #### Recipes ####
 
-# Comprssed Texts Recipes
+# Compressed Texts Recipes
 
 # =========
 # = Texts =
 # =========
 TEXT_DIR := texts
 TEXT_TOOLS := scripts/texttools
 
-TEXT_DECODER := $(PYTHON)  $(TEXT_TOOLS)/textdecoder.py
-TEXT_DPARSER := $(PYTHON) $(TEXT_TOOLS)/textdeparser.py
-TEXT_PROCESS := $(PYTHON) $(TEXT_TOOLS)/textprocess.py
+TEXT_DECODER := $(VENV_PYTHON) $(TEXT_TOOLS)/textdecoder.py
+TEXT_DPARSER := $(VENV_PYTHON) $(TEXT_TOOLS)/textdeparser.py
+TEXT_PROCESS := $(VENV_PYTHON) $(TEXT_TOOLS)/textprocess.py
 
 TEXT_MAIN := $(TEXT_DIR)/texts.txt
 TEXT_DEFS := $(TEXT_DIR)/textdefs.txt
@@ -147,7 +160,7 @@ TEXT_SRC  := $(TEXT_MAIN) $(shell find $(TEXT_DIR) -type f -name "*.txt")
 TEXT_HEADER := include/constants/msg.h
 MSG_LIST    := src/msg_data.c
 
-src/msg_data.c: $(TEXT_SRC) $(TEXT_DEFS)
+src/msg_data.c: $(TEXT_SRC) $(TEXT_DEFS) $(VENV_ACTIVATE)
 	@$(TEXT_PROCESS) $(TEXT_MAIN) $(TEXT_DEFS) $@ $(TEXT_HEADER) utf8
 
 # Graphics Recipes
@@ -169,13 +182,14 @@ include json_data_rules.mk
 %.lz: % ; $(GBAGFX) $< $@
 %.rl: % ; $(GBAGFX) $< $@
 %.fk: % ; ./scripts/compressor.py $< fk
-%.bin: %.mar  ; $(MARTOMAP)  $< $@
+%.bin: %.mar $(VENV_ACTIVATE)
+	$(MARTOMAP)  $< $@
 sound/%.bin: sound/%.aif ; $(AIF2PCM) $< $@
 
 %.4bpp.h: %.4bpp
 	$(BIN2C) $< $(subst .,_,$(notdir $<)) | sed 's/^const //' > $@
 
-%.feimg1.bin %.fetsa1.bin: %.png
+%.feimg1.bin %.fetsa1.bin: %.png $(VENV_ACTIVATE)
 	$(FETSATOOL) $< $*.feimg1.bin $*.fetsa1.bin
 
 # Battle Animation Recipes

requirements.txt

@@ -0,0 +1,3 @@
+numpy==2.2.5
+pillow==11.2.1
+ttp==0.9.5

scripts/asm2casm.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 import sys
 

scripts/dump-proc.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys

scripts/dump_088AF6F4.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_WmMonsterGenerateRates.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys

scripts/dump_anim_scr.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys

scripts/dump_anim_sprite.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_animconf.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_battle_animation_pointer_table.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 # dump battle animation pointers and data pointed
 # by laqieer

scripts/dump_battletalk.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_chapterasset.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_debugcreditpinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_debugpinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_defeattalk.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_eventinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_eventitemlist.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_events.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_eventshoplist.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_eventsinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 import sys, ctypes
 import symbols

scripts/dump_eventstrapdata.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_img.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys, struct, os
 import array

scripts/dump_imgs.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys
 from dump_img import dump_img

scripts/dump_itembonus.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_itemdata.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 from fe8db import ITEM_IDX, ITYPE_IDX, WPN_EXP, WPN_EFFECT

scripts/dump_jidlut.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 from fe8db import JID_IDX

scripts/dump_jinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 from fe8db import JID_IDX, UNIT_AFFIN, WPN_EXP
 import symbols

scripts/dump_mapanimconf.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 # struct MapAnimSpellfxConf

scripts/dump_one_sprite.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 import sys
 

scripts/dump_pinfo.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 from fe8db import PID_IDX, JID_IDX, UNIT_AFFIN, WPN_EXP
 import symbols

scripts/dump_proc_cmds.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 import struct
 import subprocess

scripts/dump_ptr.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_ptrs.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_redas.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_s16.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_supportdata.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_tactician.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 import struct
 
 bin_file_path = "baserom.gba"

scripts/dump_terraintable.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 # dump move-cast, terrain-avo table, etc

scripts/dump_u8.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/dump_udef.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys, ctypes

scripts/enum_to_pydef.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 import sys

scripts/find_nearest_symbol.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 import subprocess
 import sys

scripts/gen_split_data.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 # -*- coding: UTF-8 -*-
 
 # split data

scripts/generate_declarations.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 PREFIX = DemonLightBg4_Close
 LENGTH = 8

scripts/get_lz77_compressed_data_length.py

@@ -1,4 +1,4 @@
-#!/usr/bin/python3
+#!/usr/bin/env python3
 
 # get the length of lz77 compressed data
 # python3 get_lz77_compressed_data_length.py baserom.gba <offset>

scripts/gfxtools/lzss_compress.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys
 import lzss_lib

scripts/gfxtools/lzss_decompress.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys
 import lzss_lib

scripts/gfxtools/lzss_lib.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 from sys import stderr
 

scripts/gfxtools/tsa_analysis.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys, struct
 from collections import Counter

scripts/gfxtools/tsa_bin_analysis.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys, struct
 from collections import Counter

scripts/gfxtools/tsa_generator.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 import sys, re
 import numpy as np

scripts/lzss_lib.py

@@ -1,4 +1,4 @@
-#!/bin/python3
+#!/usr/bin/env python3
 
 from sys import stderr