瘦了就帅了 Cuile

Usage: python.exe -m nuitka [–mode=compilation_mode] [–run] [options] main_module.py

Note: For general plugin help (they often have their own command line options too), consider the output of '--help-plugins'.

Control the inclusion of modules and packages in result: –include-package=PACKAGE Include a whole package. Give as a Python namespace, e.g. “some_package.sub_package” and Nuitka will then find it and include it and all the modules found below that disk location in the binary or extension module it creates, and make it available for import by the code. To avoid unwanted sub packages, e.g. tests you can e.g. do this “–nofollow-import-to=*.tests”. Default empty. –include-module=MODULE Include a single module. Give as a Python namespace, e.g. “some_package.some_module” and Nuitka will then find it and include it in the binary or extension module it creates, and make it available for import by the code. Default empty. –include-plugin-directory=MODULE/PACKAGE Include also the code found in that directory, considering as if they are each given as a main file. Overrides all other inclusion options. You ought to prefer other inclusion options, that go by names, rather than filenames, those find things through being in “sys.path”. This option is for very special use cases only. Can be given multiple times. Default empty. –include-plugin-files=PATTERN Include into files matching the PATTERN. Overrides all other follow options. Can be given multiple times. Default empty. –prefer-source-code For already compiled extension modules, where there is both a source file and an extension module, normally the extension module is used, but it should be better to compile the module from available source code for best performance. If not desired, there is –no- prefer-source-code to disable warnings about it. Default off.

在 Docker 的容器内开发，相当于使用VSCode的远程开发能力，好处非常多。

• 开发环境统一、可维护性强
• 后期部署简单

1. 安装 Docker

Docker 安装

2. 安装 Visual Stuido Code

这不废话嘛，同上。

3. 安装 Remote Development 扩展包

官方推荐安装 Remote Development 这个扩展包，它包括三个扩展功能：

• Remote - SSH
• Remote - Containers
• Remote - WSL

如果你只使用 Docker ，可以只安装 Remote - Containers 这个扩展。

安装成功后，你可以在 VSCode 的左下角，看到一个“蓝底色+两个相对白箭头”的图标。

点击图标，可以看到 Remote - Containers 提供了许多方法进行配置。

4. 配置 Remote - Containers

4.1. 使用现成的 docker-compose.yml 配置

1. 点击左下角的蓝色图标
2. 选择 Add Development Container Configuration Files…
3. 选择 Existing Docker Compose (Extend)
   1. VSCode 会自动在项目的根目录下，生成 .devcontainer 文件夹
   2. 在 .devcontainer 目录内，包括两个文件：
      1. devcontainer.json：VSCode 使用它连接开发容器
      2. docker-compose.yml：示例文件，可以不用管它
4. 打开 devcontainer.json 文件

照着 docker-compose.yml 进行修改，见下面示例

使用 VSCode 开发 Python 是替代 PyCharm 的一个很好选择，有丰富的扩展和第三方工具可以使用，安装配置好它们，会让开发工作事半功倍。下面列举推荐安装的扩展和工具：

扩展

• Material Icon There
  • VSCode图标，很好看
• Python
  • 微软官方扩展，一定要装
• Pylance
  • 微软官方扩展，一定要装
• autoDocstring
• Python Environment Manager
• Ruff
• Code Runner
• Qt for Python

工具

• Micromamba
  • 使用 Micromamba 来配置 Python 开发环境有几个好处：
    • micromamba 是一个包管理器，可方便的同时安装几个软件，形成一个独立的开发环境，与其它项目的开发环境完全隔离。
    • micromamba 安装的软件，不会在系统留下痕迹，不会污染本地系统。
    • micromamba 只配置 python 基础环境，不影响 python 虚拟环境，同一个基础环境可提供给多个虚拟环境使用。

配置 Micromamba

Windows环境

下载

推荐使用 PowerShell¹

