2021-10-12大数据学习日志——Python基础——包、代码规范、案例

学习目标：

• 能够说出包的作用
• 知道使用import包名.模块名能够导入包中的模块
• 知道使用from包名.模块名import...能够导入模块中的符号
• 知道包中__init__.py文件的作用
• 了解PEP8代码规范
• 能够完成面向对象版学生名片管理系统案例：增、删、改、查

01_Python中的包

学习目标：

• 能够说出包的作用
• 知道使用 import 包名.模块名 能够导入包中的模块
• 知道使用 from 包名.模块名 import...能够导入模块中的符号
• 知道包中__init__.py文件的作用

---

1.1 创建包

• 有 2 个模块功能有些联系，可以将其放到同一个文件夹下

• 要组成包，还需要在该文件夹中创建__init__.py文件

总结：

• 把有联系的多个模块文件，放到同一个文件夹下，并且在这个文件夹创建一个名字为__init__.py 文件，那么这个文件夹就称之为包

• 包的本质就是一个文件夹，包的作用将模块文件组织起来

• 包能有效避免模块名称冲突问题，提高程序的结构性和可维护性

1.2 导入包中模块

• 使用 import 包名.模块名 能够导入包中的模块
• 使用 from 包名.模块名 import...能够导入模块中的符号

示例代码：

"""
方式1：
导入格式：   import 包名.模块名
            包名就是文件夹名    模块名就是文件名字
使用格式：   包名.模块名.工具   (类名、函数、变量)
"""
import msg.sendmsg
msg.sendmsg.send_test()

"""
方式2：
导入格式：   from 包名.模块名 import 所需的工具
使用格式：   工具   (类名、函数、变量)
"""
from msg.sendmsg import send_test
# from msg.sendmsg import *
send_test()

1.3 __init__.py文件有什么用

• 包被导入时，会执行 __init__.py文件的内容

• __init__.py 的作用：控制包的导入行为，管理模块文件

1.3.1 导包执行__init__.py内容

• 包被导入时，会执行 __init__.py文件的内容

 1.3.2 控制导入模块

1.4 [补充内容]列表和字典拆包传参

学习目标:

        理解列表和字典拆包传参的形式

# *args：元组不定长参数
# **kwargs：字典不定长参数

def func(*args, **kwargs):
    print(type(args), args) # tuple元祖：(1, 2, 5)
    print(type(kwargs), kwargs) # dict字典：{'a': 1, 'b': 3, 'c': 5}


# 调用 func 函数
# func(1, 2, 5, a=1, b=3, c=5)


def sum(a, b):
    print(f'a：{a}, b：{b}')
    return a + b


my_list = [1, 2]

# 需求1：调用 sum 函数，并将 my_list 中的 1 和 2 分别传递给形参 a 和 b
# res = sum(my_list[0], my_list[1])

# 调用函数时，在传递实参时在列表前添加*，表示将列表中的每个元素取出，按照顺序给函数传实参
res = sum(*my_list) # 等价于sum(my_list[0], my_list[1])
print(res)

print('=' * 20)

my_dict = {'a': 2, 'b': 3}

# 需求2：调用 sum 函数，并将 my_dict 中的 2 和 3 分别传递给形参 a 和 b
# res = sum(my_dict['a'], my_dict['b'])

# 调用函数时，在传递实参时在字典前添加**，表示将字典拆包传递实参：key=value、key=value...
res = sum(**my_dict) # 等价 sum(a=2, b=3)
print(res)

1.5 [补充内容]列表和字典拆包传参

学习目标:

        知道python中万物皆'对象'

# 定义一个空列表
my_list = []
print(type(my_list), my_list)

my_list = list()
print(type(my_list), my_list)

print('=' * 20)

# 定义一个空字典
my_dict = {}
print(type(my_dict), my_dict)

my_dict = dict()
print(type(my_dict), my_dict)


my_dict = {'a': 1, 'b': 3, 'c': 2}

