4 Commits
1.0.2 ... 1.0.3

Author SHA1 Message Date
dccde1909b Release Version 1.0.3
### Fixed

- Fixed `show` command not working with Click version 8
- Fixed release message incorrectly stating if a commit will be created or not
2021-05-11 22:27:07 -07:00
c25b780772 Run tests with multiple versions of click
will be removed once click 8.0.0 reaches critical mass I guess?
2021-05-11 22:21:09 -07:00
bf2e8f670f Fix release messages 2021-05-11 22:13:50 -07:00
dc90731f3d Fix show command 2021-05-11 22:10:13 -07:00
5 changed files with 104 additions and 18 deletions

View File

@ -10,6 +10,7 @@ jobs:
strategy: strategy:
matrix: matrix:
python-version: [ 3.8, 3.9 ] python-version: [ 3.8, 3.9 ]
click-version: [ click~=7.0, click~=8.0 ]
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v2
@ -23,6 +24,7 @@ jobs:
run: | run: |
python -m pip install --upgrade pip python -m pip install --upgrade pip
python -m pip install flake8 python -m pip install flake8
python -m pip install ${{ matrix.click-version }}
- name: Install module - name: Install module
run: python -m pip install . run: python -m pip install .

View File

@ -2,6 +2,14 @@
All notable changes to this project will be documented in this file All notable changes to this project will be documented in this file
## Version 1.0.3 - 2021-05-12
### Fixed
- Fixed `show` command not working with Click version 8
- Fixed release message incorrectly stating if a commit will be created or not
## Version 1.0.2 - 2021-05-12 ## Version 1.0.2 - 2021-05-12
### Changed ### Changed

View File

@ -218,5 +218,70 @@ class TestRelease(unittest.TestCase):
self.assertEqual(repo.tags[0].name, '1.0.0') self.assertEqual(repo.tags[0].name, '1.0.0')
class TestShow(unittest.TestCase):
# noinspection PyShadowingNames
def setUp(self):
self.runner = CliRunner()
self.location = 'CHANGELOG.md'
self.log = yaclog.Changelog()
self.log.add_version(name='1.0.0').add_entry('- entry number 1')
self.log.add_version(name='Version 2.0.0').add_entry('- entry number 2', 'Added')
self.log.add_version(name='Three Point Oh').add_entry('entry number 3')
v = self.log.add_version(name='4.0.0 "Euclid"')
v.add_entry('- entry number 4')
v.add_entry('- entry number 5')
v.tags.append('TAGGED')
self.modes = {
'full': ([], lambda v, k: v.text(**k), '\n\n'),
'name': (['-n'], lambda v, k: v.name, '\n'),
'body': (['-b'], lambda v, k: v.body(**k), '\n\n'),
'header': (['-h'], lambda v, k: v.header(**k), '\n'),
}
def test_show_all(self):
"""Test showing all version information"""
with self.runner.isolated_filesystem():
self.log.write(self.location)
for mode, t in self.modes.items():
with self.subTest(mode, flags=t[0]):
check_result(self, result := self.runner.invoke(cli, ['show', '-a'] + t[0]))
self.assertEqual(t[2].join([t[1](v, {'md': False}) for v in self.log.versions]),
result.output.strip(), 'incorrect plaintext output')
check_result(self, result := self.runner.invoke(cli, ['show', '-am'] + t[0]))
self.assertEqual(t[2].join([t[1](v, {'md': True}) for v in self.log.versions]),
result.output.strip(), 'incorrect markdown output')
def test_show_version(self):
with self.runner.isolated_filesystem():
self.log.write(self.location)
for mode, t in self.modes.items():
with self.subTest(mode, flags=t[0]):
for version in self.log.versions:
check_result(self, result := self.runner.invoke(cli, ['show', version.name] + t[0]))
self.assertEqual(t[1](version, {'md': False}),
result.output.strip(), 'incorrect plaintext output')
check_result(self, result := self.runner.invoke(cli, ['show', version.name[-5:]] + t[0]))
self.assertEqual(t[1](version, {'md': False}),
result.output.strip(), 'incorrect plaintext output')
check_result(self, result := self.runner.invoke(cli, ['show', version.name, '-m'] + t[0]))
self.assertEqual(t[1](version, {'md': True}),
result.output.strip(), 'incorrect markdown output')
check_result(self, result := self.runner.invoke(cli, ['show', version.name[-5:], '-m'] + t[0]))
self.assertEqual(t[1](version, {'md': True}),
result.output.strip(), 'incorrect markdown output')
if __name__ == '__main__': if __name__ == '__main__':
unittest.main() unittest.main()

View File

@ -381,14 +381,15 @@ class Changelog:
def get_version(self, name: Optional[str] = None) -> VersionEntry: def get_version(self, name: Optional[str] = None) -> VersionEntry:
""" """
Get a version from the changelog by name Get a version from the changelog by name.
:param name: The name of the version to get, or `None` to return the most recent :param name: The name of the version to get, or `None` to return the most recent.
The first version with this value in its name is returned.
:return: The first version with the selected name :return: The first version with the selected name
""" """
for version in self.versions: for version in self.versions:
if version.name == name or name is None: if name in version.name or name is None:
return version return version
raise KeyError(f'Version {name} not found in changelog') raise KeyError(f'Version {name} not found in changelog')

