README.rst

fishbase 简介

fishbase 是由我们自主开发和整理的一套 Python 基础函数库。

自 2016/3 初次发布以来，我们坚持不断更新，先后发布了 20 余个版本。近一年来，我们逐步形成每月更新 1 到 2 个版本的频率，抽象出了很多通用的方法，主要分为以下模块：

模块	功能函数
fish_common	基本函数包
fish_crypt	加密数据函数包
fish_csv	csv 处理增强函数包
fish_data	数据信息处理函数包，含银行卡、身份证等
fish_date	日期处理增强函数包
fish_file	文件处理增强函数包
fish_logger	日志记录增强函数包
fish_project	project 目录结构生成函数包
fish_random	随机数据生成函数包
fish_system	系统增强函数包

怎么用？

# 通过 pip 进行安装或者更新
pip install -U fishbase

fishbase 能干什么？

获取当前系统类型

>>> from fishbase.fish_system import get_platform
>>> print('current os:', get_platform())
current os: osx

获取文件的绝对路径

>>> from fishbase.fish_common import find_files
>>> print(get_abs_filename_with_sub_path('/etc', 'hosts'))
(True, '/etc/hosts')

根据时间戳获取时间间隔

>>> from fishbase.fish_date import get_time_interval
>>> print(get_time_interval(1548575829,1548476921))
{'days': 1, 'hours': 3, 'minutes': 28, 'seconds': 28}

生成随机数据

>>> from fishbase.fish_random import gen_random_id_card
>>> # 随机生成一个身份证号
>>> print(gen_random_id_card())
['3101091986******47']
>>> from fishbase.fish_random import gen_random_bank_card
>>> # 随机生成一个中国银行的信用卡卡号
>>> print(gen_random_bank_card('中国银行', 'CC'))
625907379******1

创建项目结构

>>> import os
>>> from fishbase.fish_project import init_project_by_yml
>>> package_yml = '''
... project: hellopackage
... tree:
...     - README.md
...     - requirements.txt
...     - setup.py
... '''
>>> # 通过 yml 文件创建一个项目结构
>>> init_project_by_yml(package_yml, '.')
>>> print(os.listdir('./hellopackage'))
['requirements.txt', 'README.md', 'setup.py']

更多

更多详细文档，请参见：http://fishbase.readthedocs.io/

如有好的建议，欢迎提 issue ：https://github.com/chinapnr/fishbase/issues