fish_data 数据信息处理函数包,含银行卡、身份证等

fish_data.CardBin.get_checkcode(card_number_str) 计算银行卡校验位;
fish_data.CardBin.check_bankcard(card_number_str) 检查银行卡校验位是否正确;
fish_data.CardBin.get_bank_info(bankname) 银行名称,返回银行代码;
fish_data.CardBin.get_cardbin_info(bank, …) 输入银行、借记贷记卡种类,返回有效的卡 bin;
fish_data.IdCard.get_checkcode(id_number_str) 计算身份证号码的校验位;
fish_data.IdCard.check_number(id_number) 检查身份证号码是否符合校验规则;
fish_data.IdCard.get_zone_info(area_str[, …]) 输入包含省份、城市、地区信息的内容,返回地区编号;
fish_data.IdCard.get_areanote_info(province) 输入省份代码,返回地区信息;
fish_data.IdCard.get_province_info() 获取省份代码

fish_data 包含的是一些与数据信息相关的函数,比如银行卡、身份证信息的生成和校验。

在我们进行一些开发测试、功能测试、自动化测试、压力测试等场景下,都需要模拟身份证、银行卡等信息。 fish_data 中的函数就是用在这样的场景。注意,这些函数不会生成真实的身份证和银行卡号。

class fish_data.CardBin

校验银行卡号、获取银行卡校验位,获取银行卡、银行信息;

举例如下:

print('--- CardBin demo ---')

print('get_checkcode of "439188000699010":', CardBin.get_checkcode('439188000699010'))

print('check_bankcard of "4391880006990100":', CardBin.check_number('4391880006990100'))

