路飞学城Python-Day14

转载:python之路-路飞学城-python-book
【25.常用模块-logging模块详解】
【26.常用模块-logging模块详解2】
【27.常用模块-logging模块日志过滤和日志文件截取】
很多程序都有记录日志的需求,并且日志中包含的信息即有正常的程序访问日志,还可能有错误、警告等信息输出,python的logging模块提供了标准的日志接口,你可以通过它存储各种格式的日志,logging的日志可以分为 debug(), info(), warning(), error() and critical()5个级别,下面我们看一下怎么用。
import logging
 
logging.warning("user [panda] attempted wrong password more than 3 times")
logging.critical("server is down")

路飞学城Python-Day14路飞学城Python-Day14

日志级别的意思:
Level
Use
DEBUG
Detailed information, typically of interest only when diagnosing problems.
INFO
Confirmation that things are working as expected.
WARNING
An indication that something unexpected happened, or indicative of some problem in the near future (e.g. ‘disk space low’). The software is still working as expected.
ERROR
Due to a more serious problem, the software has not been able to perform some function.
CRITICAL
A serious error, indicating that the program itself may be unable to continue running.

日志写文件

 
import logging
 
logging.basicConfig(filename='example.log',level=logging.INFO)
logging.debug('This message should go to the log file')
logging.info('So should this')
logging.warning('And this, too')
路飞学城Python-Day14路飞学城Python-Day14
其中下面这句中的level=loggin.INFO意思是,把日志纪录级别设置为INFO,也就是说,只有比日志是INFO或比INFO级别更高的日志才会被纪录到文件里,在这个例子, 第一条日志是不会被纪录的,如果希望纪录debug的日志,那把日志级别改成DEBUG就行了。
logging.basicConfig(filename='example.log',level=logging.INFO)

自定义日志格式

感觉上面的日志格式忘记加上时间啦,日志不知道时间怎么行呢,下面就来加上!
import logging
logging.basicConfig(format='%(asctime)s %(message)s', datefmt='%Y-%m-%d %I:%M:%S %p')
logging.warning('is when this event was logged.')

路飞学城Python-Day14路飞学城Python-Day14

除了加时间,还可以自定义一大堆格式,下表就是所有支持的格式
%(name)s
Logger的名字
%(levelno)s
数字形式的日志级别
%(levelname)s
文本形式的日志级别
%(pathname)s
调用日志输出函数的模块的完整路径名,可能没有
%(filename)s
调用日志输出函数的模块的文件名
%(module)s
调用日志输出函数的模块名
%(funcName)s
调用日志输出函数的函数名
%(lineno)d
调用日志输出函数的语句所在的代码行
%(created)f
当前时间,用UNIX标准的表示时间的浮 点数表示
%(relativeCreated)d
输出日志信息时的,自Logger创建以 来的毫秒数
%(asctime)s
字符串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒
%(thread)d
线程ID。可能没有
%(threadName)s
线程名。可能没有
%(process)d
进程ID。可能没有
%(message)s
用户输出的消息
 

日志同时输出到屏幕和文件

如果想同时把log打印在屏幕和文件日志里,就需要了解一点复杂的知识 了
Python 使用logging模块记录日志涉及四个主要类,使用官方文档中的概括最为合适:
  • logger提供了应用程序可以直接使用的接口;
  • handler将(logger创建的)日志记录发送到合适的目的输出;
  • filter提供了细度设备来决定输出哪条日志记录;
  • formatter决定日志记录的最终输出格式。

每个组件的主要功能

logger

每个程序在输出信息之前都要获得一个Logger。Logger通常对应了程序的模块名,比如聊天工具的图形界面模块可以这样获得它的Logger:
LOG=logging.getLogger(”chat.gui”)

而核心模块可以这样:

LOG=logging.getLogger(”chat.kernel”)

还可以绑定handler和filters

Logger.setLevel(lel):指定最低的日志级别,低于lel的级别将被忽略。debug是最低的内置级别,critical为最高
Logger.addFilter(filt)、Logger.removeFilter(filt):添加或删除指定的filter
Logger.addHandler(hdlr)、Logger.removeHandler(hdlr):增加或删除指定的handler

