Can't include a folder that is a subfolder of one excluded by gitignore

• OS version and name: Arch Linux
• Poetry version: 1.0.10

Relevant part of pyproject.toml:

[tool.poetry]
authors = ["<...>"]
description = "Solution preparation optimization."
exclude = ["examples/*.xlsx", "src/preppy/z_*"]
include = ["docs/_build/latex/*.pdf", "docs/_build/html/", "examples/*.toml"]
name = "preppy"
readme = "README.md"
version = "0.1.18"

Relevant lines in .gitignore:

# Sphinx documentation
docs/_build/

With the above configuration, my pdf documentation, docs/_build/latex/preppy.pdf, is included, but the docs/_build/html/ folder is not. If I change the include to…

include = ["docs/_build/latex/*.pdf", "docs/_build/html/*html", "examples/*.toml"]

…it does include the various *.html files, but this isn’t sufficient as there are other artifacts and subfolders in html I also wish to include.

I thought maybe the issue was my syntax, so I tried the following variations, which didn’t work either:

include = ["docs/_build/latex/*.pdf", "docs/_build/html", "examples/*.toml"]

include = ["docs/_build/latex/*.pdf", "docs/_build/html/*", "examples/*.toml"]

It seems as if there is some issue in including a folder (but not a file or group of files) that is a subfolder of one ignored by .gitignore.

[finswimmer]

Hello @multipitch ,

currently poetry does not include a folder recursive (while it does for export). You can do it by using this patter: "docs/_build/html/**/*"

fin swimmer

[ppena-LiveData]

Usually built files are files that are meant to be included in a distributed package but not included in version control, so I find this behavior very counterintuitive. If Poetry is going to continue to exclude VCS-ignored files, then at the minimum, the documentation should be REALLY explicit about that and have an example that includes something like build/**/*, since Path.glob()'s ** is quite confusing, and all the built files (including under subdirectories) are usually what someone would want to include.