Python實(shí)現(xiàn)根據(jù)Excel生成Model和數(shù)據(jù)導(dǎo)入腳本

更新時(shí)間：2022年11月16日 11:39:45 作者：程序設(shè)計(jì)實(shí)驗(yàn)室

最近遇到一個(gè)需求，有幾十個(gè)Excel，每個(gè)的字段都不一樣，然后都差不多是第一行是表頭，后面幾千上萬(wàn)的數(shù)據(jù)，需要把這些Excel中的數(shù)據(jù)全都加入某個(gè)已經(jīng)上線的Django項(xiàng)目。所以我造了個(gè)自動(dòng)生成?Model和導(dǎo)入腳本的輪子，希望對(duì)大家有所幫助

前言

最近遇到一個(gè)需求，有幾十個(gè)Excel，每個(gè)的字段都不一樣，然后都差不多是第一行是表頭，后面幾千上萬(wàn)的數(shù)據(jù)，需要把這些Excel中的數(shù)據(jù)全都加入某個(gè)已經(jīng)上線的Django項(xiàng)目

這就需要每個(gè)Excel建個(gè)表，然后一個(gè)個(gè)導(dǎo)入了

這樣的效率太低，不能忍

所以我造了個(gè)自動(dòng)生成 Model 和導(dǎo)入腳本的輪子

思路

首先拿出 pandas，它的 DataFrame 用來(lái)處理數(shù)據(jù)很方便

pandas 加載 Excel 之后，提取表頭，我們要通過(guò)表頭來(lái)生成數(shù)據(jù)表的字段。有些 Excel 的表頭是中文的，需要先做個(gè)轉(zhuǎn)換。

一開始我是想用翻譯API，全都翻譯成英文，不過(guò)發(fā)現(xiàn)免費(fèi)的很慢有限額，微軟、DeepL都要申請(qǐng)，很麻煩。索性用個(gè)拼音轉(zhuǎn)換庫(kù)，全都轉(zhuǎn)換成拼音得了~

然后字段的長(zhǎng)度也要確定，或者全部用不限制長(zhǎng)度的 TextField

權(quán)衡一下，我還是做一下字段長(zhǎng)度判定的邏輯，遍歷整個(gè)表，找出各個(gè)字段最長(zhǎng)的數(shù)據(jù)，然后再加一個(gè)偏移量，作為最大長(zhǎng)度。

接著生成 Model 類，這里我用 jinja2 模板語(yǔ)言，先把大概的模板寫好，然后根據(jù)提取出來(lái)的字段名啥的生成。

最后生成 admin 配置和導(dǎo)入腳本，同理，也是用 jinja2 模板。

實(shí)現(xiàn)

簡(jiǎn)單介紹下思路，現(xiàn)在開始上代碼。

就幾行而已，Python很省代碼~

模型

首先定義倆模型

字段模型

class Field(object):
    def __init__(self, name: str, verbose_name: str, max_length: int = 128):
        self.name = name
        self.verbose_name = verbose_name
        self.max_length = max_length

    def __str__(self):
        return f'<Field>{self.name}:{self.verbose_name}'

    def __repr__(self):
        return self.__str__()

Model模型

為了符合Python關(guān)于變量的命名規(guī)范，snake_name 屬性是用正則表達(dá)式實(shí)現(xiàn)駝峰命名轉(zhuǎn)蛇形命名

class Model(object):
    def __init__(self, name: str, verbose_name: str, id_field: Field, fields: List[Field]):
        self.name = name
        self.verbose_name = verbose_name
        self.id_field = id_field
        self.fields: List[Field] = fields

    @property
    def snake_name(self):
        import re
        pattern = re.compile(r'(?<!^)(?=[A-Z])')
        name = pattern.sub('_', self.name).lower()
        return name

    def __str__(self):
        return f'<Model>{self.name}:{self.verbose_name}'

    def __repr__(self):
        return self.__str__()

代碼模板

使用 jinja2 實(shí)現(xiàn)。

本身 jinja2 是 Flask、Django 之類的框架用來(lái)渲染網(wǎng)頁(yè)的。

不過(guò)單獨(dú)使用的效果也不錯(cuò)，我的 DjangoStarter 框架也是用這個(gè) jinja2 來(lái)自動(dòng)生成 CRUD 代碼~

Model模板

# -*- coding:utf-8 -*-
from django.db import models

