Skip to content

adodbapi: improve module docstrings, top-of-file comments and version infos#2347

Open
Avasam wants to merge 12 commits intomhammond:mainfrom
Avasam:adodbapi--improve-docstrings-and-top-of-file-comments
Open

adodbapi: improve module docstrings, top-of-file comments and version infos#2347
Avasam wants to merge 12 commits intomhammond:mainfrom
Avasam:adodbapi--improve-docstrings-and-top-of-file-comments

Conversation

@Avasam
Copy link
Collaborator

@Avasam Avasam commented Jul 29, 2024

@vernondcole Pretty safe PR affecting documentation and will reduce changes in other PRs as well.

@Avasam Avasam requested a review from vernondcole July 29, 2024 19:49
@Avasam Avasam force-pushed the adodbapi--improve-docstrings-and-top-of-file-comments branch from c237be5 to 9157292 Compare July 29, 2024 20:24
@Avasam Avasam changed the title adodbapi: improve docstrings and top-of-file comments adodbapi: improve module docstrings, top-of-file comments and version infos Aug 5, 2024
@Avasam Avasam force-pushed the adodbapi--improve-docstrings-and-top-of-file-comments branch from 8355561 to 4cf15f9 Compare October 4, 2024 21:19
Copy link
Owner

@mhammond mhammond left a comment

Choose a reason for hiding this comment

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

Can we future proof this a little more? tbh, just removing it seems fine, we don't feel the need to make this declaration for any other package - I think reasonable people would assume it is supported by all Python versions supported by the repo.

"""adodbapi - a pure Python PEP 249 DB-API package using Microsoft ADO

Adodbapi can be run on CPython 3.8 and later.
Adodbapi can be run on CPython 3.9 and later.
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@mhammond did you mean to aim the following comment at this file/line?

#2347 (review)

Can we future proof this a little more? tbh, just removing it seems fine, we don't feel the need to make this declaration for any other package - I think reasonable people would assume it is supported by all Python versions supported by the repo.

If so, I agree. Anyway as long as adodbapi is distributed by pywin32, this setuptools config file goes pretty much unused (though it is usable, by running pip install ./adodbapi).
And even if adodbapi was to be distributed as its own distribution on PyPI, it would be better declared through packaging metadata.

Suggested change
Adodbapi can be run on CPython 3.9 and later.

@Avasam Avasam requested a review from mhammond November 26, 2025 18:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants