1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
==================
Releasing Numexpr
==================
:Author: Francesc Alted
:Contact: faltet@gmail.com
:Date: 2009-06-02
Following are notes useful for releasing Numexpr.
Preliminaries
-------------
- Make sure that ``RELEASE_NOTES.txt`` and ``ANNOUNCE.txt`` are up to
date with the latest news in the release.
- Remove the `.devN` suffix in ``numexpr/version.py``.
- Do a commit and a push:
$ git commit -a -m"Getting ready for release X.Y.Z"
Testing
-------
- Run the test suite in different platforms (at least Linux and
Windows) and make sure that all tests passes.
- Re-compile with MKL support and see if all tests passes as well.
- Run all the benchmarks in ``bench/`` directory and see if the
speed-ups are the expected ones.
Packaging
---------
- Make the tarball with the command:
$ python setup.py sdist
Do a quick check that the tarball is sane.
Releasing
---------
- Create a tag ``vX.Y.Z`` from ``master``. Use the next message:
$ git tag -a vX.Y.Z -m "Tagging version X.Y.Z"
- Push the tag to the github repo:
$ git push
$ git push --tags
- If you happen to have to delete the tag, for example if the `manywheels` builds
demonstrates a fault, first delete it locally,
git tag --delete vX.Y.Z
and then remotely on Github,
git push --delete origin vX.Y.Z
Build wheels
------------
Matthew Brett has a repository for building for hosting wheels at
http://github.com/MacPython/numexpr-wheels). For the procedure to trigger and
upload the built wheels, see the README at that repo.
Build and upload the wheels before uploading the source distribution, to make
sure that people who do not have compilers do not get breakage while the
release is being uploaded.
Any problems, feel free to ask @matthew-brett for help - or indeed, pass the
whole task to him.
Uploading the source distribution
---------------------------------
- Upload it in the PyPi repository:
$ python setup.py sdist upload
Announcing
----------
- Send an announcement to the NumPy list, PyData and python-announce
list. Use the ``ANNOUNCE.rst`` file as skeleton (or possibly as the
definitive version).
Post-release actions
--------------------
- Edit ``numexpr/version.py`` to bump the version revision
(i.e. X.Y.Z --> X.Y.(Z+1).dev0).
- Create new headers for adding new features in ``RELEASE_NOTES.txt``
and add this place-holder:
#XXX version-specific blurb XXX#
Don't forget to update header to the next version in those files.
- Commit your changes:
$ git commit -a -m"Post X.Y.Z release actions done"
$ git push
That's all folks!
.. Local Variables:
.. mode: rst
.. coding: utf-8
.. fill-column: 70
.. End:
|
