| 1 | #!/usr/bin/env bash
|
| 2 | #
|
| 3 | # Usage:
|
| 4 | # devtools/release-note.sh <function name>
|
| 5 | #
|
| 6 | # Example:
|
| 7 | # $0 fetch-issues
|
| 8 | # $0 write-template
|
| 9 |
|
| 10 | set -o nounset
|
| 11 | set -o pipefail
|
| 12 | set -o errexit
|
| 13 |
|
| 14 | source build/dev-shell.sh # PYTHONPATH
|
| 15 | source devtools/release-version.sh # for escape-segments
|
| 16 |
|
| 17 | readonly OILS_VERSION=$(head -n 1 oil-version.txt)
|
| 18 | readonly PREV_VERSION='0.20.0'
|
| 19 |
|
| 20 | # adapted from release-version.sh
|
| 21 | _git-changelog-body() {
|
| 22 | local commit=$1
|
| 23 |
|
| 24 | # - a trick for HTML escaping (avoid XSS): surround %s with unlikely bytes,
|
| 25 | # \x00 and \x01. Then pipe Python to escape.
|
| 26 | # --reverse makes it go in forward chronlogical order.
|
| 27 |
|
| 28 | # %x00 generates the byte \x00
|
| 29 | local format='<tr>
|
| 30 | <td><a class="checksum"
|
| 31 | href="https://github.com/oilshell/oil/commit/%H">%h</a>
|
| 32 | </td>
|
| 33 | <td>%x00%an%x01</td>
|
| 34 | <td class="subject">%x00%s%x01</td>
|
| 35 | </tr>'
|
| 36 | git log \
|
| 37 | --reverse \
|
| 38 | --pretty="format:$format" \
|
| 39 | --date=short \
|
| 40 | -n 1 \
|
| 41 | $commit \
|
| 42 | | escape-segments
|
| 43 | }
|
| 44 |
|
| 45 | contrib-commit-table() {
|
| 46 | # Filter out my commits, then pass back to git log
|
| 47 |
|
| 48 | # 2023-07: Deoptimized due to git breakage
|
| 49 | # https://stackoverflow.com/questions/6889830/equivalence-of-git-log-exclude-author
|
| 50 |
|
| 51 | git log --format='%H %an' "release/$PREV_VERSION..release/$OILS_VERSION" |
|
| 52 | grep -v 'Andy C' |
|
| 53 | cut -d ' ' -f 1 |
|
| 54 | xargs -n 1 $0 _git-changelog-body
|
| 55 |
|
| 56 | #xargs -n 1 -- git log -n 1
|
| 57 | }
|
| 58 |
|
| 59 | fetch-issues() {
|
| 60 | local url='https://api.github.com/repos/oilshell/oil/issues?labels=pending-release'
|
| 61 | curl "$url" > _tmp/issues.json
|
| 62 | }
|
| 63 |
|
| 64 | issues-table() {
|
| 65 | cat _tmp/issues.json | devtools/services/github_issues.py
|
| 66 | }
|
| 67 |
|
| 68 | write-template() {
|
| 69 | ### New blog post
|
| 70 |
|
| 71 | local date=$(date +%Y/%m)
|
| 72 | local out=../oilshell.org/blog/$date/_release-$OILS_VERSION.md
|
| 73 | print-template > $out
|
| 74 | echo "Wrote $out"
|
| 75 | }
|
| 76 |
|
| 77 | preview-template() {
|
| 78 | local out=_tmp/release-note.html
|
| 79 |
|
| 80 | # This isn't right because it doesn't split the --- front matter
|
| 81 | # But good enough for now
|
| 82 |
|
| 83 | print-template | doctools/cmark.py > $out
|
| 84 | log "Wrote $out"
|
| 85 | }
|
| 86 |
|
| 87 | print-template() {
|
| 88 | local metric_prev=${1:-$PREV_VERSION}
|
| 89 |
|
| 90 | cat <<EOF
|
| 91 | ---
|
| 92 | title: Oils $OILS_VERSION - Foo Foo
|
| 93 | date: $(date +%Y/%m/%d)
|
| 94 | css_file: blog-bundle-v6.css
|
| 95 | body_css_class: width35
|
| 96 | default_highlighter: oil-sh
|
| 97 | tags: oil-release
|
| 98 | comments_url: TODO
|
| 99 | published: no
|
| 100 | ---
|
| 101 |
|
| 102 | This is the latest version of Oils, a Unix shell that's our upgrade path from
|
| 103 | [bash][]:
|
| 104 |
|
| 105 | [bash]: \$xref
|
| 106 |
|
| 107 | <div class="attention">
|
| 108 |
|
| 109 | [Oils version $OILS_VERSION][release-index] - Source tarballs and documentation.
|
| 110 |
|
| 111 | </div>
|
| 112 |
|
| 113 | To build and run it, follow the instructions in [INSTALL.txt][]. The wiki has
|
| 114 | tips on [How To Test OSH](\$wiki).
|
| 115 |
|
| 116 | If you're new to the project, see [Why Create a New Shell?][why-oil] and posts
|
| 117 | tagged #[FAQ](\$blog-tag).
|
| 118 |
|
| 119 | [INSTALL.txt]: /release/$OILS_VERSION/doc/INSTALL.html
|
| 120 | [github-bugs]: https://github.com/oilshell/oil/issues
|
| 121 | [why-oil]: ../../2021/01/why-a-new-shell.html
|
| 122 | [release-index]: /release/$OILS_VERSION/
|
| 123 |
|
| 124 | [oilshell.zulipchat.com]: http://oilshell.zulipchat.com/
|
| 125 |
|
| 126 | <div id="toc">
|
| 127 | </div>
|
| 128 |
|
| 129 | I'm trying something different this release. These release notes are
|
| 130 | semi-automated with a shell script! See the [last
|
| 131 | post](../02/good-parts-sketch.html) in #[shell-the-good-parts](\$blog-tag).
|
| 132 |
|
| 133 | ## Closed Issues
|
| 134 |
|
| 135 | <table>
|
| 136 | EOF
|
| 137 |
|
| 138 | issues-table
|
| 139 |
|
| 140 | cat <<EOF
|
| 141 | </table>
|
| 142 |
|
| 143 | ## Commit Log
|
| 144 |
|
| 145 | Here are the commits from other contributors. You can also view the [full
|
| 146 | changelog][changelog].
|
| 147 |
|
| 148 | [changelog]: /release/$OILS_VERSION/changelog.html
|
| 149 |
|
| 150 | <table>
|
| 151 | EOF
|
| 152 |
|
| 153 | contrib-commit-table
|
| 154 |
|
| 155 | cat <<EOF
|
| 156 | </table>
|
| 157 |
|
| 158 | ## Documentation Updated
|
| 159 |
|
| 160 | - [Known Differences](/release/$OILS_VERSION/doc/known-differences.html)
|
| 161 | - [Interpreter State](/release/$OILS_VERSION/doc/interpreter-state.html) - still
|
| 162 | a draft.
|
| 163 |
|
| 164 | ### Wiki Pages
|
| 165 |
|
| 166 | - [How Interactive Shells Work](https://github.com/oilshell/oil/wiki/How-Interactive-Shells-Work)
|
| 167 |
|
| 168 |
|
| 169 | ## What's Next?
|
| 170 |
|
| 171 | Here are some notable Open Issues
|
| 172 |
|
| 173 | - [Provide APIs to allow users to write their own line editor / interactive
|
| 174 | interface](\$issue:663)
|
| 175 |
|
| 176 | ## Appendix: Metrics for the $OILS_VERSION Release
|
| 177 |
|
| 178 | These metrics help me keep track of the project. Let's compare this release
|
| 179 | with the previous one, version [$metric_prev](/release/$metric_prev).
|
| 180 |
|
| 181 | [spec-test]: \$xref:spec-test
|
| 182 |
|
| 183 | ### Spec Tests
|
| 184 |
|
| 185 | The Python reference implementation foo foo
|
| 186 |
|
| 187 | - [OSH spec tests for $metric_prev](https://www.oilshell.org/release/$metric_prev/test/spec.wwz/osh-py/index.html): **2023** tests,
|
| 188 | **1789** passing, **91** failing
|
| 189 | - [OSH spec tests for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/test/spec.wwz/osh-py/index.html): **2042** tests, **1814** passing, **89** failing
|
| 190 |
|
| 191 | And the C++ translation foo foo
|
| 192 |
|
| 193 | - [C++ spec tests for $metric_prev](https://www.oilshell.org/release/$metric_prev/test/spec.wwz/osh-cpp/compare.html) - **1684** of **1792** passing
|
| 194 | - [C++ spec tests for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/test/spec.wwz/osh-cpp/compare.html) - **1801** of **1817** passing
|
| 195 |
|
| 196 | YSH got a lot of new behavior:
|
| 197 |
|
| 198 | - [YSH spec tests for $metric_prev](https://www.oilshell.org/release/$metric_prev/test/spec.wwz/ysh-py/index.html): **561** tests, **514** passing, **47** failing
|
| 199 | - [YSH spec tests for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/test/spec.wwz/ysh-py/index.html): **630** tests, **571** passing, **59** failing
|
| 200 |
|
| 201 | And the C++ tarball is catching up rapidly:
|
| 202 |
|
| 203 | - [YSH C++ spec tests for $metric_prev](https://www.oilshell.org/release/$metric_prev/test/spec.wwz/ysh-cpp/compare.html): **357** of **514** passing, delta **157**
|
| 204 | - [YSH C++ spec tests for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/test/spec.wwz/ysh-cpp/compare.html): **492** of **569** passing, delta **77**
|
| 205 |
|
| 206 |
|
| 207 | ### Benchmarks
|
| 208 |
|
| 209 | Bar Bar
|
| 210 |
|
| 211 | - [Parser Performance for $metric_prev](https://www.oilshell.org/release/$metric_prev/benchmarks.wwz/osh-parser/): **21.8**
|
| 212 | thousand irefs per line
|
| 213 | - [Parser Performance for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/benchmarks.wwz/osh-parser/): **26.0**
|
| 214 | thousand irefs per line
|
| 215 |
|
| 216 | G G
|
| 217 |
|
| 218 | - [benchmarks/gc for $metric_prev](https://www.oilshell.org/release/$metric_prev/benchmarks.wwz/gc/): \`parse.configure-coreutils\`
|
| 219 | **1.83 M** objects comprising **62.1 MB**, max RSS **68.9 MB**
|
| 220 | - [benchmarks/gc for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/benchmarks.wwz/gc/): \`parse.configure-coreutils\` **1.83 M** objects comprising **65.0 MB**, max RSS **69.3 MB**
|
| 221 |
|
| 222 | G G
|
| 223 |
|
| 224 | - [benchmarks/gc-cachegrind for $metric_prev](https://www.oilshell.org/release/$metric_prev/benchmarks.wwz/gc-cachegrind/) - \`fib\` takes **61.6** million irefs, mut+alloc+free+gc
|
| 225 | - [benchmarks/gc-cachegrind for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/benchmarks.wwz/gc-cachegrind/) - \`fib\` takes **65.4** million irefs, mut+alloc+free+gc
|
| 226 |
|
| 227 |
|
| 228 |
|
| 229 | Foo Foo
|
| 230 |
|
| 231 | - [Runtime Performance for $metric_prev](https://www.oilshell.org/release/$metric_prev/benchmarks.wwz/osh-runtime/): **68.7** and **56.9** seconds running CPython's \`configure\`
|
| 232 | - [Runtime Performance for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/benchmarks.wwz/osh-runtime/):
|
| 233 | **35.2** and **22.5** seconds running CPython's \`configure\`
|
| 234 | - [bash](\$xref): **26.8** and **16.2** seconds running CPython's \`configure\`
|
| 235 |
|
| 236 |
|
| 237 | ### Code Size
|
| 238 |
|
| 239 | The executable spec foo foo
|
| 240 |
|
| 241 | Significant lines:
|
| 242 |
|
| 243 | - [cloc for $metric_prev](https://www.oilshell.org/release/$metric_prev/pub/metrics.wwz/line-counts/cloc-report.txt):
|
| 244 | **19,581** lines of Python and C, **355** lines of ASDL
|
| 245 | - [cloc for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/pub/metrics.wwz/line-counts/cloc-report.txt):
|
| 246 | **19,491** lines of Python and C, **363** lines of ASDL
|
| 247 |
|
| 248 | Code in the \`oils-for-unix\` C++ tarball, much of which is generated:
|
| 249 |
|
| 250 | - [oil-cpp for $metric_prev](https://www.oilshell.org/release/$metric_prev/pub/metrics.wwz/line-counts/oil-cpp.txt) - **86,985** lines
|
| 251 | - [oil-cpp for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/pub/metrics.wwz/line-counts/oil-cpp.txt) - **90,682** lines
|
| 252 |
|
| 253 | Compiled binary size:
|
| 254 |
|
| 255 | - [ovm-build for $metric_prev](https://www.oilshell.org/release/$metric_prev/benchmarks.wwz/ovm-build/):
|
| 256 | **1.18 MB** of native code (under GCC)
|
| 257 | - [ovm-build for $OILS_VERSION](https://www.oilshell.org/release/$OILS_VERSION/benchmarks.wwz/ovm-build/):
|
| 258 | **1.23 MB** of native code (under GCC)
|
| 259 |
|
| 260 |
|
| 261 |
|
| 262 | EOF
|
| 263 | }
|
| 264 |
|
| 265 | "$@"
|