综合应用 —— 名片管理系统

目标

综合应用以下知识点：

• 变量
• 流程控制
• 函数
• 模块

开发 名片管理系统

系统需求

• 1. 程序启动，显示名片管理系统欢迎界面，并显示功能菜单

**************************************************
欢迎使用【名片管理系统】V1.0

1. 新建名片
2. 显示全部
3. 查询名片

0. 退出系统
**************************************************

• 2. 用户用数字选择不同的功能
• 3. 根据功能选择，执行不同的功能
• 4. 用户名片需要记录用户的 姓名、电话、qq、邮件
• 5. 如果查询到指定的名片，用户可以选择 修改 或者 删除 名片

步骤

1. 框架搭建
2. 新增名片
3. 显示所有名片
4. 查询名片
5. 查询成功后修改、删除名片

01. 框架搭建

目标

• 搭建名片管理系统 框架结构
  1. 准备文件，确定文件名，保证能够 在需要的位置 编写代码
  2. 编写 主运行循环，实现基本的 用户输入和判断

1.1 文件准备

1. 新建 cards_main.py 保存 主程序功能代码
   • 程序的入口
   • 每一次启动名片管理系统都通过 main 这个文件启动
2. 新建 cards_tools.py 保存 所有名片功能函数
   • 将对名片的 新增、查询、修改、删除 等功能封装在不同的函数中

• 注意，项目文件中还应该新建一个__init__.py空文件

1.2 编写主运行循环

• 在 cards_main 中添加一个 无限循环

while True:

    # TODO 显示系统的功能
    
    action_str = input("请选择希望执行的操作：")
    print("您选择的操作是【%s】"%action_str)

    # 1,2,3 针对名片的操作
    if action_str in ['1','2',"3"]:
        # 1:新增名片；
        if action_str == '1':
            pass
        # 2：显示全部；
        elif action_str == '2':
            pass
        # 3：查询名片
        elif action_str == "3":
            pass
        # 如果在开发程序时，不希望立刻编写分支内部的代码
        # 则可以使用pass关键字，表示一个占位符，能够保证程序的代码结构正确
        # 程序运行时，pass关键字不会进行任何的操作
        pass
    # 0 退出系统
    elif action_str == "0":
        print('欢迎再次使用系统')
        break
    # 其他输入则提示用户输入错误
    else:
        print('您输入的不正确，请重新选择')

字符串判断

if action in ["1", "2", "3"]:

if action == "1" or action == "2" or action == "3":

1. 使用 in 针对 列表 判断，避免使用 or 拼接复杂的逻辑条件
2. 没有使用 int 转换用户输入，可以避免 一旦用户输入的不是数字，导致程序运行出错

pass

• pass 就是一个空语句，不做任何事情，一般用做占位语句
• 是为了保持程序结构的完整性

无限循环

• 在开发软件时，如果 不希望程序执行后 立即退出
• 可以在程序中增加一个 无限循环
• 由用户来决定 退出程序的时机

TODO 注释

• 在 # 后跟上 TODO，用于标记需要去做的工作，注释变色加深

# TODO 显示系统菜单

1.3 在 cards_tools 中增加四个新函数

def show_menu():

    """显示菜单
    """
    pass

def new_card():

    """新建名片
    """
    print("-" * 50)
    print("功能：新建名片")


def show_all():

    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")


def search_card():

    """搜索名片
    """
    print("-" * 50)
    print("功能：搜索名片")

1.4 导入模块

• 在 cards_main.py 中使用 import 导入 cards_tools 模块

import cards_tools

• 修改 while 循环的代码如下：

import cards_tools

while True:

    cards_tools.show_menu()

    action = input("请选择操作功能：")

    print("您选择的操作是：%s" % action)

    # 根据用户输入决定后续的操作
    if action in ["1", "2", "3"]:

        if action == "1":
            cards_tools.new_card()

        elif action == "2":
            cards_tools.show_all()

        elif action == "3":
            cards_tools.search_card()

    elif action == "0":
        print("欢迎再次使用【名片管理系统】")

        break
    else:
        print("输入错误，请重新输入：")

至此：cards_main 中的所有代码全部开发完毕！

1.5 完成 show_menu 函数，构建new_card函数、show_all函数、search_card函数基本框架

def show_menu():
    
    """显示菜单"""
    print("*" *50)
    print("欢迎使用【名片管理系统】V 1.0")
    print("")
    print("1.新增名片")
    print("2.显示全部")
    print("3.搜索名片")
    print("")
    print("0.退出系统")
    print("*" * 50)


def new_card():
    """新增名片"""
    print("*" * 50)
    print("新增名片")


