nairods 0.1.1

Fix Bug

nairods

介绍

整理现阶段的项目

封装一些常用的工具包

提高开发效率(疑问?)

安装

pip install nairods

源安装

pip install -i  https://pypi.tuna.tsinghua.edu.cn/simple nairods
pip install -i  https://mirrors.aliyun.com/pypi/simple/ nairods
pip install -i  https://pypi.douban.com/simple/  nairods

文件结构

nairods/  			# 顶级包
│   __init__.py
│
├─ConfigTools				# 配置包	
│   └─DatabaseConfig				# 数据库配置
│          PgServe.yml			            # Pg服务器
│          Mysql.yml		                    # Mysql服务器
│   └─Database_Sql                               # 数据库语句  
│           CreatemysqlData.sql                     # 建表语句
│ 
├─CrawlerTools				# 爬虫包
│   __init__.py
│   └─Example                                   # 举个栗子
│       __init__.py	
│       DlzbCrawler.py                              # 电力招标网
│      
├─TestFile				# 测试数据包
│    └─Xlsx				        # 表格数据
│    └─Txt				        # 文本数据
│      
├─DatebaseTools				# 数据库包
│      __init__.py
│      PgTools.py				    # Pg数据库工具类
│      
├─DingtalkTools				# 钉钉包
│      __init__.py
│      DingtalkBot.py			            # 机器人,推送文件,文本
│ 
├─Document	                        # 文档
│    └─Docx	                            # word文档
│    └─Pdf                                  # pdf文件
│    └─Xlsx				    # 表格数据
│
├─FileTools                             # 常用文件包
│   __init__.py
│   ExcleTools.py                                   # 表格操作
│   FolderTools.py                                  # 文件夹操作
│   PdfTools.py                                     # pdf操作
│   YmlTools.py                                     # yml操作
│   ZipTools.py                                     # zip操作
│
├─Image				        # 图片地址
│   └─Icon			            # 图标
│   └─Png                                   # png图片
│
├─Log                                   # log日志
├─Temp  				# 临时文件夹
│   └─Csv                                   # csv文件夹
├─TimeTools				# 时间包
│   __init__.py
│   DatetimeTools.py                        # 时间
│       
│ README.en.md  
│ README.md   
│ version_update.md         # 版本更新

代码规范(试用版)

1. 变量命名

   一个单词组成: 小写 connect

   多个单词组成: 下划线 remote_folder_path

2. 函数命名

   一个单词组成: 小写 test()

   多个单词组成: 下划线 connect_test()

3. 类命名

   一个单词组成: 首字母大写 Serve()

   多个单词组成: 首字母大写&末尾字母大写 SoftwareTools()

4. 文件命名

   一个单词组成: 小写 remove.py

   多个单词组成: 首字母大写&末尾字母大写 DatabaseTools.py

5. 文件夹命名

   一个单词组成: 大写 Temp

   多个单词组成: 首字母大写&末尾字母大写 FileTools

6. 模块命名

   一个单词组成: 大写 Serve

   多个单词组成: 首字母大写&末尾字母大写 FileTools

7. 类调用

   一个单词组成: 前面两个字母大写 SE = Serve()

   多个单词组成: 首字母大写&末尾字母大写 ST = SoftwareTools()

8. 函数出参入参注释

def read_yaml(yml_path = ''):
   '''
   文件夹不存在则创建
   :param folder_path: 文件夹地址
   :return: yml文件地址
   '''
   return yml_path

8. 类初始化函数注释

class YamlCurd(obejct):
   '''
   yaml 操作
   '''
   def __init__(self):
      pass
   def read_yaml(self,yml_path = ''):
      '''
      文件夹不存在则创建
      :param folder_path: 文件夹地址
      :return: yml文件地址
      '''
      return yml_path

9. 文件要有函数入口测试

class YamlCurd(obejct):
      '''
      yaml 操作
      '''
      def __init__(self):
         pass
      def read_yaml(self,yml_path = ''):
         '''
         文件夹不存在则创建
         :param folder_path: 文件夹地址
         :return: 创建成功
         '''
         return yml_path
   
   
if __name__ == '__main__':
   YC = YamlCurd()
   YC.read_yml(F'demo.yml')

10. 变量值

    变量值 优先使用单引号 ' '

    这里主要是复制其他数据会是双引号

    如:json,xpath等等

age = 18
name = '小明'

11. 格式化字符串f-string

    f或者F 优先使用 F + ' '

age = 18
name = '小明'
result  = F'{name}今年{age}岁'

12. 转义字符 R或者r

    转义字符 使用优先使用大写 R

13. 路径类 使用优先使用大写 R

yml_path = R'./yml_path'

使用说明

1. 导入相关包

from FileTools.YmlTools import YmlCurd

2. 初始化

from FileTools.YmlTools import YmlCurd
YC = YmlCurd()

3. 使用相关函数

from FileTools.YmlTools import YmlCurd
YC = YmlCurd()
YC.read_yaml()