⭐ PG-APP-Core ⭐

A.　Implement

　Tree

tree -I 'venv|.git|__pycache__|docs|logs|assets|kafka_data|charts'

.
├── .pre-commit-config.yaml
├── LICENSE
├── README.md
├── requirements.txt
├── src
│   ├── __init__.py
│   ├── core
│   │   ├── __init__.py
│   │   ├── models
│   │   │   ├── __init__.py
│   │   │   ├── simulator.py
│   │   │   └── sink_format.py
│   │   ├── v1
│   │   │   ├── __init__.py
│   │   │   ├── factory_config.yaml
│   │   │   ├── init_factory_data.py
│   │   │   └── simulate_factory_stream.py
│   │   └── v2
│   │       ├── __init__.py
│   │       ├── api
│   │       │   └── __init__.py
│   │       ├── cp
│   │       │   ├── __init__.py
│   │       │   └── main.py
│   │       ├── factory_config.yaml
│   │       ├── inst
│   │       │   ├── __init__.py
│   │       │   └── main.py
│   │       └── scripts
│   │           ├── __init__.py
│   │           ├── create_topic.py
│   │           ├── init.py
│   │           └── topics_config.json
│   └── scripts
│       ├── __init__.py
│       ├── generic_benchmark
│       │   ├── dashboard_benchmark.sql
│       │   └── olap_benchmark.sql
│       ├── observational_simulation
│       │   ├── Makefile
│       │   ├── api.py
│       │   ├── conn.py
│       │   ├── logging_test.py
│       │   ├── sh_scripts
│       │   │   ├── check-pipeline.sh
│       │   │   ├── load-test.sh
│       │   │   └── port-forward.sh
│       │   ├── table
│       │   │   ├── __init__.py
│       │   │   └── order.py
│       │   └── utils
│       │       ├── __init__.py
│       │       ├── constant.py
│       │       └── normal.py
│       ├── security_simulation
│       │   ├── Makefile
│       │   ├── monitor_roles.py
│       │   ├── request_secret.py
│       │   ├── sh_scripts
│       │   │   ├── check-pipeline.sh
│       │   │   └── port-forward.sh
│       │   └── utils
│       │       ├── __init__.py
│       │       ├── constant.py
│       │       └── normal.py
│       └── sql
│           ├── auto_partition.py
│           ├── delete_data.py
│           └── drop_table.py
└── tests
    ├── test_generic_configs.py
    ├── test_generic_imports.py
    └── test_generic_syntax.py

B.　Execution

• b.1.　Command Platform

  python3 src/core/v2/cp/main.py
  

• b.2.　Instance

  python3 src/core/v2/inst/main.py
  

C.　Push Code

• c.1.　Manual → Not Recommended

  # <語法格式版本>
  black --version
  # <語法格式檢查>
  black src/
  
  # 期望輸出
  # All done! ✨ 🍰 ✨
  # ?? files left unchanged.

• c.2.　Auto → Recommended

  # 全域設定 ( 一次性 )
      # 1. 透過 Ubuntu 系統套件管理員安裝 pipx
      sudo apt update && sudo apt install -y pipx
      
      # 2. pipx 自動配置環境變數路徑
      pipx ensurepath
      
      # 3. 用 pipx 安裝 pre-commit
      pipx install pre-commit
  
  # ⭐ 當前專案的 .pre-commit-config.yaml & pre-commit 工具正式綁定
  pre-commit install
  
  # ⭐ 強制檢查
  pre-commit run --all-files