Sterling Greene <******@****.***> 1773161724 -0400

Paco Xu <******@****.***> 1773399395 +0800

Yuri Schimke <******@****.***> 1773794932 +0000

Yicheng Luo <******@****.***> 1773781732 -0700

///

## Add `.gitignore` { #add-gitignore }

If you are using **Git** (you should), add a `.gitignore` file to exclude everything in your `.venv` from Git.

/// tip

<div class="termy">

```console
$ echo "*" > .venv/.gitignore
```

</div>

/// details | 上述命令的含义

* `echo "*"`: 将在终端中 "打印" 文本 `*`（接下来的部分会对这个操作进行一些修改）
* `>`: 使左边的命令打印到终端的任何内容实际上都不会被打印，而是会被写入到右边的文件中
* `.gitignore`: 被写入文本的文件的名称

而 `*` 对于 Git 来说意味着 "所有内容"。所以，它会忽略 `.venv` 目录中的所有内容。

该命令会创建一个名为 `.gitignore` 的文件，内容如下：

```gitignore
*
```

///

## 安装软件包 { #install-packages }

---> 100%
```

</div>

このコマンドは、pip がまだインストールされていなければ pip をインストールし、また、インストールされる pip のバージョンが `ensurepip` で利用可能なもの以上に新しいことも保証します。

///

## `.gitignore` を追加する { #add-gitignore }

**Git**を使用している場合（使用するべきでしょう）、 `.gitignore` ファイルを追加して、 `.venv` 内のあらゆるファイルをGitの管理対象から除外します。

/// tip | 豆知識

もし [`uv`](https://github.com/astral-sh/uv) を使用して仮想環境を作成した場合、すでにこの作業は済んでいるので、この手順をスキップできます 😎。

///

testing/integ-test/
version.txt
released-versions.json

# Dev setup
.idea                                   @gradle/bt-developer-productivity
.editorconfig                           @gradle/bt-developer-productivity
.gitignore                              @gradle/bt-developer-productivity
.gitattributes                          @gradle/bt-developer-productivity
gradle/                                 @gradle/bt-developer-productivity

        if block_language in {
            "python",
            "py",
            "sh",
            "bash",
            "dockerfile",
            "requirements",
            "gitignore",
            "toml",
            "yaml",
            "yml",
            "hash-style-comments",
        }:
            _line_a_code, line_a_comment = _split_hash_comment(line_a)

#### Exempt Files for Copyright Headers:

- Scripts critical to builds, CI, or deployment (e.g., `.kts`, `.groovy`).
- Auto-generated files (e.g., by code generators).
- Minor configuration files (e.g., `.gitignore`).
- Documentation samples and code snippets (e.g., `.java`, `.kt`, `.groovy`, `.kts`).
- Release notes (e.g., `.md`).
- READMEs (e.g., `.md`).

#### Copyright Header for Source Files:

```
/*