def show_all():

    """显示所有名片"""
    print("*" * 50)
    print("显示所有名片")


def search_card():

    """搜索名片"""
    print("*" * 50)
    print("搜索名片")

02. 保存名片数据的结构

程序就是用来处理数据的，而变量就是用来存储数据的

• 使用 字典 记录 每一张名片 的详细信息
• 使用 列表 统一记录所有的 名片字典

定义名片列表变量

• 在 cards_tools 文件的顶部增加一个 列表变量

# 所有名片记录的列表
card_list = []

注意

1. 所有名片相关操作，都需要使用这个列表，所以应该 定义在程序的顶部
2. 程序刚运行时，没有数据，所以是 空列表

03. 新增名片

3.1 功能分析

1. 提示用户依次输入名片信息
2. 将名片信息保存到一个字典
3. 将字典添加到名片列表
4. 提示名片添加完成

3.2 实现 new_card 方法

• 根据步骤实现代码

def new_card():
    """新增名片"""
    print("*" * 50)
    print("新增名片")
    # 1. 提示用户输入名片的详细信息
    name_str = input("请输入姓名：")
    phone_str = input("请输入电话：")
    qq_str = input("请输入qq：")
    email_str = input("请输入邮箱：")

    # 2. 使用用户输入的信息建立一个名片字典
    card_dict = {"name":name_str,
                 "phone":phone_str,
                 "qq":qq_str,
                 "email":email_str}
    # 3. 将名片字典添加到列表中
    card_list.append(card_dict)
    print(card_list)

    # 4. 提示用户添加成功
    print("添加%s的名片成功！"%name_str)

技巧：在 PyCharm 中，可以使用 SHIFT + F6 统一修改变量名

04. 显示所有名片

4.1 功能分析

• 循环遍历名片列表，顺序显示每一个字典的信息

4.2 基础代码实现

def show_all():

    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")

    for card_dict in card_list:

        print(card_dict)
        

• 显示效果不好！信息不能很好的对应

4.3 增加标题和使用 \t 显示

def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")

    # 打印表头
    for name in ["姓名", "电话", "qq", "邮箱"]:
        print(name, end="\t\t")

    print("") #for循环内部所有内容输出后的换行

    # 打印分隔线
    print("=" * 50)
	# 遍历名片列表
    for card_dict in card_list:

        print("%s\t\t%s\t\t%s\t\t%s" % (card_dict["name"],
                                        card_dict["phone"],
                                        card_dict["qq"],
                                        card_dict["email"]))

4.4 增加没有名片记录判断

def show_all():
    """显示全部
    """
    print("-" * 50)
    print("功能：显示全部")

    # 判断是否存在名片记录，如果没有，提示用户并且返回
    if len(card_list) == 0:
        print("提示：没有任何名片记录")

        return

注意

• 通过判断列表的是否为空来判定名片是否有记录

• 在函数中使用 return 表示返回
• 如果在 return 后没有跟任何内容，只是表示该函数执行到此就不再执行后续的代码

4.5 show_all()函数完整代码

def show_all():

    """显示所有名片"""
    print("*" * 50)
    print("显示所有名片")

    # 判断是否存在名片记录，如果没有，提示用户并且返回
    if len(card_list) == 0:
        print("抱歉，没有检查到名片记录")

        # return可以返回一个函数的执行结果
        # 下方的代码不会被执行
        # 如果return 后面没有任何的内容，表示会返回到调用函数的位置
        # 并且不会返回任何的结果
        return
    # 打印表头
    for name in ["姓名","电话","qq","邮箱"]:
        print(name,end="\t\t")
    print("") # for循环内部所有内容输出后的换行
    # 打印分隔线
    print("="*50)
    # 遍历名片列表
    for card_dict in card_list:
        print("%s\t\t%s\t\t%s\t\t%s"%(card_dict["name"],
                                      card_dict["phone"],
                                      card_dict["qq"],
                                      card_dict["email"]))

05. 查询名片

5.1 功能分析

1. 提示用户要搜索的姓名
2. 根据用户输入的姓名遍历列表
3. 搜索到指定的名片后，再执行后续的操作

5.2 代码实现

• 查询功能实现

def search_card():

    """搜索名片"""
    print("*" * 50)
    print("搜索名片")

    # 1.提示用户输入要搜索的姓名
    find_name = input("请输入要搜索的姓名：")
    # 2.遍历名片列表，查询要搜索的姓名，如果没有找到，需要提示用户
    for card_dict in card_list:

        if card_dict["name"] == find_name:
            print("姓名\t\t电话\t\tqq\t\t邮箱")
            print("=" * 50)
            print("%s\t\t%s\t\t%s\t\t%s" % (card_dict["name"],
                                            card_dict["phone"],
                                            card_dict["qq"],
                                            card_dict["email"]))
            #  针对找到的名片记录执行修改和删除的操作

            break
    else:
        print("没有找到 %s" % find_name)

