项目-名片管理系统

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

目标

综合应用已经学习过的知识点:

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

开发 名片管理系统

系统需求

    1. 程序启动,显示名片管理系统欢迎界面,并显示功能菜单
1
2
3
4
5
6
7
**************************************************
欢迎使用【名片管理系统】V1.0
1. 新建名片
2. 显示全部
3. 查询名片
0. 退出系统
**************************************************
    1. 用户用数字选择不同的功能
    1. 根据功能选择,执行不同的功能
    1. 用户名片需要记录用户的 姓名电话QQ邮件
    1. 如果查询到指定的名片,用户可以选择 修改 或者 删除 名片

步骤

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

01. 框架搭建

目标

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

1.1 文件准备

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

1.2 编写主运行循环

  • cards_main 中添加一个 无限循环
1
2
3
4
5
6
7
8
9
10
11
12
while True:
# TODO(小明) 显示系统菜单
action = input("请选择操作功能:")
print("您选择的操作是:%s" % action)
# 根据用户输入决定后续的操作
if action in ["1", "2", "3"]:
pass
elif action == "0":
print("欢迎再次使用【名片管理系统】")
break
else:
print("输入错误,请重新输入")

字符串判断

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

pass

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

无限循环

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

TODO 注释

  • # 后跟上 TODO,用于标记需要去做的工作
1
# TODO(作者/邮件) 显示系统菜单

1.3 在 cards_tools 中增加四个新函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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 模块
1
import cards_tools
  • 修改 while 循环的代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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 函数

1
2
3
4
5
6
7
8
9
10
11
12
13
def show_menu():

"""显示菜单
"""
print("*" * 50)
print("欢迎使用【菜单管理系统】V1.0")
print("")
print("1. 新建名片")
print("2. 显示全部")
print("3. 查询名片")
print("")
print("0. 退出系统")
print("*" * 50)

02. 保存名片数据的结构

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

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

名片管理系统全局列表

定义名片列表变量

  • cards_tools 文件的顶部增加一个 列表变量
1
2
# 所有名片记录的列表
card_list = []

注意

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

03. 新增名片

3.1 功能分析

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

3.2 实现 new_card 方法

  • 根据步骤实现代码
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
def new_card():

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

# 1. 提示用户输入名片信息
name = input("请输入姓名:")
phone = input("请输入电话:")
qq = input("请输入 QQ 号码:")
email = input("请输入邮箱:")

# 2. 将用户信息保存到一个字典
card_dict = {"name": name,
"phone": phone,
"qq": qq,
"email": email}

# 3. 将用户字典添加到名片列表
card_list.append(card_dict)

print(card_list)

# 4. 提示添加成功信息
print("成功添加 %s 的名片" % card_dict["name"])

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

04. 显示所有名片

4.1 功能分析

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

4.2 基础代码实现

1
2
3
4
5
6
7
8
9
10
def show_all():

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

for card_dict in card_list:

print(card_dict)
  • 显示效果不好!

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
def show_all():
"""显示全部
"""
print("-" * 50)
print("功能:显示全部")

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

print("")

# 打印分隔线
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 增加没有名片记录判断

1
2
3
4
5
6
7
8
9
10
11
def show_all():
"""显示全部
"""
print("-" * 50)
print("功能:显示全部")

# 1. 判断是否有名片记录
if len(card_list) == 0:
print("提示:没有任何名片记录")

return

注意

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

05. 查询名片

5.1 功能分析

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

5.2 代码实现

  • 查询功能实现
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
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电话\t\t\tQQ\t\t\t邮箱")
print("-" * 40)

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

print("-" * 40)

# TODO(小明) 针对找到的字典进行后续操作:修改/删除

break
else:
print("没有找到 %s" % find_name)
  • 增加名片操作函数:修改/删除/返回主菜单
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
def deal_card(find_dict):

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

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

action_str = input("请选择要执行的操作 "
"[1] 修改 [2] 删除 [0] 返回上级菜单")

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

06. 修改和删除

6.1 查询成功后删除名片

  • 由于找到的字典记录已经在列表中保存
  • 要删除名片记录,只需要把列表中对应的字典删除即可
1
2
3
4
elif action == "2":
card_list.remove(find_dict)

print("删除成功")

6.2 修改名片

  • 由于找到的字典记录已经在列表中保存
  • 要修改名片记录,只需要把列表中对应的字典中每一个键值对的数据修改即可
1
2
3
4
5
6
7
8
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 函数进行扩展
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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. LINUX 上的 Shebang 符号(#!)

  • #!这个符号叫做 Shebang 或者 Sha-bang
  • Shebang 通常在 Unix 系统脚本的中 第一行开头 使用
  • 指明 执行这个脚本文件解释程序

使用 Shebang 的步骤

    1. 使用 which 查询 python3 解释器所在路径
1
$ which python3
    1. 修改要运行的 主 python 文件,在第一行增加以下内容
1
#! /usr/bin/python3
    1. 修改 主 python 文件 的文件权限,增加执行权限
1
$ chmod +x cards_main.py
    1. 在需要时执行程序即可
1
./cards_main.py