- Library API: the
fill_area
keyword parameter renamed tofill_cell
(#47) - CLI: the
-a
/--fill-area
option renamed to-c
/--fill-cell
(#47)
- CLI: errors caught when reading picture files are now being logged for later inspection (#45)
- support for Python 3.13
- support for Python 3.8
- support for PyPy 3.9
- Library API: the optional
bg_color
parameter toPictureShow.save_pdf
andpictures_to_pdf
to specify page background color (#29) - CLI: the
--bg-color
option to set page background color (#29)
- Library API: the
page_size
,landscape
,margin
,layout
,stretch_small
,fill_area
andforce_overwrite
parameters toPictureShow.save_pdf
are now keyword-only (#28)
- CLI: the
--fail
option to control the app's exit code depending on skipped files (#24)
- CLI: progress indicator (#21)
- saving pictures from URLs is no longer a tested feature
- CLI: use default prog name (#11)
- TESTS: use
tox
to run tests - switch from setup.py to pyproject.toml (#17)
- use src layout (#18)
- support for Python 3.12
- support for Python 3.7
- Library API: the
fill_area
parameter toPictureShow.save_pdf
andpictures_to_pdf
(#9) - CLI: the
--fill-area
option (#9)
- CLI: when invoked without command-line arguments, the message
Try 'pictureshow --help' for more information.
is now displayed (#7)
- CI/CD: build both sdist and wheel
- TESTS: switch from
PyPDF2
topypdf
- Library API: the
pdf_file
parameter ofPictureShow.save_pdf
andpictures_to_pdf
renamed tooutput_file
(#4) - TESTS: tests run concurrently using the pytest-xdist plugin
- CI/CD: code checked for security using bandit
- CLI:
- concise usage message
- options sorted alphabetically in help message
- available page sizes shown in help for
--page-size
- CLI: the output file must now be specified with the
-o
or--output-file
option - CI/CD: PyPA's action to publish package to PyPI is used in GitHub Actions
- remove Python 3.6 from supported versions, add Python 3.10
- CLI: if the output filename has no extension specified,
.pdf
will be appended to it
- CI/CD: steps added to GitHub Actions workflow:
- to publish package to PyPI
- to create GitHub release
- CLI: pictures do not have to be filesystem paths (can be e.g. URLs)
- Library API:
PictureShow.save_pdf
andpictures_to_pdf
now return a named tuple of three values:num_ok
: number of successfully saved pictureserrors
: list of items skipped due to errornum_pages
: number of pages of the resulting PDF document
- CLI: additional info reported: number of pages of the resulting PDF document
- TESTS: added tests for the command-line app
- Library API: comma is now allowed as delimiter when specifying layout as a string, e.g.
'2,3'
is equivalent to'2x3'
- CLI: comma is allowed as delimiter when specifying layout, e.g.
2,3
is equivalent to2x3
- Library API:
pdf_file
is now a required keyword-only argument of thepictures_to_pdf
function (all positional arguments are treated as input files)
- Library API: the
pdf_file
argument can now be specified either as a string (just like in the command line interface) or as a path-like object
- Library API: the
page_size
andlayout
arguments can now be specified either as a string (just like in the command line interface) or as a sequence of two numbers (for example,page_size='LETTER', layout='2x3'
is equivalent topage_size=(72 * 8.5, 72 * 11), layout=(2, 3)
) - CLI: error message includes the name of the underlying exception's class