欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

大陆居民身份证、港澳台居民居住证验证工具 Python 版 :验证、获取基本信息以及生成假数据

程序员文章站 2022-05-11 15:12:45
地址:https://github.com/jxlwqq/id validator.py *居民身份证 、 *港澳居民居住证 以及 **居民居住证 号码验证工具(Python 版)支持 15 位与 18 位号码。 "PHP 版本" 安装 使用 和 示例大陆居民身 ......

地址:

*居民身份证*港澳居民居住证以及**居民居住证号码验证工具(python 版)支持 15 位与 18 位号码。

安装

pip install id-validator

使用

440308199901101512610104620927690 示例大陆居民身份证均为随机生成的假数据,如撞车,请联系删除。
810000199408230021830000199201300022 示例港澳台居民居住证为北京市*局公布的居住证样式号码。

验证身份证号合法性

验证身份证号是否合法,合法返回 true,不合法返回 false

from id_validator import validator

validator.is_valid('440308199901101512') # 大陆居民身份证 18 位
validator.is_valid('610104620927690')    # 大陆居民身份证 15 位
validator.is_valid('810000199408230021') # 港澳居民居住证 18 位
validator.is_valid('830000199201300022') # *居民居住证 18 位

获取身份证号信息

当身份证号合法时,返回分析信息(地区、出生日期、星座、生肖、性别、校验位),不合法返回 false

from id_validator import validator

validator.get_info('440308199901101512') # 18 位
validator.get_info('610104620927690')    # 15 位

返回信息格式如下:

{
'addresscode'   : '440308',          # 地址码   
'abandoned'     : 0,                 # 地址码是否废弃,1 为废弃的,0 为正在使用的
'address'       : '广东省深圳市盐田区', # 地址
'birthdaycode'  : '1999-01-10',      # 出生日期
'constellation' : '水瓶座',           # 星座
'chinesezodiac' : '卯兔',             # 生肖
'sex'           : 1,                 # 性别,1 为男性,0 为女性
'length'        : 18,                # 号码长度
'checkbit'      : '2'                # 校验码
}

注:判断地址码是否废弃的依据是,本数据集的采集源来自:,每年更新一次。本数据集采用 csv 格式存储,方便大家进行数据分析或者开发其他语言的版本。

生成可通过校验的假数据

伪造符合校验的身份证:

from id_validator import validator

validator.fake_id()                                      # 18 位
validator.fake_id(false)                                 # 15 位
validator.fake_id(true, '上海市', '2000', 1)              # 生成出生于 2000 年上海市的男性居民身份证
validator.fake_id(true, '南山区', '1999', 0)              # 生成出生于 1999 年广东省深圳市南山区的女性居民身份证
validator.fake_id(true, '江苏省', '200001', 1)            # 生成出生于 2000 年 1 月江苏省的男性居民身份证
validator.fake_id(true, '厦门市', '199701', 0)            # 生成出生于 2000 年 1 月福建省厦门市的女性居民身份证
validator.fake_id(true, '*省', '20131010', 0)          # 生成出生于 2013 年 10 月 10 日*省的女性居民居住证
validator.fake_id(true, '香港特别行政区', '19970701', 0)    # 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证

参考资料

todo list

  • 增加对 python2 的支持
  • 增加单元测试和 ci

change log

license

mit