View File

@ -59,24 +59,36 @@ def reformat(obj: Changelog):
click.echo(f'Reformatted changelog file at {obj.path}') click.echo(f'Reformatted changelog file at {obj.path}')
# noinspection PyShadowingNames
@cli.command(short_help='Show changes from the changelog file') @cli.command(short_help='Show changes from the changelog file')
@click.option('--all', '-a', 'all_versions', is_flag=True, help='Show the entire changelog.') @click.option('--all', '-a', 'all_versions', is_flag=True, help='Show the entire changelog.')
@click.option('--markdown/--txt', '-m/-t', default=False, help='Display as markdown or plain text.') @click.option('--markdown/--txt', '-m/-t', default=False, help='Display as markdown or plain text.')
@click.option('--full', '-f', 'str_func', flag_value=lambda v, k: v.text(**k), default=True, @click.option('--full', '-f', 'mode', flag_value='full', default=True,
help='Show version header and body.') help='Show version header and body.')
@click.option('--name', '-n', 'str_func', flag_value=lambda v, k: v.name, help='Show only the version name') @click.option('--name', '-n', 'mode', flag_value='name',
@click.option('--body', '-b', 'str_func', flag_value=lambda v, k: v.body(**k), help='Show only the version body.') help='Show only the version name')
@click.option('--header', '-h', 'str_func', flag_value=lambda v, k: v.preamble(**k), @click.option('--body', '-b', 'mode', flag_value='body',
help='Show only the version body.')
@click.option('--header', '-h', 'mode', flag_value='header',
help='Show only the version header.') help='Show only the version header.')
@click.argument('version_names', metavar='VERSIONS', type=str, nargs=-1) @click.argument('version_names', metavar='VERSIONS', type=str, nargs=-1)
@click.pass_obj @click.pass_obj
def show(obj: Changelog, all_versions, markdown, str_func, version_names): def show(obj: Changelog, all_versions, markdown, mode, version_names):
""" """
Show the changes for VERSIONS. Show the changes for VERSIONS.
VERSIONS is a list of versions to print. If not given, the most recent version is used. VERSIONS is a list of versions to print. If not given, the most recent version is used.
""" """
functions = {
'full': (lambda v, k: v.text(**k)),
'name': (lambda v, k: v.name),
'body': (lambda v, k: v.body(**k)),
'header': (lambda v, k: v.header(**k)),
}
str_func = functions[mode]
try: try:
if all_versions: if all_versions:
versions = obj.versions versions = obj.versions
@ -85,16 +97,14 @@ def show(obj: Changelog, all_versions, markdown, str_func, version_names):
else: else:
versions = [obj.get_version(name) for name in version_names] versions = [obj.get_version(name) for name in version_names]
except KeyError as k: except KeyError as k:
raise click.BadArgumentUsage(k) raise click.BadArgumentUsage(str(k))
except ValueError as v: except ValueError as v:
raise click.ClickException(v) raise click.ClickException(str(v))
kwargs = {'md': markdown, 'color': True} kwargs = {'md': markdown, 'color': True}
for v in versions: sep = '\n\n' if mode == 'body' or mode == 'full' else '\n'
text = str_func(v, kwargs) click.echo(sep.join([str_func(v, kwargs) for v in versions]))
click.echo(text)
click.echo('\n')
@cli.command(short_help='Modify version tags') @cli.command(short_help='Modify version tags')
@ -115,9 +125,9 @@ def tag(obj: Changelog, add, tag_name: str, version_name: str):
else: else:
version = obj.current_version() version = obj.current_version()
except KeyError as k: except KeyError as k:
raise click.BadArgumentUsage(k) raise click.BadArgumentUsage(str(k))
except ValueError as v: except ValueError as v:
raise click.ClickException(v) raise click.ClickException(str(v))
if add: if add:
version.tags.append(tag_name) version.tags.append(tag_name)
@ -153,7 +163,7 @@ def entry(obj: Changelog, bullets, paragraphs, section_name, version_name):
else: else:
version = obj.current_version(released=False, new_version=True) version = obj.current_version(released=False, new_version=True)
except KeyError as k: except KeyError as k:
raise click.BadArgumentUsage(k) raise click.BadArgumentUsage(str(k))
for p in paragraphs: for p in paragraphs:
version.add_entry(p, section_name) version.add_entry(p, section_name)
@ -247,7 +257,7 @@ def release(obj: Changelog, version_name, rel_seg, pre_seg, commit):
tracked = len(repo.index.diff(repo.head.commit)) tracked = len(repo.index.diff(repo.head.commit))
untracked = len(repo.index.diff(None)) untracked = len(repo.index.diff(None))
message = [['Commit and create tag', 'Create tag'][min(tracked, 1)], 'for'] message = [['Create tag', 'Commit and create tag'][min(tracked, 1)], 'for']
if not cur_version.released: if not cur_version.released:
message.append('non-release') message.append('non-release')