aio-libs / aio-libs/sphinxcontrib-asyncio

Ownership of `sphinxcontrib/__init__.py`

Abierto
#12 3 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
Python
Estrellas
21
Forks
5
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

This project installs a file to the parent namespace, `sphinxcontrib/__init__.py`. In Fedora, this has [caused a problem for us](https://bugzilla.redhat.com/show_bug.cgi?id=2036438), because sphinxcontrib-zopeext does likewise, and the two files differ. I brought this up on the Fedora developer's mailing list, and Elliott Sales de Andrade has this to say:

```
I think these packages are wrong upstream. The `sphinxcontrib` directory is provided by python3-sphinx, and it specifically doesn't have `__init__.py` there. Those extensions should not be adding one, so as to keep the implicit namespace package nature of that directory: https://packaging.python.org/en/latest/guides/packaging-namespace-packages/#native-namespace-packages

By the contents of the files, it appears they are trying to force it to be a pkg_resources-style namespace package: https://packaging.python.org/en/latest/guides/packaging-namespace-packages/#pkg-resources-style-namespace-packages

But since Sphinx didn't do that in the first place, there's no guarantee that other packages will contain `__init__.py` (and indeed most do not).
```

Does sphinxcontrib-asyncio need that `__init__.py` file for some reason?

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.