> Invoke-Webrequest -URI https://micro.mamba.pm/api/micromamba/win-64/latest -OutFile micromamba.tar.bz2
> tar xf micromamba.tar.bz2
> MOVE -Force Library\bin\micromamba.exe micromamba.exe
>.\micromamba.exe --help
# 查看输出

安装²

> .\micromamba.exe shell init -s powershell

默认位置为 $HOME/micromamba，也就是 C:\Users\username\micromamba 。 如果想自己指定位置，可以加上 “-p <path>” 参数。

参考文档

• kraiz/django-crontab
• 使用django-crontab建立定时任务
• Linux crontab 命令

不同版本中，不同的表现形式：

• Python 2.x：reload() 是内置函数
• Python 3.0 - 3.3：使用 imp.reload(module)
• Python 3.4：imp 已经被废弃，取而代之的是 importlib

from importlib import reload

reload(<module>)

参考文档

• Python 重新加载模块 reload

1 准备环境

开发环境还是建议使用 Docker 来搭建，方便快捷。 不过 Django 的官方镜像已经弃用了，官方建议新版本使用 Python 官方提供的镜像来构建。

Docker
  ┗ Python == 3.9.12-buster
      ┗ Django == 3.2.13 LTS
      ┗ django-simpleui==2022.11.30

可以参考[https://github.com/Cuile/Docker-to-Python/tree/master/Django]，提供了 Dockerfil、yml 文件，还提供全套使用命令。

2 创建项目

# 创建项目
$ django-admin startproject mysite
$ cd mysite

# 生成项目
$ python manage.py startapp websrc
# 运行项目测试
$ python manage.py runserver 0.0.0.0:80

修改配置后，建议使用项目调试的方式启动，不要使用快捷命令，项目正常启动稳定运行后，再使用快捷命令。

# settings.py

# 任意地址都可以访问 Django
ALLOWED_HOSTS = ['*'] 

# 添加 simpleui 模板，和创建的项目
INSTALLED_APPS = [
  'simpleui',
  'websrc',
  '......',
]

# 这个与多语种有关，在项目初始阶段不要修改，后续添加了多语种支持再修改，否则会导致无法启动。
# 具体参考(http://www.i18nguy.com/unicode/language-identifiers.html)，有个傻逼教程，上来就改成 zh-CN 果然导致项目无法正常启动。
# 正确的简体中文代码如下：
LANGUAGE_CODE = 'zh-Hans'

# 时区，上海就代表北京时间，这个不能写错，写错就启动不了
# 具体参考(https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)，这里是标准的，有个傻逼教程非给写成 Asia/Beijing 导致怎么都起不来，太TMD的二逼了。
# 正解的北京时间时区如下：
TIME_ZONE = 'Asia/Shanghai'

# 启动翻译，与上面的 LANGUAGE_CODE 设置相对应
USE_I18N = True
# 启动格式控制
USE_L10N = True
# 启动时区
USE_TZ = True

3 创建管理员账号

$ python manage.py createsuperuser
Username: admin
Email address: [email protected]
Password: **********
Password (again): *********
Superuser created successfully.

访问项目链接，比如"http://127.0.0.1:8000/admin/

1、查看已安装的Python

# 查看已安装的信息
$ yum info python3
# 查看python安装位置
$ whereis python3

2、卸载已安装的Python环境

# 卸载已安装的程序
$ yum erase python3
# 删除所有残余文件
$ whereis python3|xargs rm -frv
# 查看现有的python
$ whereis python3

3、yum安装依赖环境

$ yum -y install zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel

4、官网下载Python3.9.12

$ yum -y install wget
# 尽量使用国内镜像站点下载比较快
$ wget https://mirrors.huaweicloud.com/python/3.9.12/Python-3.9.12.tgz

5、创建安装目录

$ tar -zxvf Python-3.9.12.tgz -C ./
$ cd  Python-3.9.12
$ mkdir /usr/local/python3 
$ ./configure --prefix=/usr/local/python3.9.12
$ make && make install

6、创建软链接

$ ln -s /usr/local/python3.9.12/bin/python3 /usr/bin/python3
$ ln -s /usr/local/python3.9.12/bin/pip3 /usr/bin/pip3

7、测试

$ python3 -V
Python 3.9.12

$ pip3 -V
pip 22.0.4 from /usr/local/python3.9.12/lib/python3.9/site-packages/pip (python 3.9)

8、pip升级、换源

# pip升级
$ python3 -m pip install --upgrade pip
# pip换源
# 推荐使用清华的源，因为使用https协议
$ pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

urllib.parse.urlencode(query, doseq=False, safe=’’, encoding=None, errors=None, quote_via=quote_plus) urllib.parse.urlencode 将对象或两元素序列转换为百分比编码的ASCII文本字符串，字符串是由’&‘字符分隔的一系列 key=value 对，其中 key 和 value 都使用 quote_via 函数引用。

GET 请求

import urllib
params = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})
url = "http://www.musi-cal.com/cgi-bin/query?%s" % params
with urllib.request.urlopen(url) as f:
    print(f.read().decode('utf-8'))