for key, value in my_dict.items():
    # print(type(item), item)
    print(key, value)

1.6 [补充内容]函数递归调用

学习目标:

        了解函数递归调用的过程

"""
在一个函数的内部，又去调用自身，这就是函数递归调用【自己调用自己】
注意：函数递归调用一般会在特定情况下不再调用函数本身（一定要有出口），否则会导致到达最大递归次数, 程序报错
"""

"""
通过递归函数实现求阶乘
1! = 1  
2! = 2 × 1 = 2 × 1!  
3! = 3 × 2 × 1 = 3 × 2!  
4! = 4 × 3 × 2 × 1 = 4 × 3!  
...  
n! = n × (n-1)!
"""

# 需求：封装一个函数，计算 n 的阶乘
def func(n):
    """计算n的阶乘并返回结果"""
    if n == 1:
        return 1
    else:
        return n * func(n-1)

res = func(3)
print(res)

res = func(4)
print(res)

# 需求：封装一个函数，计算1-n的和

# n=1，和：1
# n=2：和：2 + 1
# n=3：和：3 + 1

# n：func(n) = n + func(n-1)

def func_sum(n):
    """计算1-n的和"""
    if n == 1:
        return 1
    else:
        return n + func_sum(n-1)

res = func_sum(4)
print(res)

02_PEP8: Python代码风格指南

学习目标：

• 了解PEP8代码规范

---

PEP8代码规范

PEP8 提供了 Python 代码的编写约定，本节知识点旨在提高代码的可读性，并使其在各种 Python 代码中编写风格保持一致。

1） 缩进使用4个空格, 空格是首选的缩进方式. Python3 不允许混合使用制表符和空格来缩进.

2）每一行最大长度限制在79个字符以内.

3）顶层函数、类的定义, 前后使用两个空行隔开.

4）import 导入

        （1）导入建议在不同的行, 例如:

import os
import sys
# 不建议如下导包
import os, sys
# 但是可以如下:
from subprocess import Popen, PIPE

        （2）导包位于文件顶部, 在模块注释、文档字符串之后, 全局变量、常量之前. 导入按照以下顺序分组:

                a. 标准库导入

                b. 相关第三方导入

                c. 本地应用/库导入

                d. 在每一组导入之间加入空行

5）Python 中定义字符串使用双引号、单引号是相同的, 尽量保持使用同一方式定义字符串. 当一个字符串包含单引号或者双引号时, 在最外层使用不同的符号来避免使用反斜杠转义, 从而提高可读性.

6）表达式和语句中的空格:

        （1）避免在小括号、方括号、花括号后跟空格.

        （2）避免在逗号、分号、冒号之前添加空格.

        （3）冒号在切片中就像二元运算符, 两边要有相同数量的空格. 如果某个切片参数省略, 空格也省略.

        （4）避免为了和另外一个赋值语句对齐, 在赋值运算符附加多个空格.

        （5）避免在表达式尾部添加空格, 因为尾部空格通常看不见, 会产生混乱.

        （6）总是在二元运算符两边加一个空格, 赋值（=），增量赋值（+=，-=），比较（==,<,>,!=,<>,<=,>=,in,not,in,is,is not），布尔（and, or, not

7）避免将小的代码块和 if/for/while 放在同一行, 要避免代码行太长.

if foo == 'blah': do_blah_thing()
for x in lst: total += x
while t < 10: t = delay()

8）永远不要使用字母 'l'(小写的L), 'O'(大写的O), 或者 'I'(大写的I) 作为单字符变量名. 在有些字体里, 这些字符无法和数字0和1区分, 如果想用 'l', 用 'L' 代替.

9）类名一般使用首字母大写的约定.

10）函数名应该小写, 如果想提高可读性可以用下划线分隔.

11）如果函数的参数名和已有的关键词冲突, 在最后加单一下划线比缩写或随意拼写更好. 因此 class_ 比 clss 更好.(也许最好用同义词来避免这种冲突).