class {{ model.name }}(models.Model):
    """{{ model.verbose_name }}"""
    {% for field in model.fields -%}
    {{ field.name }} = models.CharField('{{ field.verbose_name }}', default='', null=True, blank=True, max_length={{ field.max_length }})
    {% endfor %}
    class Meta:
        db_table = '{{ model.snake_name }}'
        verbose_name = '{{ model.verbose_name }}'
        verbose_name_plural = verbose_name

Admin配置模板

@admin.register({{ model.name }})
class {{ model.name }}Admin(admin.ModelAdmin):
    list_display = [{% for field in model.fields %}'{{ field.name }}', {% endfor %}]
    list_display_links = None

    def has_add_permission(self, request):
        return False

    def has_delete_permission(self, request, obj=None):
        return False

    def has_view_permission(self, request, obj=None):
        return False

數(shù)據(jù)導(dǎo)入腳本

這里做了幾件事：

使用 pandas 處理空值，填充空字符串
已有數(shù)據(jù)進(jìn)行批量更新
新數(shù)據(jù)批量插入

更新邏輯麻煩一點(diǎn)，因?yàn)閿?shù)據(jù)庫(kù)一般都有每次最大更新數(shù)量的限制，所以我做了分批處理，通過(guò) update_data_once_max_lines 控制每次最多同時(shí)更新多少條數(shù)據(jù)。

def import_{{ model.snake_name }}():
    file_path = path_proc(r'{{ excel_filepath }}')

    logger.info(f'讀取文件: {file_path}')
    xlsx = pd.ExcelFile(file_path)
    df = pd.read_excel(xlsx, 0, header={{ excel_header }})
    df.fillna('', inplace=True)

    logger.info('開始處理數(shù)據(jù)')

    id_field_list = {{ model.name }}.objects.values_list('{{ model.id_field.name }}', flat=True)
    item_list = list({{ model.name }}.objects.all())

    def get_item(id_value):
        for i in item_list:
            if i.shen_qing_ren_zheng_jian_hao_ma == id_value:
                return i
        return None

    insert_data = []
    update_data_once_max_lines = 100
    update_data_sub_set_index = 0
    update_data = [[]]
    update_fields = set()

    for index, row in df.iterrows():
        if '{{ model.id_field.verbose_name }}' not in row:
            logger.error('id_field {} is not existed'.format('{{ model.id_field.verbose_name }}'))
            continue

        if row['{{ model.id_field.verbose_name }}'] in id_field_list:
            item = get_item(row['{{ model.id_field.verbose_name }}'])
            {% for field in model.fields -%}
            if '{{ field.verbose_name }}' in row:
                if item.{{ field.name }} != row['{{ field.verbose_name }}']:
                    item.{{ field.name }} = row['{{ field.verbose_name }}']
                    update_fields.add('{{ field.name }}')
            {% endfor %}
            if len(update_data[update_data_sub_set_index]) >= update_data_once_max_lines:
                update_data_sub_set_index += 1
                update_data.append([])
            update_data[update_data_sub_set_index].append(item)
        else:
            # {% for field in model.fields -%}{{ field.verbose_name }},{%- endfor %}
            model_obj = {{ model.name }}()
            {% for field in model.fields -%}
            if '{{ field.verbose_name }}' in row:
                model_obj.{{ field.name }} = row['{{ field.verbose_name }}']
            {% endfor %}
            insert_data.append(model_obj)

    logger.info('開始批量導(dǎo)入')
    {{ model.name }}.objects.bulk_create(insert_data)
    logger.info('導(dǎo)入完成')

    if len(update_data[update_data_sub_set_index]) > 0:
        logger.info('開始批量更新')
        for index, update_sub in enumerate(update_data):
            logger.info(f'正在更新 {index * update_data_once_max_lines}-{(index + 1) * update_data_once_max_lines} 條數(shù)據(jù)')
            {{ model.name }}.objects.bulk_update(update_sub, list(update_fields))
        logger.info('更新完成')

主體代碼

剩下的全是核心代碼了

引用依賴

先把用到的庫(kù)導(dǎo)入

import os
import re
from typing import List, Optional

from pypinyin import pinyin, lazy_pinyin, Style
from jinja2 import Environment, PackageLoader, FileSystemLoader

或者后面直接去我的完整代碼里面拿也行~

類

老規(guī)矩，我封裝了一個(gè)類。

構(gòu)造方法需要指定 Excel 文件地址，還有表頭的行索引。

