# IDCARD

**Repository Path**: zhoujm928/IDCARD

## Basic Information

- **Project Name**: IDCARD
- **Description**: 该模块主要功能为生成、校验、解析居民身份证号码。支持行政区划代码、出生年月日以及性别三要素生成，支持批量生成。

行政区划代码.txt为国家统计局2017年3月10号版本，截止日期为2016年7月31日。身份证代码计算方式为GB 11643-1999标准
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2017-11-02
- **Last Updated**: 2021-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IDCARD
结构：
---
    IDCARD
		--city_info_provide.py :处理城市信息
		--idcard_provide.py ：身份证号码处理类
		--city_info.py ：城市信息类
	DATA
		--主要为城市的行政区划的数据文件
		
功能：
---

- 	该模块主要功能为生成、校验、解析居民身份证号码。支持行政区划代码、出生年月日以及性别三要素生成，支持批量生成。
- 	行政区划代码.txt为国家统计局2017年3月10号版本，截止日期为2016年7月31日。身份证代码计算方式为GB 11643-1999标准
	
使用：
---

```
from IDCARD.city_info import CityInfo


test = IDCardProvide()
# '0'代表女性，'1'代表男性
# 随机生成一个身份证号码
# num_list = test.create_idnum_all_elements()

# 随机生成多个身份证号码
# num_list = test.create_idnum_all_elements(is_multi=10)

# 传入行政区划代码、出生年月日、性别三要素生成身份证号码
#num_list = test.create_idnum_all_elements(['330681'], ['19911104'],['1'])

# 传入多个三要素，三要素需要全部传入且数目相同
#num_list = test.create_idnum_all_elements(['330681', '330683'], ['19911104', '19911105'], ['1', '0'])

# 使用单一要素随机生成一个身份证号码（可传入6位行政区划代码、8位出生日期、1位性别标志）
num_list = test.create_idnum_one_element('1')

# 使用单一要素随机生成多个身份证号码
num_list = test.create_idnum_one_element('1', is_multi=10)

# 校验身份证号码是否合法
flag = test.check_idnum('511423198711020037')

# 解析身份证号码
(city_name, birthday, gender) = test.resolution_idnum('511423198711020037')
```