pip install python-office

目前，这个开源项目正处在蓬勃的发展当中，但是在发展的过程中需要更多的规范化。客户以及开发者提出了各种各样的需求，有一些需求比较大众，有一些需求比较小众。如果不对这些需求加以区分而盲目的将api合入office的库中，会导致整个库十分臃肿且没有中心，这势必会对于整个开源生态的发展非常的不利。 为此，我建议采用类似主体+插件的形式对于开源代码进行维护。主体保留最常见的相应功能，这一部分功能是用户使用的频率最高的，呼声最大的功能。而插件——在这里被我称为预设，则保证小众的需求，让客户可以选择的下载。同时在某些预设的使用量较高的情况下，将其合入主体。 这样子有几个好处：首先是，可以分清楚主次以及开发者的职责。主体由项目的主要开发者维护，而预设则主要由预设的创作者来维护。这样子不会出现某些主要开发者专注于维护低频次使用的功能而忽视主要功能的维护升级。 其次是方便项目维护，稳定的特性可以放置在主体中进行维护与迭代，而非稳定的特性可以放到预设进行开发，直到稳定再合入主体。 另外就是鼓励了创作者的开发热情。由于预设并不一定要是完整的功能，仅仅是一个小的办公脚本中就可以加入预设，这样子每一个使用了python脚本的人都可以把自己的脚本分享出来。这就有点类似创意工坊的感觉，可以极大的增加创作者的热情。 当然，预设仍有许多规范化问题需要解决，这需要社区进行讨论，制定相应的预设编写规范以及导入方法。

现在的贡献方式是在contributors文件夹下编辑各自的代码，再由核心维护者手动把功能整合进office文件夹中，再上传到PyPI上，这种方式有以下弊端：

• 增加了核心维护者 @CoderWanFeng 进行code review的工作量
• 贡献者代码质量难以保证，同时优质功能上线周期也长
• 由于相对路径、相对导入存在一些坑，从contributors到主文件夹的迁移可能产生新的bug
• office文件夹下现存的实现有的是半成品，有的有待优化，但大家不敢乱动，生怕向后不兼容

综上原因我建议，在根目录（与office文件夹）建一个tests文件夹，里面存储各模块的单元测试， 同时也改变一下贡献的方式，允许有把握的同学在不改变原有单元测试的前提下，直接commit到office目录，保证新增的功能也提供了有效的单元测试，测试通过后，在核心开发者认定代码质量够高后，即可直接merge并推送到PyPI，实现新功能的快速上线

在Pycharm 中 输入pip install -i https://pypi.tuna.tsinghua.edu.cn/simple python-office -U 都能正常安装，但有一个报错，导致安装失败

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. paddlepaddle-gpu 2.2.2 requires numpy<=1.19.3,>=1.13; python_version >= "3.5" and platform_system == "Windows", but you have numpy 1.22.3 which is incompatible.

1. 安装后 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple python-office -U

2. 执行 office.excel.fake2excel(columns=['name', 'text'], rows=20)

3. 报错

Traceback (most recent call last):
  File "/Users/xxx/work_code/python-lessons/main.py", line 9, in <module>
    import office
  File "/Users/xxx/work_code/python-lessons/venv/lib/python3.8/site-packages/office/__init__.py", line 1, in <module>
    from . import word
  File "/Users/xxx/work_code/python-lessons/venv/lib/python3.8/site-packages/office/word.py", line 12, in <module>
    from win32com.client import constants, gencache
ModuleNotFoundError: No module named 'win32com'

4. 再次安装缺少的 win32

pip install pypiwin32

6. 安装 win32 报错

Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Collecting pypiwin32
  Using cached https://mirrors.aliyun.com/pypi/packages/d0/1b/2f292bbd742e369a100c91faa0483172cd91a1a422a6692055ac920946c5/pypiwin32-223-py3-none-any.whl (1.7 kB)
  Using cached https://mirrors.aliyun.com/pypi/packages/2b/ca/5c086c18de8f70222787b3e824e755b68d99272531522e77bb381d4f60c8/pypiwin32-219.zip (4.8 MB)
  Preparing metadata (setup.py) ... error
  error: subprocess-exited-with-error
  
  × python setup.py egg_info did not run successfully.
  │ exit code: 1
  ╰─> [7 lines of output]
      Traceback (most recent call last):
        File "<string>", line 2, in <module>
        File "<pip-setuptools-caller>", line 34, in <module>
        File "/private/var/folders/2p/c0c3rrys09b8c8y0rrkscn8r0000gn/T/pip-install-b18sn648/pypiwin32_0e47d8d13683441e9c213f629f92a95f/setup.py", line 121
          print "Building pywin32", pywin32_version
                ^
      SyntaxError: Missing parentheses in call to 'print'. Did you mean print("Building pywin32", pywin32_version)?
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

使用场景：在一个充满屏幕截图的文件夹下，用一行命令将这些截图转为ppt

建议：将命令命名为py-office或者poffice或者po，短命令好打

这样上述使用场景需要的命令大概是：

po img2ppt -i . -o output.pptx
# or:
python -m python-office img2ppt -i . -o output.pptx

要实现这个功能，需要：

1. python-office的每个子包都有一个__main__.py文件
2. 打包一个总的__main__.py为一个exe文件，比如命名为po.exe

建议：对CLI参数的解析可以借助标准库的argparse模块，

但个人更推荐使用第三方库typer，用装饰器的方式，更直观更便捷地将已有的功能函数转为cli接口

提供cli接口的一个用处是，让几乎完全没有python基础的人也能使用python-office

Mac 没办法做支持的吧，安装pip python-office 不报错，执行 /Users/betty/PycharmProjects/pythonProject/venv/bin/python /Users/betty/PycharmProjects/pythonProject/myfaker.py Traceback (most recent call last): File "/Users/betty/PycharmProjects/pythonProject/myfaker.py", line 6, in import office File "/Users/betty/PycharmProjects/pythonProject/venv/lib/python3.10/site-packages/office/init.py", line 1, in from office.api import word File "/Users/betty/PycharmProjects/pythonProject/venv/lib/python3.10/site-packages/office/api/word.py", line 13, in from office.core.WordType import MainWord File "/Users/betty/PycharmProjects/pythonProject/venv/lib/python3.10/site-packages/office/core/WordType.py", line 2, in from win32com.client import constants, gencache ModuleNotFoundError: No module named 'win32com'