Bug#1042659: restic: FTBFS with Sphinx 7.1, docutils 0.20: TypeError: not all arguments converted during string formatting

[Lucas Nussbaum]

Source: restic
Version: 0.14.0-1
Severity: important
Tags: ftbfs
User: python-mo...@lists.alioth.debian.org
Usertags: sphinx7.1

Hi,

restic fails to build with Sphinx 7.1 and docutils 0.20, both of which
are currently available in experimental.

Relevant part (hopefully):
> make[1]: Entering directory '/<<PKGBUILDDIR>>'
> dh_auto_build
> cd obj-x86_64-linux-gnu && go install -trimpath -v -p 8 github.com/restic/restic/cmd/restic
> internal/goarch
> internal/unsafeheader
> internal/coverage/rtcov
> internal/goexperiment
> internal/goos
> runtime/internal/atomic
> internal/cpu
> runtime/internal/syscall
> internal/race
> internal/abi
> sync/atomic
> runtime/internal/math
> runtime/internal/sys
> unicode
> unicode/utf8
> encoding
> math/bits
> internal/itoa
> unicode/utf16
> internal/nettrace
> internal/bytealg
> crypto/internal/alias
> crypto/subtle
> crypto/internal/boring/sig
> math
> container/list
> vendor/golang.org/x/crypto/cryptobyte/asn1
> vendor/golang.org/x/crypto/internal/alias
> github.com/Azure/azure-sdk-for-go/version
> github.com/kurin/blazer/internal/b2types
> google.golang.org/grpc/serviceconfig
> go.opencensus.io
> go.opencensus.io/trace/internal
> go.opencensus.io/internal/tagencoding
> github.com/golang/groupcache/lru
> golang.org/x/crypto/internal/alias
> github.com/klauspost/compress/internal/cpuinfo
> hash/maphash
> image/color
> golang.org/x/text/encoding/internal/identifier
> golang.org/x/text/internal/utf8internal
> runtime
> github.com/klauspost/compress
> sync
> internal/reflectlite
> internal/testlog
> internal/godebug
> internal/singleflight
> internal/sysinfo
> google.golang.org/grpc/internal/buffer
> google.golang.org/grpc/internal/grpcsync
> runtime/cgo
> internal/intern
> math/rand
> sort
> errors
> internal/oserror
> internal/safefilepath
> io
> path
> strconv
> syscall
> vendor/golang.org/x/net/dns/dnsmessage
> crypto/internal/nistec/fiat
> github.com/hashicorp/golang-lru/simplelru
> golang.org/x/crypto/cast5
> strings
> bytes
> hash
> hash/fnv
> crypto/internal/randutil
> hash/crc32
> vendor/golang.org/x/text/transform
> reflect
> bufio
> net/netip
> crypto
> crypto/rc4
> net/http/internal/ascii
> regexp/syntax
> html
> text/tabwriter
> google.golang.org/grpc/encoding
> golang.org/x/text/transform
> cloud.google.com/go/internal/version
> golang.org/x/crypto/blowfish
> compress/bzip2
> github.com/restic/restic/internal/hashing
> golang.org/x/crypto/openpgp/errors
> internal/syscall/unix
> time
> internal/syscall/execenv
> regexp
> hash/adler32
> golang.org/x/crypto/openpgp/s2k
> image
> golang.org/x/text/encoding
> golang.org/x/text/runes
> golang.org/x/text/width
> golang.org/x/text/encoding/internal
> golang.org/x/text/encoding/unicode
> image/internal/imageutil
> google.golang.org/api/internal/third_party/uritemplates
> image/jpeg
> google.golang.org/grpc/backoff
> github.com/kurin/blazer/x/window
> context
> io/fs
> internal/poll
> google.golang.org/grpc/internal/grpcrand
> google.golang.org/grpc/keepalive
> github.com/juju/ratelimit
> google.golang.org/grpc/internal/backoff
> github.com/cenkalti/backoff
> google.golang.org/grpc/tap
> golang.org/x/net/context
> embed
> internal/fmtsort
> encoding/binary
> github.com/modern-go/reflect2
> os
> encoding/base64
> crypto/cipher
> golang.org/x/crypto/internal/poly1305
> crypto/internal/edwards25519/field
> crypto/internal/nistec
> golang.org/x/sys/unix
> crypto/md5
> golang.org/x/crypto/poly1305
> encoding/pem
> crypto/internal/edwards25519
> vendor/golang.org/x/crypto/internal/poly1305
> crypto/internal/boring
> crypto/des
> crypto/sha256
> crypto/aes
> crypto/hmac
> fmt
> net
> path/filepath
> io/ioutil
> golang.org/x/crypto/pbkdf2
> crypto/ecdh
> crypto/sha512
> golang.org/x/crypto/scrypt
> os/exec
> crypto/sha1
> vendor/golang.org/x/crypto/chacha20
> vendor/golang.org/x/sys/cpu
> vendor/golang.org/x/crypto/hkdf
> os/signal
> golang.org/x/crypto/pkcs12/internal/rc2
> vendor/golang.org/x/crypto/chacha20poly1305
> google.golang.org/grpc/internal/envconfig
> golang.org/x/sys/cpu
> github.com/kr/fs
> golang.org/x/crypto/chacha20
> golang.org/x/crypto/curve25519/internal/field
> github.com/restic/restic/internal/ui/signals
> golang.org/x/crypto/ssh/internal/bcrypt_pbkdf
> github.com/cespare/xxhash
> golang.org/x/crypto/blake2b
> encoding/json
> log
> flag
> math/big
> encoding/hex
> github.com/pkg/errors
> net/url
> github.com/klauspost/cpuid/v2
> runtime/debug
> compress/flate
> vendor/golang.org/x/text/unicode/bidi
> github.com/restic/restic/internal/errors
> vendor/golang.org/x/text/unicode/norm
> compress/gzip
> vendor/golang.org/x/net/http2/hpack
> github.com/minio/sha256-simd
> mime
> vendor/golang.org/x/text/secure/bidirule
> mime/quotedprintable
> net/http/internal
> github.com/restic/restic/internal/fs
> github.com/pkg/xattr
> golang.org/x/sync/errgroup
> os/user
> runtime/trace
> encoding/xml
> github.com/Azure/go-autorest/autorest/date
> testing
> crypto/rand
> crypto/elliptic
> crypto/internal/bigmod
> github.com/restic/chunker
> github.com/elithrar/simple-scrypt
> crypto/internal/boring/bbig
> encoding/asn1
> crypto/ed25519
> crypto/rsa
> github.com/restic/restic/internal/crypto
> crypto/dsa
> vendor/golang.org/x/net/idna
> database/sql/driver
> vendor/golang.org/x/crypto/cryptobyte
> crypto/x509/pkix
> github.com/restic/restic/internal/backend/sema
> github.com/restic/restic/internal/options
> github.com/kurin/blazer/internal/blog
> database/sql
> github.com/kurin/blazer/internal/b2assets
> text/template/parse
> golang.org/x/net/internal/timeseries
> google.golang.org/grpc/internal/grpclog
> google.golang.org/grpc/grpclog
> crypto/ecdsa
> github.com/golang/protobuf/proto
> google.golang.org/grpc/connectivity
> google.golang.org/grpc/attributes
> google.golang.org/grpc/internal
> google.golang.org/grpc/metadata
> google.golang.org/grpc/codes
> golang.org/x/text/unicode/bidi
> google.golang.org/grpc/internal/balancerload
> golang.org/x/text/unicode/norm
> golang.org/x/net/http2/hpack
> text/template
> cloud.google.com/go/internal/optional
> go.opencensus.io/internal
> go.opencensus.io/trace/tracestate
> google.golang.org/api/iterator
> go.opencensus.io/trace
> golang.org/x/oauth2/jws
> go.opencensus.io/resource
> go.opencensus.io/metric/metricdata
> golang.org/x/text/secure/bidirule
> runtime/pprof
> go.opencensus.io/metric/metricproducer
> archive/tar
> github.com/modern-go/concurrent
> github.com/klauspost/compress/s2
> github.com/json-iterator/go
> html/template
> golang.org/x/net/idna
> go.opencensus.io/tag
> github.com/minio/md5-simd
> go.opencensus.io/stats/internal
> go.opencensus.io/stats
> go.opencensus.io/stats/view
> gopkg.in/ini.v1
> golang.org/x/crypto/argon2
> github.com/minio/minio-go/v7/pkg/lifecycle
> github.com/rs/xid
> bazil.org/fuse
> crypto/x509
> net/textproto
> vendor/golang.org/x/net/http/httpproxy
> github.com/gofrs/uuid
> google.golang.org/grpc/encoding/proto
> github.com/golang/protobuf/ptypes/any
> vendor/golang.org/x/net/http/httpguts
> mime/multipart
> github.com/golang/protobuf/ptypes/duration
> github.com/golang/protobuf/ptypes/timestamp
> google.golang.org/genproto/googleapis/rpc/status
> golang.org/x/net/http/httpguts
> github.com/golang/protobuf/ptypes
> google.golang.org/grpc/binarylog/grpc_binarylog_v1
> google.golang.org/grpc/internal/syscall
> google.golang.org/grpc/stats
> google.golang.org/grpc/internal/status
> github.com/golang/protobuf/protoc-gen-go/descriptor
> google.golang.org/genproto/googleapis/type/expr
> google.golang.org/grpc/status
> google.golang.org/genproto/googleapis/rpc/code
> github.com/minio/minio-go/v7/pkg/s3utils
> github.com/google/uuid
> github.com/minio/minio-go/v7/pkg/replication
> github.com/minio/minio-go/v7/pkg/sse
> github.com/minio/minio-go/v7/pkg/tags
> github.com/pkg/sftp/internal/encoding/ssh/filexfer
> golang.org/x/crypto/curve25519
> golang.org/x/crypto/ed25519
> github.com/minio/minio-go/v7/pkg/set
> github.com/restic/restic/internal/test
> bazil.org/fuse/fuseutil
> github.com/klauspost/compress/fse
> github.com/klauspost/compress/internal/snapref
> bazil.org/fuse/fs
> google.golang.org/genproto/googleapis/api/annotations
> archive/zip
> github.com/minio/minio-go/v7/pkg/notification
> github.com/restic/restic/internal/filter
> crypto/tls
> github.com/golang-jwt/jwt
> golang.org/x/crypto/pkcs12
> golang.org/x/crypto/ssh
> github.com/klauspost/compress/huff0
> golang.org/x/crypto/openpgp/armor
> compress/zlib
> golang.org/x/crypto/openpgp/elgamal
> github.com/restic/restic/internal/textfile
> golang.org/x/crypto/openpgp/packet
> golang.org/x/term
> github.com/restic/restic/internal/ui/table
> encoding/csv
> github.com/russross/blackfriday/v2
> github.com/klauspost/compress/zstd
> gopkg.in/yaml.v3
> github.com/spf13/pflag
> golang.org/x/crypto/openpgp
> github.com/cpuguy83/go-md2man/v2/md2man
> github.com/spf13/cobra
> github.com/pkg/sftp
> net/http/httptrace
> google.golang.org/grpc/internal/credentials
> google.golang.org/api/transport/cert
> google.golang.org/grpc/credentials
> net/http
> github.com/spf13/cobra/doc
> google.golang.org/grpc/resolver
> google.golang.org/grpc/peer
> google.golang.org/grpc/internal/channelz
> google.golang.org/grpc/balancer
> google.golang.org/grpc/internal/grpcutil
> google.golang.org/grpc/balancer/grpclb/state
> google.golang.org/grpc/internal/resolver/dns
> google.golang.org/grpc/internal/binarylog
> google.golang.org/grpc/internal/resolver/passthrough
> google.golang.org/grpc/balancer/base
> google.golang.org/grpc/internal/serviceconfig
> google.golang.org/grpc/balancer/roundrobin
> github.com/Azure/go-autorest/tracing
> github.com/Azure/go-autorest/logger
> net/http/cookiejar
> net/http/httputil
> github.com/kurin/blazer/base
> golang.org/x/net/trace
> google.golang.org/api/googleapi
> golang.org/x/net/http2
> golang.org/x/net/context/ctxhttp
> golang.org/x/oauth2/internal
> cloud.google.com/go/compute/metadata
> github.com/Azure/go-autorest/autorest/adal
> cloud.google.com/go/internal/trace
> go.opencensus.io/trace/propagation
> golang.org/x/oauth2
> go.opencensus.io/plugin/ochttp/propagation/b3
> github.com/kurin/blazer/b2
> github.com/restic/restic/internal/debug
> google.golang.org/api/googleapi/transport
> go.opencensus.io/plugin/ochttp
> google.golang.org/api/transport/http/internal/propagation
> github.com/minio/minio-go/v7/pkg/signer
> github.com/restic/restic/internal/ui/progress
> github.com/minio/minio-go/v7/pkg/encrypt
> golang.org/x/oauth2/authhandler
> github.com/restic/restic/internal/restic
> golang.org/x/oauth2/google/internal/externalaccount
> github.com/Azure/go-autorest/autorest
> golang.org/x/oauth2/jwt
> google.golang.org/api/internal/impersonate
> github.com/minio/minio-go/v7/pkg/credentials
> golang.org/x/net/publicsuffix
> github.com/ncw/swift/v2
> golang.org/x/oauth2/google
> github.com/restic/restic/internal/selfupdate
> github.com/restic/restic/internal/ui/termstatus
> github.com/Azure/go-autorest/autorest/azure
> github.com/minio/minio-go/v7
> github.com/restic/restic/internal/ui
> github.com/restic/restic/internal/archiver
> github.com/restic/restic/internal/backend/limiter
> github.com/restic/restic/internal/backend
> github.com/restic/restic/internal/cache
> github.com/restic/restic/internal/pack
> github.com/restic/restic/internal/backend/dryrun
> github.com/Azure/azure-sdk-for-go/storage
> github.com/restic/restic/internal/bloblru
> github.com/restic/restic/internal/walker
> github.com/restic/restic/internal/fuse
> github.com/restic/restic/internal/dump
> github.com/restic/restic/internal/backend/b2
> github.com/restic/restic/internal/backend/local
> github.com/restic/restic/internal/backend/rest
> google.golang.org/grpc/internal/transport
> github.com/restic/restic/internal/backend/sftp
> github.com/restic/restic/internal/backend/swift
> github.com/restic/restic/internal/backend/mem
> github.com/restic/restic/internal/ui/backup
> github.com/restic/restic/internal/backend/rclone
> github.com/restic/restic/internal/repository
> github.com/restic/restic/internal/restorer
> google.golang.org/grpc
> github.com/restic/restic/internal/backend/azure
> github.com/restic/restic/internal/backend/s3
> github.com/restic/restic/internal/checker
> github.com/restic/restic/internal/migrations
> github.com/googleapis/gax-go/v2
> google.golang.org/api/internal
> google.golang.org/genproto/googleapis/iam/v1
> cloud.google.com/go/internal
> google.golang.org/api/internal/gensupport
> google.golang.org/api/option
> google.golang.org/api/transport/internal/dca
> cloud.google.com/go/iam
> google.golang.org/api/option/internaloption
> google.golang.org/api/transport/http
> google.golang.org/api/storage/v1
> cloud.google.com/go/storage
> github.com/restic/restic/internal/backend/gs
> github.com/restic/restic/internal/backend/location
> github.com/restic/restic/cmd/restic
> PYTHONPATH=. python3 -m sphinx -N -bhtml doc/ -d debian/doctrees build/html
> Running Sphinx v7.1.1
> WARNING: Invalid configuration value found: 'language = None'. Update your configuration to a valid language code. Falling back to 'en' (English).
> making output directory... done
> building [mo]: targets for 0 po files that are out of date
> writing output...
> building [html]: targets for 21 source files that are out of date
> updating environment: [new config] 21 added, 0 changed, 0 removed
> [2Kreading sources... [ 5%] 010_introduction
> [2Kreading sources... [ 10%] 020_installation
> [2Kreading sources... [ 14%] 030_preparing_a_new_repo
> [2Kreading sources... [ 19%] 040_backup
> [2Kreading sources... [ 24%] 045_working_with_repos
> [2Kreading sources... [ 29%] 047_tuning_backup_parameters
> [2Kreading sources... [ 33%] 050_restore
> [2Kreading sources... [ 38%] 060_forget
> [2Kreading sources... [ 43%] 070_encryption
> [2Kreading sources... [ 48%] 075_scripting
> [2Kreading sources... [ 52%] 080_examples
> [2Kreading sources... [ 57%] 090_participating
> [2Kreading sources... [ 62%] 100_references
> [2Kreading sources... [ 67%] 110_talks
> [2Kreading sources... [ 71%] REST_backend
> [2Kreading sources... [ 76%] cache
> [2Kreading sources... [ 81%] design
> [2Kreading sources... [ 86%] developer_information
> [2Kreading sources... [ 90%] faq
>
> Exception occurred:
> File "/usr/lib/python3/dist-packages/sphinx/ext/extlinks.py", line 103, in role
> title = caption % part
> ~~~~~~~~^~~~~~
> TypeError: not all arguments converted during string formatting
> The full traceback has been saved in /tmp/sphinx-err-k9qnz3ym.log, if you want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error message can be provided next time.
> A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
> make[1]: *** [debian/rules:23: override_dh_auto_build] Error 2


The full build log is available from:
http://qa-logs.debian.net/2023/07/30/exp/restic_0.14.0-1_unstable_sphinx-exp.log

Please see [1] for Sphinx changelog and [2] for Docutils changelog.

Also see [3] for the list of deprecated/removed APIs in Sphinx and possible
alternatives to them.

Some notable changes in Sphinx 6 and Sphinx 7:

- Sphinx no longer includes jquery.js and underscore.js by default.
Please use python3-sphinxcontrib.jquery package if you are using a custom
template and it still needs jquery.

- The setup.py build_sphinx command was removed. Please instead call
sphinx-build or "python3 -m sphinx" directly.

- For packages using the extlinks extension, the caption should contain
exactly one "%s" placeholder (if caption is not None).

In case you have questions, please Cc sph...@packages.debian.org on reply.

[1]: https://www.sphinx-doc.org/en/master/changes.html
[2]: https://repo.or.cz/docutils.git/blob/refs/tags/docutils-0.20.1:/RELEASE-NOTES.txt
[3]: https://www.sphinx-doc.org/en/master/extdev/deprecated.html#dev-deprecated-apis

All bugs filed during this archive rebuild are listed at:
https://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=sphinx7.1;users=python-mo...@lists.alioth.debian.org
or:
https://udd.debian.org/bugs/?release=na&merged=ign&fnewerval=7&flastmodval=7&fusertag=only&fusertagtag=sphinx7.1&fusertaguser=python-mo...@lists.alioth.debian.org&allbugs=1&cseverity=1&ctags=1&caffected=1#results

If you reassign this bug to another package, please marking it as 'affects'-ing
this package. See https://www.debian.org/Bugs/server-control#affects

[Andreas Metzler]

Colntrol: tags -1 patch

On 2023-07-30 Lucas Nussbaum <lu...@debian.org> wrote:
> Source: restic
[...]

> restic fails to build with Sphinx 7.1 and docutils 0.20, both of which
> are currently available in experimental.

> Relevant part (hopefully):

[...]

> >
> > Exception occurred:
> > File "/usr/lib/python3/dist-packages/sphinx/ext/extlinks.py", line 103, in role
> > title = caption % part
> > ~~~~~~~~^~~~~~

[...]

> Some notable changes in Sphinx 6 and Sphinx 7:

[...]

> - For packages using the extlinks extension, the caption should contain
> exactly one "%s" placeholder (if caption is not None).

Hello,

fixed in upstream GIT.

cu Andreas
--
`What a good friend you are to him, Dr. Maturin. His other friends are
so grateful to you.'
`I sew his ears on from time to time, sure'

[Andreas Metzler]

Control: tags 1042659 + pending

Dear maintainer,

I've prepared an NMU for restic (versioned as 0.14.0-1.1) and uploaded
it to DELAYED/10. (Autoremoval from testing is scheduled on Nov 14)
Please feel free to tell me if I should delay it longer.

Kind regards

Andreas

[Andreas Metzler]

On 2023-11-01 Debian Bug Tracking System <ow...@bugs.debian.org> wrote:
[...]
> #1042659: restic: FTBFS with Sphinx 7.1, docutils 0.20: TypeError: not all arguments converted during string formatting

> It has been closed by Debian FTP Masters <ftpm...@ftp-master.debian.org> (reply to Félix Sipma <fe...@debian.org>).
[...]
> * New upstream version 0.16.0 (Closes: #1031235, #1042659)
[...]

In future could we pretty pretty pretty please have a minimum amount of
communication? If you sent something like "I am working on this" or
"going to work on this in the next days" to the bug report I would not
have wasted time and effort on diagnosing the issue, digging out the
patch and preparing and testing a NMU.

TIA, cu andreas