07名片管理系统

1.  系统需求

• 程序启动, 显示名片管理系统欢迎界面, 并显示功能菜单
• 用户用数字选择不同的功能
• 根据功能选择,  执行不能的功能
• 用户名片需要记录用户的 姓名 , 电话 , QQ ,邮件
• 如果查询到指定的名片,  用户可以选择 修改 或者 删除 名片

步骤

1. 框架搭建
2. 新增名片
3. 显示所有名片
4. 查询名片
5. 查询成功后修改, 删除名片
6. 让 Python 程序能够直接运行

2.  框架搭建
目标

• 搭建名片管理系统 框架结构

1. 准备文件,  确定文件名,  保证能够  在需要的位置 编写代码
2. 编写 主运行循环,  实现基本的 用户输入和判断

2.1  文件准备

1. 新建 cards_main.py 保存 主程序功能代码

程序的入口
2. 新建 cards_tools.py 保存 所有名片功能函数

• 将对名片的 新增, 查询, 修改, 删除 等功能封装在不同的函数中

2.2  编写主运行循环

1. 在 cards_main 中添加一个 无限循环

while True:

    # 显示功能菜单

    action_str = input("请选择希望执行的操作: ")

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

    # 根据用户输入决定后续的操作
    if action_str in ["1", "2", "3"]:
        pass
    # 0 退出系统
    elif action_str == "0":

        print("欢迎再次使用【名片管理系统】")

        break
        # 如果在开发程序时, 不希望立刻写分支内部的代码
        # 可以使用 pass 关键字, 表示一个占位符, 能够保证程序的代码结构正确!
        # 程序运行时, pass 关键字不会执行任何的操作!
        # pass
    # 其他内容输入错误, 需要提示用户
    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注释 去掉
# TODO (作者 / 邮件) 显示系统菜单
在 PyCharm 左下角可以查找到哪些地方做过 TODO 注释 ,然后点击跳转, 就可以直接开始写代码了

3.  保存名片数据的结构 
程序就是用来处理数据的,  而变量就是用来存储数据的

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

定义名片列表变量 

在 cards_tools 文件的顶部增加一个 列表变量
# 记录所有名片的列表
card_list = []
注意 :

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

import cards_tools

while True:

    # 显示功能菜单
    cards_tools.show_menu()

    action_str = input("请选择希望执行的操作: ")

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

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

        # 新增名片
        if action_str == "1":
            cards_tools.new_card()
        # 显示全部
        elif action_str == "2":
            cards_tools.show_all()
        # 查询名片
        elif action_str == "3":
            cards_tools.search_card()
        pass
    # 0 退出系统
    elif action_str == "0":

        print("欢迎再次使用【名片管理系统】")

        break
        # 如果在开发程序时, 不希望立刻写分支内部的代码
        # 可以使用 pass 关键字, 表示一个占位符, 能够保证程序的代码结构正确!
        # 程序运行时, pass 关键字不会执行任何的操作!
        # pass
    # 其他内容输入错误, 需要提示用户
    else:
        print("您输入的不正确, 请重新选择")

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


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


def new_card():
    """新增名片"""
    print("-" * 30)
    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 的名片成功" % card_dict['name'])


def show_all():
    """显示所有名片"""
    print("-" * 30)
    print("显示所有名片")
    # 判断是否存在名片记录, 如果没有, 提示用户并且返回
    if len(card_list) == 0:
        print("当前没有任何的名片记录, 请使用新增功能添加名片")

        # return 可以返回一个函数的执行结果
        # 下方的代码不会被执行
        # 如果 return 后面没有任何的内容, 表示会返回到调用函数的位置
        # 并且不返回任何的结果
        return

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

    # 打印分割线
    print("=" * 30)

    # 遍历名片列表一次输入字典信息
    for card_dict in card_list:
        # 遍历名片信息
        for item in card_dict:
            print(card_dict[item], end="		")
        print("")


def search_card():
    """搜索名片"""
    print("-" * 30)
    print("搜索名片")

    # 1. 提示用户输入要搜索的姓名
    find_name = input("请输入要搜索的姓名: ")

    # 2. 遍历名片列表, 查询要搜索的姓名, 如果没有找到, 需要提示用户
    for card_dict in card_list:

        if card_dict["name"] == find_name:
            print("姓名		电话		QQ		邮箱")
            print("=" * 30)
            print("%s		%s		%s		%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. 返回上级菜单")

    if action_str == "1":
        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