《从 Gopher 到 Pythonista，Python 快速上手指南》- 学习笔记1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

project_name/                        # 项目根目录
├── project_name/                    # 源码包 (Package) - 核心代码存放地
│   ├── __init__.py                  # 标识此目录为Python包，可包含包初始化代码或定义__all__列表
│   ├── module1.py                   # 模块1：包含相关函数、类等
│   ├── module2.py
│   └── subpackage1/                 # 子包1，用于更深层次的模块化组织
│       ├── __init__.py
│       ├── module3.py
│       └── module4.py
├── tests/                           # 测试目录 - 存放所有单元测试和集成测试
│   ├── __init__.py
│   ├── test_module1.py              # 针对module1的测试
│   ├── test_module2.py
│   └── test_subpackage1/            # 针对子包的测试也可以有相应目录
│       ├── __init__.py
│       └── test_module3.py
├── docs/                            # 项目文档目录 - 使用Sphinx等工具生成详细文档
│   ├── conf.py
│   ├── index.rst
│   └── ...
├── scripts/                         # 脚本目录 - 存放可执行脚本、工具脚本
│   ├── data_cleaning.py
│   ├── train_model.py
│   └── start_server.py
├── data/                           # （可选）数据目录 - 存放项目所需或生成的数据
│   ├── input/
│   └── output/
├── examples/                       # （可选）示例目录 - 存放使用项目的示例代码
├── requirements.txt                # 项目依赖清单 - 列明项目运行所需的所有第三方库及其版本
├── requirements_dev.txt            # （可选）开发环境额外依赖（如测试、构建、文档工具）
├── setup.py                        # 打包和安装脚本 - 用于将项目打包分发给其他人安装使用
├── pyproject.toml                  # 现代项目构建配置文件 (遵循PEP 518)
├── README.md                       # 项目说明文档 - 简介、安装、快速使用等
├── LICENSE                         # 项目许可证文件 - 明确授权条款
└── .gitignore                      # Git忽略规则 - 指定哪些文件/目录不应纳入版本控制

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

"""
This module provides some example classes and functions to demonstrate Python code layout and style.
"""

__version__ = '0.1.0'
__author__ = 'Jane Developer'
__all__ = ['MyClass', 'my_function', 'CONSTANT1']

# Standard Library Imports
import os
import sys

# Third-Party Imports
import requests

# Local Application/Library Specific Imports
from myutils.helpers import format_data

# Global constants
CONSTANT1 = 10
DEFAULT_TIMEOUT = 30

class MyClass:
    """
    A brief description of MyClass.

    More detailed description of the class's purpose and functionality.
    """

    CLASS_CONSTANT = 'some_value'

    def __init__(self, name):
        self.name = name

    def method_one(self):
        """Does a specific thing."""
        pass

    def method_two(self):
        """Does another thing."""
        pass

def my_function(param1, param2=None):
    """
    A brief description of what this function does.

    Args:
        param1 (str): Description of the first parameter.
        param2 (int, optional): Description of the second parameter. Defaults to None.

    Returns:
        bool: Description of the return value.

    Raises:
        ValueError: Under what conditions it's raised.
    """
    if not param1:
        raise ValueError("param1 cannot be empty.")
    
    result = do_something_complex(param1, param2)
    return result

def _private_helper_function():
    """A non-public function (indicated by the leading underscore)."""
    pass

# Main execution block
if __name__ == "__main__":
    # Code here runs only when the module is executed directly,
    # not when it is imported.
    instance = MyClass("test")
    result = my_function("hello")
    print(result)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

print("--- 开始执行 main.py ---")

print("\n1. 导入整个包 my_package")
import my_package  # 这会执行 my_package/__init__.py

print("\n2. 从包中导入特定模块 module_a")
from my_package import module_a  # 由于包已被导入，__init__.py 不会再次执行，但会执行 module_a.py

print("\n3. 从模块中导入特定函数")
from my_package.module_b import hello_from_b  # 导入包内模块的具体函数
print(hello_from_b())  # 调用函数

print("\n--- main.py 执行结束 ---")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

--- 开始执行 main.py ---

1. 导入整个包 my_package
执行 my_package 的 __init__.py 文件

2. 从包中导入特定模块 module_a
执行 module_a.py 模块

3. 从模块中导入特定函数
执行 module_b.py 模块
Hello from Module B!

--- main.py 执行结束 ---

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import requests
from bs4 import BeautifulSoup

url = 'https://www.danielhu.cn/'

try:
    response = requests.get(url)
    response.raise_for_status() # 检查请求是否成功

    # 使用 BeautifulSoup 解析 HTML 并获取页面标题
    soup = BeautifulSoup(response.text, 'html.parser')
    page_title = soup.title.string if soup.title else 'No title found'
    print(f"The title of '{url}' is: {page_title}")

except requests.RequestException as e:
    print(f"An error occurred while fetching the URL: {e}")