我的项目构造
我的项目的构造如下,以目录模式的模块包来组织代码,同时反对以目录或包来执行,两种形式具备对立入口。
\ptetris
|---- .editorconfig
|---- .gitignore
|---- .vscode
| |---- launch.json
| |---- settings.json
|---- LICENSE.rst
|---- README.md
|---- tetris
| |---- app.py
| |---- block.py
| |---- config.py
| |---- game.py
| |---- tetris.py
| |---- __init__.py
| |---- __main__.py
实现细节
咱们的程序位于 tetris 目录(包)中,能够作为一个文件夹来执行:
python tetris
也能够作为一个包(Package)来执行:
python -m tetris
__init__.py
若要 python 将一个文件夹作为 Package 看待,那么这个文件夹中必须蕴含一个名为 __init__.py 的文件,即便它是空的。
咱们在这个文件中定义 main(),作为软件的对立入口。
from tetris.app import start # 这个 tetris 目录下的文件都位于 tetris 包中了
def main():
print("Hi I'm Tetris!")
start() #实在入口在 app.py 中
__main__.py
若要 python 运行一个文件夹,这个文件夹中必须蕴含一个名为 __main__.py 的文件
在__main__.py 中调用__init__.py 中的 main(),对立程序入口。
import tetris
tetris.main()
这时以包形式运行没有问题,但以目录形式运行会出错:
Traceback (most recent call last):
File "C:\Users\zhoutk\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 197, in _run_module_as_main
return _run_code(code, main_globals, None,
File "C:\Users\zhoutk\AppData\Local\Programs\Python\Python39\lib\runpy.py", line 87, in _run_code
exec(code, run_globals)
File "d:\codes\ptetris\tetris\__main__.py", line 7, in <module>
import tetris
File "d:\codes\ptetris\tetris\tetris.py", line 2, in <module>
from tetris.config import *
ModuleNotFoundError: No module named 'tetris.config'; 'tetris' is not a package
起因在于,sys.path 的第一个搜寻门路,一个是包,一个是空字符串。对于 python -m tetris 的调用形式来说,因为 __init__.py 被当时载入,此时 python 解释器曾经晓得了这是一个包,
因而以后门路(空字符串)被蕴含在 sys.path 中。而后再调用 __main__.py,这时 import pkg 这个包就没有问题了。
而对于 python tetris 的调用形式来说,python 解释器并不知道本人正在一个 Package 上面工作。默认的,python 解释器将 __main__.py 的以后门路 tetris 退出 sys.path 中,而后在这个门路上面寻找 tetris 这个模块,因而出错。
在__main__.py 结尾退出如下代码,就能解决这个问题:
import os, sys
if not __package__:
path = os.path.join(os.path.dirname(__file__), os.pardir)
sys.path.insert(0, path)
vscode 的配置
vscode 来写 python 还是很不错的,做两步操作,就能够很好的编写 python 程序了。
装置插件
只有装置 ms-python.python 插件就好了,相干的另外几个会主动装置的。
配置 launch.json
"configurations": [
{
"name": "Tetris",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/tetris",
"console": "integratedTerminal"
}
]
这样就能够用 vscode 关上 ptetris 目录,按 F5 运行程序了。
我的项目地址
https://gitee.com/zhoutk/ptetris
或
https://github.com/zhoutk/ptetris
运行办法
1. install python3, git
2. git clone https://gitee.com/zhoutk/ptetris (or download and unzip source code)
3. cd ptetris
4. python3 tetris
This project surpport windows, linux, macOs
on linux, you must install tkinter first, use this command:
sudo apt install python3-tk
相干我的项目
曾经实现了 C ++ 版,我的项目地址:
https://gitee.com/zhoutk/qtetris