From 27077cf96c2b45e024adfc18ca3a39b62bb41f9a Mon Sep 17 00:00:00 2001 From: tannevaled Date: Sun, 25 Oct 2026 18:57:03 +0100 Subject: [PATCH] go-notebook v0.4.0: the card, the hero notebook's tool, and Ruby in the playgrounds The go-notebook card reads v0.4.0 (the command on cobra). example/go.mod pins notebook v0.4.0 and the notebook prints the same output, so example/output.txt is unchanged. Get started says the go-statistics and go-numerics playgrounds run Ruby cells too (playground v0.2.0). Co-Authored-By: Claude Opus 5.5 --- example/go.mod | 11 +++++++---- example/go.sum | 18 ++++++++++++++++++ hugo.toml | 2 +- layouts/index.html | 2 +- 4 files changed, 27 insertions(+), 6 deletions(-) diff --git a/example/go.mod b/example/go.mod index 6c98551..f88f23c 100644 --- a/example/go.mod +++ b/example/go.mod @@ -8,15 +8,18 @@ require ( ) require ( - github.com/go-notebook/notebook v0.3.0 // indirect + github.com/go-notebook/notebook v0.4.0 // indirect github.com/go-numerics/optimize v0.1.0 // indirect github.com/go-numerics/special v0.1.0 // indirect github.com/go-opentype/opentype v0.13.0 // indirect - github.com/go-regexp/engine v0.1.3 // indirect - github.com/go-rouge/rouge v0.4.0 // indirect + github.com/go-regexp/engine v0.3.2 // indirect + github.com/go-rouge/rouge v0.7.0 // indirect github.com/go-ruby-parser/parser v0.13.1 // indirect - github.com/go-ruby-regexp/regexp v0.0.0-20260927145504-6cbb63926eb2 // indirect + github.com/go-ruby-regexp/regexp v0.1.1 // indirect github.com/go-tex/math v0.50.0 // indirect + github.com/inconshreveable/mousetrap v1.1.0 // indirect + github.com/spf13/cobra v1.10.2 // indirect + github.com/spf13/pflag v1.0.9 // indirect github.com/yuin/goldmark v1.8.6 // indirect golang.org/x/mod v0.42.0 // indirect golang.org/x/sync v0.24.0 // indirect diff --git a/example/go.sum b/example/go.sum index 4bf0061..c653dd8 100644 --- a/example/go.sum +++ b/example/go.sum @@ -1,9 +1,12 @@ +github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g= github.com/go-ndarray/ndarray v0.12.0 h1:4xfl9ZQo1m0UXopo06KypELg1wUYgQb5kdKaJPZAZus= github.com/go-ndarray/ndarray v0.12.0/go.mod h1:ZcgNCBVLXt1FxeZjQWI5Z+k0SSWAT0/wR8slfat/gRA= github.com/go-notebook/notebook v0.2.0 h1:W3z9TbBCyqsHaRcEpa2csMw5UDe8JsgOu6Hwd/R1T6M= github.com/go-notebook/notebook v0.2.0/go.mod h1:cqXgByviyVH6wBixaCPPnHfJkPP1c3jh2JAAfaz2Zf8= github.com/go-notebook/notebook v0.3.0 h1:DdIynF6MDCiUXbZzImIhUemNvnNdP6QEMsPX821AzZM= github.com/go-notebook/notebook v0.3.0/go.mod h1:wLXtnHz8JMuXRN0LL2flSQVbBR8H8701Yom1ViAsiKI= +github.com/go-notebook/notebook v0.4.0 h1:h6olzy87pUnpGEiwxFu8lVor8I62tPw1nXvosggQ0Ac= +github.com/go-notebook/notebook v0.4.0/go.mod h1:eu7YnpXAiazod6ysmpzQIghvq6GqjFxEUms4EryYVwY= github.com/go-numerics/optimize v0.1.0 h1:SOA+QxTuIjeZSAsd5Dyj433lItnOKWyprCbHQoLxg/c= github.com/go-numerics/optimize v0.1.0/go.mod h1:ieZ+/EsbBw/EfHl4W8JryPyCBB8n5a8xKk6lu/xh7zk= github.com/go-numerics/special v0.1.0 h1:HcsebTwcNuAhFBP8RuOirO9XVmWJSrxARiOVkyeCfUk= @@ -12,20 +15,34 @@ github.com/go-opentype/opentype v0.13.0 h1:q9K7IGDfwMP/ik51ZkwiYf6jbaqPfocvAIuoj github.com/go-opentype/opentype v0.13.0/go.mod h1:AOixevJf7XQaH7+WG+OMIOZEbYPXfMqklVk26Y6YTUU= github.com/go-regexp/engine v0.1.3 h1:0U5DrrBEYjNX/f0yFESpQDWmJOtXmmZqluNAUBXjfxY= github.com/go-regexp/engine v0.1.3/go.mod h1:8rju5lq5OkskQh9+m+FjBP6965giMPUdIOdrvFrbqn4= +github.com/go-regexp/engine v0.3.2 h1:zublnb1Vf5Cclh59+cp35htv2aATddBMNp5VwMAeZcc= +github.com/go-regexp/engine v0.3.2/go.mod h1:fWnPvSuE4HIVpBQIHMiaPMEE7InDc00KeoPr/QNFGwA= github.com/go-rouge/rouge v0.4.0 h1:f/5EVTEwiEnBOeyAtkV8r5KopdIRAsRoA7Kzi/cyh2Y= github.com/go-rouge/rouge v0.4.0/go.mod h1:V4Xlyl1EDqEfrzloW9y6X0xpv/WvCvTiOWNIcByw2Y8= +github.com/go-rouge/rouge v0.7.0 h1:dwNcW7TJn4kvH9P7+mAOrQ9hu6OilQkDsN+6YMVqPdA= +github.com/go-rouge/rouge v0.7.0/go.mod h1:R3jg4M5ltZUCc19bfAd8burX7zozHyynjS4oDmlNtUM= github.com/go-ruby-parser/parser v0.13.1 h1:gq7QVT7KdRp7nZt1UHsa73YDo77qrD8kGdQY/GVEA6g= github.com/go-ruby-parser/parser v0.13.1/go.mod h1:Se+ZvnD/4Vm0RRe1U5kZi0GmPSvSczJJXdZLiB0PlJY= github.com/go-ruby-regexp/regexp v0.0.0-20260927145504-6cbb63926eb2 h1:pNvJf0zgzg0rTEq1fToFa5fnzK13nIble80caTmdG3g= github.com/go-ruby-regexp/regexp v0.0.0-20260927145504-6cbb63926eb2/go.mod h1:I3i2r1AXulgMBt/KiWBcxjnoNsB09ZFKkj2Vb5Mhzuw= +github.com/go-ruby-regexp/regexp v0.1.1 h1:gqueGLmsUVVleZMzEGKax2YfpJz+aLQqdbsHp+OB3CA= +github.com/go-ruby-regexp/regexp v0.1.1/go.mod h1:RhMJEXTJUHXcrqbnS5cVSoEfLC1SBm4G+dMkhVB96RM= github.com/go-statistics/stats v0.1.0 h1:m8/5lxOZEcbWp51T6evG3Yx0ZzMlOO2wIEZa8uBGryA= github.com/go-statistics/stats v0.1.0/go.mod h1:hyKv4yhaJ7aDpNbR1MLNjiiBPeP5iZb8Q075y+q+FEw= github.com/go-tex/math v0.50.0 h1:YHJ3LYzS45zBoPKGBkZW4+LUQkOeHP30YWLsfXGZCpo= github.com/go-tex/math v0.50.0/go.mod h1:cPm5juijQkhFj1MCByLF8tOfZ+UswAGUPBh+Wy6+vbw= github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI= github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= +github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8= +github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw= +github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= +github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU= +github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4= +github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY= +github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= github.com/yuin/goldmark v1.8.6 h1:d0VcaP1sx9GkFVkoW+KtggpGi2KZ965i14b0+bDQST4= github.com/yuin/goldmark v1.8.6/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg= +go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg= golang.org/x/mod v0.41.0 h1:qJmnOUb4YB+FsEuM3HcWucdZASCPGhsX6uljO6pog0c= golang.org/x/mod v0.41.0/go.mod h1:Ek9pY8RKWXwsWvd3rQiHYtMqkjSUV+s1Rj7j4H5Ur6o= golang.org/x/mod v0.42.0 h1:ICeL3t2L30ljSPHHxDnR4fqVcBt/zR2zJAb9juavmQg= @@ -40,3 +57,4 @@ golang.org/x/tools v0.51.0 h1:k4Xc/1Om9jwkBJBo4NVLMSARBoWtK10mx+W5BnXCeAI= golang.org/x/tools v0.51.0/go.mod h1:9eEncMayCV6zRMGhR5eZEC2iBx98qWcF1HZ9Z7wJOoA= golang.org/x/tools v0.52.0 h1:ryxg4U63oaUYk7uOLTF37n43f4qgtGvqV4Ioit1BaEs= golang.org/x/tools v0.52.0/go.mod h1:ItcP5UNaVGG+Yc4eIYmaFLNJ4soEopkx5Y2d4lcEurs= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= diff --git a/hugo.toml b/hugo.toml index 135dd97..fc20f25 100644 --- a/hugo.toml +++ b/hugo.toml @@ -97,7 +97,7 @@ disableKinds = ['taxonomy', 'term', 'rss', 'sitemap', '404'] layer = 2 short = "compiled, reactive notebooks" lib = "notebook" - state = "notebook v0.3.0" + state = "notebook v0.4.0" live = true brand = true blurb = "A notebook is a Markdown file whose go and ruby blocks are cells. The kernel compiles it into a real Go program, orders the cells of both languages by what they use, and runs only what changed, keeping values across runs. Ruby cells run on go-embedded-ruby, with the go-scikit bindings." diff --git a/layouts/index.html b/layouts/index.html index 1b1af98..54fcbf2 100644 --- a/layouts/index.html +++ b/layouts/index.html @@ -125,7 +125,7 @@

