Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 916265

Summary: package man pages to python wheels
Product: Portage Development Reporter: Freed <Wuzy01>
Component: Enhancement/Feature RequestsAssignee: Portage team <dev-portage>
Status: UNCONFIRMED ---    
Severity: normal    
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Freed 2023-10-25 15:09:58 UTC
python allow developers package some data file into wheels. For example,

If developer uses `setuptools`, they can

```
# pyproject.toml
[tool.setuptools.data-files]
"share/applications" = ["/the/path/of/XXX.desktop"]
"share/icons/hicolor/36x36/apps" = ["the/path/of/icon.png"]
"share/man/man1" = ["/the/path/of/foo.1"]
"share/bash-completion/completions" = ["/the/path/of/bash_completion.sh"]
"share/zsh/site-functions" = ["/the/path/of/_zsh_completion"]
```

Then user `pip install --user foo` will get:

- `~/.local/lib/python3.10/site-packages/foobar`
- `~/.local/share/applications/XXX.desktop`
- `~/.local/share/icons/hicolor/36x36/apps/icon.png`
- `~/.local/share/man/man1/foo.1`
- `~/.local/share/bash-completion/completions/bash_completion.sh`
- `~/.local/share/zsh/site-functions/_zsh_completion`

Although portage use `meson-python`, It still support [this feature](https://meson-python.readthedocs.io/en/latest/reference/limitations.html#non-package-data-files). How about packaging man pages into wheel?