45 lines
1.2 KiB
Text
45 lines
1.2 KiB
Text
|
Running img2pdf from source
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
img2pdf can be run directly from the cloned git repository:
|
||
|
|
|
||
|
|
$ python3 src/img2pdf.py img.jpg -o out.pdf
|
||
|
|
|
||
|
|
Running the testsuite
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
$ python3 setup.py test
|
||
|
|
|
||
|
|
Fixing the testsuite
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
Sometimes your changes will break the testsuite. The testsuite works by
|
||
|
|
comparing the images found in `src/tests/input` with the corresponding PDF
|
||
|
|
documents in `src/tests/output`. The filename of the output file will be the
|
||
|
|
same name the input has with the `.pdf` suffix appended to it. To generate the
|
||
|
|
files in the `src/tests/output` directory via the command line, run:
|
||
|
|
|
||
|
|
$ src/img2pdf.py --producer="" --nodate src/tests/input/normal.jpg -o src/tests/output/normal.jpg.pdf
|
||
|
|
|
||
|
|
This makes it easier to spot where the differences are and how to fix the
|
||
|
|
issue.
|
||
|
|
|
||
|
|
Making a new release
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
- Add a new entry to CHANGES.rst
|
||
|
|
- Bump VERSION in setup.py
|
||
|
|
- Bump __version__ in src/img2pdf.py
|
||
|
|
- Commit:
|
||
|
|
|
||
|
|
$ git commit -m "release version X.Y.Z"
|
||
|
|
|
||
|
|
- Add git tag:
|
||
|
|
|
||
|
|
$ git tag X.Y.Z
|
||
|
|
|
||
|
|
- Build and upload to pypi:
|
||
|
|
|
||
|
|
$ python3 setup.py sdist bdist_wheel
|
||
|
|
$ twine upload --sign dist/*
|