项目基础及工具
文章目录
GIT简介
1. 什么是GIT
- git是一个开源的分布式版本控制系统,用于高效的管理各种大小项目和文件。
2. 代码管理工具的用途
- 防止代码丢失,做备份
- 项目的版本管理和控制,可以通过设置节点进行跳转
- 建立各自的开发环境分支,互不影响,方便合并
- 在多终端开发时,方便代码的相互传输
3. git的特点
- git是开源的,多在unix下使用,可以管理各种文件
- git是分布式的项目管理工具(svn是集中式的)
- git数据管理更多样化,分享速度快,数据安全
- git 拥有更好的分支支持,方便多人协调
4. git安装
sudo apt-get install git
GIT使用
基本概念
- 工作区(wprkspace):项目所在操作目录,实际操作项目的区域
- 暂存区(Index): 用于记录工作区的工作(修改)内容
- 仓库区(Repository): 用于备份工作区的内容
- 远程仓库(Remote): 远程主机上的GIT仓库
注意: 在本地仓库中,git总是希望工作区的内容与仓库区保持一致,而且只有仓库区的内容才能和其他远程仓库交互。
初始配置
配置命令: git config
- 配置所有用户: git config --system [选项]
配置文件位置: /etc/gitconfig
- 配置当前用户: git config --global [选项]
配置文件位置: ~/.gitconfig
- 配置当前项目: git config [选项]
配置文件位置: project/.git/config
- 配置用户名
e.g. 将用户名设置为Tedu
sudo git config --system user.name Tedu
查看:cat /etc/gitconfig
- 配置用户邮箱
e.g. 将邮箱设置为lvze@tedu.cn
git config --global user.email lvze@tedu.cn
查看:cat ~/.gitconfig
- 配置编译器
e.g. 配置编译器为pycharm
git config core.editor pycharm
---项目目录下使用---
- 查看配置信息
git config --list
---项目目录下使用---
基本命令
1. 初始化仓库
git init
意义:将某个项目目录变为git操作目录,生成git本地仓库。即该项目目录可以使用git管理
- 取消git项目文件:删除 目录下的 .git文件即可
- .git 中存放的是暂存区的文件和版本库
2. 查看本地仓库状态
git status
说明: 初始化仓库后默认工作在master分支,当工作区与仓库区不一致时会有提示。
---->查看还未放入仓库区的文件
git ls-files
---->查看本地仓库仓库区内容
3. 将工作内容记录到暂存区
git add [files..]
e.g. 将 a ,b 记录到暂存区
git add a b
e.g. 将所有文件(不包含隐藏文件)记录到暂存区
git add *
@扩展延伸
在Git项目中可以通过在项目的某个文件夹下定义.gitignore
文件的方式,规定相应的忽略规则,用来管理当前文件夹下的文件的Git提交行为。.gitignore 文件是可以提交到公有仓库中,这就为该项目下的所有开发者都共享一套定义好的忽略规则。在.gitignore 文件中,遵循相应的语法,在每一行指定一个忽略规则。
.gitignore忽略规则简单说明
file 表示忽略file文件
*.a 表示忽略所有 .a 结尾的文件
!lib.a 表示但lib.a除外
build/ 表示忽略 build/目录下的所有文件,过滤整个build文件夹;
4.取消文件暂存记录
git rm --cached [file]
5. 将文件同步到本地仓库
git commit [file] -m [message]
说明: -m表示添加一些同步信息,表达同步内容
e.g. 将暂存区所有记录同步到仓库区
git commit -m 'add files'
6. 查看commit 日志记录
git log
git log --pretty=oneline
7. 比较工作区文件和仓库文件差异
git diff [file]
8. 将暂存区或者某个commit点文件恢复到工作区
git checkout [commit] – [file]
- –是为了防止误操作,checkout还有切换分支的作用
9. 移动或者删除文件
git mv [file] [path]
git rm [files]
注意: 这两个操作会修改工作区内容,同时将操作记录提交到暂存区。
版本控制
1. 退回到上一个commit节点
git reset --hard HEAD^
注意 : 一个^表示回退1个版本,依次类推。当版本回退之后工作区会自动和当前commit版本保持一致
2. 退回到指定的commit_id节点
git reset --hard [commit_id]
3. 查看所有操作记录
git reflog
注意:最上面的为最新记录,可以利用commit_id去往任何操作位置
4. 创建标签
标签: 在项目的重要commit位置添加快照,保存当时的工作状态,一般用于版本的迭代。
git tag [tag_name] [commit_id] -m [message]
说明: commit_id可以不写则默认标签表示最新的commit_id位置,message也可以不写,但是最好添加。
e.g. 在最新的commit处添加标签v1.0
git tag v1.0 -m '版本1'
5. 查看标签
git tag 查看标签列表
git show [tag_name] 查看标签详细信息
6. 去往某个标签节点
git reset --hard [tag]
7. 删除标签
git tag -d [tag]
保存工作区
1. 保存工作区内容
git stash save [message]
说明: 将工作区未提交的修改封存,让工作区回到修改前的状态
2. 查看工作区列表
git stash list
说明:最新保存的工作区在最上面
3. 应用某个工作区
git stash apply [stash@{n}]
4. 删除工作区
git stash drop [stash@{n}] 删除某一个工作区
git stash clear 删除所有保存的工作区
分支管理
定义: 分支即每个人在原有代码(分支)的基础上建立自己的工作环境,单独开发,互不干扰。完成开发工作后再进行分支统一合并。
1. 查看分支情况
git branch
说明: 前面带 * 的分支表示当前工作分支
2. 创建分支
git branch [branch_name]
说明: 基于a分支创建b分支,此时b分支会拥有a分支全部内容。在创建b分支时最好保持a分支"干净"状态。
3. 切换工作分支
git checkout [branch]
说明: 2,3可以同时操作,即创建并切换分支
创建并切换到:
git checkout -b [branch_name]
4. 合并分支
git merge [branch]
冲突问题是合并分支过程中最为棘手的问题
- 当分支合并时,原分支和以前发生了变化就会产生冲突
- 当合并分支时添加新的模块(文件),这种冲突可以自动解决,只需自己决定commit操作即可。
- 当合并分支时两个分支修改了同一个文件,则需要手动解决冲突。
5. 删除分支
git branch -d [branch] 删除分支
git branch -D [branch] 删除没有被合并的分支
远程仓库
- 远程主机上的git仓库。实际上git是分布式结构,每台主机的git仓库结构类似,只是把别人主机上的git仓库称为远程仓库。
GitHub介绍
github是一个开源的项目社区网站,拥有全球最多的开源项目。开发者可以注册网站在github建立自己的项目仓库。
网址: github.com
代码管理工具:git
获取项目
- 在左上角搜索栏搜索想要的获取的项目
- 选择项目后复制项目git地址
- 在本地使用git clone方法即可获取
git clone https://github.com/xxxxxxxxx
注意: 获取到本地的项目会自动和github远程仓库建立连接。且获取的项目本身也是个git项目。
创建删除git仓库
- 点击右上角加号下拉菜单,选择新的仓库
-
填写相应的项目信息即可
-
github仓库相对本地主机就是一个远程仓库 通过remote连接,如果需要输入密码输入github密码即可。连接后即可使用远程仓库操作命令操作。readme文件会被自动作为项目介绍
-
如果是在自己的仓库界面选择settings,在最后可以选择删除仓库。
远程仓库操作命令
所有操作在本地git仓库下进行
1. 添加远程仓库
git remote add origin https://github.com/xxxxxxxxx
2. 查看连接的主机
git remote
注意: 一个git项目连接的远程主机名不会重复
3. 删除远程主机
git remote rm [origin]
4. 将本地分支推送给远程仓库
将master分支推送给origin主机远程仓库,第一次推送分支使用-u表示与远程对应分支建立自动关联
git push -u origin master
5. 推送代码到远程仓库
git push
6. 推送标签
git push origin [tag] 推送本地标签到远程
git push origin --tags 推送本地所有标签到远程
7. 推送旧的版本
git push --force origin 用于本地版本比远程版本旧时强行推送本地版本
8. 删除远程分支和标签
git branch -a 查看所有分支
git push origin [:branch] 删除远程分支
git push origin --delete tag [tagname] 删除远程仓库标签
9. 从远程获取代码
获取远程分支代码
git pull
将远程分支master拉取到本地,作为tmp分支
git fetch origin master:tmp
区别
pull将远程内容直接拉取到本地,并和对应分支内容进行合并
fetch将远程分支内容拉取到本地,但是不会和本地对应分支合并,可以自己判断后再使用merge合并。
@扩展延伸
ssh连接github
1.ssh -keygen 生成密钥对
2.~/.ssh 中找到公钥,复制内容
3.将内容粘贴到github中的seeting
软件项目开发流程
需求分析 ----》 概要设计 ---》 项目计划 ----》详细设计---》编码测试 -----》项目测试 ----》调试修改 ---》项目发布----》后期维护
需求分析 : 确定用户的真实需求
- 确定用户的真实需求,项目的基本功能
- 确定项目的整体难度和可行性分析
- 需求分析文档,用户确认
概要设计:对项目进行初步分析和整体设计
- 确定功能模块
- 进行可行性分析 搭建整体架构图
- 确定技术思路和使用框架
- 形成概要文档指导开发流程
项目计划 : 确定项目开发的时间轴和流程
- 确定开发工作的先后顺序
- 确定时间轴 ,事件里程碑
- 人员分工
- 形成甘特图和思维导图等辅助内容
详细设计 : 项目的具体实现
1.形成详细设计文档 : 思路,逻辑流程,功能说明,技术点说明,数据结构说明,代码说明
编码测试 : 按照预定计划实现代码编写,并且做基本检测
- 代码编写
- 写测试程序
- 技术攻关
项目测试 : 对项目按照功能进行测试
- 跨平台测试 ,使用测试
- 根据测试报告进行代码修改
- 完成测试报告
项目发布
1.项目交付用户进行发布
2.编写项目说明文档
后期维护
1.维护项目正常运转
2.进行项目的迭代升级
项目注意事项
- 按时完成项目工作和项目时间不足之间的冲突
- 项目实施人员之间的冲突
项目工具的使用
编写文档: word ppt excel markdown LaTex
项目流程图 : Mindmanager visio
项目管理 : project
代码管理 : svn git
电子词典
参考代码:dict⬇️
功能说明
用户可以登录和注册
- 登录凭借用户名和密码登录
- 注册要求用户必须填写用户名,密码,其他内容自定
- 用户名要求不能重复
- 要求用户信息能够长期保存
可以通过基本的图形界面print以提示客户端输入。
- 程序分为服务端和客户端两部分
- 客户端通过print打印简单界面输入命令发起请求
- 服务端主要负责逻辑数据处理
- 启动服务端后应该能满足多个客户端同时操作
客户端启动后即进入一级界面,包含如下功能:登录 注册 退出
* 退出后即退出该软件
* 登录成功即进入二级界面,失败回到一级界面
* 注册成功可以回到一级界面继续登录,也可以直接用注册用户进入二级界面
用户登录后进入二级界面,功能如下:查单词 历史记录 注销
* 选择注销则回到一级界面
* 查单词:循环输入单词,得到单词解释,输入特殊符号退出单词查询状态
* 历史记录:查询当前用户的查词记录,要求记录包含name word time。可以查看所有记录或者前10条均可。
HTTPServer
功能 :
httpserver部分⬇️
获取http请求
解析http请求
将请求发送给WebFrame
从WebFrame接收反馈数据
将数据组织为Response格式发送给客户端
WebFrame部分⬇️
从httpserver接收具体请求
根据请求进行逻辑处理和数据处理
将需要的数据反馈给httpserver
特点
采用httpserver和应用处理分离的模式,降低了耦合度
采用了用户配置文件的思路
webframe部分采用了模拟后端框架的处理方法
技术点
httpserver部分需要与两端建立通信
webFrame部分采用多路复用接收并发请求
数据传递使用json格式
>>> import json
>>> d={'a':1,'b':'B'}
>>> data=json.dumps(d)
>>> data
'{"a": 1, "b": "B"}'
>>> json.loads(data)
{'a': 1, 'b': 'B'}
>>> l=[1,2,3]
>>> data=json.dumps(l)
>>> data
'[1, 2, 3]'
>>> json.loads(data)
[1, 2, 3]
项目结构:
|--httpserver --HttpServer.py (主程序)
| --config (httpserver配置)
project--|
|
|
|--WebFrame --WebFrame.py (主程序代码)
--static (存放静态网页)
--views.py ( 应用处理程序)
--urls.py (存放路由)
--settings (框架配置)
交互数据格式协议
httpserver-->webframe {method:'GET',info:'/'}
webframe-->httpserver {status:'200',data:'ccccc'}
dict 服务端⤴️
"""
dict 服务端
功能: 业务逻辑处理
模型: Process 多进程 tcp 并发
"""
from socket import *
from multiprocessing import Process
import os,signal
from dict_db import Database
from time import sleep
HOST = '0.0.0.0'
PORT = 8888
ADDR = (HOST,PORT)
# 数据库操作对象
db = Database()
# 处理注册
def do_register(c,data):
tmp = data.split(' ')
name = tmp[1]
passwd = tmp[2]
if db.register(name,passwd):
c.send(b'OK')
else:
c.send(b'Fail')
# 处理登录
def do_login(c,data):
tmp = data.split(' ')
name = tmp[1]
passwd = tmp[2]
if db.login(name,passwd):
c.send(b'OK')
else:
c.send(b'Fail')
# 查询单词
def do_query(c,data):
tmp = data.split(' ')
name = tmp[1]
word = tmp[2]
# 插入历史记录
db.insert_history(name,word)
# 通过数据库找到单词 (找到返回解释,找不到None)
mean = db.query(word)
if mean:
msg = "%s : %s"%(word,mean)
else:
msg = "没有找到该单词"
c.send(msg.encode())
# 历史记录
def do_hist(c,data):
name = data.split(' ')[1]
r = db.history(name)
for i in r:
# i -->(name word time)
msg = "%s %-16s %s"%i
sleep(0.1)
c.send(msg.encode())
sleep(0.1)
c.send(b"##")
# 客户端处理函数,循环收发消息
def handle(c):
while True:
data = c.recv(1024).decode()
if not data or data[0] == 'E':
os._exit(0)
elif data[0] == 'R':
do_register(c,data)
elif data[0] == 'L':
do_login(c,data)
elif data[0] == 'Q':
do_query(c,data)
elif data[0] == 'H':
do_hist(c, data)
# 程序的启动入口
def main():
# 创建监听套接字
s = socket()
s.setsockopt(SOL_SOCKET,SO_REUSEADDR,1)
s.bind(ADDR)
s.listen(5)
signal.signal(signal.SIGCHLD,signal.SIG_IGN)
print("Listen the port 8888....")
while True:
# 循环等待客户端连接
try:
c,addr = s.accept()
print("Connect from",addr)
except KeyboardInterrupt:
db.close() # 关闭数据库连接
os._exit(0)
except Exception as e:
print(e)
continue
# 创建新的进程处理请求
client = Process(target=handle,args=(c,))
client.daemon = True
client.start()
if __name__ == '__main__':
main()
dict 服务端⤴️
HTTPserver 3.0⤴️
"""
HTTPserver 3.0
获取http请求
解析http请求
将请求发送给WebFrame
从WebFrame接收反馈数据
将数据组织为Response格式发送给客户端
"""
from socket import *
import sys
from threading import Thread
import json,re
from config import * # 导入配置文件内容
# 负责和webframe交互, socket客户端
def connect_frame(env):
s = socket()
try:
s.connect((frame_ip,frame_port))
except Exception as e:
print(e)
return
# 将env转换为json发送
data = json.dumps(env)
s.send(data.encode())
# 接收webframe反馈的数据
data = s.recv(1024 * 1024 * 10).decode()
return json.loads(data)
# httpserver功能
class HTTPServer:
def __init__(self):
self.host = HOST
self.port = PORT
self.create_socket()
self.bind()
# 创建套接字
def create_socket(self):
self.sockfd = socket()
self.sockfd.setsockopt(SOL_SOCKET,
SO_REUSEADDR,
DEBUG)
# 绑定地址
def bind(self):
self.address = (self.host,self.port)
self.sockfd.bind(self.address)
# 启动服务
def serve_forever(self):
self.sockfd.listen(5)
print("Start the http server:%d"%self.port)
while True:
connfd,addr = self.sockfd.accept()
client = Thread(target=self.handle,
args=(connfd,))
client.setDaemon(True)
client.start()
# 具体处理客户端请求
def handle(self,connfd):
request = connfd.recv(4096).decode()
pattern=r'(?P<method>[A-Z]+)\s+(?P<info>/\S*)'
try:
env = re.match(pattern,request).groupdict()
except:
connfd.close()
return
else:
# data就是从webframe得到的数据
data = connect_frame(env)
if data:
self.response(connfd,data)
def response(self,connfd,data):
# data-->{'status':'200','data':'xxx'}
if data['status'] == '200':
responseHeaders = "HTTP/1.1 200 OK\r\n"
responseHeaders += 'Content-Type:text/html\r\n'
responseHeaders += '\r\n'
responseBody = data['data']
elif data['status'] == '404':
responseHeaders = "HTTP/1.1 404 Not Found\r\n"
responseHeaders += 'Content-Type:text/html\r\n'
responseHeaders += '\r\n'
responseBody = data['data']
elif data['status'] == '302':
pass
# 将数据发送给浏览器
data = responseHeaders+responseBody
connfd.send(data.encode())
if __name__ == '__main__':
httpd = HTTPServer()
httpd.serve_forever() # 启动服务
HTTPserver 3.0⤴️
WebFrame⤴️
"""
模拟网站的后端应用
从httpserver接收具体请求
根据请求获取网页
将需要的数据反馈给httpserver
"""
from socket import *
import json
from settings import *
from select import *
from urls import *
# 应用类,实现具体的后端功能
class Application:
def __init__(self):
self.host = frame_ip
self.port = frame_port
self.fdmap = {} # 查找地图
self.ep = epoll() # epoll对象
self.sockfd = socket()
self.sockfd.setsockopt(SOL_SOCKET,
SO_REUSEADDR,
DEBUG)
self.sockfd.bind((self.host,self.port))
# 用于服务启动
def start(self):
self.sockfd.listen(5)
print("Listen the port %d"%self.port)
# 关注sockfd
self.ep.register(self.sockfd,EPOLLIN)
self.fdmap[self.sockfd.fileno()] = self.sockfd
while True:
events = self.ep.poll()
for fd,event in events:
if fd == self.sockfd.fileno():
connfd,addr = self.fdmap[fd].accept()
self.ep.register(connfd)
self.fdmap[connfd.fileno()] = connfd
else:
self.handle(self.fdmap[fd])
self.ep.unregister(fd)
del self.fdmap[fd]
# 具体处理请求
def handle(self,connfd):
request = connfd.recv(1024).decode()
request = json.loads(request)
# request -> {'method':'GET','info':'/'}
if request['method'] == 'GET':
if request['info'] == '/' or \
request['info'][-5:] == '.html':
response = self.get_html(request['info'])
else:
response = self.get_data(request['info'])
elif request['method'] == 'POST':
pass
# 将数据发送给HTTPserver
response = json.dumps(response)
connfd.send(response.encode())
connfd.close()
# 网页处理函数
def get_html(self,info):
if info == '/':
filename = STATIC_DIR+'/index.html'
else:
filename = STATIC_DIR+info
try:
fd = open(filename)
except:
f = open(STATIC_DIR+'/404.html')
return {'status':'404','data':f.read()}
else:
return {'status':'200','data':fd.read()}
# 处理数据
def get_data(self,info):
for url,func in urls:
if url == info:
return {'status':'200','data':func()}
return {'status':'404','data':'Sorry...'}
if __name__ == '__main__':
app = Application()
app.start()
WebFrame⤴️