Python：设置项目环境

安装poetry后，创建示例项目文件夹，命名为poetry-examplepoetry并初始化项目

$ poetry new poetry-example

Created package poetry_example in poetry-example

$ cd poetry-example && ls –tree

.

├── poetry_example

│ └── init.py

├── pyproject.toml

├── README.rst

└── tests

├── init.py

└── test_poetry_example.py

好的！现在poetry-example是一个使用诗歌的项目！然后，让我们安装requests软件包。

$ poetry add requests # install package

Creating virtualenv poetry-example-mO5WhdNK-py3.9 in /home/meow/.cache/pypoetry/virtualenvs

Using version ^2.24.0 for requests

Updating dependencies

Resolving dependencies… (3.1s)

Writing lock file

Package operations: 14 installs, 0 updates, 0 removals

• Installing pyparsing (2.4.7)

• Installing six (1.15.0)

• Installing attrs (20.2.0)

• Installing certifi (2020.6.20)

• Installing chardet (3.0.4)

• Installing idna (2.10)

• Installing more-itertools (8.5.0)

• Installing packaging (20.4)

• Installing pluggy (0.13.1)

• Installing py (1.9.0)

• Installing urllib3 (1.25.10)

• Installing wcwidth (0.2.5)

• Installing pytest (5.4.3)

• Installing requests (2.24.0)

$ ls

poetry.lock poetry_example pyproject.toml README.rst tests

好的，现在我们可以看到poetry.lock文件了。默认情况下，诗歌会在缓存目录中创建一个虚拟环境。

$ pwd

/home/vagrant

$ ls .cache/pypoetry/virtualenvs

poetry-example-mO5WhdNK-py3.9

如果要将 virtualenv 目录更改为本地项目文件夹，可以使用virtualenvs.in-project 配置.

样式检查器和代码格式化程序

---

样式检查器和代码格式化程序是可以帮助提高代码质量的工具。Python 生态系统中有许多不同的工具，但这里我选择了最常用的工具。

黑色的

Black 是Python 软件基金会提供的毫不妥协的 Python 代码格式化程序。黑色的替代品是yapf，由 Google 分发。这两种工具都有自己的优点和缺点，但在我个人看来，黑色更容易使用。

$ pwd

/home/vagrant/Projects/poetry-example

$ poetry add -D black # Install black as development dependency

我black使用该-D选项安装。此选项将包添加为开发依赖项。因为在大多数情况下，Style Checker 或 Code Formatter 不需要作为项目的一部分发布。

然后，创建一个示例文件进行测试。

$ cat poetry_example/main.py

def main():

print(“Hello World”);

if name == “main”:

main()

$ python poetry_example/main.py

Hello World

$ poetry run black poetry_example/main.py

reformatted poetry_example/main.py

All done! ✨ 🍰 ✨

1 file reformatted.

$ cat poetry_example/main.py

def main():

print(“Hello World”)

if name == “main”:

main()

你发现使用黑色前后的区别了吗？

在执行 black 之前，在 print 语句之后main.py包含**分号。**分号不影响 Python 执行，但 Python 不使用分号，除非特殊情况。

所以，在执行完black之后，我们可以看到分号在 main.py

flake8 & 排序

flake8是基于PEP8(Python Enhance Proposal 8)")的 Python 风格检查器。black 是一个很好的代码格式化程序。但有些项目如Documentation String, black 没有提供勾选选项。flake8 不仅有助于黑色的缺乏，而且可以很容易地与黑色一起应用。

isort也是一个与 flake8 类似的工具，该工具按字母顺序对导入进行排序，并自动按类型和部分分隔。

因此，让我们将这两种工具都与黑色一起使用。

$ pwd

/home/vagrant/Projects/poetry-example

$ poetry add -D flake8 isort # Install packages

# poetry_example/main.py

from pprint import PrettyPrinter, pformat, isreadable # Expected sorts alphabetically

def Empty():

raise NotImplemented # Expected Warning - F901

def main():

pp = PrettyPrinter(indent=4)

pp.pprint([“Hello”, “World”])

if name == “main”:

main()

添加一些测试语句并运行。

$ python poetry_example/main.py

[‘Hello’, ‘World’]

$ poetry run black poetry_example/main.py

All done! ✨ 🍰 ✨

1 file left unchanged.

$ poetry run flake8

./poetry_example/main.py:3:1: F401 ‘pprint.pformat’ imported but unused

./poetry_example/main.py:3:1: F401 ‘pprint.isreadable’ imported but unused

./poetry_example/main.py:7:5: F901 ‘raise NotImplemented’ should be ‘raise NotImplementedError’

$ poetry run isort poetry_example/main.py

Fixing /home/meow/Projects/poetry-example/poetry_example/main.py

$ head -5 poetry_example/main.py

from pprint import PrettyPrinter, isreadable, pformat # Changed!

（可选）pipx

---

Python 生态系统中有许多应用程序或包。例如，包包括和之类的东西TensorFlow，Django应用程序包括Jupyter和Ansible。

在大多数情况下，我们用于pip下载应用程序和软件包。这种方法创造了一个荒谬的情况。因为 pip 是一个通用的包安装程序，没有环境隔离。

