# 一個(gè).py文件就是一個(gè)模塊
# example.py 就是一個(gè)名為example的模塊
def say_hello():
    print("你好！")


def add(a, b):
    return a + b

# 包是一個(gè)包含__init__.py文件的文件夾
my_package/
    __init__.py    # 這個(gè)文件讓Python知道這是包
    module1.py
    module2.py

項(xiàng)目結(jié)構(gòu)：
project/
    main.py
    utils.py

# utils.py
def greet(name):
    return f"你好，{name}！"


def calculate_sum(numbers):
    return sum(numbers)

# main.py - 方法1：導(dǎo)入整個(gè)模塊
import utils

result = utils.greet("小明")
print(result)  # 輸出：你好，小明！

total = utils.calculate_sum([1, 2, 3, 4, 5])
print(total)   # 輸出：15

# main.py - 方法2：導(dǎo)入特定功能
from utils import greet, calculate_sum

result = greet("小紅")  # 直接使用，不用加 utils.
print(result)

# main.py - 方法3：導(dǎo)入并重命名
from utils import greet as say_hello

say_hello("小張")  # 使用新名字

# Python內(nèi)置庫(kù)
import math
import random
import datetime

# 第三方庫(kù)（需要先安裝）
# pip install requests
import requests

my_project/
│   main.py
│
├───database/
│   │   __init__.py
│   │   connector.py
│   │   models.py
│
└───utils/
    │   __init__.py
    │   math_tools.py
    │   string_tools.py

# main.py
from database.connector import connect_db
from utils.math_tools import add_numbers
from utils.string_tools import format_text

# 在 database/models.py 中
from .connector import connect_db    # . 表示同一目錄
from ..utils.math_tools import add_numbers  # .. 表示上級(jí)目錄

# 在 database/models.py 中
from database.connector import connect_db    # 與main同一目錄
from utils.math_tools import add_numbers  # 與main同一目錄

# database/__init__.py
# 空文件也可以，但有它才算是包

# utils/__init__.py
# 集中導(dǎo)入，方便外部使用
from .math_tools import *
from .string_tools import *


# 或者更精確的控制
__all__ = ['add_numbers', 'multiply_numbers', 'format_text']

# 這樣在外面就可以
from utils import add_numbers  # 不需要知道m(xù)ath_tools的存在

# utils/__init__.py
# 包版本信息
__version__ = "1.0.0"
__author__ = "你的名字"


# 包初始化代碼
print("正在加載工具包...")


# 包級(jí)別的配置
DEFAULT_CONFIG = {
    "log_level": "INFO",
    "timeout": 30
}

simple_app/
    app.py          # 主程序
    config.py       # 配置
    helpers.py      # 輔助函數(shù)
    data.json       # 數(shù)據(jù)文件

medium_app/
│   main.py                    # 程序入口
│   requirements.txt           # 依賴列表
│   README.md                 # 說(shuō)明文檔
│
├───core/                     # 核心業(yè)務(wù)邏輯
│   │   __init__.py
│   │   calculator.py        # 計(jì)算器類
│   │   validator.py         # 驗(yàn)證器
│
├───ui/                       # 用戶界面
│   │   __init__.py
│   │   window.py           # 主窗口
│   │   widgets.py          # 小部件
│
├───data/                     # 數(shù)據(jù)處理
│   │   __init__.py
│   │   loader.py           # 數(shù)據(jù)加載
│   │   saver.py            # 數(shù)據(jù)保存
│
└───utils/                   # 通用工具
    │   __init__.py
    │   logger.py           # 日志工具
    │   formatter.py        # 格式化工具