class ExcelToModel(object):
    def __init__(self, filepath, header_index=0):
        self.filepath = filepath
        self.header_index = header_index
        self.columns = []
        self.fields: List[Field] = []

        self.base_dir = os.path.dirname(os.path.abspath(__file__))
        self.template_path = os.path.join(self.base_dir, 'templates')
        self.jinja2_env = Environment(loader=FileSystemLoader(self.template_path))

        self.load_file()

這里面有個(gè) self.load_file() 后面再貼。

字段名中文轉(zhuǎn)拼音

用了 pypinyin 這個(gè)庫(kù)，感覺還不錯(cuò)。

轉(zhuǎn)換后用正則表達(dá)式，去除符號(hào)，只保留英文和數(shù)字。

代碼如下，也是放在 ExcelToModel 類里邊。

@staticmethod
def to_pinyin(text: str) -> str:
    pattern = r'~`!#$%^&*()_+-=|\';"＂:/.,?><~·！@#￥%……&*（）——+-=“：'；、。，？》{《}】【\n\]\[ '
    text = re.sub(r"[%s]+" % pattern, "", text)
    return '_'.join(lazy_pinyin(text, style=Style.NORMAL))

加載文件

拿出萬(wàn)能的 pandas，按照前面說(shuō)的思路，提取表頭轉(zhuǎn)換成字段，并且遍歷數(shù)據(jù)確定每個(gè)字段的最大長(zhǎng)度，我這里偏移值是32，即在當(dāng)前數(shù)據(jù)最大長(zhǎng)度基礎(chǔ)上加上32個(gè)字符。

def load_file(self):
    import pandas as pd
    xlsx = pd.ExcelFile(self.filepath)
    df = pd.read_excel(xlsx, 0, header=self.header_index)
    df.fillna('', inplace=True)
    self.columns = list(df.columns)
    for col in self.columns:
        field = Field(self.to_pinyin(col), col)
        self.fields.append(field)
        for index, row in df.iterrows():
            item_len = len(str(row[col]))
            if item_len > field.max_length:
                field.max_length = item_len + 32

        print(field.verbose_name, field.name, field.max_length)

如果覺得這樣生成表太慢，可以把確定最大長(zhǎng)度的這塊代碼去掉，就下面這塊代碼

for index, row in df.iterrows():
    item_len = len(str(row[col]))
    if item_len > field.max_length:
        field.max_length = item_len + 32

手動(dòng)指定最大長(zhǎng)度或者換成不限制長(zhǎng)度的 TextField 就行。

生成文件

先構(gòu)造個(gè) context 然后直接用 jinja2 的 render 功能生成代碼。

為了在導(dǎo)入時(shí)判斷數(shù)據(jù)存不存在，生成代碼時(shí)要指定 id_field_verbose_name，即Excel文件中類似“證件號(hào)碼”、“編號(hào)”之類的列名，注意是Excel中的表頭列名。

def find_field_by_verbose_name(self, verbose_name) -> Optional[Field]:
    for field in self.fields:
        if field.verbose_name == verbose_name:
            return field
    return None

def generate_file(self, model_name: str, verbose_name: str, id_field_verbose_name: str, output_filepath: str):
    template = self.jinja2_env.get_template('output.jinja2')
    context = {
        'model': Model(
            model_name, verbose_name,
            self.find_field_by_verbose_name(id_field_verbose_name),
            self.fields
        ),
        'excel_filepath': self.filepath,
        'excel_header': self.header_index,
    }
    with open(output_filepath, 'w+', encoding='utf-8') as f:
        render_result = template.render(context)
        f.write(render_result)

使用

看代碼。

tool = ExcelToModel('file.xlsx')
tool.generate_file('CitizenFertility', '房?jī)r(jià)與居民生育率', '證件號(hào)碼', 'output/citizen_fertility.py')

生成出來(lái)的代碼都在一個(gè)文件里，請(qǐng)根據(jù)實(shí)際情況放到項(xiàng)目的各個(gè)位置。

完整代碼

發(fā)布到Github了

地址: https://github.com/Deali-Axy/excel_to_model

以上就是Python實(shí)現(xiàn)根據(jù)Excel生成Model和數(shù)據(jù)導(dǎo)入腳本的詳細(xì)內(nèi)容，更多關(guān)于Python生成Model和數(shù)據(jù)導(dǎo)入腳本的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: