api: audit for Go 1.15 go1.15.txt #39489

toothrot · 2020-06-09T21:28:45Z

CL 237297 introduced the following for Go 1.15:

New API changes for Go 1.15:

CL 225557:

pkg bufio, var ErrBadReadCount error

CL 224937:

pkg crypto, method (Hash) String() string

CL 217940:

pkg crypto/ecdsa, func SignASN1(io.Reader, *PrivateKey, []uint8) ([]uint8, error)
pkg crypto/ecdsa, func VerifyASN1(*PublicKey, []uint8, []uint8) bool

CL 231417:

pkg crypto/ecdsa, method (*PrivateKey) Equal(crypto.PrivateKey) bool
pkg crypto/ed25519, method (PrivateKey) Equal(crypto.PrivateKey) bool
pkg crypto/rsa, method (*PrivateKey) Equal(crypto.PrivateKey) bool

CL 223754:

pkg crypto/ecdsa, method (*PublicKey) Equal(crypto.PublicKey) bool
pkg crypto/ed25519, method (PublicKey) Equal(crypto.PublicKey) bool
pkg crypto/rsa, method (*PublicKey) Equal(crypto.PublicKey) bool

CL 202819:

pkg crypto/elliptic, func MarshalCompressed(Curve, *big.Int, *big.Int) []uint8
pkg crypto/elliptic, func UnmarshalCompressed(Curve, []uint8) (*big.Int, *big.Int)

CL 214977:

pkg crypto/tls, method (*Dialer) Dial(string, string) (net.Conn, error)
pkg crypto/tls, method (*Dialer) DialContext(context.Context, string, string) (net.Conn, error)
pkg crypto/tls, type Dialer struct
pkg crypto/tls, type Dialer struct, Config *Config
pkg crypto/tls, type Dialer struct, NetDialer *net.Dialer

CL 208226:

pkg crypto/tls, method (ClientAuthType) String() string
pkg crypto/tls, method (CurveID) String() string
pkg crypto/tls, method (SignatureScheme) String() string

CL 229122:

pkg crypto/tls, type Config struct, VerifyConnection func(ConnectionState) error

CL 217298:

pkg crypto/x509, func CreateRevocationList(io.Reader, *RevocationList, *Certificate, crypto.Signer) ([]uint8, error)
pkg crypto/x509, type RevocationList struct
pkg crypto/x509, type RevocationList struct, ExtraExtensions []pkix.Extension
pkg crypto/x509, type RevocationList struct, NextUpdate time.Time
pkg crypto/x509, type RevocationList struct, Number *big.Int
pkg crypto/x509, type RevocationList struct, RevokedCertificates []pkix.RevokedCertificate
pkg crypto/x509, type RevocationList struct, SignatureAlgorithm SignatureAlgorithm
pkg crypto/x509, type RevocationList struct, ThisUpdate time.Time

CL 145758:

pkg database/sql, method (*DB) SetConnMaxIdleTime(time.Duration)
pkg database/sql, type DBStats struct, MaxIdleTimeClosed int64

CL 214317:

pkg database/sql, method (*Row) Err() error

CL 223963:

pkg database/sql/driver, type Validator interface { IsValid }
pkg database/sql/driver, type Validator interface, IsValid() bool

CL 222637:

CL 231461:

pkg go/printer, const StdFormat = 16
pkg go/printer, const StdFormat Mode

CL 231459:

pkg go/types, type Config struct, UsesCgo bool

CL 230397:

pkg math/big, method (*Int) FillBytes([]uint8) []uint8

CL 228641:

pkg net, method (*Resolver) LookupIP(context.Context, string, string) ([]IP, error)

CL 227645:

pkg net/url, method (*URL) EscapedFragment() string
pkg net/url, type URL struct, RawFragment string

CL 207082:

pkg net/url, method (*URL) Redacted() string

CL 229101:

pkg os, method (*File) ReadFrom(io.Reader) (int64, error)

CL 228645:

pkg os, var ErrDeadlineExceeded error

CL 187919:

pkg regexp, method (*Regexp) SubexpIndex(string) int

CL 216617:

pkg strconv, func FormatComplex(complex128, uint8, int, int) string
pkg strconv, func ParseComplex(string, int) (complex128, error)

CL 205899:

pkg sync, method (*Map) LoadAndDelete(interface{}) (interface{}, bool)

CL 226877:

pkg testing, type TB interface, TempDir() string
pkg testing, method (*B) TempDir() string
pkg testing, method (*T) TempDir() string

CL 202758:

pkg testing, method (*T) Deadline() (time.Time, bool)

CL 220424:

pkg time, method (*Ticker) Reset(Duration)

/cc @golang/osp-team

ianlancetaylor · 2020-06-12T22:28:54Z

bufio.ErrBadReadCount (https://golang.org/cl/225557) did not have a proposal, but is consistent with other errors in the package.

crypto.Hash.String proposal #33430.

crypto/ecdsa ASN1 functions proposal #20544.

The various PublicKey.Equal methods were proposal #21704.
The various PrivateKey.Equal methods were a follow-on bug fix.

crypto/elliptic Compressed methods proposal #34105.

crypto/tls.Dialer proposal #18482.

crypto/tls String methods proposal #35499.

crypto/tls.Config.VerifyConnection proposal #36736.

crypto/x509.RevocationList proposal #35428.

database/sql.DB.SetConnMaxIdleTime proposal #25232.

database/sql.Row.Err proposal #35804.

database/sql/driver.Validator committed without going through the proposal process. Original commit https://golang.org/cl/174122 for #31480, then the type was renamed in https://golang.org/cl/223963 based on a suggestion from @rsc.

The debug/pe constant additions are just filling out more values defined by the object file format. No proposal required.

go/printer.StdFormat (https://golang.org/cl/231461) discussed on #37476, but no actual proposal.

go/types.Config.UsesCgo proposal #16623.

math/big.Int.FillBytes proposal #35833.

net.Resolver.LookupIP proposal #30452.

net/url/URL/EscapedFragment proposal #37776.

net/url.URL.Redacted proposal #34855.

os.File.ReadFrom (https://golang.org/cl/229101) no actual proposal. For #36817.

os.ErrDeadlineExceeded discussed by proposal review committee in #31449.

regexp.Regexp.SubexpIndex proposal #32420.

strconv.FormatComplex, ParseComplex proposal #36771.

sync.Map.LoadAndDelete proposal #33762.

testing.TB.TempDir proposal #35998.

testingT.Deadline proposal #28135.

time.Ticker.Reset proposal #33184.

ianlancetaylor · 2020-06-12T22:32:12Z

Explicitly calling out additions in 1.15 that were not routine changes and did not go through the proposal review committee. They all look fine to me.

CC @rsc

bufio.ErrBadReadCount (https://golang.org/cl/225557)

database/sql/driver.Validator (https://golang.org/cl/174122, https://golang.org/cl/223963)

go/printer.StdFormat (https://golang.org/cl/231461)

os.(*File).ReadFrom (https://golang.org/cl/229101)

toothrot · 2020-06-18T18:15:41Z

/cc @bradfitz @kardianos for database/sql changes
/cc @griesemer for go/printer
/cc @bradfitz @ianlancetaylor for net
/cc @rsc @robpike @ianlancetaylor @bradfitz @griesemer for os
/cc @rsc for regexp
/cc @rsc @ianlancetaylor @dvyukov @aclements for sync

Please review the new APIs added for Go 1.15, and check off the addition if it is acceptable, ideally having gone through our proposal process (see @ianlancetaylor's comments above). Adding the applicable proposal is welcome if it exists.

Thanks!

rsc · 2020-06-23T01:12:23Z

I looked over the APIs that @ianlancetaylor flagged above, as well as the entire list. They all look good. Thanks.

gopherbot · 2020-07-15T18:47:59Z

Change https://golang.org/cl/240683 mentions this issue: go/printer: remove exported StdFormat flag

The StdFormat flag was added as part of CL 231461, where the primary aim was to fix the bug #37476. It's expected that the existing printer modes only adjust spacing but do not change any of the code text itself. A new printing flag served as a way for cmd/gofmt and go/format to delegate a part of formatting work to the printer—where it's more more convenient and efficient to perform—while maintaining current low-level printing behavior of go/printer unmodified. We already have cmd/gofmt and the go/format API that implement standard formatting of Go source code, so there isn't a need to expose StdFormat flag to the world, as it can only cause confusion. Consider that to format source in canonical gofmt style completely it may require tasks A, B, C to be done. In one version of Go, the printer may do both A and B, while cmd/gofmt and go/format will do the remaining task C. In another version, the printer may take on doing just A, while cmd/gofmt and go/format will perform B and C. This makes it hard to add a gofmt-like mode to the printer without compromising on above fluidity. This change prefers to shift back some complexity to the implementation of the standard library, allowing us to avoid creating the new exported printing flag just for the internal needs of gofmt and go/format today. We may still want to re-think the API and consider if something better should be added, but unfortunately there isn't time for Go 1.15. We are not adding new APIs now, so we can defer this decision until Go 1.16 or later, when there is more time. For #37476. For #37453. For #39489. For #37419. Change-Id: I0bb07156dca852b043487099dcf05c5350b29e20 Reviewed-on: https://go-review.googlesource.com/c/go/+/240683 Reviewed-by: Robert Griesemer <[email protected]> Reviewed-by: Russ Cox <[email protected]>

toothrot added release-blocker okay-after-beta1 Used by release team to mark a release-blocker issue as okay to resolve either before or after beta1 labels Jun 9, 2020

toothrot added this to the Go1.15 milestone Jun 9, 2020

toothrot mentioned this issue Jun 10, 2020

crypto: implement Hash.String #33430

Closed

toothrot removed the okay-after-beta1 Used by release team to mark a release-blocker issue as okay to resolve either before or after beta1 label Jun 10, 2020

andybons added the NeedsFix The path to resolution is known, but the work has not been done. label Jun 15, 2020

rsc closed this as completed Jun 23, 2020

golang locked and limited conversation to collaborators Jul 15, 2021

gopherbot added the FrozenDueToAge label Jul 15, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

api: audit for Go 1.15 go1.15.txt #39489

api: audit for Go 1.15 go1.15.txt #39489

toothrot commented Jun 9, 2020 •

edited by rsc

Loading

ianlancetaylor commented Jun 12, 2020

ianlancetaylor commented Jun 12, 2020

toothrot commented Jun 18, 2020

rsc commented Jun 23, 2020

gopherbot commented Jul 15, 2020

api: audit for Go 1.15 go1.15.txt #39489

api: audit for Go 1.15 go1.15.txt #39489

Comments

toothrot commented Jun 9, 2020 • edited by rsc Loading

New API changes for Go 1.15:

ianlancetaylor commented Jun 12, 2020

ianlancetaylor commented Jun 12, 2020

toothrot commented Jun 18, 2020

rsc commented Jun 23, 2020

gopherbot commented Jul 15, 2020

toothrot commented Jun 9, 2020 •

edited by rsc

Loading