Skip to content

Conversation

lagru
Copy link
Member

@lagru lagru commented Jun 6, 2025

Closes #59

Both CLI option and config field allow ignoring directories or files in the package directory that docstub is invoked on.

Release note

Add new command line option `--ignore` and config option `ignore_files`.
Both allow ignoring directories or files in the package directory that
docstub is invoked on.
{label="enhancement"}
Add a reference document for the configuration file.
{label="documentation"}

@lagru lagru added this to the v0.4 milestone Jun 6, 2025
@lagru lagru added documentation Improvements or adds to documentation enhancement New feature or functionality labels Jun 6, 2025
lagru added 8 commits June 6, 2025 13:31
because it isn't available in earlier versions.
Windows uses different path separators of course, so there is no easy
way to get this doctest working on both platforms. Instead let's just
skip this...
Comment on lines +8 to +10
Files: src/docstub/_vendored/stdlib.py
Copyright: 2001-2025, Python Software Foundation
License: PSF-2.0
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@stefanv could I ask you to take a look if I handled the license situation correctly here? I'd like to vendor Python's glob.translate which is only available from 3.13 onward.

I'm also not sure if need to adapt the SPDX license identifier in the pyproject.toml since the vendored part now uses a different one. 🤔

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've been starting to use the SPDX identifiers. There is now a new PEP that allows you to use a specifier+file in pyproject.toml.

Your file seems to be formatted roughly correctly according to https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#stanzas, except for the dashes.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks that helps. I made use of that in 0c7dfc1 and c2cc8e5.

@lagru lagru merged commit 2bd7076 into main Jul 17, 2025
7 checks passed
@lagru lagru deleted the glob-ignore-files branch July 17, 2025 11:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or adds to documentation enhancement New feature or functionality
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Allow excluding files
2 participants