POST 请求

import urllib.request
import urllib.parse
data = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})
data = data.encode('ascii')
with urllib.request.urlopen("http://requestb.in/xrbl82xr", data) as f:
    print(f.read().decode('utf-8'))

如果结果字符串要用作具有 urlopen() 函数的POST操作的 data，则它应该被编码为字节，否则将导致 TypeError。

默认情况下 urlencode 函数使用 quote_plus() 函数进行编码，也可以选用 quote() 函数进行编码，两者最大的不同在于对特定字符的处理。

urllib.parse.quote_plus(string, safe=’’, encoding=None, errors=None) 默认情况下使用 quote_plus() 函数，它将空格被编码为 ‘+’ 字符，而“/”字符被编码为 %2F，它遵循GET请求（application/x-www-form-urlencoded）的标准。 urllib.parse.quote(string, safe=’/’, encoding=None, errors=None) 可以作为备用的函数是 quote()，它将空格编码为 %20，字母，数字和 ‘_.-‘字符不被编码，而“/”字符被默认为安全字符不被编码。

Python 的 pypi.python.org 站点终于要退休了，而新的接任者 pypi.org 无论从美观、风格上都让人大大的喜欢，终于在审美一这项上及格了。

而且新的 pypi.org 能够正确的渲染 Markdown 格式的描述，实在是让人欣慰，终于可以和 Github 同步了，不用在麻烦的转换一次了。

下面就来聊聊，如何正确的把库发布到 pypi.org 上：

1. 注册 pypi.org 账号

嗯，这是正确的废话！

2. 编写 setup.py

setup.py 的内容比较重要，但其它的细节不谈，主要聊聊 long_description 部分，这部分是对库能力的详细描述。

如果说 keywords 和 description 能提高别人搜索到项目的概率的话，那 long_description 就在很大程度上决定别人对你对项目有没有进一步的想法了。

在针对 long_description 的网上介绍中，对具体使用方法明确写出的是少之又少，所以我今天就特别举例说明一下。

2.1 setup.py

#!/usr/bin/env python
# coding: utf-8

from setuptools import setup

setup(
name='sequence2hash',
version='1.1.2',
keywords='tuple dict list sequence hash key/value',
packages=['sequence2hash'],

url='https://github.com/Cuile/sequence2hash',
description='This tool converts a valid value in a sequence to a hash and contains a path to a valid value in the key field',
long_description_content_type='text/markdown',
long_description=open('README.md', encoding='utf8').read(),

author='cuile',
author_email='[email protected]'
)

2.2 读取 readme.md 文件

long_description=open('README.md', encoding='utf8').read()

这句代码是较少明确说明的，可以不引用 io 库，而直接使用 open 函数读取文件内容，由于 pypi.org 支持 Markdown ，所以可以和 Github 使用同一份 README.md 文件。