Logger.debug()、Logger.info()、Logger.warning()、Logger.error()、Logger.critical():可以设置的日志级别

handler

handler对象负责发送相关的信息到指定目的地。Python的日志系统有多种Handler可以使用。有些Handler可以把信息输出到控制台,有些Handler可以把信息输出到文件,还有些 Handler可以把信息发送到网络上。如果觉得不够用,还可以编写自己的Handler。可以通过addHandler()方法添加多个多handler
Handler.setLevel(lel):指定被处理的信息级别,低于lel级别的信息将被忽略
Handler.setFormatter():给这个handler选择一个格式
Handler.addFilter(filt)、Handler.removeFilter(filt):新增或删除一个filter对象

每个Logger可以附加多个Handler。接下来我们就来介绍一些常用的Handler:

  1. logging.StreamHandler 使用这个Handler可以向类似与sys.stdout或者sys.stderr的任何文件对象(file object)输出信息。
  2. logging.FileHandler 和StreamHandler 类似,用于向一个文件输出日志信息。不过FileHandler会帮你打开这个文件
  3. logging.handlers.RotatingFileHandler
    这个Handler类似于上面的FileHandler,但是它可以管理文件大小。当文件达到一定大小之后,它会自动将当前日志文件改名,然后创建 一个新的同名日志文件继续输出。比如日志文件是chat.log。当chat.log达到指定的大小之后,RotatingFileHandler自动把 文件改名为chat.log.1。不过,如果chat.log.1已经存在,会先把chat.log.1重命名为chat.log.2。。。最后重新创建 chat.log,继续输出日志信息。它的函数是:
