refactor: build hierarchy for codec

- Separate codec build Makefile and README instructions into the j2735codec folder.
- Update CI build process to reflet new structure.

Author: yhseanhsu

.github/workflows/ci-release.yml

@@ -41,10 +41,11 @@ jobs:
       - name: Compile
         run: |
           source emsdk/emsdk_env.sh
+          cd j2735codec
           make wasm
           # Create __init__.py files
-          touch j2735codec/bindings/python/src/j2735codec/generated/__init__.py
-          touch j2735codec/bindings/python/src/j2735codec/protobuf/__init__.py
+          touch bindings/python/src/j2735codec/generated/__init__.py
+          touch bindings/python/src/j2735codec/protobuf/__init__.py
 
       - name: Upload Python Artifacts
         uses: actions/upload-artifact@v4

Makefile

@@ -1,228 +1,8 @@
-# SPDX-FileCopyrightText: 2025 Verizon
-# SPDX-License-Identifier: Apache-2.0
-
-# --- Colors and Styles ---
-ifeq ($(shell tput colors 2>/dev/null), 256)
-    RED    := $(shell tput setaf 1)
-    YELLOW := $(shell tput setaf 3)
-    GREEN  := $(shell tput setaf 2)
-    BOLD   := $(shell tput bold)
-    RESET  := $(shell tput sgr0)
-else
-    RED := ""
-    YELLOW := ""
-    GREEN := ""
-    BOLD := ""
-    RESET := ""
-endif
-
-# --- Detection ---
-PYTHON_CMD := $(shell which python3 || which python)
-ifeq ($(PYTHON_CMD),)
-    PYTHON_INSTALLED := false
-else
-    PYTHON_INSTALLED := true
-    PYTHON := $(PYTHON_CMD)
-    IS_VENV := $(shell $(PYTHON) -c 'import sys; print("true" if sys.prefix != sys.base_prefix else "false")')
-endif
-
-NPM   := $(shell which npm)
-CMAKE := $(shell which cmake)
-UV    := $(shell which uv)
-
-# --- Variables ---
-PROJECT_ROOT        := $(shell pwd)
-BUILD_DIR_NATIVE    = j2735codec/build_native
-BUILD_DIR_WASM      = j2735codec/build_wasm
-
-DIST_DIR            = j2735codec/dist
-
-BINDING_PY          = j2735codec/bindings/python
-PY_DIST_DIR         = $(BINDING_PY)/dist
-
-BINDING_JS          = j2735codec/bindings/node
-JS_DIST_DIR         = $(BINDING_JS)/dist
-
-J2735_REV           ?= j2735_202409
-THREADS             ?= $(shell nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)
-
-SAMPLE_PY			= etx/examples/python
-
-SAMPLE_JS			= etx/examples/node
-
-VERSION             ?= $(shell cat VERSION 2>/dev/null || echo "0.1.0")
-
-# --- Targets ---
-
-.PHONY: all setup native wasm purge help \
-        setup-py build-py install-py test-py clean-py uninstall-py \
-        setup-js build-js install-js test-js clean-js sync-version
-
-help:
-	@echo "$(BOLD)ETX Starter Kit Management:$(RESET)"
-	@echo "  $(BOLD)make setup$(RESET)      - Sync all dependencies (Frozen/Locked)"
-	@echo "  $(BOLD)make install-py$(RESET) - Full Python lifecycle (Build -> Test Wheel)"
-	@echo "  $(BOLD)make install-js$(RESET) - Full Node.js lifecycle (Build -> Test Tarball)"
-	@echo "  $(BOLD)make native$(RESET)     - Build native C library"
-	@echo "  $(BOLD)make wasm$(RESET)       - Build WASM & Generate Enums"
-	@echo "  $(BOLD)make purge$(RESET)      - Hard reset of all artifacts and lockfiles"
-
-all: sync-version setup native wasm build-py build-js
-
-setup: setup-py setup-js
-
-# --- Environment Guard ---
-
-check-env:
-ifeq ($(PYTHON_INSTALLED), false)
-	@echo "$(RED)$(BOLD)❌ ERROR: Python not found!$(RESET)"; exit 1
-endif
-ifeq ($(NPM),)
-	@echo "$(RED)$(BOLD)❌ ERROR: npm not found!$(RESET)"; exit 1
-endif
-
-# --- Python Workflow ---
-
-setup-py: check-env
-	@echo "🛠️  Syncing Python dependencies (Frozen)..."
-ifdef UV
-	$(UV) sync --all-packages --frozen --quiet
-else
-	$(PYTHON) -m pip install --upgrade pip build pytest psutil
-	$(PYTHON) -m pip install -e $(BINDING_PY)
-endif
-
-uninstall-py:
-	@echo "🗑️  Uninstalling j2735codec package..."
-	@if [ -d ".venv" ]; then \
-		if [ -n "$(UV)" ]; then $(UV) pip uninstall j2735codec 2>/dev/null || true; \
-		else $(PYTHON) -m pip uninstall -y j2735codec 2>/dev/null || true; fi \
-	fi
-
-build-py: wasm setup-py
-	@echo "📦 Packaging Python Wheel..."
-ifdef UV
-	$(UV) build --package j2735codec --wheel --out-dir $(PY_DIST_DIR)
-else
-	$(PYTHON) -m build $(BINDING_PY) --outdir $(PY_DIST_DIR)
-endif
-
-test-py: setup-py
-	@echo "🧪 Running pytest..."
-ifdef UV
-	$(UV) run python -m pytest $(BINDING_PY)/tests -s
-else
-	$(PYTHON) -m pytest $(BINDING_PY)/tests -s
-endif
-
-install-py: uninstall-py clean-py wasm
-	@echo "$(BOLD)🧪 Phase 1: Testing Local Source...$(RESET)"
-	@$(MAKE) test-py
-	@echo "$(BOLD)🔨 Phase 2: Building Wheel...$(RESET)"
-	@$(MAKE) build-py
-	@WHEEL_PATH=$$(ls $(PY_DIST_DIR)/*.whl | head -n 1); \
-	echo "$(BOLD)📦 Phase 3: Installing $$WHEEL_PATH...$(RESET)"; \
-	if [ -n "$(UV)" ]; then $(UV) pip install $$WHEEL_PATH; \
-	else $(PYTHON) -m pip install $$WHEEL_PATH; fi
-	@echo "$(BOLD)🧪 Phase 4: Integration Test (Clean-Room)...$(RESET)"
-	@TEMP_DIR=$$(mktemp -d); \
-		echo "Temp Test Directory: $$TEMP_DIR"; \
-		cp -r $(BINDING_PY)/tests $$TEMP_DIR/tests; \
-		mkdir -p $$TEMP_DIR/tests/samples; \
-		cp -r $(PROJECT_ROOT)/j2735codec/core/$(J2735_REV)/samples/jer/* $$TEMP_DIR/tests/samples/; \
-		cd $$TEMP_DIR; \
-		echo "Contents of temp directory:"; \
-		ls -R; \
-		if [ -n "$(UV)" ]; then \
-			$(UV) init; \
-			$(UV) venv; \
-			WHEEL_PATH=$$(realpath $(PROJECT_ROOT)/$(BINDING_PY)/dist/*.whl | head -n1); \
-			$(UV) pip install --upgrade pip pytest psutil $$WHEEL_PATH; \
-			$(UV) run python -m pytest tests -s; \
-		else \
-			$(PYTHON) -m pip install --upgrade pip pytest; \
-			$(PYTHON) -m pytest tests -s; \
-		fi; \
-		rm -rf $$TEMP_DIR; \
-		echo "$(GREEN)$(BOLD)✅ Success: Python Wheel verified in isolation.$(RESET)"
-
-clean-py:
-	rm -rf $(PY_DIST_DIR) $(BINDING_PY)/*.egg-info
-	find $(BINDING_PY) -type d -name "__pycache__" -exec rm -rf {} +
-
-# --- Node Workflow ---
-
-setup-js: check-env
-	@echo "📦 Syncing Node.js workspaces (Frozen/ci)..."
-	@$(NPM) ci
-
-build-js: wasm setup-js
-	@echo "🔨 Building Node Bindings..."
-	@$(NPM) run build -w j2735codec
-
-test-js: setup-js
-	@echo "🧪 Running Vitest..."
-	@$(NPM) test -w j2735codec
-
-clean-js:
-	@echo "🧹 Cleaning Node artifacts..."
-	@rm -rf $(JS_DIST_DIR)
-	@find $(BINDING_JS) -name "*.tgz" -delete
-	@find . -type d -name "node_modules" -exec rm -rf {} +
-
-install-js: clean-js build-js
-	@echo "$(BOLD)🧪 Phase 1: Local Source Test...$(RESET)"
-	@$(MAKE) test-js
-	@echo "$(BOLD)🔨 Phase 2: Packaging Tarball...$(RESET)"
-	@cd $(BINDING_JS) && $(NPM) pack > /dev/null
-	@echo "$(BOLD)📦 Phase 3: Isolated Integration Test...$(RESET)"
-	@TARBALL_PATH=$$(ls $(BINDING_JS)/*.tgz | head -n 1); \
-	FULL_TARBALL_PATH=$$(pwd)/$$TARBALL_PATH; \
-	TEMP_DIR=$$(mktemp -d); \
-	echo "Temp Test Directory: $$TEMP_DIR"; \
-	( \
-		cd $$TEMP_DIR && \
-		$(NPM) init -y > /dev/null && \
-		echo "📦 Installing tarball..." && \
-		$(NPM) install $$FULL_TARBALL_PATH > /dev/null && \
-		$(NPM) install vitest --no-save > /dev/null && \
-		cp -r $(PROJECT_ROOT)/$(BINDING_JS)/tests ./tests && \
-		mkdir -p samples && \
-		cp -r $(PROJECT_ROOT)/j2735codec/core/$(J2735_REV)/samples/jer/* ./samples/ && \
-		echo "$(BOLD)🚀 Verifying tarball in isolation...$(RESET)" && \
-		$(NPM) exec vitest run -- --environment node --dir ./tests \
-	) || (rm -rf $$TEMP_DIR && exit 1); \
-	rm -rf $$TEMP_DIR; \
-	echo "$(GREEN)$(BOLD)✅ Success: Node Tarball verified.$(RESET)"
-
-# --- C++ / WASM Logic ---
-
-native:
-	$(CMAKE) -B $(BUILD_DIR_NATIVE) -S j2735codec -DBUILD_NATIVE_LIB=ON
-	$(CMAKE) --build $(BUILD_DIR_NATIVE) -j $(THREADS)
-
-wasm:
-	emcmake $(CMAKE) -B $(BUILD_DIR_WASM) -S j2735codec -DJ2735_REV=$(J2735_REV)
-	$(CMAKE) --build $(BUILD_DIR_WASM) -j $(THREADS)
-
-purge: uninstall-py clean-py clean-js
-	@echo "🔥 Hard purging all artifacts and lockfiles..."
-	# 1. Remove specific known directories
-	rm -rf $(BUILD_DIR_NATIVE) $(BUILD_DIR_WASM) node_modules $(DIST_DIR)
-	rm -rf $(BINDING_PY)/src/j2735codec/generated
-	rm -rf $(BINDING_JS)/src/generated
-	
-	# 2. Find and remove all .venv directories in the project
-	find . -type d -name ".venv" -exec rm -rf {} +
-	
-	# 3. Find and remove other common python artifacts
-	find . -type d -name "build" -not -path "*/emsdk/*" -exec rm -rf {} +
-	find . -type d -name "*.egg-info" -exec rm -rf {} +
-	find . -type d -name ".pytest_cache" -exec rm -rf {} +
-	
-	@echo "✨ Purged. Use 'make setup' to recreate environment."
-
-# --- Versioning Logic ---
+BINDING_PY 		= 	j2735codec/bindings/python
+BINDING_JS      = 	j2735codec/bindings/node
+SAMPLE_PY		= 	etx/examples/python
+SAMPLE_JS		= 	etx/examples/node
+VERSION         ?= 	$(shell cat VERSION 2>/dev/null || echo "0.1.0")
 
 sync-version:
 	@echo "🔄 Syncing version $(VERSION) to manifests..."