• 增加名片操作函数：修改/删除/返回主菜单

def deal_card(find_dict):

    """操作搜索到的名片字典

    :param find_dict:找到的名片字典
    """
    print(find_dict)

    action_str = input("请选择要执行的操作 "
                       "【1】修改，【2】删除，【0】返回上一级菜单\n")

    if action == "1":
        print("修改")
    elif action == "2":
        print("删除")

06. 修改和删除

6.1 查询成功后删除名片

• 由于找到的字典记录已经在列表中保存
• 要删除名片记录，只需要把列表中对应的字典删除即可

    elif action == "2":
        card_list.remove(find_dict)

        print("删除成功")

6.2 修改名片

• 由于找到的字典记录已经在列表中保存
• 要修改名片记录，只需要把列表中对应的字典中每一个键值对的数据修改即可

    if action == "1":

        find_dict["name"] = input("请输入姓名：")
        find_dict["phone"] = input("请输入电话：")
        find_dict["qq"] = input("请输入qq：")
        find_dict["email"] = input("请输入邮件：")

        print("%s 的名片修改成功" % find_dict["name"])

修改名片细化

• 如果用户在使用时，某些名片内容并不想修改

  系统提供的 input 函数不能满足需求，重新新定义一个函数 input_card_info 对系统的 input 函数进行扩展

def input_card_info(dict_value,tip_message):
    """输入名片信息

    :param dict_value: 字典中原有的值
    :param tip_message: 输入的提示文字
    :return: 如果用户输入了内容，就返回输入的内容，否则返回字典中原有的值
    """
    # 1.提示用户输入内容
    result_str = input(tip_message)
    # 2.针对用户的输入进行判断，如果用户输入了内容，直接返回结果
    if len(result_str) > 0:
        return result_str
    # 3.如果用户没有输入内容，返回字典中原有的值
    else:
        return dict_value

6.3 查询search_card()函数与input_card_info()函数完整代码

def search_card():

    """搜索名片"""
    print("*" * 50)
    print("搜索名片")

    # 1.提示用户输入要搜索的姓名
    find_name = input("请输入要搜索的姓名：")
    # 2.遍历名片列表，查询要搜索的姓名，如果没有找到，需要提示用户
    for card_dict in card_list:

        if card_dict["name"] == find_name:
            print("姓名\t\t电话\t\tqq\t\t邮箱")
            print("=" * 50)
            print("%s\t\t%s\t\t%s\t\t%s" % (card_dict["name"],
                                            card_dict["phone"],
                                            card_dict["qq"],
                                            card_dict["email"]))
            #  针对找到的名片记录执行修改和删除的操作
            #  为了使循环部分代码简洁，单独封装一个函数来实现此功能
            deal_card(card_dict)

            break
    else:
        print("抱歉，没有找到%s"%find_name)


def deal_card(find_dict):
    """处理查找到的名片

    :param find_dict: 查找到的名片
    """
    print(find_dict)
    action_str = input("请选择要执行的操作："
                       "【1】修改，【2】删除，【0】返回上一级菜单\n")
    if action_str == "1":

        # find_dict["name"] = input("姓名：")
        # find_dict["phone"] = input("电话：")
        # find_dict["qq"] = input("qq:")
        # find_dict["email"] = input("邮箱：")
        # input函数提供的功能有限，通过input_card_info函数扩展
        find_dict["name"] = input_card_info(find_dict["name"],"姓名：")
        find_dict["phone"] = input_card_info(find_dict["phone"],"电话：")
        find_dict["qq"] = input_card_info(find_dict["qq"],"qq:")
        find_dict["email"] = input_card_info( find_dict["email"],"邮箱：")
        print("修改名片成功！")

    elif action_str == "2":

        card_list.remove(find_dict)
        print("删除名片成功！")


def input_card_info(dict_value,tip_message):
    """输入名片信息

    :param dict_value: 字典中原有的值
    :param tip_message: 输入的提示文字
    :return: 如果用户输入了内容，就返回输入的内容，否则返回字典中原有的值
    """
    # 1.提示用户输入内容
    result_str = input(tip_message)
    # 2.针对用户的输入进行判断，如果用户输入了内容，直接返回结果
    if len(result_str) > 0:
        return result_str
    # 3.如果用户没有输入内容，返回字典中原有的值
    else:
        return dict_value

07. 程序完整代码

传送门