File: GEMINI.md

package info (click to toggle)
cmd2 3.2.0%2Bds-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 2,664 kB
  • sloc: python: 17,488; makefile: 114; sh: 39; javascript: 7
file content (38 lines) | stat: -rw-r--r-- 1,280 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# Instructions for Gemini CLI in a `uv` Python project

This `GEMINI.md` file provides context and instructions for the Gemini CLI when working with this
Python project, which utilizes `uv` for environment and package management.

## General Instructions

- **Environment Management:** Prefer using `uv` for all Python environment management tasks.
- **Package Installation:** Always use `uv` to install packages and ensure they are installed within
  the project's virtual environment.
- **Running Scripts/Commands:**
    - To run Python scripts within the project's virtual environment, use `uv run ...`.
    - To run programs directly from a PyPI package (installing it on the fly if necessary), use
      `uvx ...` (shortcut for `uv tool run`).
- **New Dependencies:** If a new dependency is required, please state the reason for its inclusion.

## Python Code Standards

To ensure Python code adheres to required standards, the following commands **must** be run before
creating or modifying any `.py` files:

```bash
make check
```

To run unit tests use the following command:

```bash
make test
```

To make sure the documentation builds properly, use the following command:

```bash
make docs-test
```

All 3 of the above commands should be run prior to committing code.