Mercurial > p > roundup > code
annotate RELEASE.txt @ 8106:47f0a4eba1b2
fix: fix key for broken translation template in admin.py
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Wed, 07 Aug 2024 21:11:13 -0400 |
| parents | e3c5f85af7d5 |
| children | 3283f30623d0 |
| rev | line source |
|---|---|
| 1354 | 1 Building Releases |
| 2 ================= | |
|
98
16dcdab5ce70
Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
3 |
| 4807 | 4 Roundup is a pure Python application with no binary components. This file |
| 5 describes how to build a source release. To find out how to install | |
| 6 Roundup, read the doc/installation.txt file. | |
|
98
16dcdab5ce70
Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
7 |
| 4807 | 8 Roundup release checklist: |
|
98
16dcdab5ce70
Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
9 |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
10 1. Regenerate locale/roundup.pot. See "Extracting Translatable |
|
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
11 Messages" in doc/developers.txt. This is best done some time in |
|
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
12 advance of the release to allow for translators to update their |
|
5841
f2804ec3bd06
issue2551007 document merging .pot files into .po file and
John Rouillard <rouilj@ieee.org>
parents:
5835
diff
changeset
|
13 translations. Merge into .po files by running 'make *.po' |
|
6224
3cf5bcf2bb5c
Update commands needed for locale updates.
John Rouillard <rouilj@ieee.org>
parents:
6137
diff
changeset
|
14 in the locale directory. Run: |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
15 |
|
6453
3e7fc096fe5b
add cd commands for better cut/paste.
John Rouillard <rouilj@ieee.org>
parents:
6451
diff
changeset
|
16 cd locale |
|
7423
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
17 make merge |
|
6453
3e7fc096fe5b
add cd commands for better cut/paste.
John Rouillard <rouilj@ieee.org>
parents:
6451
diff
changeset
|
18 cd .. |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
19 |
|
7423
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
20 'make merge' will remake template if the source and html files are |
|
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
21 out of date. 'make template' will regenerate roundup.pot. Touch |
|
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
22 any .py file in the roundup/ directory to force 'make template' |
|
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
23 to run. |
|
f6bad20ef102
Document use of new make merge.
John Rouillard <rouilj@ieee.org>
parents:
7227
diff
changeset
|
24 |
|
6297
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
25 2. Run unit tests! They should pass successfully. Install pytest |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
26 using pip2/pip3 for python2 and python3. Then invoke pytest |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
27 using both python versions from the top of the roundup tree: |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
28 |
|
6297
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
29 python3 -m pytest test/ |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
30 python2 -m pytest test/ |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
31 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
32 3. Update version in: |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
33 CHANGES.txt (set date for version as well) |
|
4815
efa61cc8be67
RELEASE.txt: doc/upgrading.txt needs to be updated too
anatoly techtonik <techtonik@gmail.com>
parents:
4809
diff
changeset
|
34 roundup/__init__.py |
|
7468
f100f5fdf6bf
Autmatically get version and release from roundup/__init__.py
John Rouillard <rouilj@ieee.org>
parents:
7435
diff
changeset
|
35 website/www/index.txt (current stable version, release highlights) |
| 7529 | 36 website/www/conf.py (update copyright, version auto-set from |
| 37 roundup/__init__.py) | |
| 38 scripts/Docker/Dockerfile update value of | |
| 39 org.opencontainers.image.version | |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
40 3a. Update license end date in COPYING.txt |
|
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
41 3b. Update doc/acknowledgements.txt (add section for |
|
5835
ad5cae31cd0f
Fix typos and add build step.
John Rouillard <rouilj@ieee.org>
parents:
5776
diff
changeset
|
42 release, churn contributers etc.). (Use hg churn -c -r ####..####) |
|
6697
ff0b3402fa73
add blank line to separate section.
John Rouillard <rouilj@ieee.org>
parents:
6695
diff
changeset
|
43 |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
44 4. Update documentation |
|
4815
efa61cc8be67
RELEASE.txt: doc/upgrading.txt needs to be updated too
anatoly techtonik <techtonik@gmail.com>
parents:
4809
diff
changeset
|
45 doc/announcement.txt |
|
efa61cc8be67
RELEASE.txt: doc/upgrading.txt needs to be updated too
anatoly techtonik <techtonik@gmail.com>
parents:
4809
diff
changeset
|
46 doc/upgrading.txt |
|
7941
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
47 |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
48 Use:: |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
49 |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
50 sed -ne '/^20[0-9][0-9]-XX/,/^202[0-9]-/{/^-/p}' CHANGES.txt | wc -l |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
51 |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
52 to get number of features/fixes included in the release. |
|
d272c828d376
doc: add sed command to extract number of changes in a release.
John Rouillard <rouilj@ieee.org>
parents:
7939
diff
changeset
|
53 |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
54 4a. cd to website/www and run 'make linkcheck'. See output in |
|
5374
488d44cb42ef
add running linkcheck to update docs
John Rouillard <rouilj@ieee.org>
parents:
5358
diff
changeset
|
55 _tmp/linkcheck/output.txt |
|
488d44cb42ef
add running linkcheck to update docs
John Rouillard <rouilj@ieee.org>
parents:
5358
diff
changeset
|
56 fix broken references in docs |
|
488d44cb42ef
add running linkcheck to update docs
John Rouillard <rouilj@ieee.org>
parents:
5358
diff
changeset
|
57 verify redirects are correct |
|
6697
ff0b3402fa73
add blank line to separate section.
John Rouillard <rouilj@ieee.org>
parents:
6695
diff
changeset
|
58 |
|
7962
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
59 Use:: |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
60 |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
61 grep '\[broken\]\s*htt' _tmp/linkcheck/output.txt |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
62 |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
63 to find external refs only. Internal refs will probably fail |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
64 because they don't use :ref: or :doc: roles to reference them. |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
65 They are referenced using html link syntax. |
|
828f79ae965b
doc: update links and docs on checking links
John Rouillard <rouilj@ieee.org>
parents:
7941
diff
changeset
|
66 |
|
5941
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
67 5. Update setup.py info if needed (contacts, classifiers, etc.). When |
|
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
68 releasing check that Development Status matches release: stable, |
|
8069
4f07d7835019
build: some work from RELEASE.txt for 2.4.0 release.
John Rouillard <rouilj@ieee.org>
parents:
8050
diff
changeset
|
69 beta, alpha etc. |
|
5941
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
70 |
|
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
71 Check that metadata is valid and long descriptions is proper reST: |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
72 |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
73 python3 setup.py check --restructuredtext --metadata --strict |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
74 |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
75 6. Clean out all *.orig, *.rej, .#* files from the source. |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
76 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
77 find . -name '*.orig' -exec rm {} \; |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
78 find . -name '*.rej' -exec rm {} \; |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
79 find . -name '.#*' -exec rm {} \; |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
80 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
81 6a. Rebuild .mo translation files in distribution |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
82 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
83 cd locale |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
84 make |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
85 cd .. |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
86 |
|
5520
0036f4a7bf2a
Mention regenerating roundup.pot in release instructions.
Joseph Myers <jsm@polyomino.org.uk>
parents:
5374
diff
changeset
|
87 7. Remove previous build files |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
88 |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
89 python3 setup.py clean --all |
|
6225
043a8ffd79ad
Commits for roundup 2.0 release.
John Rouillard <rouilj@ieee.org>
parents:
6224
diff
changeset
|
90 rm -rf build/share # deletes locale .mo files |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
91 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
92 Build including new .mo files built in 6a. |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
93 |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
94 python3 setup.py build |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
95 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
96 (sdist generation will fail if this isn't done) |
|
6697
ff0b3402fa73
add blank line to separate section.
John Rouillard <rouilj@ieee.org>
parents:
6695
diff
changeset
|
97 |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
98 8. Rebuild documentation in "share/doc/roundup/html" |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
99 |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
100 python3 setup.py build_doc |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
101 |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
102 9. Generate source distribution: |
|
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
103 |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
104 python3 setup.py sdist |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
105 |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
106 (if you find sdist a little verbose, add "--quiet" to the end of the |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
107 command) |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
108 9a. 2021/04/17 skip this for now. Need to make sure that whl installs |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
109 executable scripts properly and update these directions to test. |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
110 |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
111 python2 setup.py bdist_wheel; python3 setup.py bdist_wheel |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
112 |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
113 to create binary distributions in wheel format. (egg format is |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
114 deprecated.) |
| 6695 | 115 |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
116 10. Check the roundup.egg-info/SOURCES.txt to make sure that any new files are |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
117 included. (use hg status --rev <last release or tag>:tip to list changed |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
118 added and removed files. Last release e.g. 1.5.1 where tip is what would |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
119 become 1.6) E.G. |
|
5951
0a42163ac846
Final doc fixes and translation extraction.
John Rouillard <rouilj@ieee.org>
parents:
5941
diff
changeset
|
120 |
|
7530
ed2bc951277b
Updates for 2.3.0 release.
John Rouillard <rouilj@ieee.org>
parents:
7529
diff
changeset
|
121 hg status --rev 2.2.0:tip | sed -ne 's/^A //p' | while read i ; \ |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
122 do echo $i; grep "$i" roundup.egg-info/SOURCES.txt; done | \ |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
123 uniq -c | sort -rn |
|
5951
0a42163ac846
Final doc fixes and translation extraction.
John Rouillard <rouilj@ieee.org>
parents:
5941
diff
changeset
|
124 |
|
6137
eb9d00db0923
Forgot to check in changed doc files for 2.0.0beta0
John Rouillard <rouilj@ieee.org>
parents:
5954
diff
changeset
|
125 Anything with a count of 1 is not in the manifest. |
|
6225
043a8ffd79ad
Commits for roundup 2.0 release.
John Rouillard <rouilj@ieee.org>
parents:
6224
diff
changeset
|
126 If there are missing files that should be in the manifest, |
|
6137
eb9d00db0923
Forgot to check in changed doc files for 2.0.0beta0
John Rouillard <rouilj@ieee.org>
parents:
5954
diff
changeset
|
127 edit MANIFEST.in to include them. For format docs see |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
128 https://packaging.python.org/guides/using-manifest-in/#using-manifest-in |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
129 (Note: files under website/ shouldn't be in the manifest.) |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
130 10a: Check for removed files still in manifest: |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
131 |
|
7530
ed2bc951277b
Updates for 2.3.0 release.
John Rouillard <rouilj@ieee.org>
parents:
7529
diff
changeset
|
132 hg status --rev 2.2.0:tip | sed -ne 's/^R //p' | while read i ; \ |
|
6451
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
133 do echo $i; grep "$i" roundup.egg-info/SOURCES.txt; done | \ |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
134 uniq -c | sort -n |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
135 |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
136 any file with a count of 2 or more needs to be removed from |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
137 MANIFEST.in and possibly cleaned out of the build tree. |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
138 10b: if you added/removed files rebuild starting at step 6a. |
|
bb561a8b179f
python -> python3, check removed files; baseline from 2.0.0
John Rouillard <rouilj@ieee.org>
parents:
6439
diff
changeset
|
139 |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
140 11. Unpack the new tarball created in dist/roundup-<version>.tar.gz |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
141 file in /tmp then |
|
6297
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
142 a) run tests using installed pytest run under python2 and |
|
a635a60ffb84
Remove standalone pytest run_tests.py bundle
John Rouillard <rouilj@ieee.org>
parents:
6265
diff
changeset
|
143 python3. (python2 -m pytest test/; python3 -m pytest test/) |
|
4834
8a4021713c6e
RELEASE: Add PyPI page review to the checklist.
anatoly techtonik <techtonik@gmail.com>
parents:
4815
diff
changeset
|
144 b) demo.py |
|
1947
0e19e99075e3
fix #white in cgitb
Richard Jones <richard@users.sourceforge.net>
parents:
1939
diff
changeset
|
145 with all available Python versions. |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
146 11a. (TBD how to test wheel binary distribution before uploading.) |
|
6697
ff0b3402fa73
add blank line to separate section.
John Rouillard <rouilj@ieee.org>
parents:
6695
diff
changeset
|
147 |
| 7529 | 148 11b. Generate GPG signature file |
| 149 | |
| 150 cd dist | |
| 151 gpg --detach-sign --armor -u 1F2DD0CB756A76D8 <filename>.tar.gz | |
| 152 | |
| 153 you should be prompted to use the roundup release key. If not you | |
| 154 can add --local=roundup-devel@lists.sourceforge.net. | |
| 155 This will create a file by the name <filename>.tar.gz.asc. | |
| 156 | |
| 157 Move file to website/www/signature directory | |
| 158 | |
| 8076 | 159 mv <filename>.tar.gz.asc ../website/www/signatures/. |
| 7529 | 160 hg add ../website/www/signature/<filename>.tar.gz.asc |
| 161 # commiting the file will be done in step 12 | |
| 162 cd .. | |
| 163 | |
| 164 Add a link to the signature to doc/security.txt. Add a new link | |
| 165 to the start of the signature list in doc/security.txt (look for | |
| 166 the word multicol). | |
| 167 | |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
168 12. Assuming all is well commit and tag the release in the version-control |
|
5358
adf1061f15a6
Update docs on how to tag with mercurial.
John Rouillard <rouilj@ieee.org>
parents:
5357
diff
changeset
|
169 system. |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
170 a) hg commit ... # commit any edits from steps 1-5 |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
171 b) hg tag 2.1.0 # use right version. Should create/commit a changeset |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
172 c) hg push # update main repo |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
173 d) hg sum # verify that the tag shows up |
|
6697
ff0b3402fa73
add blank line to separate section.
John Rouillard <rouilj@ieee.org>
parents:
6695
diff
changeset
|
174 |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
175 13. Upload source distribution to PyPI - requires you sign up for a |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
176 pypi account and be added as a maintainer to roundup. Ask existing |
| 7529 | 177 maintainer for access. Do this using twine (pip install twine). |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
178 |
|
7428
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
179 The original directions used twine to upload the tarball and the |
|
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
180 signature, but as of May 2023, PyPI no longer accepts signature |
| 7529 | 181 files. So we publish the signature as part of the website. |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
182 |
|
7428
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
183 Use twine to upload the distribution tarball. E.G. |
|
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
184 |
|
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
185 twine upload --repository pypi <filename>.tar.gz |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
186 |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
187 The distribution file should appear on |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
188 https://pypi.python.org/pypi/roundup in no time. If you are using |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
189 python older than 2.7.13 you need a .pypirc shown below since the |
|
7428
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
190 URL has changed. |
|
6378
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
191 |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
192 You can also use twine to upload the .whl (wheel) format |
|
b57c3d50505b
issue2550899 Migrate setup.py to setuptools
John Rouillard <rouilj@ieee.org>
parents:
6297
diff
changeset
|
193 distributions (if created). Follow the directions for generating |
|
7428
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
194 the gpg asc files and place the .whl.asc in the signature |
|
186956a87ad7
issue2551279 - GPG support removed from pypi - rewrite pgp signature validation.
John Rouillard <rouilj@ieee.org>
parents:
7423
diff
changeset
|
195 directory. |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
196 |
| 7529 | 197 Another way to upload is to use: |
| 198 | |
| 199 python3 setup.py sdist upload --repository pypi | |
| 200 | |
| 201 BUT this rebuilds the source distribution tarball and uploads it. | |
| 202 This means that you have uploaded something that is not tested. | |
| 203 Also the metadata in the file changes and will not match the GPG | |
| 204 signature you commited in step 12. So use twine. | |
| 205 | |
|
6748
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
206 14. Refresh website. |
|
4836
fdcd7ef5bacf
RELEASE.txt: +website update
anatoly techtonik <techtonik@gmail.com>
parents:
4835
diff
changeset
|
207 website/README.txt |
|
6265
b2eb59ada444
Replace http:....roundup-tracker.org with https. Also fix wiki links.
John Rouillard <rouilj@ieee.org>
parents:
6225
diff
changeset
|
208 https://www.roundup-tracker.org/ should state that the stable |
|
5148
71643a839c80
Updated release docs to account for issue2550838.
John Rouillard <rouilj@ieee.org>
parents:
5144
diff
changeset
|
209 version is the one that you released. |
|
6265
b2eb59ada444
Replace http:....roundup-tracker.org with https. Also fix wiki links.
John Rouillard <rouilj@ieee.org>
parents:
6225
diff
changeset
|
210 https://www.roundup-tracker.org/docs.html should also match the |
|
5941
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
211 released version (or at least the major non pre-release |
|
29d428927362
prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents:
5841
diff
changeset
|
212 1.x/2.x version). |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
213 |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
214 15. Send doc/announcement.txt to python-announce@python.org, |
|
6748
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
215 roundup-users@lists.sourceforge.net, |
|
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
216 roundup-devel@lists.sourceforge.net, and lwn@lwn.net. |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
217 15b. Update entry on https://freshcode.club/projects/roundup-tracker |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
218 15c. Update entries for fossies by emailing announcement to |
|
6748
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
219 announce@fossies.org |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
220 15d. Update entry on https://directory.fsf.org/wiki/Roundup. |
|
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
221 |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
222 16. Change the version in the URL that generates the "commits since |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
223 release ...." badge. Also update Python test versions in the |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
224 GitHub Actions section at: |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
225 https://wiki.roundup-tracker.org/CiTestingEnvironment |
|
6782
a1868fe784d0
Changes for release 2.2.0.
John Rouillard <rouilj@ieee.org>
parents:
6748
diff
changeset
|
226 16b. Update release info on wikipedia: |
|
6748
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
227 https://en.wikipedia.org/wiki/Roundup_(issue_tracker) |
|
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
228 |
|
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
229 https://en.wikipedia.org/wiki/Comparison_of_issue-tracking_systems |
|
647f806d54b8
Change order of ops website then notices; additional web pages
John Rouillard <rouilj@ieee.org>
parents:
6697
diff
changeset
|
230 |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
231 17 Push release docker image to dockerhub |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
232 17a. install docker |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
233 17b. run: (issues, how to release a version e.g. to update alpine for |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
234 security issues. Currently thinking that release tag is |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
235 rounduptracker/roundup:2.4.0-1, -2 etc. Then add a tag |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
236 rounduptracker/roundup:2.4.0 that moves to always tag |
| 7529 | 237 the latest -N release. Also roundup:latest points to the |
| 238 newest -N for the newest roundup version.) | |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
239 |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
240 docker build -t rounduptracker/roundup:2.4.0 \ |
|
7049
a6526afd7c71
update commands for easier cut/paste.
John Rouillard <rouilj@ieee.org>
parents:
6812
diff
changeset
|
241 --build-arg="source=pypi" -f scripts/Docker/Dockerfile . |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
242 |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
243 to create the docker image. *Change 2.4.0 to current version* |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
244 Always use the exact release tag. |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
245 17c. vulnerability scan local image using: |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
246 |
|
7049
a6526afd7c71
update commands for easier cut/paste.
John Rouillard <rouilj@ieee.org>
parents:
6812
diff
changeset
|
247 docker run --rm --volume \ |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
248 /var/run/docker.sock:/var/run/docker.sock \ |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
249 --name Grype anchore/grype:latest rounduptracker/roundup:2.4.0 |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
250 |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
251 should report no vulnerabilities (note match version with current |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
252 build) |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
253 |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
254 Also can scan (optionally) using trivy: |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
255 |
|
7671
2fc2b14edbf7
doc: add -it to docker command for running trivy
John Rouillard <rouilj@ieee.org>
parents:
7530
diff
changeset
|
256 docker run -it --rm --volume \ |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
257 /var/run/docker.sock:/var/run/docker.sock \ |
|
7939
383560895329
test: update trivy options ignore-unifixed and exit-code 1
John Rouillard <rouilj@ieee.org>
parents:
7671
diff
changeset
|
258 --name trivy aquasec/trivy:latest image --exit-code 1 \ |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
259 --ignore-unfixed rounduptracker/roundup:2.4.0 |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
260 |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
261 You may need to explicitly update/refresh the scanners with: |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
262 "docker pull anchore/grype:latest" and similarly for |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
263 aquasec/trivy if used. |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
264 17d. test roundup in demo mode: |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
265 |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
266 docker run -it --rm -p 8917:8080 \ |
|
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
267 -v $PWD/tracker:/usr/src/app/tracker \ |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
268 rounduptracker/roundup:2.4.0 demo |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
269 |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
270 17e. push to DockerHub login (login using 'docker login <username>' |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
271 first and user must be member of rounduptracker org with ability |
|
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
272 to publish). Replace -N with the release number (e.g. -1, -2, -3...) |
|
6812
d7905a78ab8a
Add item to push docker image post release.
John Rouillard <rouilj@ieee.org>
parents:
6782
diff
changeset
|
273 |
|
8079
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
274 docker tag rounduptracker/roundup:2.4.0 roundup-tracker/roundup:latest |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
275 docker tag rounduptracker/roundup:2.4.0 roundup-tracker/roundup:2.4.0-N |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
276 docker push rounduptracker/roundup:2.4.0 |
|
e3c5f85af7d5
docs: update release notes.
John Rouillard <rouilj@ieee.org>
parents:
8076
diff
changeset
|
277 docker push rounduptracker/roundup:2.4.0-N |
|
7120
06305faf0332
Update docker release instructions.
John Rouillard <rouilj@ieee.org>
parents:
7049
diff
changeset
|
278 docker push rounduptracker/roundup # update roundup:latest |
|
98
16dcdab5ce70
Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
279 |
|
6379
843a88670707
Delete cut/paste command sequence; make commands more obvious
John Rouillard <rouilj@ieee.org>
parents:
6378
diff
changeset
|
280 ------------- |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
281 |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
282 If you get errors on the upload operation, you may need the following |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
283 ~/.pypirc file as well |
|
98
16dcdab5ce70
Added build instructions...
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
284 |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
285 ======== |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
286 [distutils] |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
287 index-servers = |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
288 test |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
289 pypi |
|
4501
588e5dbbb9fe
- document experience from release(s)
Ralf Schlatterbeck <schlatterbeck@users.sourceforge.net>
parents:
4487
diff
changeset
|
290 |
|
5337
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
291 [pypi] |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
292 repository: https://upload.pypi.org/legacy/ |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
293 username: <your username on pypi.org here> |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
294 password: <your password here> |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
295 |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
296 [test] |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
297 repository: https://test.pypi.org/legacy/ |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
298 username: <your username on test.pypi.org here> |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
299 password: <your password here> |
|
01dabc0483b0
more changes to prep for 1.6 release.
John Rouillard <rouilj@ieee.org>
parents:
5335
diff
changeset
|
300 ======== |
|
7227
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
301 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
302 ------------- |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
303 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
304 ========================== |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
305 GPG public key operations. |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
306 ========================== |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
307 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
308 LIST IN KEYRING |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
309 =============== |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
310 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
311 $ gpg --list-keys -a roundup-devel@lists.sourceforge.net |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
312 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
313 pub rsa4096 2018-07-11 [SC] [expires: 2028-07-17] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
314 411E354B5D1AF26125D621221F2DD0CB756A76D8 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
315 uid [ultimate] Roundup Team (signing key for roundup |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
316 releases) <roundup-devel@lists.sourceforge.net> |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
317 sub rsa4096 2018-07-11 [E] [expires: 2028-07-17] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
318 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
319 EXTEND EXPIRATION DATE |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
320 ====================== |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
321 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
322 Needs private key and passphrse for private key |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
323 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
324 $ gpg --edit-key 411E354B5D1AF26125D621221F2DD0CB756A76D8 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
325 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
326 > expire |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
327 [add some number of months/years to it] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
328 > key 1 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
329 [ this chooses the subkey "sub" ] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
330 > expire |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
331 [add some number of months/years to the sub key ] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
332 > save |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
333 [ saves both keys, will need the private key and passphrase ] |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
334 |
| 7529 | 335 EXPORT NEW PUBLIC KEY |
| 336 ===================== | |
|
7227
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
337 |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
338 $ gpg --export -a roundup-devel@lists.sourceforge.net >> \ |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
339 tools/roundup.public.pgp.key |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
340 |
| 7529 | 341 then edit roundup.public.pgp.key keeping only the last key that starts |
|
7227
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
342 with: -----BEGIN PGP PUBLIC KEY BLOCK----- |
|
1e004afe87bb
Update expiration date for gpg release signing key to 2028-07-17.
John Rouillard <rouilj@ieee.org>
parents:
7120
diff
changeset
|
343 |
| 7529 | 344 and add back the preamble that describes where to find doc for |
| 345 it. Commmit new key to mercurial. | |
|
8050
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
346 |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
347 SAVE TO KEYSERVER |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
348 ================= |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
349 |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
350 $ gpg --keyserver pgp.mit.edu --send-keys \ |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
351 411E354B5D1AF26125D621221F2DD0CB756A76D8 |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
352 |
|
093d2e0761d4
docs: add directions on saving the key to the pgp.mit.edu keyserver
John Rouillard <rouilj@ieee.org>
parents:
7962
diff
changeset
|
353 update it on the keysserver so users can download it. |