excel-operate-light22 0.2.0

方便快捷Excel操作

欢迎使用

一、概述

本模块为方便大家更便捷使用Python来操作Excel文件而编写，基于openpyxl进行编写，所以在使用本模块前请确保您的计算机中已安装有Python环境以及openpyxl库.

作者：北极星光

E-mail：[e-mail]

二、功能介绍

• 简化openpyxl库的导入流程，无需分别导入Workbook和load_workbook来创建和打开工作薄，只需要使用ExcelOperate类实例化对象时，指定file_path参数即打开已有的Excel文件，不指定即为新建工作薄。同时实例化打开EXcel文件时可以直接指定sheet_name参数来快速打开工作表，不指定则打开当前激活工作表。
• 方便快捷插入和删除行（列）。解决直接使用openpyxl中工作表对象的insert_rows/insert_cols/delete_rows/delete_cols方法时，插入或删除的行（列）的位置后方行（列）的行高（列宽）以及如果存在已合并单元格的情况下，已合并的单元格信息等格式不会因插入或删除的行（列）而下（后）移或上（前）移，从而导致表格的整体格式甚至数据受到影响。通过本模块的方法插入或删除行（列）后的效果与在Excel程序中插入或删除行（列）的效果可以做到近乎完全相同。同时为insert_rows和insert_cols方法增加height和width参数，方便插入行（列）时快捷设定行高和列宽。
• 可以使用openpyxl库中的所有操作。
• 其它功能敬请期待

三、使用方法

• 导入本模块方法：在需要导入本模块的代码中写入导入语句：from excel_operate import ExcelOperate
• 对象实例化方法：excel = ExcelOperate(file_path=None,sheet_name=None)，其中参数file_path为文件路径，指定后打开文件路径对应的Excel文件（相当于openpyxl中的load_workbook方法）不指定则会新建一个空白Excel文件（相当于openpyxl中的Workbook类的实例化）；参数sheet_name为工作表名，指定后打开对应的工作表，不指定则打开当前激活的工作表（相当于工作薄对象的active方法）。实例化后获得一个名为excel的对象。
• 插入或删除行（列）：插入行excel.insert_rows(idx,amount=1,height='before')，删除行excel.delete_rows(idx,amount=1)，插入列excel.insert_cols(idx,amount=1,width='before')，删除列excel.delete_cols(idx,amount=1)。其中参数idx为插入或删除的起始行（列），参数amount为插入或删除的行（列）数，不指定的情况下默认插入或删除1行（列），参数height和width仅在插入行和列时使用，可指定为整数或者浮点数来设置插入的行高或列宽，不指定的情况下默认参数为'before'，该参数可以让插入的行或列继承插入前上一行（列）的行高或列宽。另外插入行时，height参数也可指定为None，此参数可以设置插入行的行高为自动行高。
• 其它openpyxl操作：可使用wb = excel.wb来获得openpyxl中的工作薄对象，从而进行openpyxl中关于工作薄对象的一切操作；使用ws = excel.ws可以获得openpyxl中的工作表对象，从而进行openpyxl中关于工作表对象的一切操作。
• Excel文件的保存：可直接使用excel.save（file_path=None）的方法来保存，file_path参数默认不指定的情况下为覆盖原文件保存，指定后可以另存为新的路径（如果之前实例化excel对象时没有指定file_path，即创建空白Excel文件的情况下，保存时不指定路径的话则会报错。）

---

---