Add --gh and --section flags to "blurb add"

[hugovk]

Fixes#6.

Updated version of python/core-workflow#312 but with --gh instead of --bpo.

Examples

Success cases

blurb add opens the usual empty template

#
# Please enter the relevant GitHub issue number here:
#
.. gh-issue: #
# Uncomment one of these "section:" lines to specify which section
# this entry should go in in Misc/NEWS.d.
#
#.. section: Security
#.. section: Core and Builtins
#.. section: Library
#.. section: Documentation
#.. section: Tests
#.. section: Build
#.. section: Windows
#.. section: macOS
#.. section: IDLE
#.. section: Tools/Demos
#.. section: C API
# Write your Misc/NEWS.d entry below. It should be a simple ReST paragraph.
# Don't start with "- Issue #<n>: " or "- gh-issue-<n>: " or that sort of stuff.
###########################################################################

blurb add --gh 123456 opens the template with gh-issue filled in

#
# Please enter the relevant GitHub issue number here:
#
.. gh-issue: 123456
#
# Uncomment one of these "section:" lines to specify which section
# this entry should go in in Misc/NEWS.d.
#
#.. section: Security
#.. section: Core and Builtins
#.. section: Library
#.. section: Documentation
#.. section: Tests
#.. section: Build
#.. section: Windows
#.. section: macOS
#.. section: IDLE
#.. section: Tools/Demos
#.. section: C API
# Write your Misc/NEWS.d entry below. It should be a simple ReST paragraph.
# Don't start with "- Issue #<n>: " or "- gh-issue-<n>: " or that sort of stuff.
###########################################################################

blurb add --section Security adds an uncommented section

#
# Please enter the relevant GitHub issue number here:
#
.. gh-issue: #
# Uncomment one of these "section:" lines to specify which section
# this entry should go in in Misc/NEWS.d.
#
#.. section: Security
#.. section: Core and Builtins
#.. section: Library
#.. section: Documentation
#.. section: Tests
#.. section: Build
#.. section: Windows
#.. section: macOS
#.. section: IDLE
#.. section: Tools/Demos
#.. section: C API
.. section: Security
# Write your Misc/NEWS.d entry below. It should be a simple ReST paragraph.
# Don't start with "- Issue #<n>: " or "- gh-issue-<n>: " or that sort of stuff.
###########################################################################

blurb add --gh 123456 --section Security adds both

#
# Please enter the relevant GitHub issue number here:
#
.. gh-issue: 123456
#
# Uncomment one of these "section:" lines to specify which section
# this entry should go in in Misc/NEWS.d.
#
#.. section: Security
#.. section: Core and Builtins
#.. section: Library
#.. section: Documentation
#.. section: Tests
#.. section: Build
#.. section: Windows
#.. section: macOS
#.. section: IDLE
#.. section: Tools/Demos
#.. section: C API
.. section: Security
# Write your Misc/NEWS.d entry below. It should be a simple ReST paragraph.
# Don't start with "- Issue #<n>: " or "- gh-issue-<n>: " or that sort of stuff.
###########################################################################

Error cases

❯ blurb add --gh SecurityError: blurb add --gh argument Security is not a valid integer!
❯ blurb add --section 123456Error: blurb add --section argument '123456' is not a valid section! Use one of:SecurityCore and BuiltinsLibraryDocumentationTestsBuildWindowsmacOSIDLETools/DemosC API
❯ blurb add --gh Security --section 123456Error: blurb add --gh argument Security is not a valid integer!

[hugovk]

pyfakefs doesn't yet support Python 3.13 (pytest-dev/pyfakefs#1017), let's temporarily remove it from the CI.

[picnixz]

Aaaah I was writing it as well! I have an alternative where you can add something like blurb add -i 12345 -s 2 instead of writing the section name. But I did not have your alternative with --gh and --section.

@hugovk I have an alternative with tests and a bit more checks, could I also post it?

[hugovk]

@picnixz Yes, please do :)

[hugovk]

Closing in favour of #16.