Metadata-Version: 2.3
Name: nemo-annotation
Version: 0.1.0
Summary: An annotation extension for Nemo.
Author: Flynn
Author-email: Flynn <leisure-zyf@qq.com>
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# Nemo Annotation

> An annotation extension for Nemo.

## Installation

```sh
pip install nemo_annotation
```

```sh
uv add nemo_annotation
```

## Usage

```sh
[uv run] python -m nemo_annotation install[uninstall]
nemo -q && nemo
```

## Current System Environment

| Item | Version / Path | Notes |
|------|---------------|-------|
| Distribution | Ubuntu (Mint 22 "Zena" family) | `nemo` version carries `+zena` |
| System Python | 3.12.3 | `/usr/bin/python3` |
| Nemo core | 6.6.3+zena | The file manager itself |
| nemo-python | 6.0.0+ds-1build3 | Python bindings, packaged by Ubuntu |
| nemo-python maintainer | Debian Cinnamon Team | Upstream is Linux Mint |
| nemo-python homepage | https://github.com/linuxmint/nemo-extensions/ | Source repository |

## Dependencies

| Package | Version requirement | Purpose |
|---------|--------------------|---------|
| `gir1.2-nemo-3.0` | >= 4.6~ | GObject Introspection data for Nemo |
| `python3-gi` | — | System PyGObject (runtime) |
| `libnemo-extension1` | >= 4.6~ | Nemo extension C shared library |
| `libgtk-3-0t64` | >= 3.0.0 | GTK3 runtime |
| `libpython3.12t64` | >= 3.12.1 | Python 3.12 runtime |

## Version Compatibility Check

| Check | Result | Conclusion |
|-------|--------|------------|
| Nemo core range required by `nemo-python` | `>= 4.6~` | 6.6.3 satisfies |
| Current Nemo core | 6.6.3 | Above minimum requirement |
| Documentation source | Installed with the `nemo-python 6.0.0` package | Matches the bindings |
| Documentation vs. runtime API | Core interfaces stable | Usable |

## GTK-Doc Documentation Location

```bash
/usr/share/gtk-doc/html/nemo-python/
```

Covered classes:

- `class-nemo-python-column.html`
- `class-nemo-python-column-provider.html`
- `class-nemo-python-file-info.html`
- `class-nemo-python-info-provider.html`
- `class-nemo-python-location-widget-provider.html`
- `class-nemo-python-menu.html`
- `class-nemo-python-menu-item.html`
- `class-nemo-python-menu-provider.html`
- `class-nemo-python-property-page.html`
- `class-nemo-python-property-page-provider.html`
- `enum-nemo-python-operation-result.html`

## Development Environment

| Item | Value |
|------|-------|
| Project directory | `~/桌面/nemo-meta/` |
| Virtual environment | `.venv` (managed by uv, based on system Python 3.12.3) |
| IDE type stubs | `pygobject-stubs` + custom `Nemo.pyi` |
| Extension install path | `~/.local/share/nemo-python/extensions/` |
| Debugging method | `TMPDIR=/tmp/testing nemo --no-desktop` |

## Key Version Risks

| Risk | Notes |
|------|-------|
| `nemo-python` 6.0.0 vs `nemo` 6.6.3 | Bindings lag behind the core, but the dependency declaration is compatible |
| Multiple versions in between | 6.0 → 6.2 → 6.4 → 6.6; core extension interfaces (Provider) are stable |
| Want the latest API | Check the `.c` sources at the corresponding tag (e.g. 6.6.3) on GitHub |



### Notes

- **`nemo-python` 6.0.0** is the version packaged in the Ubuntu repositories. Its dependency declaration `>= 4.6~` means it is compatible with Nemo core 4.6 and above; your 6.6.3 satisfies this.
- **The documentation version matches the bindings** — both come from the `nemo-python 6.0.0` package, so it is safe to use for generating `.pyi` stubs.
- **For the latest upstream source**, look on GitHub for the `6.6.3` tag or similar, since the system bindings lag behind the core.