print('get_bank_info of "招商银行":', CardBin.get_bank_info('招商银行')

print('get_cardbin_info of "CMB", "DC":', CardBin.get_cardbin_info('CMB', 'DC'))

print('---')

执行结果:

--- CardBin demo ---

get_checkcode of "439188000699010": 9

check_bankcard of "4391880006990100": False

get_bank_info of "招商银行": [('CMB', '招商银行')]

get_cardbin_info of "CMB", "DC": [('410062', 'CMB', 'DC', 16), ('468203', 'CMB', 'DC', 16), ...

---
classmethod check_bankcard(card_number_str)

检查银行卡校验位是否正确;

Param:
  • card_number_str: (string) 要查询的银行卡号
Returns:

返回结果:(bool) True or False

举例如下:

from fishbase.fish_data import *

print('--- fish_data check_bankcard demo ---')

# 不能放真的卡信息,有风险
print(CardBin.check_bankcard('4391880006990100'))

print('---')

输出结果:

--- fish_data check_bankcard demo ---
False
---
classmethod get_bank_info(bankname)

银行名称,返回银行代码;

Param:
  • bankname: (string) 要查询的银行 名称,比如 招商银行
Returns:

  • 返回 银行代号bank , 银行名称 bankname,一条记录为一个 tuple (a, b),然后组成 list 返回

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_bank_info demo ---')

print(CardBin.get_bank_info('招商银行'))

print('---')

输出结果:

--- fish_data get_bank_info demo ---
[('CMB', '招商银行')]
---
classmethod get_cardbin_info(bank, card_type)

输入银行、借记贷记卡种类,返回有效的卡 bin;

Param:
  • bank: (string) 要查询的银行代号,比如 ICBC, CMB
  • card_type: (string) 银行卡类型,比如 CC 表示信用卡
Returns:

  • 返回 cardbin, bank, 银行卡类型type, 银行卡长度 length,一条记录为一个 tuple (a, b, c, d),然后组成 list 返回

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_cardbin_info demo ---')

result = CardBin.get_cardbin_info('CMB', 'DC')
print(result)

print('---')

输出结果:

--- fish_data get_cardbin_info demo ---

[('410062', 'CMB', 'DC', 16), ('468203', 'CMB', 'DC', 16), ...
---
classmethod get_checkcode(card_number_str)

计算银行卡校验位;

Param:
  • card_number_str: (string) 要查询的银行卡号
Returns:

checkcode: (string) 银行卡的校验位

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_checkcode demo ---')

# 不能放真的卡信息,有风险
print(CardBin.get_checkcode('439188000699010'))

print('---')

输出结果:

--- fish_data get_checkcode demo ---
9
---
class fish_data.IdCard

校验身份证号、获取身份证校验位,获取随机生成身份证号所需身份代码等函数;

举例如下:

print('--- IdCard demo ---')

print('get_checkcode of "32012419870101001":', IdCard.get_checkcode('32012419870101001')[1])

print('check_number of "130522198407316471":', IdCard.check_number('130522198407316471')[0])

print('get_zone_info of "北京市":', IdCard.get_zone_info(area_str='北京市')

print('get_areanote_info of "北京(11)":', IdCard.get_areanote_info('11'))

print('---')

执行结果:

--- IdCard demo ---

get_checkcode of "32012419870101001": 5

check_number of "130522198407316471": True

get_zone_info of "北京市": [('110000', '北京市')]

get_areanote_info of "北京(11)": ([('110000', '北京市'), ('110100', '北京市市辖区'), ('110101', '北京市东城区'), ...

---
classmethod check_number(id_number)

检查身份证号码是否符合校验规则;

Param:
  • id_number: (string) 身份证号,比如 32012419870101001
Returns:

  • 返回类型 (tuple),当前有一个值,第一个为 flag,以后第二个值会返回具体校验不通过的详细错误
  • flag: (bool) 如果身份证号码校验通过,返回 True;如果身份证校验不通过,返回 False

举例如下:

from fishbase.fish_data import *

print('--- fish_data check_number demo ---')

# id number false
id1 = '320124198701010012'
print(id1, IdCard.check_number(id1)[0])

# id number true
id2 = '130522198407316471'
print(id2, IdCard.check_number(id2)[0])

print('---')

输出结果:

--- fish_data check_number demo ---
320124198701010012 False
130522198407316471 True
---
classmethod get_areanote_info(province)

输入省份代码,返回地区信息;

Param:
  • province_code: (string) 省份代码 比如:11
Returns:

  • note_list: (list) 地区信息列表

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_areanote_info demo ---')

print(IdCard.get_areanote_info('11'))

print('---')

输出结果:

--- fish_data get_areanote_info demo ---
[('110000', '北京市'), ('110100', '北京市市辖区'), ('110101', '北京市东城区'), ...

---
classmethod get_checkcode(id_number_str)

计算身份证号码的校验位;

Param:
  • id_number_str: (string) 身份证号的前17位,比如 3201241987010100
Returns:

  • 返回类型 (tuple)
  • flag: (bool) 如果身份证号格式正确,返回 True;格式错误,返回 False
  • checkcode: 计算身份证前17位的校验码

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_checkcode demo ---')

# id number
id1 = '32012419870101001'
print(id1, IdCard.get_checkcode(id1)[1])

# id number
id2 = '13052219840731647'
print(id2, IdCard.get_checkcode(id2)[1])

print('---')

输出结果:

--- fish_data get_checkcode demo ---
32012419870101001 5
13052219840731647 1
---
classmethod get_province_info()

获取省份代码

Param:
Returns:
  • province_list: (list) 省份代码列表

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_province_info demo ---')
print(IdCard.get_province_info())
print('---')

输出结果:

--- fish_data get_province_info demo ---

[(‘11’,), (‘12’,), (‘13’,), (‘14’,), (‘15’,), … —

classmethod get_zone_info(area_str, match_type='EXACT', result_type='LIST')

输入包含省份、城市、地区信息的内容,返回地区编号;

Param:
  • area_str: (string) 要查询的区域,省份、城市、地区信息,比如 北京市
  • match_type: (string) 查询匹配模式,默认值 ‘EXACT’,表示精确匹配,可选 ‘FUZZY’,表示模糊查询
  • result_type: (string) 返回结果数量类型,默认值 ‘LIST’,表示返回列表,可选 ‘SINGLE_STR’,返回结果的第一个地区编号字符串
Returns:

  • 返回类型 根据 resule_type 决定返回类型是列表或者单一字符串,列表中包含元组 比如:[(‘110000’, ‘北京市’)],元组中的第一个元素是地区码,

第二个元素是对应的区域内容 结果最多返回 20 个。

举例如下:

from fishbase.fish_data import *

print('--- fish_data get_zone_info demo ---')

result = IdCard.get_zone_info(area_str='北京市')
print(result)

# 模糊查询
result = IdCard.get_zone_info(area_str='西安市', match_type='FUZZY')
print(result)

result0 = []
for i in result:
    result0.append(i[0])

print('---西安市---')
print(len(result0))
print(result0)

# 模糊查询, 结果返回设定 single_str
result = IdCard.get_zone_info(area_str='西安市', match_type='FUZZY', result_type='SINGLE_STR')
print(result)

# 模糊查询, 结果返回设定 single_str,西安市 和 西安 的差别
result = IdCard.get_zone_info(area_str='西安', match_type='FUZZY', result_type='SINGLE_STR')
print(result)

print('---')

输出结果:

--- fish_data get_zone_info demo ---
[('110000', '北京市')]
130522198407316471 True

---西安市---
11
['610100', '610101', '610102', '610103', '610104', '610111', '610112', '610113', '610114', '610115',
'610116']

610100
220403
---