Release Trac 1.2.1

[Ryan J Ollos]

This ticket is used to coordinate the finalization and testing of the next stable version of Trac, 1.2.1.

[ilewismsl]

This comment probably belongs under #12120, but that ticket is closed. So, placing here.

Your home page still shows 1.0 as the current stable version of Trac and 1.2 as the in-development version of Trac.

[Ryan J Ollos]

Thanks for bringing that to our attention. We should update TracDev/ReleaseChecklist to add that step.

[Christian Boos]

I've delayed that a bit until I finalize creating a demo-1.2 site… Should be coming soon! DONE

[ilewismsl]

Replying to Christian Boos:

I've delayed that a bit until I finalize creating a demo-1.2 site…

Home page looks good for the main-line branch, but the Watch it evolve block still references the now-closed 1.2 milestone.

[Ryan J Ollos]

Replying to ilewismsl:

Home page looks good for the main-line branch, but the Watch it evolve block still references the now-closed 1.2 milestone.

Thanks, fixed in WikiStart@165. Prior to WikiStart@162 we pointed to next-dev-1.1.x.

[Ryan J Ollos]

After WikiStart@166, Trac 1.0 is labeled as LTS. I'm making note of that here because based on previous discussion we would make 1.2 an LTS release, but not 1.0.

[Christian Boos]

Replying to Ryan J Ollos:

After WikiStart@166, Trac 1.0 is labeled as LTS. I'm making note of that here because based on previous discussion we would make 1.2 an LTS release, but not 1.0.

Right, I also asked myself what would be the best way to handle this, 1.0 is indeed the previous stable, 0.12 is the previous "LTS" stable while 1.2 was supposed to be the next "LTS" one. Or is that just too complex? I wanted to raise the question on Trac-dev…

[Peter Suter]

Sorry, I didn't intend to restart a settled discussion. I thought I was just fixing a small oversight. The 1.0 demo instance is shown in the box, while the 0.12 demo instance is not shown. So I thought I had just fixed the "Get started"-links to be consistent with that. I didn't remember that 1.0 wasn't supposed to be LTS. Feel free to revert / adjust accordingly.

[Ryan J Ollos]

As far as I'm aware we hadn't formally documented the decision anywhere, but making 1.2 an LTS release sounds good to me.

[Ryan J Ollos]

I'll plan to do release on 03/25 or 03/26.

[Ryan J Ollos]

We can no longer upload both tar.gz and zip to PyPI. See ​this comment and the two that follow it.

[Ryan J Ollos]

I had to make a change to Makefile to get it to work on OSX:

Makefile

@@ -655 +655 @@
         @echo "Packages for Trac-$(version):"
         @echo
         @$(if $(packages), \
-            md5sum $(packages); \
-            sha1sum $(packages); \
+            md5 $(packages); \
+            shasum $(packages); \
         , \
             echo "No packages found: $(sdist+wheel) $(wininst)" \
         )

Maybe it needs to be configurable to support multiple platforms?

[Jun Omae]

I think we could add small script to compute checksum, instead of configurable. See also ​python-issue:26488.

$ make version=1.0.14dev checksum
Packages for Trac-1.0.14dev:

90c3832d4a0909de8358a0c116d6b1c8 *dist/Trac-1.0.14dev.tar.gz
d7a765e82d6b217532d0ca3d6bca73fb *dist/Trac-1.0.14dev.zip
931ed6ff9efbbbd5b25097c5b6db3d91a7d712d6 *dist/Trac-1.0.14dev.tar.gz
798ec3780899757480f30c3e3dc8b225709c5042 *dist/Trac-1.0.14dev.zip

Makefile

@@ -657 +657 @@
        @echo "Packages for Trac-$(version):"
        @echo
        @$(if $(packages), \
-           md5sum $(packages); \
-           sha1sum $(packages); \
+           python contrib/checksum.py md5:sha1 $(packages); \
        , \
            echo "No packages found: $(sdist+wheel) $(wininst)" \
        )

new file contrib/checksum.py

@@ +1 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2017 Edgewall Software
+# All rights reserved.
+#
+# This software is licensed as described in the file COPYING, which
+# you should have received as part of this distribution. The terms
+# are also available at http://trac.edgewall.com/license.html.
+#
+# This software consists of voluntary contributions made by many
+# individuals. For the exact contribution history, see the revision
+# history and logs, available at http://trac.edgewall.org/.
+
+import hashlib
+import io
+import sys
+
+
+def main():
+    args = sys.argv[1:]
+    if not args:
+        sys.stderr.write('Usage: %s algorithm files...\n' % sys.argv[0])
+        return 2
+    algorithms = args.pop(0).replace(':', ' ').split()
+    for algorithm in algorithms:
+        for filename in args:
+            m = hashlib.new(algorithm)
+            with io.open(filename, 'rb') as f:
+                while True:
+                    data = f.read(4096)
+                    if not data:
+                        break
+                    m.update(data)
+            print('%s *%s' % (m.hexdigest(), filename))
+
+
+if __name__ == '__main__':
+    sys.exit(main() or 0)

[Ryan J Ollos]

Good idea and works well. I'll commit the changes shortly if there's no further feedback.

[Ryan J Ollos]

comment:13 change committed in [15731:15733].

[Ryan J Ollos]

Replying to Ryan J Ollos:

We can no longer upload both tar.gz and zip to PyPI. See ​this comment and the two that follow it.

Updated Makefile on 1.0-stable in r16014, merged in r16015 and r16016. See also #12833.

Edited TracDev/ReleaseChecklist@114.