12）方法名和实例变量使用下划线分割的小写单词, 以提高可读性.

03_学生名片管理系统：面向对象版

学习目标：

• 能够完成面向对象版学生名片管理系统案例：增、删、改、查

---

示例代码

import os

class Student(object):
    """学生类：保存学生的基本信息"""

    def __init__(self, _name='mike', _age=18, _tel='110'):
        self.name = _name
        self.age = _age
        self.tel = _tel

    def __str__(self):
        """返回实例属性信息"""
        # \t一个tab键的空格
        return f'{self.name}\t{self.age}\t{self.tel}'

    # 设计方法，返回一个字典格式的内容
    def to_dict(self):
        return {'name': self.name, 'age': self.age, 'tel': self.tel}


# 学生管理类，管理学生：增删改查学生信息
class ManagerStuSys(object):
    # 1. 需要有个属性，专门保存学生对象，属性是列表
    def __init__(self):
        self.user_list = []

    # 2. 测试，专门放学生信息
    def test(self):
        s1 = Student('mike', 34, '110')
        s2 = Student('yoyo', 24, '120')
        self.user_list.append(s1)
        self.user_list.append(s2)

        # 1. 从列表取出对象
        for obj in self.user_list:
            # 2. 打印的是对象, 打印obj str方法的返回值
            print(obj)

    # 显示菜单函数定义
    @staticmethod
    def show_menu():
        print('=' * 20)
        print('= 1. 添加学生')
        print('= 2. 查询所有学生')
        print('= 3. 查询某个学生')
        print('= 4. 修改某个学生')
        print('= 5. 删除某个学生')
        print('= 6. 保存信息')
        print('= 7. 退出系统')
        print('=' * 20)

    # 定义新建学生的函数
    def add_stu_info(self):
        """添加学生信息"""
        # 1. 输入用户信息：姓名、年龄、电话
        _name = input('请输入学生姓名：')
        _age = int(input('请输入学生年龄：'))  # 年龄应该是整型，所有做了int转换
        _tel = input('请输入学生电话：')

        # 2. 通过for遍历，取出某个对象元素
        for obj in self.user_list:
            # 2.1 对象.name == 用户输入的名字，是否相等，相等则跳出循环
            if obj.name == _name:
                print('此用户已经存在，请重来')
                # 2.2 break跳出循环
                break
        else:
            # 3. for中的else 如果用户不存在列表中，创建对象，添加到列表
            # 3.1 创建对象
            obj = Student(_name, _age, _tel)

            # 3.2 追加列表
            self.user_list.append(obj)

    # 显示所有的学生，带序号的
    def show_all_stu(self):
        """显示所有的学生"""
        # 1. 遍历前，打印一些提示信息：序号    姓名  年龄  电话
        # \t一个tab键的空格
        print('序号\t\t姓名\t\t年龄\t\t电话')

        # 2. 遍历 for 索引位置，对象 in enumerate(列表)：
        for i, obj in enumerate(self.user_list):
            # 2.1 打印一个用户的信息 索引位置+1，对象.属性……
            print('%d\t\t%s\t\t%d\t\t%s' % (i + 1, obj.name, obj.age, obj.tel))

    # 显示某个学生
    def show_one_stu(self):
        """显示某个学生"""
        # 1. 输入姓名
        _name = input('请输入学生姓名：')

        # 2. 通过for遍历，取出一个对象
        for obj in self.user_list:
            # 2.1 对象.name和输入姓名判断
            if obj.name == _name:
                # 2.1.1 如果相等，输出用户信息，退出循环
                print('查询到的用户信息如下：')
                print('%s\t%d\t%s' % (obj.name, obj.age, obj.tel))
                break
        # 3. for中的else，循环执行完毕，没有break，说明用户不存在，提示一下
        else:
            print('查询的用户不存在')

    def update_stu_by_name(self):
        """更新某个学生信息，根据输入的姓名匹配哪个学生"""
        # 1. 输入需要修改的用户姓名
        update_name = input('输入需要修改的用户姓名：')

        # 2. for遍历，带索引的遍历   i, obj  in 列表
        for i, obj in enumerate(self.user_list):
            # 2.1 如果obj.name和输入用户名字相等
            if obj.name == update_name:
                # 2.1.1 重新输入新的姓名、年龄、电话
                _name = input('请输入新的学生姓名：')
                _age = int(input('请输入新的学生年龄：'))
                _tel = input('请输入新的学生电话：')
                # 2.1.2 对user_list[i].name = 新的name
                self.user_list[i].name = _name
                self.user_list[i].age = _age
                self.user_list[i].tel = _tel
                # 2.1.3 ……、修改成功打印、break跳出循环
                print('修改成功')
                break
        # 3. for中的else 输入的用户不在列表
        else:
            print('输入的用户不在列表，请重新输入')

    def del_stu_by_name(self):
        """删除某个学生，根据输入的姓名"""
        # 1. 输入用户姓名
        _name = input('请输入需要删除的名字：')

        # 2. for遍历，带索引的遍历   i, obj  in 列表
        for i, obj in enumerate(self.user_list):
            # 2.1 如果obj.name和输入用户名字相等
            if obj.name == _name:
                # 2.1.1 del 列表[i], 同时break跳出循环
                del self.user_list[i]
                print('删除成功')
                break
        # 3. for中else 输入的用户在列表中，不存在
        else:
            print('用户不在列表中，无法删除')

    # 1.3 名片信息保存到文件 函数的设计
    def save_info(self):
        """名片信息保存到文件"""
        # 1. 将[对象1， 对象2] 转换为 [{}, {}]
        new_list = []
        for obj in self.user_list:
            temp_dict = {'name': obj.name, 'age': obj.age, 'tel': obj.tel}
            new_list.append(temp_dict)

        # 2. str([{}, {}])转换后，写入文件
        with open('stu.txt', 'w') as f:
            f.write(str(new_list))
            print('文件保存成功')

    def load_info(self):
        """加载数据"""
        # 2.2 判断文件是否存在，不存在，中断函数
        # 文件开头需要 import os
        if not os.path.exists('stu.txt'):
            print('文件不存在，无法加载')
            return

        # 2.3 文件存在的时候，加载数据
        # 2.4 通过with打开文件，只读方式打开文件
        with open('stu.txt', 'r') as f:
            # 1. 从文件读出来的内容是字符串，通过eval转换为[{}, {}]
            content = f.read()
            stu_list = eval(content)
            # 2. 从列表中取出字典，再取出字典的元素，这个元素用新建对象
            for user_dict in stu_list:
                obj = Student(user_dict['name'], user_dict['age'], user_dict['tel'])
                # 3. 列表追加对象
                self.user_list.append(obj)
            print('数据成功加载')

    # 3. 主逻辑程序，就是功能选择
    def start(self):

        # 加载文件
        self.load_info()

        # 1. 死循环
        while True:
            # 调用菜单
            self.show_menu()

            # 2. 用户输入数字
            cmd = input("请输入功能数字：")

            # 3. 条件选择
            if cmd == "1":
                print('添加学生')
                self.add_stu_info()
            elif cmd == "2":
                print('查询所有学生')
                self.show_all_stu()
            elif cmd == "3":
                print('查询某个学生')
                self.show_one_stu()
            elif cmd == "4":
                print('修改某个学生')
                self.update_stu_by_name()
            elif cmd == "5":
                print('删除某个学生')
                self.del_stu_by_name()
            elif cmd == '6':
                print('保存文件')
                self.save_info()
            elif cmd == "7":
                print('退出循环')
                break
            else:
                print('输入有误，请重新输入')


# 创建对象，调用方法
ms = ManagerStuSys()
ms.start()