RotatingFileHandler( filename[, mode[, maxBytes[, backupCount]]])
  1. 其中filename和mode两个参数和FileHandler一样。
  • maxBytes用于指定日志文件的最大文件大小。如果maxBytes为0,意味着日志文件可以无限大,这时上面描述的重命名过程就不会发生。
  • backupCount用于指定保留的备份文件的个数。比如,如果指定为2,当上面描述的重命名过程发生时,原有的chat.log.2并不会被更名,而是被删除。
  • logging.handlers.TimedRotatingFileHandler
    这个Handler和RotatingFileHandler类似,不过,它没有通过判断文件大小来决定何时重新创建日志文件,而是间隔一定时间就 自动创建新的日志文件。重命名的过程与RotatingFileHandler类似,不过新的文件不是附加数字,而是当前时间。它的函数是:
  • TimedRotatingFileHandler( filename [,when [,interval [,backupCount]]])
    其中filename参数和backupCount参数和RotatingFileHandler具有相同的意义
    interval是时间间隔。
    when参数是一个字符串。表示时间间隔的单位,不区分大小写。它有以下取值:
    • S 秒
    • M 分
    • H 小时
    • D 天
    • W 每星期(interval==0时代表星期一)
    • midnight 每天凌晨
     

    formatter 组件

    日志的formatter是个独立的组件,可以跟handler组合
    fh = logging.FileHandler("access.log")
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
     
    fh.setFormatter(formatter) #把formmater绑定到fh上

    filter 组件

    如果你想对日志内容进行过滤,就可自定义一个filter
    class IgnoreBackupLogFilter(logging.Filter):
    """忽略带db backup 的日志"""
    def filter(self, record): #固定写法
    return "db backup" not in record.getMessage()

    注意filter函数会返加True or False,logger根据此值决定是否输出此日志

    然后把这个filter添加到logger中
    logger.addFilter(IgnoreBackupLogFilter())

    下面的日志就会把符合filter条件的过滤掉

    logger.debug("test ....")
    logger.info("test info ....")
    logger.warning("start to run db backup job ....")
    logger.error("test error ....")

    一个同时输出到屏幕、文件、带filter的完成例子

    import logging
     
     
     
    class IgnoreBackupLogFilter(logging.Filter):
    """忽略带db backup 的日志"""
    def filter(self, record): #固定写法
    return "db backup" not in record.getMessage()
     
     
     
     
    #console handler
    ch = logging.StreamHandler()
    ch.setLevel(logging.INFO)
    #file handler
    fh = logging.FileHandler('mysql.log')
    #fh.setLevel(logging.WARNING)
     
     
    #formatter
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    #bind formatter to ch
    ch.setFormatter(formatter)
    fh.setFormatter(formatter)
     
    logger = logging.getLogger("Mysql")
    logger.setLevel(logging.DEBUG) #logger 优先级高于其它输出途径的
     
     
    #add handler to logger instance
    logger.addHandler(ch)
    logger.addHandler(fh)
     
     
     
    #add filter
    logger.addFilter(IgnoreBackupLogFilter())
     
    logger.debug("test ....")
    logger.info("test info ....")
    logger.warning("start to run db backup job ....")
    logger.error("test error ....")

    文件自动截断例子

    import logging
     
    from logging import handlers
     
    logger = logging.getLogger(__name__)
     
    log_file = "timelog.log"
    #fh = handlers.RotatingFileHandler(filename=log_file,maxBytes=10,backupCount=3)
    fh = handlers.TimedRotatingFileHandler(filename=log_file,when="S",interval=5,backupCount=3)
     
     
    formatter = logging.Formatter('%(asctime)s %(module)s:%(lineno)d %(message)s')
     
    fh.setFormatter(formatter)
     
    logger.addHandler(fh)
     
     
    logger.warning("test1")
    logger.warning("test12")
    logger.warning("test13")
    logger.warning("test14")

    【28.常用模块-re正则表达式】
    【29.常用模块-re语法】
    【30.常用模块-re表达式详解1】
    【31.常用模块-re表达式详解2】
    【32.常用模块-re表达式详解3】
    【34.常用模块-re表达式详解4】
    【35.常用模块-re表达式详解5】
    【36.常用模块-re表达式详解6】

    引子

    请从以下文件里取出所有的手机号
    姓名 地区 身高 体重 电话
    况咏蜜 北京 171 48 13651054608
    王心颜 上海 169 46 13813234424
    马纤羽 深圳 173 50 13744234523
    乔亦菲 广州 172 52 15823423525
    罗梦竹 北京 175 49 18623423421
    刘诺涵 北京 170 48 18623423765
    岳妮妮 深圳 177 54 18835324553
    贺婉萱 深圳 174 52 18933434452
    叶梓萱 上海 171 49 18042432324
    杜姗姗 北京 167 49 13324523342
    你能想到的办法是什么?
    必然是下面这种吧?
    f = open("兼职白领学生空姐模特护士联系方式.txt",'r',encoding="gbk")
     
    phones = []
     
    for line in f:
    name,city,height,weight,phone = line.split()
    if phone.startswith('1') and len(phone) == 11:
    phones.append(phone)
     
    print(phones)

    有没有更简单的方式?

    手机号是有规则的,都是数字且是11位,再严格点,就都是1开头,如果能把这样的规则写成代码,直接拿规则代码匹配文件内容不就行了?
     
    import re 
    f = open('test.txt','r+',encoding = 'utf-8')
    data = f.read()
    phones = re.findall("[0-9]{11}",data)
    print(phones)
     

    re模块

    正则表达式就是字符串的匹配规则,在多数编程语言里都有相应的支持,python里对应的模块是re

    常用的表达式规则

    '.' 默认匹配除\n之外的任意一个字符,若指定flag DOTALL,则匹配任意字符,包括换行
    '^' 匹配字符开头,若指定flags MULTILINE,这种也可以匹配上(r"^a","\nabc\neee",flags=re.MULTILINE)
    '$' 匹配字符结尾, 若指定flags MULTILINE ,re.search('foo.$','foo1\nfoo2\n',re.MULTILINE).group() 会匹配到foo1
    '*' 匹配*号前的字符0次或多次, re.search('a*','aaaabac') 结果'aaaa'
    '+' 匹配前一个字符1次或多次,re.findall("ab+","ab+cd+abb+bba") 结果['ab', 'abb']
    '?' 匹配前一个字符1次或0次 ,re.search('b?','alex').group() 匹配b 0次
    '{m}' 匹配前一个字符m次 ,re.search('b{3}','alexbbbs').group() 匹配到'bbb'
    '{n,m}' 匹配前一个字符n到m次,re.findall("ab{1,3}","abb abc abbcbbb") 结果'abb', 'ab', 'abb']
    '|' 匹配|左或|右的字符,re.search("abc|ABC","ABCBabcCD").group() 结果'ABC'
    '(...)' 分组匹配, re.search("(abc){2}a(123|45)", "abcabca456c").group() 结果为'abcabca45'
     
    '\A' 只从字符开头匹配,re.search("\Aabc","alexabc") 是匹配不到的,相当于re.match('abc',"alexabc") 或^
    '\Z' 匹配字符结尾,同$
    '\d' 匹配数字0-9
    '\D' 匹配非数字
    '\w' 匹配[A-Za-z0-9]
    '\W' 匹配非[A-Za-z0-9]
    's' 匹配空白字符、\t、\n、\r , re.search("\s+","ab\tc1\n3").group() 结果 '\t'

    re的匹配语法有以下几种

    • re.match 从头开始匹配
    • re.search 匹配包含
    • re.findall 把所有匹配到的字符放到以列表中的元素返回
    • re.split 以匹配到的字符当做列表分隔符
    • re.sub 匹配字符并替换
    • re.fullmatch 全部匹配
    Compile a regular expression pattern into a regular expression object, which can be used for matching using its match(), search() and other methods, described below.
    The sequence
    result = prog.match(string)
    is equivalent to
    result = re.match(pattern, string)
    but using re.compile() and saving the resulting regular expression object for reuse is more efficient when the expression will be used several times in a single program.
    re.match(pattern, string, flags=0)
    从起始位置开始根据模型去字符串中匹配指定内容,匹配单个
    • pattern 正则表达式
    • string 要匹配的字符串
    • flags 标志位,用于控制正则表达式的匹配方式
    import re
    obj = re.match('\d+', '123uuasf')
    if obj:
    print obj.group()
    Flags标志符
    • re.I(re.IGNORECASE): 忽略大小写(括号内是完整写法,下同)
    • M(MULTILINE): 多行模式,改变'^'和'$'的行为
    • S(DOTALL): 改变'.'的行为,make the '.' special character match any character at all, including a newline; without this flag, '.' will match anything except a newline.
    • X(re.VERBOSE) 可以给你的表达式写注释,使其更可读,下面这2个意思一样
    a = re.compile(r"""\d + # the integral part
    \. # the decimal point
    \d * # some fractional digits""",
    re.X)
     
    b = re.compile(r"\d+\.\d*")
    re.search(pattern, string, flags=0)
    根据模型去字符串中匹配指定内容,匹配单个
    import re
    obj = re.search('\d+', 'u123uu888asf')
    if obj:
    print obj.group()
    re.findall(pattern, string, flags=0)
    match and search均用于匹配单值,即:只能匹配字符串中的一个,如果想要匹配到字符串中所有符合条件的元素,则需要使用 findall。
    import re
    obj = re.findall('\d+', 'fa123uu888asf')
    print obj
    re.sub(pattern, repl, string, count=0, flags=0)
    用于替换匹配的字符串
    >>>re.sub('[a-z]+','sb','武配齐是abc123',)
     
    >>> re.sub('\d+','|', 'alex22wupeiqi33oldboy55',count=2)
    'alex|wupeiqi|oldboy55'
    相比于str.replace功能更加强大
    re.split(pattern, string, maxsplit=0, flags=0)
    >>>s='9-2*5/3+7/3*99/4*2998+10*568/14'
    >>>re.split('[\*\-\/\+]',s)
    ['9', '2', '5', '3', '7', '3', '99', '4', '2998', '10', '568', '14']
     
    >>> re.split('[\*\-\/\+]',s,3)
    ['9', '2', '5', '3+7/3*99/4*2998+10*568/14']
    re.fullmatch(pattern, string, flags=0)
    整个字符串匹配成功就返回re object, 否则返回None
    re.fullmatch('\w+@\w+\.(com|cn|edu)',"alex@oldboyedu.cn")

    练习:

    1.验证手机号是否合法
    2.验证邮箱是否合法
    3.开发一个简单的python计算器,实现加减乘除及拓号优先级解析
    • 用户输入 1 - 2 * ( (60-30 +(-40/5) * (9-2*5/3 + 7 /3*99/4*2998 +10 * 568/14 )) - (-4*3)/ (16-3*2) )等类似公式后,必须自己解析里面的(),+,-,*,/符号和公式(不能调用eval等类似功能偷懒实现),运算后得出结果,结果必须与真实的计算器所得出的结果一致
    hint:
    re.search(r'\([^()]+\)',s).group()#可拿到最里层的括号中的值
     
    '(-40/5)'

    【37.常用模块-软件开发目录规范1】
    【38.常用模块-软件开发目录规范2】

    为什么要设计好目录结构?

    "设计项目目录结构",就和"代码编码风格"一样,属于个人风格问题。对于这种风格上的规范,一直都存在两种态度:
    1. 一类同学认为,这种个人风格问题"无关紧要"。理由是能让程序work就好,风格问题根本不是问题。
    2. 另一类同学认为,规范化能更好的控制程序结构,让程序具有更高的可读性。
    我是比较偏向于后者的,因为我是前一类同学思想行为下的直接受害者。我曾经维护过一个非常不好读的项目,其实现的逻辑并不复杂,但是却耗费了我非常长的时间去理解它想表达的意思。从此我个人对于提高项目可读性、可维护性的要求就很高了。"项目目录结构"其实也是属于"可读性和可维护性"的范畴,我们设计一个层次清晰的目录结构,就是为了达到以下两点:
    1. 可读性高: 不熟悉这个项目的代码的人,一眼就能看懂目录结构,知道程序启动脚本是哪个,测试目录在哪儿,配置文件在哪儿等等。从而非常快速的了解这个项目。
    2. 可维护性高: 定义好组织规则后,维护者就能很明确地知道,新增的哪个文件和代码应该放在什么目录之下。这个好处是,随着时间的推移,代码/配置的规模增加,项目结构不会混乱,仍然能够组织良好。
    所以,我认为,保持一个层次清晰的目录结构是有必要的。更何况组织一个良好的工程目录,其实是一件很简单的事儿。

    目录组织方式

    关于如何组织一个较好的Python工程目录结构,已经有一些得到了共识的目录结构。在*的这个问题上,能看到大家对Python目录结构的讨论。
    这里面说的已经很好了,我也不打算重新造*列举各种不同的方式,这里面我说一下我的理解和体会。
    假设你的项目名为foo, 我比较建议的最方便快捷目录结构这样就足够了:
    Foo/
    |-- bin/
    | |-- foo
    |
    |-- foo/
    | |-- tests/
    | | |-- __init__.py
    | | |-- test_main.py
    | |
    | |-- __init__.py
    | |-- main.py
    |
    |-- docs/
    | |-- conf.py
    | |-- abc.rst
    |
    |-- setup.py
    |-- requirements.txt
    |-- README
    简要解释一下:
    • bin/: 存放项目的一些可执行文件,当然你可以起名script/之类的也行。
    • foo/: 存放项目的所有源代码。(1) 源代码中的所有模块、包都应该放在此目录。不要置于顶层目录。(2) 其子目录tests/存放单元测试代码; (3) 程序的入口最好命名为main.py。
    • docs/: 存放一些文档。
    • setup.py: 安装、部署、打包的脚本。
    • requirements.txt: 存放软件依赖的外部Python包列表。
    • README: 项目说明文件。
    除此之外,有一些方案给出了更加多的内容。比如LICENSE.txt,ChangeLog.txt文件等,我没有列在这里,因为这些东西主要是项目开源的时候需要用到。如果你想写一个开源软件,目录该如何组织,可以参考这篇文章
    下面,再简单讲一下我对这些目录的理解和个人要求吧。

    关于README的内容

    这个我觉得是每个项目都应该有的一个文件,目的是能简要描述该项目的信息,让读者快速了解这个项目。
    它需要说明以下几个事项:
    1. 软件定位,软件的基本功能。
    2. 运行代码的方法: 安装环境、启动命令等。
    3. 简要的使用说明。
    4. 代码目录结构说明,更详细点可以说明软件的基本原理。
    5. 常见问题说明。

    关于requirements.txt和setup.py

    setup.py

    一般来说,用setup.py来管理代码的打包、安装、部署问题。业界标准的写法是用Python流行的打包工具setuptools来管理这些事情。这种方式普遍应用于开源项目中。不过这里的核心思想不是用标准化的工具来解决这些问题,而是说,一个项目一定要有一个安装部署工具,能快速便捷的在一台新机器上将环境装好、代码部署好和将程序运行起来。
    这个我是踩过坑的。
    我刚开始接触Python写项目的时候,安装环境、部署代码、运行程序这个过程全是手动完成,遇到过以下问题:
    1. 安装环境时经常忘了最近又添加了一个新的Python包,结果一到线上运行,程序就出错了。
    2. Python包的版本依赖问题,有时候我们程序中使用的是一个版本的Python包,但是官方的已经是最新的包了,通过手动安装就可能装错了。
    3. 如果依赖的包很多的话,一个一个安装这些依赖是很费时的事情。
    4. 新同学开始写项目的时候,将程序跑起来非常麻烦,因为可能经常忘了要怎么安装各种依赖。
    setup.py可以将这些事情自动化起来,提高效率、减少出错的概率。"复杂的东西自动化,能自动化的东西一定要自动化。"是一个非常好的习惯。
    setuptools的文档比较庞大,刚接触的话,可能不太好找到切入点。学习技术的方式就是看他人是怎么用的,可以参考一下Python的一个Web框架,flask是如何写的: setup.py
    当然,简单点自己写个安装脚本(deploy.sh)替代setup.py也未尝不可。

    requirements.txt

    这个文件存在的目的是:
    1. 方便开发者维护软件的包依赖。将开发过程中新增的包添加进这个列表中,避免在 setup.py 安装依赖时漏掉软件包。
    2. 方便读者明确项目使用了哪些Python包。
    这个文件的格式是每一行包含一个包依赖的说明,通常是flask>=0.10这种格式,要求是这个格式能被pip识别,这样就可以简单的通过 pip install -r requirements.txt来把所有Python包依赖都装好了。具体格式说明: 点这里

    关于配置文件的使用方法

    注意,在上面的目录结构中,没有将conf.py放在源码目录下,而是放在docs/目录下。
    很多项目对配置文件的使用做法是:
    1. 配置文件写在一个或多个python文件中,比如此处的conf.py。
    2. 项目中哪个模块用到这个配置文件就直接通过import conf这种形式来在代码中使用配置。
    这种做法我不太赞同:
    1. 这让单元测试变得困难(因为模块内部依赖了外部配置)
    2. 另一方面配置文件作为用户控制程序的接口,应当可以由用户*指定该文件的路径。
    3. 程序组件可复用性太差,因为这种贯穿所有模块的代码硬编码方式,使得大部分模块都依赖conf.py这个文件。
    所以,我认为配置的使用,更好的方式是,
    1. 模块的配置都是可以灵活配置的,不受外部配置文件的影响。
    2. 程序的配置也是可以灵活控制的。
    能够佐证这个思想的是,用过nginx和mysql的同学都知道,nginx、mysql这些程序都可以*的指定用户配置。
    所以,不应当在代码中直接import conf来使用配置文件。上面目录结构中的conf.py,是给出的一个配置样例,不是在写死在程序中直接引用的配置文件。可以通过给main.py启动参数指定配置路径的方式来让程序读取配置内容。当然,这里的conf.py你可以换个类似的名字,比如settings.py。或者你也可以使用其他格式的内容来编写配置文件,比如settings.yaml之类的。
     
    上一篇:****CodeIgniter使用cli模式运行,把php作为shell编程


    下一篇:Mac OS X 系统下自带的文本文件格式转换工具iconv