所以，[pipx]( )是一个帮助解决这些情况的工具。

$ python3 -m pip install –user pipx # install via pip

$ python3 -m pipx ensurepath

# Example

$ pipx install bpytop

installed package bpytop 1.0.42, Python 3.9.0

These apps are now globally available

• bpytop

done! ✨ 🌟 ✨

$ which bpytop

/home/vagrant/.local/bin/bpytop

视觉工作室代码

=======

Visual Studio Code 是我最喜欢的代码编辑器之一。特别是，我认为 VSCode 与 Python 非常兼容。

因此，我将通过示例项目展示如何使用我迄今为止介绍的 VSCode 工具。首先，让我们创建一个新项目。

$ poetry new python-boilerplate && cd python-boilerplate

$ poetry config virtualenvs.in-project true –local # change virtualenv location to local

$ poetry add -D black flake8 isort

$ touch setup.cfg # for flake8 configuration

$ ls -a

.venv poetry.lock poetry.toml pyproject.toml python_boilerplate README.rst setup.cfg tests

正如之前在诗歌部分中所解释的，诗歌会自动virtualenv在缓存目录中创建文件夹。

在这些情况下，VScode 无法轻松访问 virtualenv 目录。所以我使用virtualenvs.in-project选项来更容易访问venvVSCode 中的文件夹。

现在准备配置设置。首先，安装Visual Studio Code 的 Python 扩展并创建.vscode/settings.json文件。

{

// VSCode

“[python]”: {

“editor.formatOnSave”: true,

“editor.codeActionsOnSave”: {

“source.organizeImports”: true

}

},

// Python Extension

“python.venvPath”: “./.venv”,

“python.linting.pylintEnabled”: false,

“python.linting.flake8Enabled”: true,

“python.formatting.provider”: “black”,

“python.linting.enabled”: true,

}

好的！现在 lint 将自动应用于 python 文件。

（可选）类型检查器/提示

---

众所周知，Python 是一种动态类型语言。这些特性各有利弊，但有些用户希望 Python 像一种静态类型 语言。

为了弥补这一点，Python从 3.5 版开始支持 Type Hints ( typing )。。")但是，该文件说：

Python 运行时不强制执行函数和变量类型注释。它们可以被第三方工具使用，例如类型检查器、IDE、linter 等。

所以有几个工具支持 Type Hint：

• 我的

• 版权

• 火柴检查

这三个工具都适用于类型检查。但其中，我个人更喜欢pyright。

版权

pyright 是微软开发的静态类型检查器。我更喜欢 pyright 的最大原因是它可以通过 VSCode 轻松应用。只需尝试安装Pyright 扩展并创建pyrightconfig.json

{

“include”: [

“python_boilerplate”

],

“exclude”: [

“**/pycache”

],

“reportMissingImports”: “error”,

“reportMissingTypeStubs”: “none”

}

这是一个示例配置。Pyright 提供了多种选择。更多信息请查看官方文档。

并创建main.py用于测试

def sayHello(name: str) -> str:

return 0 # Error!

VSCode 将显示以下问题与该函数的返回

Expression of type “Literal[0]” cannot be assigned to return type “str”

“Literal[0]” is incompatible with “str”

结论

==
我认为 Python 的最大优势是任何人都可以只用编辑器轻松编程。因此，上述设置不是必需的！
但是，我希望它对任何需要上述信息的人有所帮助。如果对Python有兴趣，想了解更多的Python以及AIoT知识，解决测试问题,以及入门指导，帮你解决学习Python中遇到的困惑，我们这里有技术高手。如果你正在找工作或者刚刚学校出来，又或者已经工作但是经常觉得难点很多，觉得自己Python方面学的不够精想要继续学习的，想转行怕学不会的， 都可以加入我们，可领取最新Python大厂面试资料和Python爬虫、人工智能、学习资料！微信公众号【Python大本营】等你来玩奥~
感谢阅读😆

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Python工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Python开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Python开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip1024c （备注Python）

现在能在网上找到很多很多的学习资源，有免费的也有收费的，当我拿到1套比较全的学习资源之前，我并没着急去看第1节，我而是去审视这套资源是否值得学习，有时候也会去问一些学长的意见，如果可以之后，我会对这套学习资源做1个学习计划，我的学习计划主要包括规划图和学习进度表。

分享给大家这份我薅到的免费视频资料，质量还不错，大家可以跟着学习

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Python开发知识点，真正体系化！**

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip1024c （备注Python）
[外链图片转存中…(img-kB5SsBzk-1712861320340)]

现在能在网上找到很多很多的学习资源，有免费的也有收费的，当我拿到1套比较全的学习资源之前，我并没着急去看第1节，我而是去审视这套资源是否值得学习，有时候也会去问一些学长的意见，如果可以之后，我会对这套学习资源做1个学习计划，我的学习计划主要包括规划图和学习进度表。

分享给大家这份我薅到的免费视频资料，质量还不错，大家可以跟着学习

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
[外链图片转存中…(img-uA5Cuyov-1712861320340)]