A first notebook, in four commands.

# notebook html first.md writes first.html # notebook serve first.md the same, live in the browser, editable -

Run it again and every cell is kept: a cell whose code and inputs did not change is not run again, across runs. The go-notebook documentation gives the cell rules; to try the arrays and the transforms without installing anything, the go-ndarray and go-fft playgrounds run them compiled to WebAssembly in the browser, and the go-statistics and go-numerics playgrounds run whole notebooks there: edit the cells, run them, see the figures.

+

Run it again and every cell is kept: a cell whose code and inputs did not change is not run again, across runs. The go-notebook documentation gives the cell rules; to try the arrays and the transforms without installing anything, the go-ndarray and go-fft playgrounds run them compiled to WebAssembly in the browser, and the go-statistics and go-numerics playgrounds run whole notebooks there, Go and Ruby cells alike: edit the cells, run them, see the figures.

A ruby cell runs on go-embedded-ruby, a Ruby written in Go, so the notebook stays one Go program with no Ruby to install. It sees the values the Go cells above it defined (here x, a Go []float64), and the Go cells below it see what it defines; the kernel orders and re-runs cells of both languages by what they use. From Ruby, the stack is reached through go-scikit/ruby, which the kernel adds by itself: Stats, Special, Optimize, Integrate, DataFrame and Plot call the same Go functions, with the same answers. The Ruby cells page gives the rules, and the -timeout and -memory limits that stop a runaway cell.