professional_app/
│
├───src/                     # 源代碼目錄（推薦結(jié)構(gòu)）
│   └───my_app/              # 你的包名
│       │   __init__.py
│       │   __main__.py     # 命令行入口：python -m my_app
│       │   cli.py          # CLI接口
│       │   config.py       # 配置管理
│       │
│       ├───core/
│       │   │   __init__.py
│       │   │   business_logic.py
│       │   │   models.py
│       │
│       ├───api/
│       │   │   __init__.py
│       │   │   routes.py
│       │   │   handlers.py
│       │
│       └───utils/
│           │   __init__.py
│           │   helpers.py
│           │   decorators.py
│
├───tests/                   # 測(cè)試目錄
│   │   __init__.py
│   │   test_core.py
│   │   test_utils.py
│   │   conftest.py         # pytest配置
│
├───docs/                    # 文檔
│       index.md
│       tutorial.md
│
├───examples/               # 示例代碼
│       basic_usage.py
│       advanced_features.py
│
├───scripts/                # 腳本
│       setup_env.py
│       generate_data.py
│
│   .gitignore              # Git忽略文件
│   pyproject.toml          # 項(xiàng)目配置（現(xiàn)代方式）
│   setup.py               # 安裝配置（傳統(tǒng)方式）
│   README.md              # 項(xiàng)目說(shuō)明
│   LICENSE               # 許可證
└───requirements.txt       # 依賴包列表

# 在命令行中執(zhí)行
pip install pyinstaller


# 驗(yàn)證安裝
pyinstaller --version

# 最簡(jiǎn)單的打包
pyinstaller your_program.py


# 打包后，在 dist/ 文件夾中找到可執(zhí)行文件

# 1. --onefile：打包成單個(gè)文件
pyinstaller --onefile main.py


# 2. --windowed：無(wú)控制臺(tái)窗口（適合GUI程序）
pyinstaller --windowed gui_app.py


# 3. --icon：設(shè)置圖標(biāo)
pyinstaller --onefile --windowed --icon=my_icon.ico main.py


# 4. --name：指定輸出文件名
pyinstaller --name "我的應(yīng)用" main.py


# 5. --add-data：添加額外文件（如配置文件、圖片）
# Windows格式：源文件路徑;目標(biāo)路徑
# Linux/Mac格式：源文件路徑:目標(biāo)路徑
pyinstaller --add-data "config.ini;." main.py
pyinstaller --add-data "images/*.png:images" main.py


# 6. --hidden-import：添加隱藏的依賴
pyinstaller --hidden-import=tkinter main.py

# 假設(shè)你有一個(gè) tkinter 程序
pip install pyinstaller


# 進(jìn)入項(xiàng)目目錄
cd your_project_folder


# 打包命令
pyinstaller --onefile --windowed --icon=app.ico --name "我的應(yīng)用" ^
            --add-data "images;images" ^
            --add-data "config.ini;." ^
            main.py

# 生成初始spec文件
pyi-makespec main.py


# 或者從已經(jīng)打包的項(xiàng)目中復(fù)制

# main.spec
# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['main.py'],  # 主程序文件
    pathex=[],    # 搜索路徑
    binaries=[],  # 二進(jìn)制文件
    datas=[       # 數(shù)據(jù)文件
        ('config.ini', '.'),
        ('images/*.png', 'images'),
        ('sounds/*.wav', 'sounds')
    ],
    hiddenimports=[  # 隱藏的依賴
        'tkinter',
        'PIL._tkinter_finder'
    ],
    hookspath=[],    # 鉤子路徑
    hooksconfig={},  # 鉤子配置
    runtime_hooks=[],  # 運(yùn)行時(shí)鉤子
    excludes=[],     # 排除模塊（減少體積）
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=None,     # 加密字節(jié)碼
    noarchive=False  # 不打包成archive
)


# 打包成單個(gè)文件
pyz = PYZ(a.pure, a.zipped_data, cipher=None)


exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='我的應(yīng)用',  # 輸出文件名
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,        # 使用UPX壓縮
    console=False,   # 顯示控制臺(tái)？True/False
    icon='app.ico',  # 圖標(biāo)
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None
)


coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='我的應(yīng)用'  # 文件夾名稱
)

# 使用spec文件打包
pyinstaller main.spec

pip install cx-Freeze