Update c/common to an unreleased version
... to get https://github.com/containers/common/pull/1106 . Signed-off-by: Miloslav Trmač <mitr@redhat.com>
This commit is contained in:
		
							parent
							
								
									b01478044b
								
							
						
					
					
						commit
						63d77da5b9
					
				
							
								
								
									
										8
									
								
								go.mod
								
								
								
								
							
							
						
						
									
										8
									
								
								go.mod
								
								
								
								
							|  | @ -12,12 +12,12 @@ require ( | |||
| 	github.com/containernetworking/cni v1.1.2 | ||||
| 	github.com/containernetworking/plugins v1.1.1 | ||||
| 	github.com/containers/buildah v1.26.1-0.20220716095526-d31d27c357ab | ||||
| 	github.com/containers/common v0.48.1-0.20220720145307-26032247af78 | ||||
| 	github.com/containers/common v0.49.1-0.20220729221035-246800047d46 | ||||
| 	github.com/containers/conmon v2.0.20+incompatible | ||||
| 	github.com/containers/image/v5 v5.21.2-0.20220721072459-bf19265865b7 | ||||
| 	github.com/containers/image/v5 v5.22.0 | ||||
| 	github.com/containers/ocicrypt v1.1.5 | ||||
| 	github.com/containers/psgo v1.7.2 | ||||
| 	github.com/containers/storage v1.41.1-0.20220718173332-b10c469fda0a | ||||
| 	github.com/containers/storage v1.42.0 | ||||
| 	github.com/coreos/go-systemd/v22 v22.3.2 | ||||
| 	github.com/coreos/stream-metadata-go v0.0.0-20210225230131-70edb9eb47b3 | ||||
| 	github.com/cyphar/filepath-securejoin v0.2.3 | ||||
|  | @ -43,7 +43,7 @@ require ( | |||
| 	github.com/moby/term v0.0.0-20210619224110-3f7ff695adc6 | ||||
| 	github.com/nxadm/tail v1.4.8 | ||||
| 	github.com/onsi/ginkgo v1.16.5 | ||||
| 	github.com/onsi/gomega v1.19.0 | ||||
| 	github.com/onsi/gomega v1.20.0 | ||||
| 	github.com/opencontainers/go-digest v1.0.0 | ||||
| 	github.com/opencontainers/image-spec v1.0.3-0.20220114050600-8b9d41f48198 | ||||
| 	github.com/opencontainers/runc v1.1.3 | ||||
|  |  | |||
							
								
								
									
										19
									
								
								go.sum
								
								
								
								
							
							
						
						
									
										19
									
								
								go.sum
								
								
								
								
							|  | @ -395,14 +395,14 @@ github.com/containernetworking/plugins v1.1.1/go.mod h1:Sr5TH/eBsGLXK/h71HeLfX19 | |||
| github.com/containers/buildah v1.26.1-0.20220716095526-d31d27c357ab h1:NeI0DOkTf3Tn4OpdjMhMubAfTPs2oCO5jUY5wnpv4qk= | ||||
| github.com/containers/buildah v1.26.1-0.20220716095526-d31d27c357ab/go.mod h1:iVtQtU6a+pbETBqIzg0oAWW3gTR1ItrAihJpLFFppmA= | ||||
| github.com/containers/common v0.48.1-0.20220715075726-2ac10faca05a/go.mod h1:1dA7JPGoSi83kjf5H4NIrGANyLOULyvFqV1bwvYFEek= | ||||
| github.com/containers/common v0.48.1-0.20220720145307-26032247af78 h1:Z25E8uA264l7dgk0h+1pfV5Y3ZhrFY/0eR6BUQ5BwkY= | ||||
| github.com/containers/common v0.48.1-0.20220720145307-26032247af78/go.mod h1:w9q2iCLu6pIB9qu0S9oZWM2Qo4lOWrIdDB+2SjLljqA= | ||||
| github.com/containers/common v0.49.1-0.20220729221035-246800047d46 h1:BNNV+JlPYSmaa9rTapL9kh2JZrg7hmWwi/VrIY/KH1E= | ||||
| github.com/containers/common v0.49.1-0.20220729221035-246800047d46/go.mod h1:ueM5hT0itKqCQvVJDs+EtjornAQtrHYxQJzP2gxeGIg= | ||||
| github.com/containers/conmon v2.0.20+incompatible h1:YbCVSFSCqFjjVwHTPINGdMX1F6JXHGTUje2ZYobNrkg= | ||||
| github.com/containers/conmon v2.0.20+incompatible/go.mod h1:hgwZ2mtuDrppv78a/cOBNiCm6O0UMWGx1mu7P00nu5I= | ||||
| github.com/containers/image/v5 v5.21.2-0.20220712113758-29aec5f7bbbf/go.mod h1:0+N0ZM9mgMmoZZc6uNcgnEsbX85Ne7b29cIW5lqWwVU= | ||||
| github.com/containers/image/v5 v5.21.2-0.20220714132403-2bb3f3e44c5c/go.mod h1:ykVAVRj4DhQNMHZDVU+KCtXjWBKpqiUe669eF0WBEEc= | ||||
| github.com/containers/image/v5 v5.21.2-0.20220721072459-bf19265865b7 h1:ORdlKVGjzQY3x/5A9O9poemoguCj9BW3lSKofTdvTv4= | ||||
| github.com/containers/image/v5 v5.21.2-0.20220721072459-bf19265865b7/go.mod h1:Nl5bQr7zq+fXbYyGtv9ObVMkOkOD32xMyxMfnIueCKg= | ||||
| github.com/containers/image/v5 v5.22.0 h1:KemxPmD4D2YYOFZN2SgoTk7nBFcnwPiPW0MqjYtknSE= | ||||
| github.com/containers/image/v5 v5.22.0/go.mod h1:D8Ksv2RNB8qLJ7xe1P3rgJJOSQpahA6amv2Ax++/YO4= | ||||
| github.com/containers/libtrust v0.0.0-20200511145503-9c3a6c22cd9a h1:spAGlqziZjCJL25C6F1zsQY05tfCKE9F5YwtEWWe6hU= | ||||
| github.com/containers/libtrust v0.0.0-20200511145503-9c3a6c22cd9a/go.mod h1:9rfv8iPl1ZP7aqh9YA68wnZv2NUDbXdcdPHVz0pFbPY= | ||||
| github.com/containers/ocicrypt v1.0.1/go.mod h1:MeJDzk1RJHv89LjsH0Sp5KTY3ZYkjXO/C+bKAeWFIrc= | ||||
|  | @ -419,8 +419,8 @@ github.com/containers/storage v1.38.0/go.mod h1:lBzt28gAk5ADZuRtwdndRJyqX22vnRaX | |||
| github.com/containers/storage v1.41.0/go.mod h1:Pb0l5Sm/89kolX3o2KolKQ5cCHk5vPNpJrhNaLcdS5s= | ||||
| github.com/containers/storage v1.41.1-0.20220712184034-d26be7b27860/go.mod h1:uu6HCcijN30xRxW1ZuZRngwFGOlH5NpBWYiNBnDQNRw= | ||||
| github.com/containers/storage v1.41.1-0.20220714115232-fc9b0ff5272a/go.mod h1:4DfR+cPpkXKhJnnyydD3z82DXrnTBT63y1k0QWtM2i4= | ||||
| github.com/containers/storage v1.41.1-0.20220718173332-b10c469fda0a h1:+2n/MLjSlLQwxcROpJLAOvN86SvOMB5IxOahq4iitok= | ||||
| github.com/containers/storage v1.41.1-0.20220718173332-b10c469fda0a/go.mod h1:jfYNR16uI3eCaWU2Bdn9sHgET7W8JB0OPiswQamG1Cs= | ||||
| github.com/containers/storage v1.42.0 h1:zm2AQD4NDeTB3JQ8X+Wo5+VRqNB+b4ocEd7Qj6ylPJA= | ||||
| github.com/containers/storage v1.42.0/go.mod h1:JiUJwOgOo1dr2DdOUc1MRe2GCAXABYoYmOdPF8yvH78= | ||||
| github.com/coreos/bbolt v1.3.2/go.mod h1:iRUV2dpdMOn7Bo10OQBFzIJO9kkE559Wcmn+qkEiiKk= | ||||
| github.com/coreos/etcd v3.3.10+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE= | ||||
| github.com/coreos/etcd v3.3.13+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE= | ||||
|  | @ -1041,8 +1041,9 @@ github.com/klauspost/compress v1.14.1/go.mod h1:/3/Vjq9QcHkK5uEr5lBEmyoZ1iFhe47e | |||
| github.com/klauspost/compress v1.15.1/go.mod h1:/3/Vjq9QcHkK5uEr5lBEmyoZ1iFhe47etQ6QUkpK6sk= | ||||
| github.com/klauspost/compress v1.15.4/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/compress v1.15.7/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/compress v1.15.8 h1:JahtItbkWjf2jzm/T+qgMxkP9EMHsqEUA6vCMGmXvhA= | ||||
| github.com/klauspost/compress v1.15.8/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/compress v1.15.9 h1:wKRjX6JRtDdrE9qwa4b/Cip7ACOshUI4smpCQanqjSY= | ||||
| github.com/klauspost/compress v1.15.9/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/pgzip v1.2.5 h1:qnWYvvKqedOF2ulHpMG72XQol4ILEJ8k2wwRl/Km8oE= | ||||
| github.com/klauspost/pgzip v1.2.5/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs= | ||||
| github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= | ||||
|  | @ -1277,8 +1278,9 @@ github.com/onsi/gomega v1.15.0/go.mod h1:cIuvLEne0aoVhAgh/O6ac0Op8WWw9H6eYCriF+t | |||
| github.com/onsi/gomega v1.16.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= | ||||
| github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= | ||||
| github.com/onsi/gomega v1.18.1/go.mod h1:0q+aL8jAiMXy9hbwj2mr5GziHiwhAIQpFmmtT5hitRs= | ||||
| github.com/onsi/gomega v1.19.0 h1:4ieX6qQjPP/BfC3mpsAtIGGlxTWPeA3Inl/7DtXw1tw= | ||||
| github.com/onsi/gomega v1.19.0/go.mod h1:LY+I3pBVzYsTBU1AnDwOSxaYi9WoWiqgwooUqq9yPro= | ||||
| github.com/onsi/gomega v1.20.0 h1:8W0cWlwFkflGPLltQvLRB7ZVD5HuP6ng320w2IS245Q= | ||||
| github.com/onsi/gomega v1.20.0/go.mod h1:DtrZpjmvpn2mPm4YWQa0/ALMDj9v4YxLgojwPeREyVo= | ||||
| github.com/op/go-logging v0.0.0-20160315200505-970db520ece7/go.mod h1:HzydrMdWErDVzsI23lYNej1Htcns9BCg93Dk0bBINWk= | ||||
| github.com/opencontainers/go-digest v0.0.0-20170106003457-a6d0ee40d420/go.mod h1:cMLVZDEM3+U2I4VmLI6N8jQYUd2OVphdqWwCJHrFt2s= | ||||
| github.com/opencontainers/go-digest v0.0.0-20180430190053-c9281466c8b2/go.mod h1:cMLVZDEM3+U2I4VmLI6N8jQYUd2OVphdqWwCJHrFt2s= | ||||
|  | @ -2059,6 +2061,7 @@ golang.org/x/sys v0.0.0-20220227234510-4e6760a101f9/go.mod h1:oPkhp1MJrh7nUepCBc | |||
| golang.org/x/sys v0.0.0-20220319134239-a9b59b0215f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220328115105-d36c6a25d886/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220412211240-33da011f77ad/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220422013727-9388b58f7150/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220502124256-b6088ccd6cba/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220503163025-988cb79eb6c6/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
|  |  | |||
|  | @ -102,6 +102,13 @@ type CopyOptions struct { | |||
| 	// If non-empty, asks for a signature to be added during the copy, and
 | ||||
| 	// specifies a key ID.
 | ||||
| 	SignBy string | ||||
| 	// If non-empty, passphrase to use when signing with the key ID from SignBy.
 | ||||
| 	SignPassphrase string | ||||
| 	// If non-empty, asks for a signature to be added during the copy, using
 | ||||
| 	// a sigstore private key file at the provided path.
 | ||||
| 	SignBySigstorePrivateKeyFile string | ||||
| 	// Passphrase to use when signing with SignBySigstorePrivateKeyFile.
 | ||||
| 	SignSigstorePrivateKeyPassphrase []byte | ||||
| 	// Remove any pre-existing signatures. SignBy will still add a new
 | ||||
| 	// signature.
 | ||||
| 	RemoveSignatures bool | ||||
|  | @ -293,6 +300,9 @@ func (r *Runtime) newCopier(options *CopyOptions) (*copier, error) { | |||
| 	c.imageCopyOptions.OciDecryptConfig = options.OciDecryptConfig | ||||
| 	c.imageCopyOptions.RemoveSignatures = options.RemoveSignatures | ||||
| 	c.imageCopyOptions.SignBy = options.SignBy | ||||
| 	c.imageCopyOptions.SignPassphrase = options.SignPassphrase | ||||
| 	c.imageCopyOptions.SignBySigstorePrivateKeyFile = options.SignBySigstorePrivateKeyFile | ||||
| 	c.imageCopyOptions.SignSigstorePrivateKeyPassphrase = options.SignSigstorePrivateKeyPassphrase | ||||
| 	c.imageCopyOptions.ReportWriter = options.Writer | ||||
| 
 | ||||
| 	defaultContainerConfig, err := config.Default() | ||||
|  |  | |||
|  | @ -13,6 +13,7 @@ import ( | |||
| 	"github.com/containers/image/v5/transports/alltransports" | ||||
| 	"github.com/containers/image/v5/types" | ||||
| 	"github.com/containers/storage" | ||||
| 	structcopier "github.com/jinzhu/copier" | ||||
| 	"github.com/opencontainers/go-digest" | ||||
| ) | ||||
| 
 | ||||
|  | @ -39,6 +40,28 @@ type ManifestList struct { | |||
| 	list manifests.List | ||||
| } | ||||
| 
 | ||||
| // ManifestListDescriptor references a platform-specific manifest.
 | ||||
| // Contains exclusive field like `annotations` which is only present in
 | ||||
| // OCI spec and not in docker image spec.
 | ||||
| type ManifestListDescriptor struct { | ||||
| 	manifest.Schema2Descriptor | ||||
| 	Platform manifest.Schema2PlatformSpec `json:"platform"` | ||||
| 	// Annotations contains arbitrary metadata for the image index.
 | ||||
| 	Annotations map[string]string `json:"annotations,omitempty"` | ||||
| } | ||||
| 
 | ||||
| // ManifestListData is a list of platform-specific manifests, specifically used to
 | ||||
| // generate output struct for `podman manifest inspect`. Reason for maintaining and
 | ||||
| // having this type is to ensure we can have a common type which contains exclusive
 | ||||
| // fields from both Docker manifest format and OCI manifest format.
 | ||||
| type ManifestListData struct { | ||||
| 	SchemaVersion int                      `json:"schemaVersion"` | ||||
| 	MediaType     string                   `json:"mediaType"` | ||||
| 	Manifests     []ManifestListDescriptor `json:"manifests"` | ||||
| 	// Annotations contains arbitrary metadata for the image index.
 | ||||
| 	Annotations map[string]string `json:"annotations,omitempty"` | ||||
| } | ||||
| 
 | ||||
| // ID returns the ID of the manifest list.
 | ||||
| func (m *ManifestList) ID() string { | ||||
| 	return m.image.ID() | ||||
|  | @ -210,8 +233,21 @@ func (i *Image) IsManifestList(ctx context.Context) (bool, error) { | |||
| } | ||||
| 
 | ||||
| // Inspect returns a dockerized version of the manifest list.
 | ||||
| func (m *ManifestList) Inspect() (*manifest.Schema2List, error) { | ||||
| 	return m.list.Docker(), nil | ||||
| func (m *ManifestList) Inspect() (*ManifestListData, error) { | ||||
| 	inspectList := ManifestListData{} | ||||
| 	dockerFormat := m.list.Docker() | ||||
| 	err := structcopier.Copy(&inspectList, &dockerFormat) | ||||
| 	if err != nil { | ||||
| 		return &inspectList, err | ||||
| 	} | ||||
| 	// Get missing annotation field from OCIv1 Spec
 | ||||
| 	// and populate inspect data.
 | ||||
| 	ociFormat := m.list.OCIv1() | ||||
| 	inspectList.Annotations = ociFormat.Annotations | ||||
| 	for i, manifest := range ociFormat.Manifests { | ||||
| 		inspectList.Manifests[i].Annotations = manifest.Annotations | ||||
| 	} | ||||
| 	return &inspectList, nil | ||||
| } | ||||
| 
 | ||||
| // Options for adding a manifest list.
 | ||||
|  | @ -411,14 +447,17 @@ func (m *ManifestList) Push(ctx context.Context, destination string, options *Ma | |||
| 	defer copier.close() | ||||
| 
 | ||||
| 	pushOptions := manifests.PushOptions{ | ||||
| 		Store:              m.image.runtime.store, | ||||
| 		SystemContext:      copier.systemContext, | ||||
| 		ImageListSelection: options.ImageListSelection, | ||||
| 		Instances:          options.Instances, | ||||
| 		ReportWriter:       options.Writer, | ||||
| 		SignBy:             options.SignBy, | ||||
| 		RemoveSignatures:   options.RemoveSignatures, | ||||
| 		ManifestType:       options.ManifestMIMEType, | ||||
| 		Store:                            m.image.runtime.store, | ||||
| 		SystemContext:                    copier.systemContext, | ||||
| 		ImageListSelection:               options.ImageListSelection, | ||||
| 		Instances:                        options.Instances, | ||||
| 		ReportWriter:                     options.Writer, | ||||
| 		SignBy:                           options.SignBy, | ||||
| 		SignPassphrase:                   options.SignPassphrase, | ||||
| 		SignBySigstorePrivateKeyFile:     options.SignBySigstorePrivateKeyFile, | ||||
| 		SignSigstorePrivateKeyPassphrase: options.SignSigstorePrivateKeyPassphrase, | ||||
| 		RemoveSignatures:                 options.RemoveSignatures, | ||||
| 		ManifestType:                     options.ManifestMIMEType, | ||||
| 	} | ||||
| 
 | ||||
| 	_, d, err := m.list.Push(ctx, dest, pushOptions) | ||||
|  |  | |||
|  | @ -56,15 +56,18 @@ type List interface { | |||
| // PushOptions includes various settings which are needed for pushing the
 | ||||
| // manifest list and its instances.
 | ||||
| type PushOptions struct { | ||||
| 	Store              storage.Store | ||||
| 	SystemContext      *types.SystemContext  // github.com/containers/image/types.SystemContext
 | ||||
| 	ImageListSelection cp.ImageListSelection // set to either CopySystemImage, CopyAllImages, or CopySpecificImages
 | ||||
| 	Instances          []digest.Digest       // instances to copy if ImageListSelection == CopySpecificImages
 | ||||
| 	ReportWriter       io.Writer             // will be used to log the writing of the list and any blobs
 | ||||
| 	SignBy             string                // fingerprint of GPG key to use to sign images
 | ||||
| 	RemoveSignatures   bool                  // true to discard signatures in images
 | ||||
| 	ManifestType       string                // the format to use when saving the list - possible options are oci, v2s1, and v2s2
 | ||||
| 	SourceFilter       LookupReferenceFunc   // filter the list source
 | ||||
| 	Store                            storage.Store | ||||
| 	SystemContext                    *types.SystemContext  // github.com/containers/image/types.SystemContext
 | ||||
| 	ImageListSelection               cp.ImageListSelection // set to either CopySystemImage, CopyAllImages, or CopySpecificImages
 | ||||
| 	Instances                        []digest.Digest       // instances to copy if ImageListSelection == CopySpecificImages
 | ||||
| 	ReportWriter                     io.Writer             // will be used to log the writing of the list and any blobs
 | ||||
| 	SignBy                           string                // fingerprint of GPG key to use to sign images
 | ||||
| 	SignPassphrase                   string                // passphrase to use when signing with the key ID from SignBy.
 | ||||
| 	SignBySigstorePrivateKeyFile     string                // if non-empty, asks for a signature to be added during the copy, using a sigstore private key file at the provided path.
 | ||||
| 	SignSigstorePrivateKeyPassphrase []byte                // passphrase to use when signing with SignBySigstorePrivateKeyFile.
 | ||||
| 	RemoveSignatures                 bool                  // true to discard signatures in images
 | ||||
| 	ManifestType                     string                // the format to use when saving the list - possible options are oci, v2s1, and v2s2
 | ||||
| 	SourceFilter                     LookupReferenceFunc   // filter the list source
 | ||||
| } | ||||
| 
 | ||||
| // Create creates a new list containing information about the specified image,
 | ||||
|  | @ -235,14 +238,17 @@ func (l *list) Push(ctx context.Context, dest types.ImageReference, options Push | |||
| 		} | ||||
| 	} | ||||
| 	copyOptions := &cp.Options{ | ||||
| 		ImageListSelection:    options.ImageListSelection, | ||||
| 		Instances:             options.Instances, | ||||
| 		SourceCtx:             options.SystemContext, | ||||
| 		DestinationCtx:        options.SystemContext, | ||||
| 		ReportWriter:          options.ReportWriter, | ||||
| 		RemoveSignatures:      options.RemoveSignatures, | ||||
| 		SignBy:                options.SignBy, | ||||
| 		ForceManifestMIMEType: singleImageManifestType, | ||||
| 		ImageListSelection:               options.ImageListSelection, | ||||
| 		Instances:                        options.Instances, | ||||
| 		SourceCtx:                        options.SystemContext, | ||||
| 		DestinationCtx:                   options.SystemContext, | ||||
| 		ReportWriter:                     options.ReportWriter, | ||||
| 		RemoveSignatures:                 options.RemoveSignatures, | ||||
| 		SignBy:                           options.SignBy, | ||||
| 		SignPassphrase:                   options.SignPassphrase, | ||||
| 		SignBySigstorePrivateKeyFile:     options.SignBySigstorePrivateKeyFile, | ||||
| 		SignSigstorePrivateKeyPassphrase: options.SignSigstorePrivateKeyPassphrase, | ||||
| 		ForceManifestMIMEType:            singleImageManifestType, | ||||
| 	} | ||||
| 
 | ||||
| 	// Copy whatever we were asked to copy.
 | ||||
|  |  | |||
|  | @ -1,4 +1,4 @@ | |||
| package version | ||||
| 
 | ||||
| // Version is the version of the build.
 | ||||
| const Version = "0.49.0-dev" | ||||
| const Version = "0.49.1-dev" | ||||
|  |  | |||
|  | @ -19,7 +19,6 @@ import ( | |||
| 	"github.com/containers/image/v5/internal/imagesource" | ||||
| 	"github.com/containers/image/v5/internal/pkg/platform" | ||||
| 	"github.com/containers/image/v5/internal/private" | ||||
| 	internalsig "github.com/containers/image/v5/internal/signature" | ||||
| 	"github.com/containers/image/v5/manifest" | ||||
| 	"github.com/containers/image/v5/pkg/blobinfocache" | ||||
| 	"github.com/containers/image/v5/pkg/compression" | ||||
|  | @ -405,23 +404,11 @@ func (c *copier) copyMultipleImages(ctx context.Context, policyContext *signatur | |||
| 	} | ||||
| 	updatedList := originalList.Clone() | ||||
| 
 | ||||
| 	// Read and/or clear the set of signatures for this list.
 | ||||
| 	var sigs []internalsig.Signature | ||||
| 	if options.RemoveSignatures { | ||||
| 		sigs = []internalsig.Signature{} | ||||
| 	} else { | ||||
| 		c.Printf("Getting image list signatures\n") | ||||
| 		s, err := c.rawSource.GetSignaturesWithFormat(ctx, nil) | ||||
| 		if err != nil { | ||||
| 			return nil, fmt.Errorf("reading signatures: %w", err) | ||||
| 		} | ||||
| 		sigs = s | ||||
| 	} | ||||
| 	if len(sigs) != 0 { | ||||
| 		c.Printf("Checking if image list destination supports signatures\n") | ||||
| 		if err := c.dest.SupportsSignatures(ctx); err != nil { | ||||
| 			return nil, fmt.Errorf("Can not copy signatures to %s: %w", transports.ImageName(c.dest.Reference()), err) | ||||
| 		} | ||||
| 	sigs, err := c.sourceSignatures(ctx, unparsedToplevel, options, | ||||
| 		"Getting image list signatures", | ||||
| 		"Checking if image list destination supports signatures") | ||||
| 	if err != nil { | ||||
| 		return nil, err | ||||
| 	} | ||||
| 
 | ||||
| 	// If the destination is a digested reference, make a note of that, determine what digest value we're
 | ||||
|  | @ -656,22 +643,11 @@ func (c *copier) copyOneImage(ctx context.Context, policyContext *signature.Poli | |||
| 		return nil, "", "", err | ||||
| 	} | ||||
| 
 | ||||
| 	var sigs []internalsig.Signature | ||||
| 	if options.RemoveSignatures { | ||||
| 		sigs = []internalsig.Signature{} | ||||
| 	} else { | ||||
| 		c.Printf("Getting image source signatures\n") | ||||
| 		s, err := src.UntrustedSignatures(ctx) | ||||
| 		if err != nil { | ||||
| 			return nil, "", "", fmt.Errorf("reading signatures: %w", err) | ||||
| 		} | ||||
| 		sigs = s | ||||
| 	} | ||||
| 	if len(sigs) != 0 { | ||||
| 		c.Printf("Checking if image destination supports signatures\n") | ||||
| 		if err := c.dest.SupportsSignatures(ctx); err != nil { | ||||
| 			return nil, "", "", fmt.Errorf("Can not copy signatures to %s: %w", transports.ImageName(c.dest.Reference()), err) | ||||
| 		} | ||||
| 	sigs, err := c.sourceSignatures(ctx, src, options, | ||||
| 		"Getting image source signatures", | ||||
| 		"Checking if image destination supports signatures") | ||||
| 	if err != nil { | ||||
| 		return nil, "", "", err | ||||
| 	} | ||||
| 
 | ||||
| 	// Determine if we're allowed to modify the manifest.
 | ||||
|  |  | |||
|  | @ -1,15 +1,42 @@ | |||
| package copy | ||||
| 
 | ||||
| import ( | ||||
| 	"context" | ||||
| 	"fmt" | ||||
| 
 | ||||
| 	"github.com/containers/image/v5/docker/reference" | ||||
| 	"github.com/containers/image/v5/internal/private" | ||||
| 	internalsig "github.com/containers/image/v5/internal/signature" | ||||
| 	"github.com/containers/image/v5/signature" | ||||
| 	"github.com/containers/image/v5/signature/sigstore" | ||||
| 	"github.com/containers/image/v5/transports" | ||||
| ) | ||||
| 
 | ||||
| // sourceSignatures returns signatures from unparsedSource based on options,
 | ||||
| // and verifies that they can be used (to avoid copying a large image when we
 | ||||
| // can tell in advance that it would ultimately fail)
 | ||||
| func (c *copier) sourceSignatures(ctx context.Context, unparsed private.UnparsedImage, options *Options, | ||||
| 	gettingSignaturesMessage, checkingDestMessage string) ([]internalsig.Signature, error) { | ||||
| 	var sigs []internalsig.Signature | ||||
| 	if options.RemoveSignatures { | ||||
| 		sigs = []internalsig.Signature{} | ||||
| 	} else { | ||||
| 		c.Printf("%s\n", gettingSignaturesMessage) | ||||
| 		s, err := unparsed.UntrustedSignatures(ctx) | ||||
| 		if err != nil { | ||||
| 			return nil, fmt.Errorf("reading signatures: %w", err) | ||||
| 		} | ||||
| 		sigs = s | ||||
| 	} | ||||
| 	if len(sigs) != 0 { | ||||
| 		c.Printf("%s\n", checkingDestMessage) | ||||
| 		if err := c.dest.SupportsSignatures(ctx); err != nil { | ||||
| 			return nil, fmt.Errorf("Can not copy signatures to %s: %w", transports.ImageName(c.dest.Reference()), err) | ||||
| 		} | ||||
| 	} | ||||
| 	return sigs, nil | ||||
| } | ||||
| 
 | ||||
| // createSignature creates a new signature of manifest using keyIdentity.
 | ||||
| func (c *copier) createSignature(manifest []byte, keyIdentity string, passphrase string, identity reference.Named) (internalsig.Signature, error) { | ||||
| 	mech, err := signature.NewGPGSigningMechanism() | ||||
|  |  | |||
|  | @ -6,12 +6,12 @@ const ( | |||
| 	// VersionMajor is for an API incompatible changes
 | ||||
| 	VersionMajor = 5 | ||||
| 	// VersionMinor is for functionality in a backwards-compatible manner
 | ||||
| 	VersionMinor = 21 | ||||
| 	VersionMinor = 22 | ||||
| 	// VersionPatch is for backwards-compatible bug fixes
 | ||||
| 	VersionPatch = 2 | ||||
| 	VersionPatch = 0 | ||||
| 
 | ||||
| 	// VersionDev indicates development branch. Releases will be empty string.
 | ||||
| 	VersionDev = "-dev" | ||||
| 	VersionDev = "" | ||||
| ) | ||||
| 
 | ||||
| // Version is the specification version that the package types support.
 | ||||
|  |  | |||
|  | @ -1 +1 @@ | |||
| 1.41.1-dev | ||||
| 1.42.0 | ||||
|  |  | |||
|  | @ -177,8 +177,10 @@ func writeLVMConfig(root string, cfg directLVMConfig) error { | |||
| 	if err != nil { | ||||
| 		return fmt.Errorf("marshalling direct lvm config: %w", err) | ||||
| 	} | ||||
| 	err = ioutil.WriteFile(p, b, 0600) | ||||
| 	return fmt.Errorf("writing direct lvm config to file: %w", err) | ||||
| 	if err := ioutil.WriteFile(p, b, 0600); err != nil { | ||||
| 		return fmt.Errorf("writing direct lvm config to file: %w", err) | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| func setupDirectLVM(cfg directLVMConfig) error { | ||||
|  |  | |||
|  | @ -3,7 +3,7 @@ go 1.16 | |||
| module github.com/containers/storage | ||||
| 
 | ||||
| require ( | ||||
| 	github.com/BurntSushi/toml v1.1.0 | ||||
| 	github.com/BurntSushi/toml v1.2.0 | ||||
| 	github.com/Microsoft/go-winio v0.5.2 | ||||
| 	github.com/Microsoft/hcsshim v0.9.3 | ||||
| 	github.com/containerd/stargz-snapshotter/estargz v0.12.0 | ||||
|  | @ -12,7 +12,7 @@ require ( | |||
| 	github.com/google/go-intervals v0.0.2 | ||||
| 	github.com/hashicorp/go-multierror v1.1.1 | ||||
| 	github.com/json-iterator/go v1.1.12 | ||||
| 	github.com/klauspost/compress v1.15.8 | ||||
| 	github.com/klauspost/compress v1.15.9 | ||||
| 	github.com/klauspost/pgzip v1.2.5 | ||||
| 	github.com/mattn/go-shellwords v1.0.12 | ||||
| 	github.com/mistifyio/go-zfs v2.1.2-0.20190413222219-f784269be439+incompatible | ||||
|  | @ -21,13 +21,13 @@ require ( | |||
| 	github.com/opencontainers/runc v1.1.3 | ||||
| 	github.com/opencontainers/runtime-spec v1.0.3-0.20210326190908-1c3f411f0417 | ||||
| 	github.com/opencontainers/selinux v1.10.1 | ||||
| 	github.com/sirupsen/logrus v1.8.1 | ||||
| 	github.com/sirupsen/logrus v1.9.0 | ||||
| 	github.com/stretchr/testify v1.8.0 | ||||
| 	github.com/syndtr/gocapability v0.0.0-20200815063812-42c35b437635 | ||||
| 	github.com/tchap/go-patricia v2.3.0+incompatible | ||||
| 	github.com/ulikunitz/xz v0.5.10 | ||||
| 	github.com/vbatts/tar-split v0.11.2 | ||||
| 	golang.org/x/net v0.0.0-20210825183410-e898025ed96a | ||||
| 	golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a | ||||
| 	golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 | ||||
| 	gotest.tools v2.2.0+incompatible | ||||
| ) | ||||
|  |  | |||
|  | @ -36,8 +36,8 @@ github.com/Azure/go-autorest/autorest/mocks v0.4.1/go.mod h1:LTp+uSrOhSkaKrUy935 | |||
| github.com/Azure/go-autorest/logger v0.2.0/go.mod h1:T9E3cAhj2VqvPOtCYAvby9aBXkZmbF5NWuPV8+WeEW8= | ||||
| github.com/Azure/go-autorest/tracing v0.6.0/go.mod h1:+vhtPC754Xsa23ID7GlGsrdKBpUA79WCAKPPZVC2DeU= | ||||
| github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= | ||||
| github.com/BurntSushi/toml v1.1.0 h1:ksErzDEI1khOiGPgpwuI7x2ebx/uXQNw7xJpn9Eq1+I= | ||||
| github.com/BurntSushi/toml v1.1.0/go.mod h1:CxXYINrC8qIiEnFrOxCa7Jy5BFHlXnUU2pbicEuybxQ= | ||||
| github.com/BurntSushi/toml v1.2.0 h1:Rt8g24XnyGTyglgET/PRUNlrUeu9F5L+7FilkXfZgs0= | ||||
| github.com/BurntSushi/toml v1.2.0/go.mod h1:CxXYINrC8qIiEnFrOxCa7Jy5BFHlXnUU2pbicEuybxQ= | ||||
| github.com/BurntSushi/xgb v0.0.0-20160522181843-27f122750802/go.mod h1:IVnqGOEym/WlBOVXweHU+Q+/VP0lqqI8lqeDx9IjBqo= | ||||
| github.com/Microsoft/go-winio v0.4.11/go.mod h1:VhR8bwka0BXejwEJY73c50VrPtXAaKcyvVC4A4RozmA= | ||||
| github.com/Microsoft/go-winio v0.4.14/go.mod h1:qXqCSQ3Xa7+6tgxaGTIe4Kpcdsi+P8jBhyzoq1bpyYA= | ||||
|  | @ -425,8 +425,8 @@ github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+o | |||
| github.com/klauspost/compress v1.11.3/go.mod h1:aoV0uJVorq1K+umq18yTdKaF57EivdYsUV+/s2qKfXs= | ||||
| github.com/klauspost/compress v1.11.13/go.mod h1:aoV0uJVorq1K+umq18yTdKaF57EivdYsUV+/s2qKfXs= | ||||
| github.com/klauspost/compress v1.15.7/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/compress v1.15.8 h1:JahtItbkWjf2jzm/T+qgMxkP9EMHsqEUA6vCMGmXvhA= | ||||
| github.com/klauspost/compress v1.15.8/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/compress v1.15.9 h1:wKRjX6JRtDdrE9qwa4b/Cip7ACOshUI4smpCQanqjSY= | ||||
| github.com/klauspost/compress v1.15.9/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= | ||||
| github.com/klauspost/pgzip v1.2.5 h1:qnWYvvKqedOF2ulHpMG72XQol4ILEJ8k2wwRl/Km8oE= | ||||
| github.com/klauspost/pgzip v1.2.5/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs= | ||||
| github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= | ||||
|  | @ -594,8 +594,9 @@ github.com/sirupsen/logrus v1.4.1/go.mod h1:ni0Sbl8bgC9z8RoU9G6nDWqqs/fq4eDPysMB | |||
| github.com/sirupsen/logrus v1.4.2/go.mod h1:tLMulIdttU9McNUspp0xgXVQah82FyeX6MwdIuYE2rE= | ||||
| github.com/sirupsen/logrus v1.6.0/go.mod h1:7uNnSEd1DgxDLC74fIahvMZmmYsHGZGEOFrfsX/uA88= | ||||
| github.com/sirupsen/logrus v1.7.0/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0= | ||||
| github.com/sirupsen/logrus v1.8.1 h1:dJKuHgqk1NNQlqoA6BTlM1Wf9DOH3NBjQyu0h9+AZZE= | ||||
| github.com/sirupsen/logrus v1.8.1/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0= | ||||
| github.com/sirupsen/logrus v1.9.0 h1:trlNQbNUG3OdDrDil03MCb1H2o9nJ1x4/5LYw7byDE0= | ||||
| github.com/sirupsen/logrus v1.9.0/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ= | ||||
| github.com/smartystreets/assertions v0.0.0-20180927180507-b2de0cb4f26d/go.mod h1:OnSkiWE9lh6wB0YB77sQom3nweQdgAjqCqsofrRNTgc= | ||||
| github.com/smartystreets/goconvey v0.0.0-20190330032615-68dc04aab96a/go.mod h1:syvi0/a8iFYH4r/RixwvyeAJjdLS9QV7WQ/tjFTllLA= | ||||
| github.com/soheilhy/cmux v0.1.4/go.mod h1:IM3LyeVVIOuxMH7sFAkER9+bJ4dT7Ms6E4xg4kGIyLM= | ||||
|  | @ -625,6 +626,7 @@ github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UV | |||
| github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= | ||||
| github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= | ||||
| github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= | ||||
| github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= | ||||
| github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= | ||||
| github.com/stretchr/testify v1.8.0 h1:pSgiaMZlXftHpm5L7V1+rVB+AZJydKsMxsQBIJw4PKk= | ||||
| github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= | ||||
|  | @ -853,8 +855,9 @@ golang.org/x/sys v0.0.0-20210906170528-6f6e22806c34/go.mod h1:oPkhp1MJrh7nUepCBc | |||
| golang.org/x/sys v0.0.0-20211025201205-69cdffdb9359/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20211116061358-0a5406a5449c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a h1:dGzPydgVsqGcTRVwiLJ1jVbufYwmzD3LfVPLKsKg+0k= | ||||
| golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8 h1:0A+M6Uqn+Eje4kHMK80dtF3JCXC4ykBgQG4Fe06QRhQ= | ||||
| golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= | ||||
| golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= | ||||
| golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= | ||||
|  |  | |||
|  | @ -0,0 +1,27 @@ | |||
| Copyright (c) 2017 The Go Authors. All rights reserved. | ||||
| 
 | ||||
| Redistribution and use in source and binary forms, with or without | ||||
| modification, are permitted provided that the following conditions are | ||||
| met: | ||||
| 
 | ||||
|    * Redistributions of source code must retain the above copyright | ||||
| notice, this list of conditions and the following disclaimer. | ||||
|    * Redistributions in binary form must reproduce the above | ||||
| copyright notice, this list of conditions and the following disclaimer | ||||
| in the documentation and/or other materials provided with the | ||||
| distribution. | ||||
|    * Neither the name of Google Inc. nor the names of its | ||||
| contributors may be used to endorse or promote products derived from | ||||
| this software without specific prior written permission. | ||||
| 
 | ||||
| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | ||||
| "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | ||||
| LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | ||||
| A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | ||||
| OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | ||||
| SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | ||||
| LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
| DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
| THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
| (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | ||||
| OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
|  | @ -0,0 +1,667 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| // Package cmp determines equality of values.
 | ||||
| //
 | ||||
| // This package is intended to be a more powerful and safer alternative to
 | ||||
| // reflect.DeepEqual for comparing whether two values are semantically equal.
 | ||||
| // It is intended to only be used in tests, as performance is not a goal and
 | ||||
| // it may panic if it cannot compare the values. Its propensity towards
 | ||||
| // panicking means that its unsuitable for production environments where a
 | ||||
| // spurious panic may be fatal.
 | ||||
| //
 | ||||
| // The primary features of cmp are:
 | ||||
| //
 | ||||
| // • When the default behavior of equality does not suit the needs of the test,
 | ||||
| // custom equality functions can override the equality operation.
 | ||||
| // For example, an equality function may report floats as equal so long as they
 | ||||
| // are within some tolerance of each other.
 | ||||
| //
 | ||||
| // • Types that have an Equal method may use that method to determine equality.
 | ||||
| // This allows package authors to determine the equality operation for the types
 | ||||
| // that they define.
 | ||||
| //
 | ||||
| // • If no custom equality functions are used and no Equal method is defined,
 | ||||
| // equality is determined by recursively comparing the primitive kinds on both
 | ||||
| // values, much like reflect.DeepEqual. Unlike reflect.DeepEqual, unexported
 | ||||
| // fields are not compared by default; they result in panics unless suppressed
 | ||||
| // by using an Ignore option (see cmpopts.IgnoreUnexported) or explicitly
 | ||||
| // compared using the Exporter option.
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 	"strings" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/diff" | ||||
| 	"github.com/google/go-cmp/cmp/internal/function" | ||||
| 	"github.com/google/go-cmp/cmp/internal/value" | ||||
| ) | ||||
| 
 | ||||
| // TODO(≥go1.18): Use any instead of interface{}.
 | ||||
| 
 | ||||
| // Equal reports whether x and y are equal by recursively applying the
 | ||||
| // following rules in the given order to x and y and all of their sub-values:
 | ||||
| //
 | ||||
| // • Let S be the set of all Ignore, Transformer, and Comparer options that
 | ||||
| // remain after applying all path filters, value filters, and type filters.
 | ||||
| // If at least one Ignore exists in S, then the comparison is ignored.
 | ||||
| // If the number of Transformer and Comparer options in S is greater than one,
 | ||||
| // then Equal panics because it is ambiguous which option to use.
 | ||||
| // If S contains a single Transformer, then use that to transform the current
 | ||||
| // values and recursively call Equal on the output values.
 | ||||
| // If S contains a single Comparer, then use that to compare the current values.
 | ||||
| // Otherwise, evaluation proceeds to the next rule.
 | ||||
| //
 | ||||
| // • If the values have an Equal method of the form "(T) Equal(T) bool" or
 | ||||
| // "(T) Equal(I) bool" where T is assignable to I, then use the result of
 | ||||
| // x.Equal(y) even if x or y is nil. Otherwise, no such method exists and
 | ||||
| // evaluation proceeds to the next rule.
 | ||||
| //
 | ||||
| // • Lastly, try to compare x and y based on their basic kinds.
 | ||||
| // Simple kinds like booleans, integers, floats, complex numbers, strings, and
 | ||||
| // channels are compared using the equivalent of the == operator in Go.
 | ||||
| // Functions are only equal if they are both nil, otherwise they are unequal.
 | ||||
| //
 | ||||
| // Structs are equal if recursively calling Equal on all fields report equal.
 | ||||
| // If a struct contains unexported fields, Equal panics unless an Ignore option
 | ||||
| // (e.g., cmpopts.IgnoreUnexported) ignores that field or the Exporter option
 | ||||
| // explicitly permits comparing the unexported field.
 | ||||
| //
 | ||||
| // Slices are equal if they are both nil or both non-nil, where recursively
 | ||||
| // calling Equal on all non-ignored slice or array elements report equal.
 | ||||
| // Empty non-nil slices and nil slices are not equal; to equate empty slices,
 | ||||
| // consider using cmpopts.EquateEmpty.
 | ||||
| //
 | ||||
| // Maps are equal if they are both nil or both non-nil, where recursively
 | ||||
| // calling Equal on all non-ignored map entries report equal.
 | ||||
| // Map keys are equal according to the == operator.
 | ||||
| // To use custom comparisons for map keys, consider using cmpopts.SortMaps.
 | ||||
| // Empty non-nil maps and nil maps are not equal; to equate empty maps,
 | ||||
| // consider using cmpopts.EquateEmpty.
 | ||||
| //
 | ||||
| // Pointers and interfaces are equal if they are both nil or both non-nil,
 | ||||
| // where they have the same underlying concrete type and recursively
 | ||||
| // calling Equal on the underlying values reports equal.
 | ||||
| //
 | ||||
| // Before recursing into a pointer, slice element, or map, the current path
 | ||||
| // is checked to detect whether the address has already been visited.
 | ||||
| // If there is a cycle, then the pointed at values are considered equal
 | ||||
| // only if both addresses were previously visited in the same path step.
 | ||||
| func Equal(x, y interface{}, opts ...Option) bool { | ||||
| 	s := newState(opts) | ||||
| 	s.compareAny(rootStep(x, y)) | ||||
| 	return s.result.Equal() | ||||
| } | ||||
| 
 | ||||
| // Diff returns a human-readable report of the differences between two values:
 | ||||
| // y - x. It returns an empty string if and only if Equal returns true for the
 | ||||
| // same input values and options.
 | ||||
| //
 | ||||
| // The output is displayed as a literal in pseudo-Go syntax.
 | ||||
| // At the start of each line, a "-" prefix indicates an element removed from x,
 | ||||
| // a "+" prefix to indicates an element added from y, and the lack of a prefix
 | ||||
| // indicates an element common to both x and y. If possible, the output
 | ||||
| // uses fmt.Stringer.String or error.Error methods to produce more humanly
 | ||||
| // readable outputs. In such cases, the string is prefixed with either an
 | ||||
| // 's' or 'e' character, respectively, to indicate that the method was called.
 | ||||
| //
 | ||||
| // Do not depend on this output being stable. If you need the ability to
 | ||||
| // programmatically interpret the difference, consider using a custom Reporter.
 | ||||
| func Diff(x, y interface{}, opts ...Option) string { | ||||
| 	s := newState(opts) | ||||
| 
 | ||||
| 	// Optimization: If there are no other reporters, we can optimize for the
 | ||||
| 	// common case where the result is equal (and thus no reported difference).
 | ||||
| 	// This avoids the expensive construction of a difference tree.
 | ||||
| 	if len(s.reporters) == 0 { | ||||
| 		s.compareAny(rootStep(x, y)) | ||||
| 		if s.result.Equal() { | ||||
| 			return "" | ||||
| 		} | ||||
| 		s.result = diff.Result{} // Reset results
 | ||||
| 	} | ||||
| 
 | ||||
| 	r := new(defaultReporter) | ||||
| 	s.reporters = append(s.reporters, reporter{r}) | ||||
| 	s.compareAny(rootStep(x, y)) | ||||
| 	d := r.String() | ||||
| 	if (d == "") != s.result.Equal() { | ||||
| 		panic("inconsistent difference and equality results") | ||||
| 	} | ||||
| 	return d | ||||
| } | ||||
| 
 | ||||
| // rootStep constructs the first path step. If x and y have differing types,
 | ||||
| // then they are stored within an empty interface type.
 | ||||
| func rootStep(x, y interface{}) PathStep { | ||||
| 	vx := reflect.ValueOf(x) | ||||
| 	vy := reflect.ValueOf(y) | ||||
| 
 | ||||
| 	// If the inputs are different types, auto-wrap them in an empty interface
 | ||||
| 	// so that they have the same parent type.
 | ||||
| 	var t reflect.Type | ||||
| 	if !vx.IsValid() || !vy.IsValid() || vx.Type() != vy.Type() { | ||||
| 		t = reflect.TypeOf((*interface{})(nil)).Elem() | ||||
| 		if vx.IsValid() { | ||||
| 			vvx := reflect.New(t).Elem() | ||||
| 			vvx.Set(vx) | ||||
| 			vx = vvx | ||||
| 		} | ||||
| 		if vy.IsValid() { | ||||
| 			vvy := reflect.New(t).Elem() | ||||
| 			vvy.Set(vy) | ||||
| 			vy = vvy | ||||
| 		} | ||||
| 	} else { | ||||
| 		t = vx.Type() | ||||
| 	} | ||||
| 
 | ||||
| 	return &pathStep{t, vx, vy} | ||||
| } | ||||
| 
 | ||||
| type state struct { | ||||
| 	// These fields represent the "comparison state".
 | ||||
| 	// Calling statelessCompare must not result in observable changes to these.
 | ||||
| 	result    diff.Result // The current result of comparison
 | ||||
| 	curPath   Path        // The current path in the value tree
 | ||||
| 	curPtrs   pointerPath // The current set of visited pointers
 | ||||
| 	reporters []reporter  // Optional reporters
 | ||||
| 
 | ||||
| 	// recChecker checks for infinite cycles applying the same set of
 | ||||
| 	// transformers upon the output of itself.
 | ||||
| 	recChecker recChecker | ||||
| 
 | ||||
| 	// dynChecker triggers pseudo-random checks for option correctness.
 | ||||
| 	// It is safe for statelessCompare to mutate this value.
 | ||||
| 	dynChecker dynChecker | ||||
| 
 | ||||
| 	// These fields, once set by processOption, will not change.
 | ||||
| 	exporters []exporter // List of exporters for structs with unexported fields
 | ||||
| 	opts      Options    // List of all fundamental and filter options
 | ||||
| } | ||||
| 
 | ||||
| func newState(opts []Option) *state { | ||||
| 	// Always ensure a validator option exists to validate the inputs.
 | ||||
| 	s := &state{opts: Options{validator{}}} | ||||
| 	s.curPtrs.Init() | ||||
| 	s.processOption(Options(opts)) | ||||
| 	return s | ||||
| } | ||||
| 
 | ||||
| func (s *state) processOption(opt Option) { | ||||
| 	switch opt := opt.(type) { | ||||
| 	case nil: | ||||
| 	case Options: | ||||
| 		for _, o := range opt { | ||||
| 			s.processOption(o) | ||||
| 		} | ||||
| 	case coreOption: | ||||
| 		type filtered interface { | ||||
| 			isFiltered() bool | ||||
| 		} | ||||
| 		if fopt, ok := opt.(filtered); ok && !fopt.isFiltered() { | ||||
| 			panic(fmt.Sprintf("cannot use an unfiltered option: %v", opt)) | ||||
| 		} | ||||
| 		s.opts = append(s.opts, opt) | ||||
| 	case exporter: | ||||
| 		s.exporters = append(s.exporters, opt) | ||||
| 	case reporter: | ||||
| 		s.reporters = append(s.reporters, opt) | ||||
| 	default: | ||||
| 		panic(fmt.Sprintf("unknown option %T", opt)) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // statelessCompare compares two values and returns the result.
 | ||||
| // This function is stateless in that it does not alter the current result,
 | ||||
| // or output to any registered reporters.
 | ||||
| func (s *state) statelessCompare(step PathStep) diff.Result { | ||||
| 	// We do not save and restore curPath and curPtrs because all of the
 | ||||
| 	// compareX methods should properly push and pop from them.
 | ||||
| 	// It is an implementation bug if the contents of the paths differ from
 | ||||
| 	// when calling this function to when returning from it.
 | ||||
| 
 | ||||
| 	oldResult, oldReporters := s.result, s.reporters | ||||
| 	s.result = diff.Result{} // Reset result
 | ||||
| 	s.reporters = nil        // Remove reporters to avoid spurious printouts
 | ||||
| 	s.compareAny(step) | ||||
| 	res := s.result | ||||
| 	s.result, s.reporters = oldResult, oldReporters | ||||
| 	return res | ||||
| } | ||||
| 
 | ||||
| func (s *state) compareAny(step PathStep) { | ||||
| 	// Update the path stack.
 | ||||
| 	s.curPath.push(step) | ||||
| 	defer s.curPath.pop() | ||||
| 	for _, r := range s.reporters { | ||||
| 		r.PushStep(step) | ||||
| 		defer r.PopStep() | ||||
| 	} | ||||
| 	s.recChecker.Check(s.curPath) | ||||
| 
 | ||||
| 	// Cycle-detection for slice elements (see NOTE in compareSlice).
 | ||||
| 	t := step.Type() | ||||
| 	vx, vy := step.Values() | ||||
| 	if si, ok := step.(SliceIndex); ok && si.isSlice && vx.IsValid() && vy.IsValid() { | ||||
| 		px, py := vx.Addr(), vy.Addr() | ||||
| 		if eq, visited := s.curPtrs.Push(px, py); visited { | ||||
| 			s.report(eq, reportByCycle) | ||||
| 			return | ||||
| 		} | ||||
| 		defer s.curPtrs.Pop(px, py) | ||||
| 	} | ||||
| 
 | ||||
| 	// Rule 1: Check whether an option applies on this node in the value tree.
 | ||||
| 	if s.tryOptions(t, vx, vy) { | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Rule 2: Check whether the type has a valid Equal method.
 | ||||
| 	if s.tryMethod(t, vx, vy) { | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Rule 3: Compare based on the underlying kind.
 | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.Bool: | ||||
| 		s.report(vx.Bool() == vy.Bool(), 0) | ||||
| 	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: | ||||
| 		s.report(vx.Int() == vy.Int(), 0) | ||||
| 	case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr: | ||||
| 		s.report(vx.Uint() == vy.Uint(), 0) | ||||
| 	case reflect.Float32, reflect.Float64: | ||||
| 		s.report(vx.Float() == vy.Float(), 0) | ||||
| 	case reflect.Complex64, reflect.Complex128: | ||||
| 		s.report(vx.Complex() == vy.Complex(), 0) | ||||
| 	case reflect.String: | ||||
| 		s.report(vx.String() == vy.String(), 0) | ||||
| 	case reflect.Chan, reflect.UnsafePointer: | ||||
| 		s.report(vx.Pointer() == vy.Pointer(), 0) | ||||
| 	case reflect.Func: | ||||
| 		s.report(vx.IsNil() && vy.IsNil(), 0) | ||||
| 	case reflect.Struct: | ||||
| 		s.compareStruct(t, vx, vy) | ||||
| 	case reflect.Slice, reflect.Array: | ||||
| 		s.compareSlice(t, vx, vy) | ||||
| 	case reflect.Map: | ||||
| 		s.compareMap(t, vx, vy) | ||||
| 	case reflect.Ptr: | ||||
| 		s.comparePtr(t, vx, vy) | ||||
| 	case reflect.Interface: | ||||
| 		s.compareInterface(t, vx, vy) | ||||
| 	default: | ||||
| 		panic(fmt.Sprintf("%v kind not handled", t.Kind())) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (s *state) tryOptions(t reflect.Type, vx, vy reflect.Value) bool { | ||||
| 	// Evaluate all filters and apply the remaining options.
 | ||||
| 	if opt := s.opts.filter(s, t, vx, vy); opt != nil { | ||||
| 		opt.apply(s, vx, vy) | ||||
| 		return true | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
| 
 | ||||
| func (s *state) tryMethod(t reflect.Type, vx, vy reflect.Value) bool { | ||||
| 	// Check if this type even has an Equal method.
 | ||||
| 	m, ok := t.MethodByName("Equal") | ||||
| 	if !ok || !function.IsType(m.Type, function.EqualAssignable) { | ||||
| 		return false | ||||
| 	} | ||||
| 
 | ||||
| 	eq := s.callTTBFunc(m.Func, vx, vy) | ||||
| 	s.report(eq, reportByMethod) | ||||
| 	return true | ||||
| } | ||||
| 
 | ||||
| func (s *state) callTRFunc(f, v reflect.Value, step Transform) reflect.Value { | ||||
| 	if !s.dynChecker.Next() { | ||||
| 		return f.Call([]reflect.Value{v})[0] | ||||
| 	} | ||||
| 
 | ||||
| 	// Run the function twice and ensure that we get the same results back.
 | ||||
| 	// We run in goroutines so that the race detector (if enabled) can detect
 | ||||
| 	// unsafe mutations to the input.
 | ||||
| 	c := make(chan reflect.Value) | ||||
| 	go detectRaces(c, f, v) | ||||
| 	got := <-c | ||||
| 	want := f.Call([]reflect.Value{v})[0] | ||||
| 	if step.vx, step.vy = got, want; !s.statelessCompare(step).Equal() { | ||||
| 		// To avoid false-positives with non-reflexive equality operations,
 | ||||
| 		// we sanity check whether a value is equal to itself.
 | ||||
| 		if step.vx, step.vy = want, want; !s.statelessCompare(step).Equal() { | ||||
| 			return want | ||||
| 		} | ||||
| 		panic(fmt.Sprintf("non-deterministic function detected: %s", function.NameOf(f))) | ||||
| 	} | ||||
| 	return want | ||||
| } | ||||
| 
 | ||||
| func (s *state) callTTBFunc(f, x, y reflect.Value) bool { | ||||
| 	if !s.dynChecker.Next() { | ||||
| 		return f.Call([]reflect.Value{x, y})[0].Bool() | ||||
| 	} | ||||
| 
 | ||||
| 	// Swapping the input arguments is sufficient to check that
 | ||||
| 	// f is symmetric and deterministic.
 | ||||
| 	// We run in goroutines so that the race detector (if enabled) can detect
 | ||||
| 	// unsafe mutations to the input.
 | ||||
| 	c := make(chan reflect.Value) | ||||
| 	go detectRaces(c, f, y, x) | ||||
| 	got := <-c | ||||
| 	want := f.Call([]reflect.Value{x, y})[0].Bool() | ||||
| 	if !got.IsValid() || got.Bool() != want { | ||||
| 		panic(fmt.Sprintf("non-deterministic or non-symmetric function detected: %s", function.NameOf(f))) | ||||
| 	} | ||||
| 	return want | ||||
| } | ||||
| 
 | ||||
| func detectRaces(c chan<- reflect.Value, f reflect.Value, vs ...reflect.Value) { | ||||
| 	var ret reflect.Value | ||||
| 	defer func() { | ||||
| 		recover() // Ignore panics, let the other call to f panic instead
 | ||||
| 		c <- ret | ||||
| 	}() | ||||
| 	ret = f.Call(vs)[0] | ||||
| } | ||||
| 
 | ||||
| func (s *state) compareStruct(t reflect.Type, vx, vy reflect.Value) { | ||||
| 	var addr bool | ||||
| 	var vax, vay reflect.Value // Addressable versions of vx and vy
 | ||||
| 
 | ||||
| 	var mayForce, mayForceInit bool | ||||
| 	step := StructField{&structField{}} | ||||
| 	for i := 0; i < t.NumField(); i++ { | ||||
| 		step.typ = t.Field(i).Type | ||||
| 		step.vx = vx.Field(i) | ||||
| 		step.vy = vy.Field(i) | ||||
| 		step.name = t.Field(i).Name | ||||
| 		step.idx = i | ||||
| 		step.unexported = !isExported(step.name) | ||||
| 		if step.unexported { | ||||
| 			if step.name == "_" { | ||||
| 				continue | ||||
| 			} | ||||
| 			// Defer checking of unexported fields until later to give an
 | ||||
| 			// Ignore a chance to ignore the field.
 | ||||
| 			if !vax.IsValid() || !vay.IsValid() { | ||||
| 				// For retrieveUnexportedField to work, the parent struct must
 | ||||
| 				// be addressable. Create a new copy of the values if
 | ||||
| 				// necessary to make them addressable.
 | ||||
| 				addr = vx.CanAddr() || vy.CanAddr() | ||||
| 				vax = makeAddressable(vx) | ||||
| 				vay = makeAddressable(vy) | ||||
| 			} | ||||
| 			if !mayForceInit { | ||||
| 				for _, xf := range s.exporters { | ||||
| 					mayForce = mayForce || xf(t) | ||||
| 				} | ||||
| 				mayForceInit = true | ||||
| 			} | ||||
| 			step.mayForce = mayForce | ||||
| 			step.paddr = addr | ||||
| 			step.pvx = vax | ||||
| 			step.pvy = vay | ||||
| 			step.field = t.Field(i) | ||||
| 		} | ||||
| 		s.compareAny(step) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (s *state) compareSlice(t reflect.Type, vx, vy reflect.Value) { | ||||
| 	isSlice := t.Kind() == reflect.Slice | ||||
| 	if isSlice && (vx.IsNil() || vy.IsNil()) { | ||||
| 		s.report(vx.IsNil() && vy.IsNil(), 0) | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// NOTE: It is incorrect to call curPtrs.Push on the slice header pointer
 | ||||
| 	// since slices represents a list of pointers, rather than a single pointer.
 | ||||
| 	// The pointer checking logic must be handled on a per-element basis
 | ||||
| 	// in compareAny.
 | ||||
| 	//
 | ||||
| 	// A slice header (see reflect.SliceHeader) in Go is a tuple of a starting
 | ||||
| 	// pointer P, a length N, and a capacity C. Supposing each slice element has
 | ||||
| 	// a memory size of M, then the slice is equivalent to the list of pointers:
 | ||||
| 	//	[P+i*M for i in range(N)]
 | ||||
| 	//
 | ||||
| 	// For example, v[:0] and v[:1] are slices with the same starting pointer,
 | ||||
| 	// but they are clearly different values. Using the slice pointer alone
 | ||||
| 	// violates the assumption that equal pointers implies equal values.
 | ||||
| 
 | ||||
| 	step := SliceIndex{&sliceIndex{pathStep: pathStep{typ: t.Elem()}, isSlice: isSlice}} | ||||
| 	withIndexes := func(ix, iy int) SliceIndex { | ||||
| 		if ix >= 0 { | ||||
| 			step.vx, step.xkey = vx.Index(ix), ix | ||||
| 		} else { | ||||
| 			step.vx, step.xkey = reflect.Value{}, -1 | ||||
| 		} | ||||
| 		if iy >= 0 { | ||||
| 			step.vy, step.ykey = vy.Index(iy), iy | ||||
| 		} else { | ||||
| 			step.vy, step.ykey = reflect.Value{}, -1 | ||||
| 		} | ||||
| 		return step | ||||
| 	} | ||||
| 
 | ||||
| 	// Ignore options are able to ignore missing elements in a slice.
 | ||||
| 	// However, detecting these reliably requires an optimal differencing
 | ||||
| 	// algorithm, for which diff.Difference is not.
 | ||||
| 	//
 | ||||
| 	// Instead, we first iterate through both slices to detect which elements
 | ||||
| 	// would be ignored if standing alone. The index of non-discarded elements
 | ||||
| 	// are stored in a separate slice, which diffing is then performed on.
 | ||||
| 	var indexesX, indexesY []int | ||||
| 	var ignoredX, ignoredY []bool | ||||
| 	for ix := 0; ix < vx.Len(); ix++ { | ||||
| 		ignored := s.statelessCompare(withIndexes(ix, -1)).NumDiff == 0 | ||||
| 		if !ignored { | ||||
| 			indexesX = append(indexesX, ix) | ||||
| 		} | ||||
| 		ignoredX = append(ignoredX, ignored) | ||||
| 	} | ||||
| 	for iy := 0; iy < vy.Len(); iy++ { | ||||
| 		ignored := s.statelessCompare(withIndexes(-1, iy)).NumDiff == 0 | ||||
| 		if !ignored { | ||||
| 			indexesY = append(indexesY, iy) | ||||
| 		} | ||||
| 		ignoredY = append(ignoredY, ignored) | ||||
| 	} | ||||
| 
 | ||||
| 	// Compute an edit-script for slices vx and vy (excluding ignored elements).
 | ||||
| 	edits := diff.Difference(len(indexesX), len(indexesY), func(ix, iy int) diff.Result { | ||||
| 		return s.statelessCompare(withIndexes(indexesX[ix], indexesY[iy])) | ||||
| 	}) | ||||
| 
 | ||||
| 	// Replay the ignore-scripts and the edit-script.
 | ||||
| 	var ix, iy int | ||||
| 	for ix < vx.Len() || iy < vy.Len() { | ||||
| 		var e diff.EditType | ||||
| 		switch { | ||||
| 		case ix < len(ignoredX) && ignoredX[ix]: | ||||
| 			e = diff.UniqueX | ||||
| 		case iy < len(ignoredY) && ignoredY[iy]: | ||||
| 			e = diff.UniqueY | ||||
| 		default: | ||||
| 			e, edits = edits[0], edits[1:] | ||||
| 		} | ||||
| 		switch e { | ||||
| 		case diff.UniqueX: | ||||
| 			s.compareAny(withIndexes(ix, -1)) | ||||
| 			ix++ | ||||
| 		case diff.UniqueY: | ||||
| 			s.compareAny(withIndexes(-1, iy)) | ||||
| 			iy++ | ||||
| 		default: | ||||
| 			s.compareAny(withIndexes(ix, iy)) | ||||
| 			ix++ | ||||
| 			iy++ | ||||
| 		} | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (s *state) compareMap(t reflect.Type, vx, vy reflect.Value) { | ||||
| 	if vx.IsNil() || vy.IsNil() { | ||||
| 		s.report(vx.IsNil() && vy.IsNil(), 0) | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Cycle-detection for maps.
 | ||||
| 	if eq, visited := s.curPtrs.Push(vx, vy); visited { | ||||
| 		s.report(eq, reportByCycle) | ||||
| 		return | ||||
| 	} | ||||
| 	defer s.curPtrs.Pop(vx, vy) | ||||
| 
 | ||||
| 	// We combine and sort the two map keys so that we can perform the
 | ||||
| 	// comparisons in a deterministic order.
 | ||||
| 	step := MapIndex{&mapIndex{pathStep: pathStep{typ: t.Elem()}}} | ||||
| 	for _, k := range value.SortKeys(append(vx.MapKeys(), vy.MapKeys()...)) { | ||||
| 		step.vx = vx.MapIndex(k) | ||||
| 		step.vy = vy.MapIndex(k) | ||||
| 		step.key = k | ||||
| 		if !step.vx.IsValid() && !step.vy.IsValid() { | ||||
| 			// It is possible for both vx and vy to be invalid if the
 | ||||
| 			// key contained a NaN value in it.
 | ||||
| 			//
 | ||||
| 			// Even with the ability to retrieve NaN keys in Go 1.12,
 | ||||
| 			// there still isn't a sensible way to compare the values since
 | ||||
| 			// a NaN key may map to multiple unordered values.
 | ||||
| 			// The most reasonable way to compare NaNs would be to compare the
 | ||||
| 			// set of values. However, this is impossible to do efficiently
 | ||||
| 			// since set equality is provably an O(n^2) operation given only
 | ||||
| 			// an Equal function. If we had a Less function or Hash function,
 | ||||
| 			// this could be done in O(n*log(n)) or O(n), respectively.
 | ||||
| 			//
 | ||||
| 			// Rather than adding complex logic to deal with NaNs, make it
 | ||||
| 			// the user's responsibility to compare such obscure maps.
 | ||||
| 			const help = "consider providing a Comparer to compare the map" | ||||
| 			panic(fmt.Sprintf("%#v has map key with NaNs\n%s", s.curPath, help)) | ||||
| 		} | ||||
| 		s.compareAny(step) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (s *state) comparePtr(t reflect.Type, vx, vy reflect.Value) { | ||||
| 	if vx.IsNil() || vy.IsNil() { | ||||
| 		s.report(vx.IsNil() && vy.IsNil(), 0) | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Cycle-detection for pointers.
 | ||||
| 	if eq, visited := s.curPtrs.Push(vx, vy); visited { | ||||
| 		s.report(eq, reportByCycle) | ||||
| 		return | ||||
| 	} | ||||
| 	defer s.curPtrs.Pop(vx, vy) | ||||
| 
 | ||||
| 	vx, vy = vx.Elem(), vy.Elem() | ||||
| 	s.compareAny(Indirect{&indirect{pathStep{t.Elem(), vx, vy}}}) | ||||
| } | ||||
| 
 | ||||
| func (s *state) compareInterface(t reflect.Type, vx, vy reflect.Value) { | ||||
| 	if vx.IsNil() || vy.IsNil() { | ||||
| 		s.report(vx.IsNil() && vy.IsNil(), 0) | ||||
| 		return | ||||
| 	} | ||||
| 	vx, vy = vx.Elem(), vy.Elem() | ||||
| 	if vx.Type() != vy.Type() { | ||||
| 		s.report(false, 0) | ||||
| 		return | ||||
| 	} | ||||
| 	s.compareAny(TypeAssertion{&typeAssertion{pathStep{vx.Type(), vx, vy}}}) | ||||
| } | ||||
| 
 | ||||
| func (s *state) report(eq bool, rf resultFlags) { | ||||
| 	if rf&reportByIgnore == 0 { | ||||
| 		if eq { | ||||
| 			s.result.NumSame++ | ||||
| 			rf |= reportEqual | ||||
| 		} else { | ||||
| 			s.result.NumDiff++ | ||||
| 			rf |= reportUnequal | ||||
| 		} | ||||
| 	} | ||||
| 	for _, r := range s.reporters { | ||||
| 		r.Report(Result{flags: rf}) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // recChecker tracks the state needed to periodically perform checks that
 | ||||
| // user provided transformers are not stuck in an infinitely recursive cycle.
 | ||||
| type recChecker struct{ next int } | ||||
| 
 | ||||
| // Check scans the Path for any recursive transformers and panics when any
 | ||||
| // recursive transformers are detected. Note that the presence of a
 | ||||
| // recursive Transformer does not necessarily imply an infinite cycle.
 | ||||
| // As such, this check only activates after some minimal number of path steps.
 | ||||
| func (rc *recChecker) Check(p Path) { | ||||
| 	const minLen = 1 << 16 | ||||
| 	if rc.next == 0 { | ||||
| 		rc.next = minLen | ||||
| 	} | ||||
| 	if len(p) < rc.next { | ||||
| 		return | ||||
| 	} | ||||
| 	rc.next <<= 1 | ||||
| 
 | ||||
| 	// Check whether the same transformer has appeared at least twice.
 | ||||
| 	var ss []string | ||||
| 	m := map[Option]int{} | ||||
| 	for _, ps := range p { | ||||
| 		if t, ok := ps.(Transform); ok { | ||||
| 			t := t.Option() | ||||
| 			if m[t] == 1 { // Transformer was used exactly once before
 | ||||
| 				tf := t.(*transformer).fnc.Type() | ||||
| 				ss = append(ss, fmt.Sprintf("%v: %v => %v", t, tf.In(0), tf.Out(0))) | ||||
| 			} | ||||
| 			m[t]++ | ||||
| 		} | ||||
| 	} | ||||
| 	if len(ss) > 0 { | ||||
| 		const warning = "recursive set of Transformers detected" | ||||
| 		const help = "consider using cmpopts.AcyclicTransformer" | ||||
| 		set := strings.Join(ss, "\n\t") | ||||
| 		panic(fmt.Sprintf("%s:\n\t%s\n%s", warning, set, help)) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // dynChecker tracks the state needed to periodically perform checks that
 | ||||
| // user provided functions are symmetric and deterministic.
 | ||||
| // The zero value is safe for immediate use.
 | ||||
| type dynChecker struct{ curr, next int } | ||||
| 
 | ||||
| // Next increments the state and reports whether a check should be performed.
 | ||||
| //
 | ||||
| // Checks occur every Nth function call, where N is a triangular number:
 | ||||
| //	0 1 3 6 10 15 21 28 36 45 55 66 78 91 105 120 136 153 171 190 ...
 | ||||
| // See https://en.wikipedia.org/wiki/Triangular_number
 | ||||
| //
 | ||||
| // This sequence ensures that the cost of checks drops significantly as
 | ||||
| // the number of functions calls grows larger.
 | ||||
| func (dc *dynChecker) Next() bool { | ||||
| 	ok := dc.curr == dc.next | ||||
| 	if ok { | ||||
| 		dc.curr = 0 | ||||
| 		dc.next++ | ||||
| 	} | ||||
| 	dc.curr++ | ||||
| 	return ok | ||||
| } | ||||
| 
 | ||||
| // makeAddressable returns a value that is always addressable.
 | ||||
| // It returns the input verbatim if it is already addressable,
 | ||||
| // otherwise it creates a new value and returns an addressable copy.
 | ||||
| func makeAddressable(v reflect.Value) reflect.Value { | ||||
| 	if v.CanAddr() { | ||||
| 		return v | ||||
| 	} | ||||
| 	vc := reflect.New(v.Type()).Elem() | ||||
| 	vc.Set(v) | ||||
| 	return vc | ||||
| } | ||||
|  | @ -0,0 +1,16 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build purego
 | ||||
| // +build purego
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import "reflect" | ||||
| 
 | ||||
| const supportExporters = false | ||||
| 
 | ||||
| func retrieveUnexportedField(reflect.Value, reflect.StructField, bool) reflect.Value { | ||||
| 	panic("no support for forcibly accessing unexported fields") | ||||
| } | ||||
|  | @ -0,0 +1,36 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build !purego
 | ||||
| // +build !purego
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"reflect" | ||||
| 	"unsafe" | ||||
| ) | ||||
| 
 | ||||
| const supportExporters = true | ||||
| 
 | ||||
| // retrieveUnexportedField uses unsafe to forcibly retrieve any field from
 | ||||
| // a struct such that the value has read-write permissions.
 | ||||
| //
 | ||||
| // The parent struct, v, must be addressable, while f must be a StructField
 | ||||
| // describing the field to retrieve. If addr is false,
 | ||||
| // then the returned value will be shallowed copied to be non-addressable.
 | ||||
| func retrieveUnexportedField(v reflect.Value, f reflect.StructField, addr bool) reflect.Value { | ||||
| 	ve := reflect.NewAt(f.Type, unsafe.Pointer(uintptr(unsafe.Pointer(v.UnsafeAddr()))+f.Offset)).Elem() | ||||
| 	if !addr { | ||||
| 		// A field is addressable if and only if the struct is addressable.
 | ||||
| 		// If the original parent value was not addressable, shallow copy the
 | ||||
| 		// value to make it non-addressable to avoid leaking an implementation
 | ||||
| 		// detail of how forcibly exporting a field works.
 | ||||
| 		if ve.Kind() == reflect.Interface && ve.IsNil() { | ||||
| 			return reflect.Zero(f.Type) | ||||
| 		} | ||||
| 		return reflect.ValueOf(ve.Interface()).Convert(f.Type) | ||||
| 	} | ||||
| 	return ve | ||||
| } | ||||
							
								
								
									
										18
									
								
								vendor/github.com/google/go-cmp/cmp/internal/diff/debug_disable.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										18
									
								
								vendor/github.com/google/go-cmp/cmp/internal/diff/debug_disable.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,18 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build !cmp_debug
 | ||||
| // +build !cmp_debug
 | ||||
| 
 | ||||
| package diff | ||||
| 
 | ||||
| var debug debugger | ||||
| 
 | ||||
| type debugger struct{} | ||||
| 
 | ||||
| func (debugger) Begin(_, _ int, f EqualFunc, _, _ *EditScript) EqualFunc { | ||||
| 	return f | ||||
| } | ||||
| func (debugger) Update() {} | ||||
| func (debugger) Finish() {} | ||||
							
								
								
									
										123
									
								
								vendor/github.com/google/go-cmp/cmp/internal/diff/debug_enable.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										123
									
								
								vendor/github.com/google/go-cmp/cmp/internal/diff/debug_enable.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,123 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build cmp_debug
 | ||||
| // +build cmp_debug
 | ||||
| 
 | ||||
| package diff | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"strings" | ||||
| 	"sync" | ||||
| 	"time" | ||||
| ) | ||||
| 
 | ||||
| // The algorithm can be seen running in real-time by enabling debugging:
 | ||||
| //	go test -tags=cmp_debug -v
 | ||||
| //
 | ||||
| // Example output:
 | ||||
| //	=== RUN   TestDifference/#34
 | ||||
| //	┌───────────────────────────────┐
 | ||||
| //	│ \ · · · · · · · · · · · · · · │
 | ||||
| //	│ · # · · · · · · · · · · · · · │
 | ||||
| //	│ · \ · · · · · · · · · · · · · │
 | ||||
| //	│ · · \ · · · · · · · · · · · · │
 | ||||
| //	│ · · · X # · · · · · · · · · · │
 | ||||
| //	│ · · · # \ · · · · · · · · · · │
 | ||||
| //	│ · · · · · # # · · · · · · · · │
 | ||||
| //	│ · · · · · # \ · · · · · · · · │
 | ||||
| //	│ · · · · · · · \ · · · · · · · │
 | ||||
| //	│ · · · · · · · · \ · · · · · · │
 | ||||
| //	│ · · · · · · · · · \ · · · · · │
 | ||||
| //	│ · · · · · · · · · · \ · · # · │
 | ||||
| //	│ · · · · · · · · · · · \ # # · │
 | ||||
| //	│ · · · · · · · · · · · # # # · │
 | ||||
| //	│ · · · · · · · · · · # # # # · │
 | ||||
| //	│ · · · · · · · · · # # # # # · │
 | ||||
| //	│ · · · · · · · · · · · · · · \ │
 | ||||
| //	└───────────────────────────────┘
 | ||||
| //	[.Y..M.XY......YXYXY.|]
 | ||||
| //
 | ||||
| // The grid represents the edit-graph where the horizontal axis represents
 | ||||
| // list X and the vertical axis represents list Y. The start of the two lists
 | ||||
| // is the top-left, while the ends are the bottom-right. The '·' represents
 | ||||
| // an unexplored node in the graph. The '\' indicates that the two symbols
 | ||||
| // from list X and Y are equal. The 'X' indicates that two symbols are similar
 | ||||
| // (but not exactly equal) to each other. The '#' indicates that the two symbols
 | ||||
| // are different (and not similar). The algorithm traverses this graph trying to
 | ||||
| // make the paths starting in the top-left and the bottom-right connect.
 | ||||
| //
 | ||||
| // The series of '.', 'X', 'Y', and 'M' characters at the bottom represents
 | ||||
| // the currently established path from the forward and reverse searches,
 | ||||
| // separated by a '|' character.
 | ||||
| 
 | ||||
| const ( | ||||
| 	updateDelay  = 100 * time.Millisecond | ||||
| 	finishDelay  = 500 * time.Millisecond | ||||
| 	ansiTerminal = true // ANSI escape codes used to move terminal cursor
 | ||||
| ) | ||||
| 
 | ||||
| var debug debugger | ||||
| 
 | ||||
| type debugger struct { | ||||
| 	sync.Mutex | ||||
| 	p1, p2           EditScript | ||||
| 	fwdPath, revPath *EditScript | ||||
| 	grid             []byte | ||||
| 	lines            int | ||||
| } | ||||
| 
 | ||||
| func (dbg *debugger) Begin(nx, ny int, f EqualFunc, p1, p2 *EditScript) EqualFunc { | ||||
| 	dbg.Lock() | ||||
| 	dbg.fwdPath, dbg.revPath = p1, p2 | ||||
| 	top := "┌─" + strings.Repeat("──", nx) + "┐\n" | ||||
| 	row := "│ " + strings.Repeat("· ", nx) + "│\n" | ||||
| 	btm := "└─" + strings.Repeat("──", nx) + "┘\n" | ||||
| 	dbg.grid = []byte(top + strings.Repeat(row, ny) + btm) | ||||
| 	dbg.lines = strings.Count(dbg.String(), "\n") | ||||
| 	fmt.Print(dbg) | ||||
| 
 | ||||
| 	// Wrap the EqualFunc so that we can intercept each result.
 | ||||
| 	return func(ix, iy int) (r Result) { | ||||
| 		cell := dbg.grid[len(top)+iy*len(row):][len("│ ")+len("· ")*ix:][:len("·")] | ||||
| 		for i := range cell { | ||||
| 			cell[i] = 0 // Zero out the multiple bytes of UTF-8 middle-dot
 | ||||
| 		} | ||||
| 		switch r = f(ix, iy); { | ||||
| 		case r.Equal(): | ||||
| 			cell[0] = '\\' | ||||
| 		case r.Similar(): | ||||
| 			cell[0] = 'X' | ||||
| 		default: | ||||
| 			cell[0] = '#' | ||||
| 		} | ||||
| 		return | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (dbg *debugger) Update() { | ||||
| 	dbg.print(updateDelay) | ||||
| } | ||||
| 
 | ||||
| func (dbg *debugger) Finish() { | ||||
| 	dbg.print(finishDelay) | ||||
| 	dbg.Unlock() | ||||
| } | ||||
| 
 | ||||
| func (dbg *debugger) String() string { | ||||
| 	dbg.p1, dbg.p2 = *dbg.fwdPath, dbg.p2[:0] | ||||
| 	for i := len(*dbg.revPath) - 1; i >= 0; i-- { | ||||
| 		dbg.p2 = append(dbg.p2, (*dbg.revPath)[i]) | ||||
| 	} | ||||
| 	return fmt.Sprintf("%s[%v|%v]\n\n", dbg.grid, dbg.p1, dbg.p2) | ||||
| } | ||||
| 
 | ||||
| func (dbg *debugger) print(d time.Duration) { | ||||
| 	if ansiTerminal { | ||||
| 		fmt.Printf("\x1b[%dA", dbg.lines) // Reset terminal cursor
 | ||||
| 	} | ||||
| 	fmt.Print(dbg) | ||||
| 	time.Sleep(d) | ||||
| } | ||||
|  | @ -0,0 +1,398 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| // Package diff implements an algorithm for producing edit-scripts.
 | ||||
| // The edit-script is a sequence of operations needed to transform one list
 | ||||
| // of symbols into another (or vice-versa). The edits allowed are insertions,
 | ||||
| // deletions, and modifications. The summation of all edits is called the
 | ||||
| // Levenshtein distance as this problem is well-known in computer science.
 | ||||
| //
 | ||||
| // This package prioritizes performance over accuracy. That is, the run time
 | ||||
| // is more important than obtaining a minimal Levenshtein distance.
 | ||||
| package diff | ||||
| 
 | ||||
| import ( | ||||
| 	"math/rand" | ||||
| 	"time" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/flags" | ||||
| ) | ||||
| 
 | ||||
| // EditType represents a single operation within an edit-script.
 | ||||
| type EditType uint8 | ||||
| 
 | ||||
| const ( | ||||
| 	// Identity indicates that a symbol pair is identical in both list X and Y.
 | ||||
| 	Identity EditType = iota | ||||
| 	// UniqueX indicates that a symbol only exists in X and not Y.
 | ||||
| 	UniqueX | ||||
| 	// UniqueY indicates that a symbol only exists in Y and not X.
 | ||||
| 	UniqueY | ||||
| 	// Modified indicates that a symbol pair is a modification of each other.
 | ||||
| 	Modified | ||||
| ) | ||||
| 
 | ||||
| // EditScript represents the series of differences between two lists.
 | ||||
| type EditScript []EditType | ||||
| 
 | ||||
| // String returns a human-readable string representing the edit-script where
 | ||||
| // Identity, UniqueX, UniqueY, and Modified are represented by the
 | ||||
| // '.', 'X', 'Y', and 'M' characters, respectively.
 | ||||
| func (es EditScript) String() string { | ||||
| 	b := make([]byte, len(es)) | ||||
| 	for i, e := range es { | ||||
| 		switch e { | ||||
| 		case Identity: | ||||
| 			b[i] = '.' | ||||
| 		case UniqueX: | ||||
| 			b[i] = 'X' | ||||
| 		case UniqueY: | ||||
| 			b[i] = 'Y' | ||||
| 		case Modified: | ||||
| 			b[i] = 'M' | ||||
| 		default: | ||||
| 			panic("invalid edit-type") | ||||
| 		} | ||||
| 	} | ||||
| 	return string(b) | ||||
| } | ||||
| 
 | ||||
| // stats returns a histogram of the number of each type of edit operation.
 | ||||
| func (es EditScript) stats() (s struct{ NI, NX, NY, NM int }) { | ||||
| 	for _, e := range es { | ||||
| 		switch e { | ||||
| 		case Identity: | ||||
| 			s.NI++ | ||||
| 		case UniqueX: | ||||
| 			s.NX++ | ||||
| 		case UniqueY: | ||||
| 			s.NY++ | ||||
| 		case Modified: | ||||
| 			s.NM++ | ||||
| 		default: | ||||
| 			panic("invalid edit-type") | ||||
| 		} | ||||
| 	} | ||||
| 	return | ||||
| } | ||||
| 
 | ||||
| // Dist is the Levenshtein distance and is guaranteed to be 0 if and only if
 | ||||
| // lists X and Y are equal.
 | ||||
| func (es EditScript) Dist() int { return len(es) - es.stats().NI } | ||||
| 
 | ||||
| // LenX is the length of the X list.
 | ||||
| func (es EditScript) LenX() int { return len(es) - es.stats().NY } | ||||
| 
 | ||||
| // LenY is the length of the Y list.
 | ||||
| func (es EditScript) LenY() int { return len(es) - es.stats().NX } | ||||
| 
 | ||||
| // EqualFunc reports whether the symbols at indexes ix and iy are equal.
 | ||||
| // When called by Difference, the index is guaranteed to be within nx and ny.
 | ||||
| type EqualFunc func(ix int, iy int) Result | ||||
| 
 | ||||
| // Result is the result of comparison.
 | ||||
| // NumSame is the number of sub-elements that are equal.
 | ||||
| // NumDiff is the number of sub-elements that are not equal.
 | ||||
| type Result struct{ NumSame, NumDiff int } | ||||
| 
 | ||||
| // BoolResult returns a Result that is either Equal or not Equal.
 | ||||
| func BoolResult(b bool) Result { | ||||
| 	if b { | ||||
| 		return Result{NumSame: 1} // Equal, Similar
 | ||||
| 	} else { | ||||
| 		return Result{NumDiff: 2} // Not Equal, not Similar
 | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // Equal indicates whether the symbols are equal. Two symbols are equal
 | ||||
| // if and only if NumDiff == 0. If Equal, then they are also Similar.
 | ||||
| func (r Result) Equal() bool { return r.NumDiff == 0 } | ||||
| 
 | ||||
| // Similar indicates whether two symbols are similar and may be represented
 | ||||
| // by using the Modified type. As a special case, we consider binary comparisons
 | ||||
| // (i.e., those that return Result{1, 0} or Result{0, 1}) to be similar.
 | ||||
| //
 | ||||
| // The exact ratio of NumSame to NumDiff to determine similarity may change.
 | ||||
| func (r Result) Similar() bool { | ||||
| 	// Use NumSame+1 to offset NumSame so that binary comparisons are similar.
 | ||||
| 	return r.NumSame+1 >= r.NumDiff | ||||
| } | ||||
| 
 | ||||
| var randBool = rand.New(rand.NewSource(time.Now().Unix())).Intn(2) == 0 | ||||
| 
 | ||||
| // Difference reports whether two lists of lengths nx and ny are equal
 | ||||
| // given the definition of equality provided as f.
 | ||||
| //
 | ||||
| // This function returns an edit-script, which is a sequence of operations
 | ||||
| // needed to convert one list into the other. The following invariants for
 | ||||
| // the edit-script are maintained:
 | ||||
| //	• eq == (es.Dist()==0)
 | ||||
| //	• nx == es.LenX()
 | ||||
| //	• ny == es.LenY()
 | ||||
| //
 | ||||
| // This algorithm is not guaranteed to be an optimal solution (i.e., one that
 | ||||
| // produces an edit-script with a minimal Levenshtein distance). This algorithm
 | ||||
| // favors performance over optimality. The exact output is not guaranteed to
 | ||||
| // be stable and may change over time.
 | ||||
| func Difference(nx, ny int, f EqualFunc) (es EditScript) { | ||||
| 	// This algorithm is based on traversing what is known as an "edit-graph".
 | ||||
| 	// See Figure 1 from "An O(ND) Difference Algorithm and Its Variations"
 | ||||
| 	// by Eugene W. Myers. Since D can be as large as N itself, this is
 | ||||
| 	// effectively O(N^2). Unlike the algorithm from that paper, we are not
 | ||||
| 	// interested in the optimal path, but at least some "decent" path.
 | ||||
| 	//
 | ||||
| 	// For example, let X and Y be lists of symbols:
 | ||||
| 	//	X = [A B C A B B A]
 | ||||
| 	//	Y = [C B A B A C]
 | ||||
| 	//
 | ||||
| 	// The edit-graph can be drawn as the following:
 | ||||
| 	//	   A B C A B B A
 | ||||
| 	//	  ┌─────────────┐
 | ||||
| 	//	C │_|_|\|_|_|_|_│ 0
 | ||||
| 	//	B │_|\|_|_|\|\|_│ 1
 | ||||
| 	//	A │\|_|_|\|_|_|\│ 2
 | ||||
| 	//	B │_|\|_|_|\|\|_│ 3
 | ||||
| 	//	A │\|_|_|\|_|_|\│ 4
 | ||||
| 	//	C │ | |\| | | | │ 5
 | ||||
| 	//	  └─────────────┘ 6
 | ||||
| 	//	   0 1 2 3 4 5 6 7
 | ||||
| 	//
 | ||||
| 	// List X is written along the horizontal axis, while list Y is written
 | ||||
| 	// along the vertical axis. At any point on this grid, if the symbol in
 | ||||
| 	// list X matches the corresponding symbol in list Y, then a '\' is drawn.
 | ||||
| 	// The goal of any minimal edit-script algorithm is to find a path from the
 | ||||
| 	// top-left corner to the bottom-right corner, while traveling through the
 | ||||
| 	// fewest horizontal or vertical edges.
 | ||||
| 	// A horizontal edge is equivalent to inserting a symbol from list X.
 | ||||
| 	// A vertical edge is equivalent to inserting a symbol from list Y.
 | ||||
| 	// A diagonal edge is equivalent to a matching symbol between both X and Y.
 | ||||
| 
 | ||||
| 	// Invariants:
 | ||||
| 	//	• 0 ≤ fwdPath.X ≤ (fwdFrontier.X, revFrontier.X) ≤ revPath.X ≤ nx
 | ||||
| 	//	• 0 ≤ fwdPath.Y ≤ (fwdFrontier.Y, revFrontier.Y) ≤ revPath.Y ≤ ny
 | ||||
| 	//
 | ||||
| 	// In general:
 | ||||
| 	//	• fwdFrontier.X < revFrontier.X
 | ||||
| 	//	• fwdFrontier.Y < revFrontier.Y
 | ||||
| 	// Unless, it is time for the algorithm to terminate.
 | ||||
| 	fwdPath := path{+1, point{0, 0}, make(EditScript, 0, (nx+ny)/2)} | ||||
| 	revPath := path{-1, point{nx, ny}, make(EditScript, 0)} | ||||
| 	fwdFrontier := fwdPath.point // Forward search frontier
 | ||||
| 	revFrontier := revPath.point // Reverse search frontier
 | ||||
| 
 | ||||
| 	// Search budget bounds the cost of searching for better paths.
 | ||||
| 	// The longest sequence of non-matching symbols that can be tolerated is
 | ||||
| 	// approximately the square-root of the search budget.
 | ||||
| 	searchBudget := 4 * (nx + ny) // O(n)
 | ||||
| 
 | ||||
| 	// Running the tests with the "cmp_debug" build tag prints a visualization
 | ||||
| 	// of the algorithm running in real-time. This is educational for
 | ||||
| 	// understanding how the algorithm works. See debug_enable.go.
 | ||||
| 	f = debug.Begin(nx, ny, f, &fwdPath.es, &revPath.es) | ||||
| 
 | ||||
| 	// The algorithm below is a greedy, meet-in-the-middle algorithm for
 | ||||
| 	// computing sub-optimal edit-scripts between two lists.
 | ||||
| 	//
 | ||||
| 	// The algorithm is approximately as follows:
 | ||||
| 	//	• Searching for differences switches back-and-forth between
 | ||||
| 	//	a search that starts at the beginning (the top-left corner), and
 | ||||
| 	//	a search that starts at the end (the bottom-right corner). The goal of
 | ||||
| 	//	the search is connect with the search from the opposite corner.
 | ||||
| 	//	• As we search, we build a path in a greedy manner, where the first
 | ||||
| 	//	match seen is added to the path (this is sub-optimal, but provides a
 | ||||
| 	//	decent result in practice). When matches are found, we try the next pair
 | ||||
| 	//	of symbols in the lists and follow all matches as far as possible.
 | ||||
| 	//	• When searching for matches, we search along a diagonal going through
 | ||||
| 	//	through the "frontier" point. If no matches are found, we advance the
 | ||||
| 	//	frontier towards the opposite corner.
 | ||||
| 	//	• This algorithm terminates when either the X coordinates or the
 | ||||
| 	//	Y coordinates of the forward and reverse frontier points ever intersect.
 | ||||
| 
 | ||||
| 	// This algorithm is correct even if searching only in the forward direction
 | ||||
| 	// or in the reverse direction. We do both because it is commonly observed
 | ||||
| 	// that two lists commonly differ because elements were added to the front
 | ||||
| 	// or end of the other list.
 | ||||
| 	//
 | ||||
| 	// Non-deterministically start with either the forward or reverse direction
 | ||||
| 	// to introduce some deliberate instability so that we have the flexibility
 | ||||
| 	// to change this algorithm in the future.
 | ||||
| 	if flags.Deterministic || randBool { | ||||
| 		goto forwardSearch | ||||
| 	} else { | ||||
| 		goto reverseSearch | ||||
| 	} | ||||
| 
 | ||||
| forwardSearch: | ||||
| 	{ | ||||
| 		// Forward search from the beginning.
 | ||||
| 		if fwdFrontier.X >= revFrontier.X || fwdFrontier.Y >= revFrontier.Y || searchBudget == 0 { | ||||
| 			goto finishSearch | ||||
| 		} | ||||
| 		for stop1, stop2, i := false, false, 0; !(stop1 && stop2) && searchBudget > 0; i++ { | ||||
| 			// Search in a diagonal pattern for a match.
 | ||||
| 			z := zigzag(i) | ||||
| 			p := point{fwdFrontier.X + z, fwdFrontier.Y - z} | ||||
| 			switch { | ||||
| 			case p.X >= revPath.X || p.Y < fwdPath.Y: | ||||
| 				stop1 = true // Hit top-right corner
 | ||||
| 			case p.Y >= revPath.Y || p.X < fwdPath.X: | ||||
| 				stop2 = true // Hit bottom-left corner
 | ||||
| 			case f(p.X, p.Y).Equal(): | ||||
| 				// Match found, so connect the path to this point.
 | ||||
| 				fwdPath.connect(p, f) | ||||
| 				fwdPath.append(Identity) | ||||
| 				// Follow sequence of matches as far as possible.
 | ||||
| 				for fwdPath.X < revPath.X && fwdPath.Y < revPath.Y { | ||||
| 					if !f(fwdPath.X, fwdPath.Y).Equal() { | ||||
| 						break | ||||
| 					} | ||||
| 					fwdPath.append(Identity) | ||||
| 				} | ||||
| 				fwdFrontier = fwdPath.point | ||||
| 				stop1, stop2 = true, true | ||||
| 			default: | ||||
| 				searchBudget-- // Match not found
 | ||||
| 			} | ||||
| 			debug.Update() | ||||
| 		} | ||||
| 		// Advance the frontier towards reverse point.
 | ||||
| 		if revPath.X-fwdFrontier.X >= revPath.Y-fwdFrontier.Y { | ||||
| 			fwdFrontier.X++ | ||||
| 		} else { | ||||
| 			fwdFrontier.Y++ | ||||
| 		} | ||||
| 		goto reverseSearch | ||||
| 	} | ||||
| 
 | ||||
| reverseSearch: | ||||
| 	{ | ||||
| 		// Reverse search from the end.
 | ||||
| 		if fwdFrontier.X >= revFrontier.X || fwdFrontier.Y >= revFrontier.Y || searchBudget == 0 { | ||||
| 			goto finishSearch | ||||
| 		} | ||||
| 		for stop1, stop2, i := false, false, 0; !(stop1 && stop2) && searchBudget > 0; i++ { | ||||
| 			// Search in a diagonal pattern for a match.
 | ||||
| 			z := zigzag(i) | ||||
| 			p := point{revFrontier.X - z, revFrontier.Y + z} | ||||
| 			switch { | ||||
| 			case fwdPath.X >= p.X || revPath.Y < p.Y: | ||||
| 				stop1 = true // Hit bottom-left corner
 | ||||
| 			case fwdPath.Y >= p.Y || revPath.X < p.X: | ||||
| 				stop2 = true // Hit top-right corner
 | ||||
| 			case f(p.X-1, p.Y-1).Equal(): | ||||
| 				// Match found, so connect the path to this point.
 | ||||
| 				revPath.connect(p, f) | ||||
| 				revPath.append(Identity) | ||||
| 				// Follow sequence of matches as far as possible.
 | ||||
| 				for fwdPath.X < revPath.X && fwdPath.Y < revPath.Y { | ||||
| 					if !f(revPath.X-1, revPath.Y-1).Equal() { | ||||
| 						break | ||||
| 					} | ||||
| 					revPath.append(Identity) | ||||
| 				} | ||||
| 				revFrontier = revPath.point | ||||
| 				stop1, stop2 = true, true | ||||
| 			default: | ||||
| 				searchBudget-- // Match not found
 | ||||
| 			} | ||||
| 			debug.Update() | ||||
| 		} | ||||
| 		// Advance the frontier towards forward point.
 | ||||
| 		if revFrontier.X-fwdPath.X >= revFrontier.Y-fwdPath.Y { | ||||
| 			revFrontier.X-- | ||||
| 		} else { | ||||
| 			revFrontier.Y-- | ||||
| 		} | ||||
| 		goto forwardSearch | ||||
| 	} | ||||
| 
 | ||||
| finishSearch: | ||||
| 	// Join the forward and reverse paths and then append the reverse path.
 | ||||
| 	fwdPath.connect(revPath.point, f) | ||||
| 	for i := len(revPath.es) - 1; i >= 0; i-- { | ||||
| 		t := revPath.es[i] | ||||
| 		revPath.es = revPath.es[:i] | ||||
| 		fwdPath.append(t) | ||||
| 	} | ||||
| 	debug.Finish() | ||||
| 	return fwdPath.es | ||||
| } | ||||
| 
 | ||||
| type path struct { | ||||
| 	dir   int // +1 if forward, -1 if reverse
 | ||||
| 	point     // Leading point of the EditScript path
 | ||||
| 	es    EditScript | ||||
| } | ||||
| 
 | ||||
| // connect appends any necessary Identity, Modified, UniqueX, or UniqueY types
 | ||||
| // to the edit-script to connect p.point to dst.
 | ||||
| func (p *path) connect(dst point, f EqualFunc) { | ||||
| 	if p.dir > 0 { | ||||
| 		// Connect in forward direction.
 | ||||
| 		for dst.X > p.X && dst.Y > p.Y { | ||||
| 			switch r := f(p.X, p.Y); { | ||||
| 			case r.Equal(): | ||||
| 				p.append(Identity) | ||||
| 			case r.Similar(): | ||||
| 				p.append(Modified) | ||||
| 			case dst.X-p.X >= dst.Y-p.Y: | ||||
| 				p.append(UniqueX) | ||||
| 			default: | ||||
| 				p.append(UniqueY) | ||||
| 			} | ||||
| 		} | ||||
| 		for dst.X > p.X { | ||||
| 			p.append(UniqueX) | ||||
| 		} | ||||
| 		for dst.Y > p.Y { | ||||
| 			p.append(UniqueY) | ||||
| 		} | ||||
| 	} else { | ||||
| 		// Connect in reverse direction.
 | ||||
| 		for p.X > dst.X && p.Y > dst.Y { | ||||
| 			switch r := f(p.X-1, p.Y-1); { | ||||
| 			case r.Equal(): | ||||
| 				p.append(Identity) | ||||
| 			case r.Similar(): | ||||
| 				p.append(Modified) | ||||
| 			case p.Y-dst.Y >= p.X-dst.X: | ||||
| 				p.append(UniqueY) | ||||
| 			default: | ||||
| 				p.append(UniqueX) | ||||
| 			} | ||||
| 		} | ||||
| 		for p.X > dst.X { | ||||
| 			p.append(UniqueX) | ||||
| 		} | ||||
| 		for p.Y > dst.Y { | ||||
| 			p.append(UniqueY) | ||||
| 		} | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (p *path) append(t EditType) { | ||||
| 	p.es = append(p.es, t) | ||||
| 	switch t { | ||||
| 	case Identity, Modified: | ||||
| 		p.add(p.dir, p.dir) | ||||
| 	case UniqueX: | ||||
| 		p.add(p.dir, 0) | ||||
| 	case UniqueY: | ||||
| 		p.add(0, p.dir) | ||||
| 	} | ||||
| 	debug.Update() | ||||
| } | ||||
| 
 | ||||
| type point struct{ X, Y int } | ||||
| 
 | ||||
| func (p *point) add(dx, dy int) { p.X += dx; p.Y += dy } | ||||
| 
 | ||||
| // zigzag maps a consecutive sequence of integers to a zig-zag sequence.
 | ||||
| //	[0 1 2 3 4 5 ...] => [0 -1 +1 -2 +2 ...]
 | ||||
| func zigzag(x int) int { | ||||
| 	if x&1 != 0 { | ||||
| 		x = ^x | ||||
| 	} | ||||
| 	return x >> 1 | ||||
| } | ||||
|  | @ -0,0 +1,9 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package flags | ||||
| 
 | ||||
| // Deterministic controls whether the output of Diff should be deterministic.
 | ||||
| // This is only used for testing.
 | ||||
| var Deterministic bool | ||||
|  | @ -0,0 +1,99 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| // Package function provides functionality for identifying function types.
 | ||||
| package function | ||||
| 
 | ||||
| import ( | ||||
| 	"reflect" | ||||
| 	"regexp" | ||||
| 	"runtime" | ||||
| 	"strings" | ||||
| ) | ||||
| 
 | ||||
| type funcType int | ||||
| 
 | ||||
| const ( | ||||
| 	_ funcType = iota | ||||
| 
 | ||||
| 	tbFunc  // func(T) bool
 | ||||
| 	ttbFunc // func(T, T) bool
 | ||||
| 	trbFunc // func(T, R) bool
 | ||||
| 	tibFunc // func(T, I) bool
 | ||||
| 	trFunc  // func(T) R
 | ||||
| 
 | ||||
| 	Equal             = ttbFunc // func(T, T) bool
 | ||||
| 	EqualAssignable   = tibFunc // func(T, I) bool; encapsulates func(T, T) bool
 | ||||
| 	Transformer       = trFunc  // func(T) R
 | ||||
| 	ValueFilter       = ttbFunc // func(T, T) bool
 | ||||
| 	Less              = ttbFunc // func(T, T) bool
 | ||||
| 	ValuePredicate    = tbFunc  // func(T) bool
 | ||||
| 	KeyValuePredicate = trbFunc // func(T, R) bool
 | ||||
| ) | ||||
| 
 | ||||
| var boolType = reflect.TypeOf(true) | ||||
| 
 | ||||
| // IsType reports whether the reflect.Type is of the specified function type.
 | ||||
| func IsType(t reflect.Type, ft funcType) bool { | ||||
| 	if t == nil || t.Kind() != reflect.Func || t.IsVariadic() { | ||||
| 		return false | ||||
| 	} | ||||
| 	ni, no := t.NumIn(), t.NumOut() | ||||
| 	switch ft { | ||||
| 	case tbFunc: // func(T) bool
 | ||||
| 		if ni == 1 && no == 1 && t.Out(0) == boolType { | ||||
| 			return true | ||||
| 		} | ||||
| 	case ttbFunc: // func(T, T) bool
 | ||||
| 		if ni == 2 && no == 1 && t.In(0) == t.In(1) && t.Out(0) == boolType { | ||||
| 			return true | ||||
| 		} | ||||
| 	case trbFunc: // func(T, R) bool
 | ||||
| 		if ni == 2 && no == 1 && t.Out(0) == boolType { | ||||
| 			return true | ||||
| 		} | ||||
| 	case tibFunc: // func(T, I) bool
 | ||||
| 		if ni == 2 && no == 1 && t.In(0).AssignableTo(t.In(1)) && t.Out(0) == boolType { | ||||
| 			return true | ||||
| 		} | ||||
| 	case trFunc: // func(T) R
 | ||||
| 		if ni == 1 && no == 1 { | ||||
| 			return true | ||||
| 		} | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
| 
 | ||||
| var lastIdentRx = regexp.MustCompile(`[_\p{L}][_\p{L}\p{N}]*$`) | ||||
| 
 | ||||
| // NameOf returns the name of the function value.
 | ||||
| func NameOf(v reflect.Value) string { | ||||
| 	fnc := runtime.FuncForPC(v.Pointer()) | ||||
| 	if fnc == nil { | ||||
| 		return "<unknown>" | ||||
| 	} | ||||
| 	fullName := fnc.Name() // e.g., "long/path/name/mypkg.(*MyType).(long/path/name/mypkg.myMethod)-fm"
 | ||||
| 
 | ||||
| 	// Method closures have a "-fm" suffix.
 | ||||
| 	fullName = strings.TrimSuffix(fullName, "-fm") | ||||
| 
 | ||||
| 	var name string | ||||
| 	for len(fullName) > 0 { | ||||
| 		inParen := strings.HasSuffix(fullName, ")") | ||||
| 		fullName = strings.TrimSuffix(fullName, ")") | ||||
| 
 | ||||
| 		s := lastIdentRx.FindString(fullName) | ||||
| 		if s == "" { | ||||
| 			break | ||||
| 		} | ||||
| 		name = s + "." + name | ||||
| 		fullName = strings.TrimSuffix(fullName, s) | ||||
| 
 | ||||
| 		if i := strings.LastIndexByte(fullName, '('); inParen && i >= 0 { | ||||
| 			fullName = fullName[:i] | ||||
| 		} | ||||
| 		fullName = strings.TrimSuffix(fullName, ".") | ||||
| 	} | ||||
| 	return strings.TrimSuffix(name, ".") | ||||
| } | ||||
|  | @ -0,0 +1,164 @@ | |||
| // Copyright 2020, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package value | ||||
| 
 | ||||
| import ( | ||||
| 	"reflect" | ||||
| 	"strconv" | ||||
| ) | ||||
| 
 | ||||
| var anyType = reflect.TypeOf((*interface{})(nil)).Elem() | ||||
| 
 | ||||
| // TypeString is nearly identical to reflect.Type.String,
 | ||||
| // but has an additional option to specify that full type names be used.
 | ||||
| func TypeString(t reflect.Type, qualified bool) string { | ||||
| 	return string(appendTypeName(nil, t, qualified, false)) | ||||
| } | ||||
| 
 | ||||
| func appendTypeName(b []byte, t reflect.Type, qualified, elideFunc bool) []byte { | ||||
| 	// BUG: Go reflection provides no way to disambiguate two named types
 | ||||
| 	// of the same name and within the same package,
 | ||||
| 	// but declared within the namespace of different functions.
 | ||||
| 
 | ||||
| 	// Use the "any" alias instead of "interface{}" for better readability.
 | ||||
| 	if t == anyType { | ||||
| 		return append(b, "any"...) | ||||
| 	} | ||||
| 
 | ||||
| 	// Named type.
 | ||||
| 	if t.Name() != "" { | ||||
| 		if qualified && t.PkgPath() != "" { | ||||
| 			b = append(b, '"') | ||||
| 			b = append(b, t.PkgPath()...) | ||||
| 			b = append(b, '"') | ||||
| 			b = append(b, '.') | ||||
| 			b = append(b, t.Name()...) | ||||
| 		} else { | ||||
| 			b = append(b, t.String()...) | ||||
| 		} | ||||
| 		return b | ||||
| 	} | ||||
| 
 | ||||
| 	// Unnamed type.
 | ||||
| 	switch k := t.Kind(); k { | ||||
| 	case reflect.Bool, reflect.String, reflect.UnsafePointer, | ||||
| 		reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, | ||||
| 		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr, | ||||
| 		reflect.Float32, reflect.Float64, reflect.Complex64, reflect.Complex128: | ||||
| 		b = append(b, k.String()...) | ||||
| 	case reflect.Chan: | ||||
| 		if t.ChanDir() == reflect.RecvDir { | ||||
| 			b = append(b, "<-"...) | ||||
| 		} | ||||
| 		b = append(b, "chan"...) | ||||
| 		if t.ChanDir() == reflect.SendDir { | ||||
| 			b = append(b, "<-"...) | ||||
| 		} | ||||
| 		b = append(b, ' ') | ||||
| 		b = appendTypeName(b, t.Elem(), qualified, false) | ||||
| 	case reflect.Func: | ||||
| 		if !elideFunc { | ||||
| 			b = append(b, "func"...) | ||||
| 		} | ||||
| 		b = append(b, '(') | ||||
| 		for i := 0; i < t.NumIn(); i++ { | ||||
| 			if i > 0 { | ||||
| 				b = append(b, ", "...) | ||||
| 			} | ||||
| 			if i == t.NumIn()-1 && t.IsVariadic() { | ||||
| 				b = append(b, "..."...) | ||||
| 				b = appendTypeName(b, t.In(i).Elem(), qualified, false) | ||||
| 			} else { | ||||
| 				b = appendTypeName(b, t.In(i), qualified, false) | ||||
| 			} | ||||
| 		} | ||||
| 		b = append(b, ')') | ||||
| 		switch t.NumOut() { | ||||
| 		case 0: | ||||
| 			// Do nothing
 | ||||
| 		case 1: | ||||
| 			b = append(b, ' ') | ||||
| 			b = appendTypeName(b, t.Out(0), qualified, false) | ||||
| 		default: | ||||
| 			b = append(b, " ("...) | ||||
| 			for i := 0; i < t.NumOut(); i++ { | ||||
| 				if i > 0 { | ||||
| 					b = append(b, ", "...) | ||||
| 				} | ||||
| 				b = appendTypeName(b, t.Out(i), qualified, false) | ||||
| 			} | ||||
| 			b = append(b, ')') | ||||
| 		} | ||||
| 	case reflect.Struct: | ||||
| 		b = append(b, "struct{ "...) | ||||
| 		for i := 0; i < t.NumField(); i++ { | ||||
| 			if i > 0 { | ||||
| 				b = append(b, "; "...) | ||||
| 			} | ||||
| 			sf := t.Field(i) | ||||
| 			if !sf.Anonymous { | ||||
| 				if qualified && sf.PkgPath != "" { | ||||
| 					b = append(b, '"') | ||||
| 					b = append(b, sf.PkgPath...) | ||||
| 					b = append(b, '"') | ||||
| 					b = append(b, '.') | ||||
| 				} | ||||
| 				b = append(b, sf.Name...) | ||||
| 				b = append(b, ' ') | ||||
| 			} | ||||
| 			b = appendTypeName(b, sf.Type, qualified, false) | ||||
| 			if sf.Tag != "" { | ||||
| 				b = append(b, ' ') | ||||
| 				b = strconv.AppendQuote(b, string(sf.Tag)) | ||||
| 			} | ||||
| 		} | ||||
| 		if b[len(b)-1] == ' ' { | ||||
| 			b = b[:len(b)-1] | ||||
| 		} else { | ||||
| 			b = append(b, ' ') | ||||
| 		} | ||||
| 		b = append(b, '}') | ||||
| 	case reflect.Slice, reflect.Array: | ||||
| 		b = append(b, '[') | ||||
| 		if k == reflect.Array { | ||||
| 			b = strconv.AppendUint(b, uint64(t.Len()), 10) | ||||
| 		} | ||||
| 		b = append(b, ']') | ||||
| 		b = appendTypeName(b, t.Elem(), qualified, false) | ||||
| 	case reflect.Map: | ||||
| 		b = append(b, "map["...) | ||||
| 		b = appendTypeName(b, t.Key(), qualified, false) | ||||
| 		b = append(b, ']') | ||||
| 		b = appendTypeName(b, t.Elem(), qualified, false) | ||||
| 	case reflect.Ptr: | ||||
| 		b = append(b, '*') | ||||
| 		b = appendTypeName(b, t.Elem(), qualified, false) | ||||
| 	case reflect.Interface: | ||||
| 		b = append(b, "interface{ "...) | ||||
| 		for i := 0; i < t.NumMethod(); i++ { | ||||
| 			if i > 0 { | ||||
| 				b = append(b, "; "...) | ||||
| 			} | ||||
| 			m := t.Method(i) | ||||
| 			if qualified && m.PkgPath != "" { | ||||
| 				b = append(b, '"') | ||||
| 				b = append(b, m.PkgPath...) | ||||
| 				b = append(b, '"') | ||||
| 				b = append(b, '.') | ||||
| 			} | ||||
| 			b = append(b, m.Name...) | ||||
| 			b = appendTypeName(b, m.Type, qualified, true) | ||||
| 		} | ||||
| 		if b[len(b)-1] == ' ' { | ||||
| 			b = b[:len(b)-1] | ||||
| 		} else { | ||||
| 			b = append(b, ' ') | ||||
| 		} | ||||
| 		b = append(b, '}') | ||||
| 	default: | ||||
| 		panic("invalid kind: " + k.String()) | ||||
| 	} | ||||
| 	return b | ||||
| } | ||||
							
								
								
									
										34
									
								
								vendor/github.com/google/go-cmp/cmp/internal/value/pointer_purego.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										34
									
								
								vendor/github.com/google/go-cmp/cmp/internal/value/pointer_purego.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,34 @@ | |||
| // Copyright 2018, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build purego
 | ||||
| // +build purego
 | ||||
| 
 | ||||
| package value | ||||
| 
 | ||||
| import "reflect" | ||||
| 
 | ||||
| // Pointer is an opaque typed pointer and is guaranteed to be comparable.
 | ||||
| type Pointer struct { | ||||
| 	p uintptr | ||||
| 	t reflect.Type | ||||
| } | ||||
| 
 | ||||
| // PointerOf returns a Pointer from v, which must be a
 | ||||
| // reflect.Ptr, reflect.Slice, or reflect.Map.
 | ||||
| func PointerOf(v reflect.Value) Pointer { | ||||
| 	// NOTE: Storing a pointer as an uintptr is technically incorrect as it
 | ||||
| 	// assumes that the GC implementation does not use a moving collector.
 | ||||
| 	return Pointer{v.Pointer(), v.Type()} | ||||
| } | ||||
| 
 | ||||
| // IsNil reports whether the pointer is nil.
 | ||||
| func (p Pointer) IsNil() bool { | ||||
| 	return p.p == 0 | ||||
| } | ||||
| 
 | ||||
| // Uintptr returns the pointer as a uintptr.
 | ||||
| func (p Pointer) Uintptr() uintptr { | ||||
| 	return p.p | ||||
| } | ||||
							
								
								
									
										37
									
								
								vendor/github.com/google/go-cmp/cmp/internal/value/pointer_unsafe.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										37
									
								
								vendor/github.com/google/go-cmp/cmp/internal/value/pointer_unsafe.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,37 @@ | |||
| // Copyright 2018, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| //go:build !purego
 | ||||
| // +build !purego
 | ||||
| 
 | ||||
| package value | ||||
| 
 | ||||
| import ( | ||||
| 	"reflect" | ||||
| 	"unsafe" | ||||
| ) | ||||
| 
 | ||||
| // Pointer is an opaque typed pointer and is guaranteed to be comparable.
 | ||||
| type Pointer struct { | ||||
| 	p unsafe.Pointer | ||||
| 	t reflect.Type | ||||
| } | ||||
| 
 | ||||
| // PointerOf returns a Pointer from v, which must be a
 | ||||
| // reflect.Ptr, reflect.Slice, or reflect.Map.
 | ||||
| func PointerOf(v reflect.Value) Pointer { | ||||
| 	// The proper representation of a pointer is unsafe.Pointer,
 | ||||
| 	// which is necessary if the GC ever uses a moving collector.
 | ||||
| 	return Pointer{unsafe.Pointer(v.Pointer()), v.Type()} | ||||
| } | ||||
| 
 | ||||
| // IsNil reports whether the pointer is nil.
 | ||||
| func (p Pointer) IsNil() bool { | ||||
| 	return p.p == nil | ||||
| } | ||||
| 
 | ||||
| // Uintptr returns the pointer as a uintptr.
 | ||||
| func (p Pointer) Uintptr() uintptr { | ||||
| 	return uintptr(p.p) | ||||
| } | ||||
|  | @ -0,0 +1,106 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package value | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"math" | ||||
| 	"reflect" | ||||
| 	"sort" | ||||
| ) | ||||
| 
 | ||||
| // SortKeys sorts a list of map keys, deduplicating keys if necessary.
 | ||||
| // The type of each value must be comparable.
 | ||||
| func SortKeys(vs []reflect.Value) []reflect.Value { | ||||
| 	if len(vs) == 0 { | ||||
| 		return vs | ||||
| 	} | ||||
| 
 | ||||
| 	// Sort the map keys.
 | ||||
| 	sort.SliceStable(vs, func(i, j int) bool { return isLess(vs[i], vs[j]) }) | ||||
| 
 | ||||
| 	// Deduplicate keys (fails for NaNs).
 | ||||
| 	vs2 := vs[:1] | ||||
| 	for _, v := range vs[1:] { | ||||
| 		if isLess(vs2[len(vs2)-1], v) { | ||||
| 			vs2 = append(vs2, v) | ||||
| 		} | ||||
| 	} | ||||
| 	return vs2 | ||||
| } | ||||
| 
 | ||||
| // isLess is a generic function for sorting arbitrary map keys.
 | ||||
| // The inputs must be of the same type and must be comparable.
 | ||||
| func isLess(x, y reflect.Value) bool { | ||||
| 	switch x.Type().Kind() { | ||||
| 	case reflect.Bool: | ||||
| 		return !x.Bool() && y.Bool() | ||||
| 	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: | ||||
| 		return x.Int() < y.Int() | ||||
| 	case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr: | ||||
| 		return x.Uint() < y.Uint() | ||||
| 	case reflect.Float32, reflect.Float64: | ||||
| 		// NOTE: This does not sort -0 as less than +0
 | ||||
| 		// since Go maps treat -0 and +0 as equal keys.
 | ||||
| 		fx, fy := x.Float(), y.Float() | ||||
| 		return fx < fy || math.IsNaN(fx) && !math.IsNaN(fy) | ||||
| 	case reflect.Complex64, reflect.Complex128: | ||||
| 		cx, cy := x.Complex(), y.Complex() | ||||
| 		rx, ix, ry, iy := real(cx), imag(cx), real(cy), imag(cy) | ||||
| 		if rx == ry || (math.IsNaN(rx) && math.IsNaN(ry)) { | ||||
| 			return ix < iy || math.IsNaN(ix) && !math.IsNaN(iy) | ||||
| 		} | ||||
| 		return rx < ry || math.IsNaN(rx) && !math.IsNaN(ry) | ||||
| 	case reflect.Ptr, reflect.UnsafePointer, reflect.Chan: | ||||
| 		return x.Pointer() < y.Pointer() | ||||
| 	case reflect.String: | ||||
| 		return x.String() < y.String() | ||||
| 	case reflect.Array: | ||||
| 		for i := 0; i < x.Len(); i++ { | ||||
| 			if isLess(x.Index(i), y.Index(i)) { | ||||
| 				return true | ||||
| 			} | ||||
| 			if isLess(y.Index(i), x.Index(i)) { | ||||
| 				return false | ||||
| 			} | ||||
| 		} | ||||
| 		return false | ||||
| 	case reflect.Struct: | ||||
| 		for i := 0; i < x.NumField(); i++ { | ||||
| 			if isLess(x.Field(i), y.Field(i)) { | ||||
| 				return true | ||||
| 			} | ||||
| 			if isLess(y.Field(i), x.Field(i)) { | ||||
| 				return false | ||||
| 			} | ||||
| 		} | ||||
| 		return false | ||||
| 	case reflect.Interface: | ||||
| 		vx, vy := x.Elem(), y.Elem() | ||||
| 		if !vx.IsValid() || !vy.IsValid() { | ||||
| 			return !vx.IsValid() && vy.IsValid() | ||||
| 		} | ||||
| 		tx, ty := vx.Type(), vy.Type() | ||||
| 		if tx == ty { | ||||
| 			return isLess(x.Elem(), y.Elem()) | ||||
| 		} | ||||
| 		if tx.Kind() != ty.Kind() { | ||||
| 			return vx.Kind() < vy.Kind() | ||||
| 		} | ||||
| 		if tx.String() != ty.String() { | ||||
| 			return tx.String() < ty.String() | ||||
| 		} | ||||
| 		if tx.PkgPath() != ty.PkgPath() { | ||||
| 			return tx.PkgPath() < ty.PkgPath() | ||||
| 		} | ||||
| 		// This can happen in rare situations, so we fallback to just comparing
 | ||||
| 		// the unique pointer for a reflect.Type. This guarantees deterministic
 | ||||
| 		// ordering within a program, but it is obviously not stable.
 | ||||
| 		return reflect.ValueOf(vx.Type()).Pointer() < reflect.ValueOf(vy.Type()).Pointer() | ||||
| 	default: | ||||
| 		// Must be Func, Map, or Slice; which are not comparable.
 | ||||
| 		panic(fmt.Sprintf("%T is not comparable", x.Type())) | ||||
| 	} | ||||
| } | ||||
|  | @ -0,0 +1,48 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package value | ||||
| 
 | ||||
| import ( | ||||
| 	"math" | ||||
| 	"reflect" | ||||
| ) | ||||
| 
 | ||||
| // IsZero reports whether v is the zero value.
 | ||||
| // This does not rely on Interface and so can be used on unexported fields.
 | ||||
| func IsZero(v reflect.Value) bool { | ||||
| 	switch v.Kind() { | ||||
| 	case reflect.Bool: | ||||
| 		return v.Bool() == false | ||||
| 	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: | ||||
| 		return v.Int() == 0 | ||||
| 	case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr: | ||||
| 		return v.Uint() == 0 | ||||
| 	case reflect.Float32, reflect.Float64: | ||||
| 		return math.Float64bits(v.Float()) == 0 | ||||
| 	case reflect.Complex64, reflect.Complex128: | ||||
| 		return math.Float64bits(real(v.Complex())) == 0 && math.Float64bits(imag(v.Complex())) == 0 | ||||
| 	case reflect.String: | ||||
| 		return v.String() == "" | ||||
| 	case reflect.UnsafePointer: | ||||
| 		return v.Pointer() == 0 | ||||
| 	case reflect.Chan, reflect.Func, reflect.Interface, reflect.Ptr, reflect.Map, reflect.Slice: | ||||
| 		return v.IsNil() | ||||
| 	case reflect.Array: | ||||
| 		for i := 0; i < v.Len(); i++ { | ||||
| 			if !IsZero(v.Index(i)) { | ||||
| 				return false | ||||
| 			} | ||||
| 		} | ||||
| 		return true | ||||
| 	case reflect.Struct: | ||||
| 		for i := 0; i < v.NumField(); i++ { | ||||
| 			if !IsZero(v.Field(i)) { | ||||
| 				return false | ||||
| 			} | ||||
| 		} | ||||
| 		return true | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
|  | @ -0,0 +1,552 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 	"regexp" | ||||
| 	"strings" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/function" | ||||
| ) | ||||
| 
 | ||||
| // Option configures for specific behavior of Equal and Diff. In particular,
 | ||||
| // the fundamental Option functions (Ignore, Transformer, and Comparer),
 | ||||
| // configure how equality is determined.
 | ||||
| //
 | ||||
| // The fundamental options may be composed with filters (FilterPath and
 | ||||
| // FilterValues) to control the scope over which they are applied.
 | ||||
| //
 | ||||
| // The cmp/cmpopts package provides helper functions for creating options that
 | ||||
| // may be used with Equal and Diff.
 | ||||
| type Option interface { | ||||
| 	// filter applies all filters and returns the option that remains.
 | ||||
| 	// Each option may only read s.curPath and call s.callTTBFunc.
 | ||||
| 	//
 | ||||
| 	// An Options is returned only if multiple comparers or transformers
 | ||||
| 	// can apply simultaneously and will only contain values of those types
 | ||||
| 	// or sub-Options containing values of those types.
 | ||||
| 	filter(s *state, t reflect.Type, vx, vy reflect.Value) applicableOption | ||||
| } | ||||
| 
 | ||||
| // applicableOption represents the following types:
 | ||||
| //	Fundamental: ignore | validator | *comparer | *transformer
 | ||||
| //	Grouping:    Options
 | ||||
| type applicableOption interface { | ||||
| 	Option | ||||
| 
 | ||||
| 	// apply executes the option, which may mutate s or panic.
 | ||||
| 	apply(s *state, vx, vy reflect.Value) | ||||
| } | ||||
| 
 | ||||
| // coreOption represents the following types:
 | ||||
| //	Fundamental: ignore | validator | *comparer | *transformer
 | ||||
| //	Filters:     *pathFilter | *valuesFilter
 | ||||
| type coreOption interface { | ||||
| 	Option | ||||
| 	isCore() | ||||
| } | ||||
| 
 | ||||
| type core struct{} | ||||
| 
 | ||||
| func (core) isCore() {} | ||||
| 
 | ||||
| // Options is a list of Option values that also satisfies the Option interface.
 | ||||
| // Helper comparison packages may return an Options value when packing multiple
 | ||||
| // Option values into a single Option. When this package processes an Options,
 | ||||
| // it will be implicitly expanded into a flat list.
 | ||||
| //
 | ||||
| // Applying a filter on an Options is equivalent to applying that same filter
 | ||||
| // on all individual options held within.
 | ||||
| type Options []Option | ||||
| 
 | ||||
| func (opts Options) filter(s *state, t reflect.Type, vx, vy reflect.Value) (out applicableOption) { | ||||
| 	for _, opt := range opts { | ||||
| 		switch opt := opt.filter(s, t, vx, vy); opt.(type) { | ||||
| 		case ignore: | ||||
| 			return ignore{} // Only ignore can short-circuit evaluation
 | ||||
| 		case validator: | ||||
| 			out = validator{} // Takes precedence over comparer or transformer
 | ||||
| 		case *comparer, *transformer, Options: | ||||
| 			switch out.(type) { | ||||
| 			case nil: | ||||
| 				out = opt | ||||
| 			case validator: | ||||
| 				// Keep validator
 | ||||
| 			case *comparer, *transformer, Options: | ||||
| 				out = Options{out, opt} // Conflicting comparers or transformers
 | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 	return out | ||||
| } | ||||
| 
 | ||||
| func (opts Options) apply(s *state, _, _ reflect.Value) { | ||||
| 	const warning = "ambiguous set of applicable options" | ||||
| 	const help = "consider using filters to ensure at most one Comparer or Transformer may apply" | ||||
| 	var ss []string | ||||
| 	for _, opt := range flattenOptions(nil, opts) { | ||||
| 		ss = append(ss, fmt.Sprint(opt)) | ||||
| 	} | ||||
| 	set := strings.Join(ss, "\n\t") | ||||
| 	panic(fmt.Sprintf("%s at %#v:\n\t%s\n%s", warning, s.curPath, set, help)) | ||||
| } | ||||
| 
 | ||||
| func (opts Options) String() string { | ||||
| 	var ss []string | ||||
| 	for _, opt := range opts { | ||||
| 		ss = append(ss, fmt.Sprint(opt)) | ||||
| 	} | ||||
| 	return fmt.Sprintf("Options{%s}", strings.Join(ss, ", ")) | ||||
| } | ||||
| 
 | ||||
| // FilterPath returns a new Option where opt is only evaluated if filter f
 | ||||
| // returns true for the current Path in the value tree.
 | ||||
| //
 | ||||
| // This filter is called even if a slice element or map entry is missing and
 | ||||
| // provides an opportunity to ignore such cases. The filter function must be
 | ||||
| // symmetric such that the filter result is identical regardless of whether the
 | ||||
| // missing value is from x or y.
 | ||||
| //
 | ||||
| // The option passed in may be an Ignore, Transformer, Comparer, Options, or
 | ||||
| // a previously filtered Option.
 | ||||
| func FilterPath(f func(Path) bool, opt Option) Option { | ||||
| 	if f == nil { | ||||
| 		panic("invalid path filter function") | ||||
| 	} | ||||
| 	if opt := normalizeOption(opt); opt != nil { | ||||
| 		return &pathFilter{fnc: f, opt: opt} | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| type pathFilter struct { | ||||
| 	core | ||||
| 	fnc func(Path) bool | ||||
| 	opt Option | ||||
| } | ||||
| 
 | ||||
| func (f pathFilter) filter(s *state, t reflect.Type, vx, vy reflect.Value) applicableOption { | ||||
| 	if f.fnc(s.curPath) { | ||||
| 		return f.opt.filter(s, t, vx, vy) | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| func (f pathFilter) String() string { | ||||
| 	return fmt.Sprintf("FilterPath(%s, %v)", function.NameOf(reflect.ValueOf(f.fnc)), f.opt) | ||||
| } | ||||
| 
 | ||||
| // FilterValues returns a new Option where opt is only evaluated if filter f,
 | ||||
| // which is a function of the form "func(T, T) bool", returns true for the
 | ||||
| // current pair of values being compared. If either value is invalid or
 | ||||
| // the type of the values is not assignable to T, then this filter implicitly
 | ||||
| // returns false.
 | ||||
| //
 | ||||
| // The filter function must be
 | ||||
| // symmetric (i.e., agnostic to the order of the inputs) and
 | ||||
| // deterministic (i.e., produces the same result when given the same inputs).
 | ||||
| // If T is an interface, it is possible that f is called with two values with
 | ||||
| // different concrete types that both implement T.
 | ||||
| //
 | ||||
| // The option passed in may be an Ignore, Transformer, Comparer, Options, or
 | ||||
| // a previously filtered Option.
 | ||||
| func FilterValues(f interface{}, opt Option) Option { | ||||
| 	v := reflect.ValueOf(f) | ||||
| 	if !function.IsType(v.Type(), function.ValueFilter) || v.IsNil() { | ||||
| 		panic(fmt.Sprintf("invalid values filter function: %T", f)) | ||||
| 	} | ||||
| 	if opt := normalizeOption(opt); opt != nil { | ||||
| 		vf := &valuesFilter{fnc: v, opt: opt} | ||||
| 		if ti := v.Type().In(0); ti.Kind() != reflect.Interface || ti.NumMethod() > 0 { | ||||
| 			vf.typ = ti | ||||
| 		} | ||||
| 		return vf | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| type valuesFilter struct { | ||||
| 	core | ||||
| 	typ reflect.Type  // T
 | ||||
| 	fnc reflect.Value // func(T, T) bool
 | ||||
| 	opt Option | ||||
| } | ||||
| 
 | ||||
| func (f valuesFilter) filter(s *state, t reflect.Type, vx, vy reflect.Value) applicableOption { | ||||
| 	if !vx.IsValid() || !vx.CanInterface() || !vy.IsValid() || !vy.CanInterface() { | ||||
| 		return nil | ||||
| 	} | ||||
| 	if (f.typ == nil || t.AssignableTo(f.typ)) && s.callTTBFunc(f.fnc, vx, vy) { | ||||
| 		return f.opt.filter(s, t, vx, vy) | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| func (f valuesFilter) String() string { | ||||
| 	return fmt.Sprintf("FilterValues(%s, %v)", function.NameOf(f.fnc), f.opt) | ||||
| } | ||||
| 
 | ||||
| // Ignore is an Option that causes all comparisons to be ignored.
 | ||||
| // This value is intended to be combined with FilterPath or FilterValues.
 | ||||
| // It is an error to pass an unfiltered Ignore option to Equal.
 | ||||
| func Ignore() Option { return ignore{} } | ||||
| 
 | ||||
| type ignore struct{ core } | ||||
| 
 | ||||
| func (ignore) isFiltered() bool                                                     { return false } | ||||
| func (ignore) filter(_ *state, _ reflect.Type, _, _ reflect.Value) applicableOption { return ignore{} } | ||||
| func (ignore) apply(s *state, _, _ reflect.Value)                                   { s.report(true, reportByIgnore) } | ||||
| func (ignore) String() string                                                       { return "Ignore()" } | ||||
| 
 | ||||
| // validator is a sentinel Option type to indicate that some options could not
 | ||||
| // be evaluated due to unexported fields, missing slice elements, or
 | ||||
| // missing map entries. Both values are validator only for unexported fields.
 | ||||
| type validator struct{ core } | ||||
| 
 | ||||
| func (validator) filter(_ *state, _ reflect.Type, vx, vy reflect.Value) applicableOption { | ||||
| 	if !vx.IsValid() || !vy.IsValid() { | ||||
| 		return validator{} | ||||
| 	} | ||||
| 	if !vx.CanInterface() || !vy.CanInterface() { | ||||
| 		return validator{} | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| func (validator) apply(s *state, vx, vy reflect.Value) { | ||||
| 	// Implies missing slice element or map entry.
 | ||||
| 	if !vx.IsValid() || !vy.IsValid() { | ||||
| 		s.report(vx.IsValid() == vy.IsValid(), 0) | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Unable to Interface implies unexported field without visibility access.
 | ||||
| 	if !vx.CanInterface() || !vy.CanInterface() { | ||||
| 		help := "consider using a custom Comparer; if you control the implementation of type, you can also consider using an Exporter, AllowUnexported, or cmpopts.IgnoreUnexported" | ||||
| 		var name string | ||||
| 		if t := s.curPath.Index(-2).Type(); t.Name() != "" { | ||||
| 			// Named type with unexported fields.
 | ||||
| 			name = fmt.Sprintf("%q.%v", t.PkgPath(), t.Name()) // e.g., "path/to/package".MyType
 | ||||
| 			if _, ok := reflect.New(t).Interface().(error); ok { | ||||
| 				help = "consider using cmpopts.EquateErrors to compare error values" | ||||
| 			} | ||||
| 		} else { | ||||
| 			// Unnamed type with unexported fields. Derive PkgPath from field.
 | ||||
| 			var pkgPath string | ||||
| 			for i := 0; i < t.NumField() && pkgPath == ""; i++ { | ||||
| 				pkgPath = t.Field(i).PkgPath | ||||
| 			} | ||||
| 			name = fmt.Sprintf("%q.(%v)", pkgPath, t.String()) // e.g., "path/to/package".(struct { a int })
 | ||||
| 		} | ||||
| 		panic(fmt.Sprintf("cannot handle unexported field at %#v:\n\t%v\n%s", s.curPath, name, help)) | ||||
| 	} | ||||
| 
 | ||||
| 	panic("not reachable") | ||||
| } | ||||
| 
 | ||||
| // identRx represents a valid identifier according to the Go specification.
 | ||||
| const identRx = `[_\p{L}][_\p{L}\p{N}]*` | ||||
| 
 | ||||
| var identsRx = regexp.MustCompile(`^` + identRx + `(\.` + identRx + `)*$`) | ||||
| 
 | ||||
| // Transformer returns an Option that applies a transformation function that
 | ||||
| // converts values of a certain type into that of another.
 | ||||
| //
 | ||||
| // The transformer f must be a function "func(T) R" that converts values of
 | ||||
| // type T to those of type R and is implicitly filtered to input values
 | ||||
| // assignable to T. The transformer must not mutate T in any way.
 | ||||
| //
 | ||||
| // To help prevent some cases of infinite recursive cycles applying the
 | ||||
| // same transform to the output of itself (e.g., in the case where the
 | ||||
| // input and output types are the same), an implicit filter is added such that
 | ||||
| // a transformer is applicable only if that exact transformer is not already
 | ||||
| // in the tail of the Path since the last non-Transform step.
 | ||||
| // For situations where the implicit filter is still insufficient,
 | ||||
| // consider using cmpopts.AcyclicTransformer, which adds a filter
 | ||||
| // to prevent the transformer from being recursively applied upon itself.
 | ||||
| //
 | ||||
| // The name is a user provided label that is used as the Transform.Name in the
 | ||||
| // transformation PathStep (and eventually shown in the Diff output).
 | ||||
| // The name must be a valid identifier or qualified identifier in Go syntax.
 | ||||
| // If empty, an arbitrary name is used.
 | ||||
| func Transformer(name string, f interface{}) Option { | ||||
| 	v := reflect.ValueOf(f) | ||||
| 	if !function.IsType(v.Type(), function.Transformer) || v.IsNil() { | ||||
| 		panic(fmt.Sprintf("invalid transformer function: %T", f)) | ||||
| 	} | ||||
| 	if name == "" { | ||||
| 		name = function.NameOf(v) | ||||
| 		if !identsRx.MatchString(name) { | ||||
| 			name = "λ" // Lambda-symbol as placeholder name
 | ||||
| 		} | ||||
| 	} else if !identsRx.MatchString(name) { | ||||
| 		panic(fmt.Sprintf("invalid name: %q", name)) | ||||
| 	} | ||||
| 	tr := &transformer{name: name, fnc: reflect.ValueOf(f)} | ||||
| 	if ti := v.Type().In(0); ti.Kind() != reflect.Interface || ti.NumMethod() > 0 { | ||||
| 		tr.typ = ti | ||||
| 	} | ||||
| 	return tr | ||||
| } | ||||
| 
 | ||||
| type transformer struct { | ||||
| 	core | ||||
| 	name string | ||||
| 	typ  reflect.Type  // T
 | ||||
| 	fnc  reflect.Value // func(T) R
 | ||||
| } | ||||
| 
 | ||||
| func (tr *transformer) isFiltered() bool { return tr.typ != nil } | ||||
| 
 | ||||
| func (tr *transformer) filter(s *state, t reflect.Type, _, _ reflect.Value) applicableOption { | ||||
| 	for i := len(s.curPath) - 1; i >= 0; i-- { | ||||
| 		if t, ok := s.curPath[i].(Transform); !ok { | ||||
| 			break // Hit most recent non-Transform step
 | ||||
| 		} else if tr == t.trans { | ||||
| 			return nil // Cannot directly use same Transform
 | ||||
| 		} | ||||
| 	} | ||||
| 	if tr.typ == nil || t.AssignableTo(tr.typ) { | ||||
| 		return tr | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| func (tr *transformer) apply(s *state, vx, vy reflect.Value) { | ||||
| 	step := Transform{&transform{pathStep{typ: tr.fnc.Type().Out(0)}, tr}} | ||||
| 	vvx := s.callTRFunc(tr.fnc, vx, step) | ||||
| 	vvy := s.callTRFunc(tr.fnc, vy, step) | ||||
| 	step.vx, step.vy = vvx, vvy | ||||
| 	s.compareAny(step) | ||||
| } | ||||
| 
 | ||||
| func (tr transformer) String() string { | ||||
| 	return fmt.Sprintf("Transformer(%s, %s)", tr.name, function.NameOf(tr.fnc)) | ||||
| } | ||||
| 
 | ||||
| // Comparer returns an Option that determines whether two values are equal
 | ||||
| // to each other.
 | ||||
| //
 | ||||
| // The comparer f must be a function "func(T, T) bool" and is implicitly
 | ||||
| // filtered to input values assignable to T. If T is an interface, it is
 | ||||
| // possible that f is called with two values of different concrete types that
 | ||||
| // both implement T.
 | ||||
| //
 | ||||
| // The equality function must be:
 | ||||
| //	• Symmetric: equal(x, y) == equal(y, x)
 | ||||
| //	• Deterministic: equal(x, y) == equal(x, y)
 | ||||
| //	• Pure: equal(x, y) does not modify x or y
 | ||||
| func Comparer(f interface{}) Option { | ||||
| 	v := reflect.ValueOf(f) | ||||
| 	if !function.IsType(v.Type(), function.Equal) || v.IsNil() { | ||||
| 		panic(fmt.Sprintf("invalid comparer function: %T", f)) | ||||
| 	} | ||||
| 	cm := &comparer{fnc: v} | ||||
| 	if ti := v.Type().In(0); ti.Kind() != reflect.Interface || ti.NumMethod() > 0 { | ||||
| 		cm.typ = ti | ||||
| 	} | ||||
| 	return cm | ||||
| } | ||||
| 
 | ||||
| type comparer struct { | ||||
| 	core | ||||
| 	typ reflect.Type  // T
 | ||||
| 	fnc reflect.Value // func(T, T) bool
 | ||||
| } | ||||
| 
 | ||||
| func (cm *comparer) isFiltered() bool { return cm.typ != nil } | ||||
| 
 | ||||
| func (cm *comparer) filter(_ *state, t reflect.Type, _, _ reflect.Value) applicableOption { | ||||
| 	if cm.typ == nil || t.AssignableTo(cm.typ) { | ||||
| 		return cm | ||||
| 	} | ||||
| 	return nil | ||||
| } | ||||
| 
 | ||||
| func (cm *comparer) apply(s *state, vx, vy reflect.Value) { | ||||
| 	eq := s.callTTBFunc(cm.fnc, vx, vy) | ||||
| 	s.report(eq, reportByFunc) | ||||
| } | ||||
| 
 | ||||
| func (cm comparer) String() string { | ||||
| 	return fmt.Sprintf("Comparer(%s)", function.NameOf(cm.fnc)) | ||||
| } | ||||
| 
 | ||||
| // Exporter returns an Option that specifies whether Equal is allowed to
 | ||||
| // introspect into the unexported fields of certain struct types.
 | ||||
| //
 | ||||
| // Users of this option must understand that comparing on unexported fields
 | ||||
| // from external packages is not safe since changes in the internal
 | ||||
| // implementation of some external package may cause the result of Equal
 | ||||
| // to unexpectedly change. However, it may be valid to use this option on types
 | ||||
| // defined in an internal package where the semantic meaning of an unexported
 | ||||
| // field is in the control of the user.
 | ||||
| //
 | ||||
| // In many cases, a custom Comparer should be used instead that defines
 | ||||
| // equality as a function of the public API of a type rather than the underlying
 | ||||
| // unexported implementation.
 | ||||
| //
 | ||||
| // For example, the reflect.Type documentation defines equality to be determined
 | ||||
| // by the == operator on the interface (essentially performing a shallow pointer
 | ||||
| // comparison) and most attempts to compare *regexp.Regexp types are interested
 | ||||
| // in only checking that the regular expression strings are equal.
 | ||||
| // Both of these are accomplished using Comparers:
 | ||||
| //
 | ||||
| //	Comparer(func(x, y reflect.Type) bool { return x == y })
 | ||||
| //	Comparer(func(x, y *regexp.Regexp) bool { return x.String() == y.String() })
 | ||||
| //
 | ||||
| // In other cases, the cmpopts.IgnoreUnexported option can be used to ignore
 | ||||
| // all unexported fields on specified struct types.
 | ||||
| func Exporter(f func(reflect.Type) bool) Option { | ||||
| 	if !supportExporters { | ||||
| 		panic("Exporter is not supported on purego builds") | ||||
| 	} | ||||
| 	return exporter(f) | ||||
| } | ||||
| 
 | ||||
| type exporter func(reflect.Type) bool | ||||
| 
 | ||||
| func (exporter) filter(_ *state, _ reflect.Type, _, _ reflect.Value) applicableOption { | ||||
| 	panic("not implemented") | ||||
| } | ||||
| 
 | ||||
| // AllowUnexported returns an Options that allows Equal to forcibly introspect
 | ||||
| // unexported fields of the specified struct types.
 | ||||
| //
 | ||||
| // See Exporter for the proper use of this option.
 | ||||
| func AllowUnexported(types ...interface{}) Option { | ||||
| 	m := make(map[reflect.Type]bool) | ||||
| 	for _, typ := range types { | ||||
| 		t := reflect.TypeOf(typ) | ||||
| 		if t.Kind() != reflect.Struct { | ||||
| 			panic(fmt.Sprintf("invalid struct type: %T", typ)) | ||||
| 		} | ||||
| 		m[t] = true | ||||
| 	} | ||||
| 	return exporter(func(t reflect.Type) bool { return m[t] }) | ||||
| } | ||||
| 
 | ||||
| // Result represents the comparison result for a single node and
 | ||||
| // is provided by cmp when calling Result (see Reporter).
 | ||||
| type Result struct { | ||||
| 	_     [0]func() // Make Result incomparable
 | ||||
| 	flags resultFlags | ||||
| } | ||||
| 
 | ||||
| // Equal reports whether the node was determined to be equal or not.
 | ||||
| // As a special case, ignored nodes are considered equal.
 | ||||
| func (r Result) Equal() bool { | ||||
| 	return r.flags&(reportEqual|reportByIgnore) != 0 | ||||
| } | ||||
| 
 | ||||
| // ByIgnore reports whether the node is equal because it was ignored.
 | ||||
| // This never reports true if Equal reports false.
 | ||||
| func (r Result) ByIgnore() bool { | ||||
| 	return r.flags&reportByIgnore != 0 | ||||
| } | ||||
| 
 | ||||
| // ByMethod reports whether the Equal method determined equality.
 | ||||
| func (r Result) ByMethod() bool { | ||||
| 	return r.flags&reportByMethod != 0 | ||||
| } | ||||
| 
 | ||||
| // ByFunc reports whether a Comparer function determined equality.
 | ||||
| func (r Result) ByFunc() bool { | ||||
| 	return r.flags&reportByFunc != 0 | ||||
| } | ||||
| 
 | ||||
| // ByCycle reports whether a reference cycle was detected.
 | ||||
| func (r Result) ByCycle() bool { | ||||
| 	return r.flags&reportByCycle != 0 | ||||
| } | ||||
| 
 | ||||
| type resultFlags uint | ||||
| 
 | ||||
| const ( | ||||
| 	_ resultFlags = (1 << iota) / 2 | ||||
| 
 | ||||
| 	reportEqual | ||||
| 	reportUnequal | ||||
| 	reportByIgnore | ||||
| 	reportByMethod | ||||
| 	reportByFunc | ||||
| 	reportByCycle | ||||
| ) | ||||
| 
 | ||||
| // Reporter is an Option that can be passed to Equal. When Equal traverses
 | ||||
| // the value trees, it calls PushStep as it descends into each node in the
 | ||||
| // tree and PopStep as it ascend out of the node. The leaves of the tree are
 | ||||
| // either compared (determined to be equal or not equal) or ignored and reported
 | ||||
| // as such by calling the Report method.
 | ||||
| func Reporter(r interface { | ||||
| 	// PushStep is called when a tree-traversal operation is performed.
 | ||||
| 	// The PathStep itself is only valid until the step is popped.
 | ||||
| 	// The PathStep.Values are valid for the duration of the entire traversal
 | ||||
| 	// and must not be mutated.
 | ||||
| 	//
 | ||||
| 	// Equal always calls PushStep at the start to provide an operation-less
 | ||||
| 	// PathStep used to report the root values.
 | ||||
| 	//
 | ||||
| 	// Within a slice, the exact set of inserted, removed, or modified elements
 | ||||
| 	// is unspecified and may change in future implementations.
 | ||||
| 	// The entries of a map are iterated through in an unspecified order.
 | ||||
| 	PushStep(PathStep) | ||||
| 
 | ||||
| 	// Report is called exactly once on leaf nodes to report whether the
 | ||||
| 	// comparison identified the node as equal, unequal, or ignored.
 | ||||
| 	// A leaf node is one that is immediately preceded by and followed by
 | ||||
| 	// a pair of PushStep and PopStep calls.
 | ||||
| 	Report(Result) | ||||
| 
 | ||||
| 	// PopStep ascends back up the value tree.
 | ||||
| 	// There is always a matching pop call for every push call.
 | ||||
| 	PopStep() | ||||
| }) Option { | ||||
| 	return reporter{r} | ||||
| } | ||||
| 
 | ||||
| type reporter struct{ reporterIface } | ||||
| type reporterIface interface { | ||||
| 	PushStep(PathStep) | ||||
| 	Report(Result) | ||||
| 	PopStep() | ||||
| } | ||||
| 
 | ||||
| func (reporter) filter(_ *state, _ reflect.Type, _, _ reflect.Value) applicableOption { | ||||
| 	panic("not implemented") | ||||
| } | ||||
| 
 | ||||
| // normalizeOption normalizes the input options such that all Options groups
 | ||||
| // are flattened and groups with a single element are reduced to that element.
 | ||||
| // Only coreOptions and Options containing coreOptions are allowed.
 | ||||
| func normalizeOption(src Option) Option { | ||||
| 	switch opts := flattenOptions(nil, Options{src}); len(opts) { | ||||
| 	case 0: | ||||
| 		return nil | ||||
| 	case 1: | ||||
| 		return opts[0] | ||||
| 	default: | ||||
| 		return opts | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // flattenOptions copies all options in src to dst as a flat list.
 | ||||
| // Only coreOptions and Options containing coreOptions are allowed.
 | ||||
| func flattenOptions(dst, src Options) Options { | ||||
| 	for _, opt := range src { | ||||
| 		switch opt := opt.(type) { | ||||
| 		case nil: | ||||
| 			continue | ||||
| 		case Options: | ||||
| 			dst = flattenOptions(dst, opt) | ||||
| 		case coreOption: | ||||
| 			dst = append(dst, opt) | ||||
| 		default: | ||||
| 			panic(fmt.Sprintf("invalid option type: %T", opt)) | ||||
| 		} | ||||
| 	} | ||||
| 	return dst | ||||
| } | ||||
|  | @ -0,0 +1,378 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 	"strings" | ||||
| 	"unicode" | ||||
| 	"unicode/utf8" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/value" | ||||
| ) | ||||
| 
 | ||||
| // Path is a list of PathSteps describing the sequence of operations to get
 | ||||
| // from some root type to the current position in the value tree.
 | ||||
| // The first Path element is always an operation-less PathStep that exists
 | ||||
| // simply to identify the initial type.
 | ||||
| //
 | ||||
| // When traversing structs with embedded structs, the embedded struct will
 | ||||
| // always be accessed as a field before traversing the fields of the
 | ||||
| // embedded struct themselves. That is, an exported field from the
 | ||||
| // embedded struct will never be accessed directly from the parent struct.
 | ||||
| type Path []PathStep | ||||
| 
 | ||||
| // PathStep is a union-type for specific operations to traverse
 | ||||
| // a value's tree structure. Users of this package never need to implement
 | ||||
| // these types as values of this type will be returned by this package.
 | ||||
| //
 | ||||
| // Implementations of this interface are
 | ||||
| // StructField, SliceIndex, MapIndex, Indirect, TypeAssertion, and Transform.
 | ||||
| type PathStep interface { | ||||
| 	String() string | ||||
| 
 | ||||
| 	// Type is the resulting type after performing the path step.
 | ||||
| 	Type() reflect.Type | ||||
| 
 | ||||
| 	// Values is the resulting values after performing the path step.
 | ||||
| 	// The type of each valid value is guaranteed to be identical to Type.
 | ||||
| 	//
 | ||||
| 	// In some cases, one or both may be invalid or have restrictions:
 | ||||
| 	//	• For StructField, both are not interface-able if the current field
 | ||||
| 	//	is unexported and the struct type is not explicitly permitted by
 | ||||
| 	//	an Exporter to traverse unexported fields.
 | ||||
| 	//	• For SliceIndex, one may be invalid if an element is missing from
 | ||||
| 	//	either the x or y slice.
 | ||||
| 	//	• For MapIndex, one may be invalid if an entry is missing from
 | ||||
| 	//	either the x or y map.
 | ||||
| 	//
 | ||||
| 	// The provided values must not be mutated.
 | ||||
| 	Values() (vx, vy reflect.Value) | ||||
| } | ||||
| 
 | ||||
| var ( | ||||
| 	_ PathStep = StructField{} | ||||
| 	_ PathStep = SliceIndex{} | ||||
| 	_ PathStep = MapIndex{} | ||||
| 	_ PathStep = Indirect{} | ||||
| 	_ PathStep = TypeAssertion{} | ||||
| 	_ PathStep = Transform{} | ||||
| ) | ||||
| 
 | ||||
| func (pa *Path) push(s PathStep) { | ||||
| 	*pa = append(*pa, s) | ||||
| } | ||||
| 
 | ||||
| func (pa *Path) pop() { | ||||
| 	*pa = (*pa)[:len(*pa)-1] | ||||
| } | ||||
| 
 | ||||
| // Last returns the last PathStep in the Path.
 | ||||
| // If the path is empty, this returns a non-nil PathStep that reports a nil Type.
 | ||||
| func (pa Path) Last() PathStep { | ||||
| 	return pa.Index(-1) | ||||
| } | ||||
| 
 | ||||
| // Index returns the ith step in the Path and supports negative indexing.
 | ||||
| // A negative index starts counting from the tail of the Path such that -1
 | ||||
| // refers to the last step, -2 refers to the second-to-last step, and so on.
 | ||||
| // If index is invalid, this returns a non-nil PathStep that reports a nil Type.
 | ||||
| func (pa Path) Index(i int) PathStep { | ||||
| 	if i < 0 { | ||||
| 		i = len(pa) + i | ||||
| 	} | ||||
| 	if i < 0 || i >= len(pa) { | ||||
| 		return pathStep{} | ||||
| 	} | ||||
| 	return pa[i] | ||||
| } | ||||
| 
 | ||||
| // String returns the simplified path to a node.
 | ||||
| // The simplified path only contains struct field accesses.
 | ||||
| //
 | ||||
| // For example:
 | ||||
| //	MyMap.MySlices.MyField
 | ||||
| func (pa Path) String() string { | ||||
| 	var ss []string | ||||
| 	for _, s := range pa { | ||||
| 		if _, ok := s.(StructField); ok { | ||||
| 			ss = append(ss, s.String()) | ||||
| 		} | ||||
| 	} | ||||
| 	return strings.TrimPrefix(strings.Join(ss, ""), ".") | ||||
| } | ||||
| 
 | ||||
| // GoString returns the path to a specific node using Go syntax.
 | ||||
| //
 | ||||
| // For example:
 | ||||
| //	(*root.MyMap["key"].(*mypkg.MyStruct).MySlices)[2][3].MyField
 | ||||
| func (pa Path) GoString() string { | ||||
| 	var ssPre, ssPost []string | ||||
| 	var numIndirect int | ||||
| 	for i, s := range pa { | ||||
| 		var nextStep PathStep | ||||
| 		if i+1 < len(pa) { | ||||
| 			nextStep = pa[i+1] | ||||
| 		} | ||||
| 		switch s := s.(type) { | ||||
| 		case Indirect: | ||||
| 			numIndirect++ | ||||
| 			pPre, pPost := "(", ")" | ||||
| 			switch nextStep.(type) { | ||||
| 			case Indirect: | ||||
| 				continue // Next step is indirection, so let them batch up
 | ||||
| 			case StructField: | ||||
| 				numIndirect-- // Automatic indirection on struct fields
 | ||||
| 			case nil: | ||||
| 				pPre, pPost = "", "" // Last step; no need for parenthesis
 | ||||
| 			} | ||||
| 			if numIndirect > 0 { | ||||
| 				ssPre = append(ssPre, pPre+strings.Repeat("*", numIndirect)) | ||||
| 				ssPost = append(ssPost, pPost) | ||||
| 			} | ||||
| 			numIndirect = 0 | ||||
| 			continue | ||||
| 		case Transform: | ||||
| 			ssPre = append(ssPre, s.trans.name+"(") | ||||
| 			ssPost = append(ssPost, ")") | ||||
| 			continue | ||||
| 		} | ||||
| 		ssPost = append(ssPost, s.String()) | ||||
| 	} | ||||
| 	for i, j := 0, len(ssPre)-1; i < j; i, j = i+1, j-1 { | ||||
| 		ssPre[i], ssPre[j] = ssPre[j], ssPre[i] | ||||
| 	} | ||||
| 	return strings.Join(ssPre, "") + strings.Join(ssPost, "") | ||||
| } | ||||
| 
 | ||||
| type pathStep struct { | ||||
| 	typ    reflect.Type | ||||
| 	vx, vy reflect.Value | ||||
| } | ||||
| 
 | ||||
| func (ps pathStep) Type() reflect.Type             { return ps.typ } | ||||
| func (ps pathStep) Values() (vx, vy reflect.Value) { return ps.vx, ps.vy } | ||||
| func (ps pathStep) String() string { | ||||
| 	if ps.typ == nil { | ||||
| 		return "<nil>" | ||||
| 	} | ||||
| 	s := ps.typ.String() | ||||
| 	if s == "" || strings.ContainsAny(s, "{}\n") { | ||||
| 		return "root" // Type too simple or complex to print
 | ||||
| 	} | ||||
| 	return fmt.Sprintf("{%s}", s) | ||||
| } | ||||
| 
 | ||||
| // StructField represents a struct field access on a field called Name.
 | ||||
| type StructField struct{ *structField } | ||||
| type structField struct { | ||||
| 	pathStep | ||||
| 	name string | ||||
| 	idx  int | ||||
| 
 | ||||
| 	// These fields are used for forcibly accessing an unexported field.
 | ||||
| 	// pvx, pvy, and field are only valid if unexported is true.
 | ||||
| 	unexported bool | ||||
| 	mayForce   bool                // Forcibly allow visibility
 | ||||
| 	paddr      bool                // Was parent addressable?
 | ||||
| 	pvx, pvy   reflect.Value       // Parent values (always addressable)
 | ||||
| 	field      reflect.StructField // Field information
 | ||||
| } | ||||
| 
 | ||||
| func (sf StructField) Type() reflect.Type { return sf.typ } | ||||
| func (sf StructField) Values() (vx, vy reflect.Value) { | ||||
| 	if !sf.unexported { | ||||
| 		return sf.vx, sf.vy // CanInterface reports true
 | ||||
| 	} | ||||
| 
 | ||||
| 	// Forcibly obtain read-write access to an unexported struct field.
 | ||||
| 	if sf.mayForce { | ||||
| 		vx = retrieveUnexportedField(sf.pvx, sf.field, sf.paddr) | ||||
| 		vy = retrieveUnexportedField(sf.pvy, sf.field, sf.paddr) | ||||
| 		return vx, vy // CanInterface reports true
 | ||||
| 	} | ||||
| 	return sf.vx, sf.vy // CanInterface reports false
 | ||||
| } | ||||
| func (sf StructField) String() string { return fmt.Sprintf(".%s", sf.name) } | ||||
| 
 | ||||
| // Name is the field name.
 | ||||
| func (sf StructField) Name() string { return sf.name } | ||||
| 
 | ||||
| // Index is the index of the field in the parent struct type.
 | ||||
| // See reflect.Type.Field.
 | ||||
| func (sf StructField) Index() int { return sf.idx } | ||||
| 
 | ||||
| // SliceIndex is an index operation on a slice or array at some index Key.
 | ||||
| type SliceIndex struct{ *sliceIndex } | ||||
| type sliceIndex struct { | ||||
| 	pathStep | ||||
| 	xkey, ykey int | ||||
| 	isSlice    bool // False for reflect.Array
 | ||||
| } | ||||
| 
 | ||||
| func (si SliceIndex) Type() reflect.Type             { return si.typ } | ||||
| func (si SliceIndex) Values() (vx, vy reflect.Value) { return si.vx, si.vy } | ||||
| func (si SliceIndex) String() string { | ||||
| 	switch { | ||||
| 	case si.xkey == si.ykey: | ||||
| 		return fmt.Sprintf("[%d]", si.xkey) | ||||
| 	case si.ykey == -1: | ||||
| 		// [5->?] means "I don't know where X[5] went"
 | ||||
| 		return fmt.Sprintf("[%d->?]", si.xkey) | ||||
| 	case si.xkey == -1: | ||||
| 		// [?->3] means "I don't know where Y[3] came from"
 | ||||
| 		return fmt.Sprintf("[?->%d]", si.ykey) | ||||
| 	default: | ||||
| 		// [5->3] means "X[5] moved to Y[3]"
 | ||||
| 		return fmt.Sprintf("[%d->%d]", si.xkey, si.ykey) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // Key is the index key; it may return -1 if in a split state
 | ||||
| func (si SliceIndex) Key() int { | ||||
| 	if si.xkey != si.ykey { | ||||
| 		return -1 | ||||
| 	} | ||||
| 	return si.xkey | ||||
| } | ||||
| 
 | ||||
| // SplitKeys are the indexes for indexing into slices in the
 | ||||
| // x and y values, respectively. These indexes may differ due to the
 | ||||
| // insertion or removal of an element in one of the slices, causing
 | ||||
| // all of the indexes to be shifted. If an index is -1, then that
 | ||||
| // indicates that the element does not exist in the associated slice.
 | ||||
| //
 | ||||
| // Key is guaranteed to return -1 if and only if the indexes returned
 | ||||
| // by SplitKeys are not the same. SplitKeys will never return -1 for
 | ||||
| // both indexes.
 | ||||
| func (si SliceIndex) SplitKeys() (ix, iy int) { return si.xkey, si.ykey } | ||||
| 
 | ||||
| // MapIndex is an index operation on a map at some index Key.
 | ||||
| type MapIndex struct{ *mapIndex } | ||||
| type mapIndex struct { | ||||
| 	pathStep | ||||
| 	key reflect.Value | ||||
| } | ||||
| 
 | ||||
| func (mi MapIndex) Type() reflect.Type             { return mi.typ } | ||||
| func (mi MapIndex) Values() (vx, vy reflect.Value) { return mi.vx, mi.vy } | ||||
| func (mi MapIndex) String() string                 { return fmt.Sprintf("[%#v]", mi.key) } | ||||
| 
 | ||||
| // Key is the value of the map key.
 | ||||
| func (mi MapIndex) Key() reflect.Value { return mi.key } | ||||
| 
 | ||||
| // Indirect represents pointer indirection on the parent type.
 | ||||
| type Indirect struct{ *indirect } | ||||
| type indirect struct { | ||||
| 	pathStep | ||||
| } | ||||
| 
 | ||||
| func (in Indirect) Type() reflect.Type             { return in.typ } | ||||
| func (in Indirect) Values() (vx, vy reflect.Value) { return in.vx, in.vy } | ||||
| func (in Indirect) String() string                 { return "*" } | ||||
| 
 | ||||
| // TypeAssertion represents a type assertion on an interface.
 | ||||
| type TypeAssertion struct{ *typeAssertion } | ||||
| type typeAssertion struct { | ||||
| 	pathStep | ||||
| } | ||||
| 
 | ||||
| func (ta TypeAssertion) Type() reflect.Type             { return ta.typ } | ||||
| func (ta TypeAssertion) Values() (vx, vy reflect.Value) { return ta.vx, ta.vy } | ||||
| func (ta TypeAssertion) String() string                 { return fmt.Sprintf(".(%v)", ta.typ) } | ||||
| 
 | ||||
| // Transform is a transformation from the parent type to the current type.
 | ||||
| type Transform struct{ *transform } | ||||
| type transform struct { | ||||
| 	pathStep | ||||
| 	trans *transformer | ||||
| } | ||||
| 
 | ||||
| func (tf Transform) Type() reflect.Type             { return tf.typ } | ||||
| func (tf Transform) Values() (vx, vy reflect.Value) { return tf.vx, tf.vy } | ||||
| func (tf Transform) String() string                 { return fmt.Sprintf("%s()", tf.trans.name) } | ||||
| 
 | ||||
| // Name is the name of the Transformer.
 | ||||
| func (tf Transform) Name() string { return tf.trans.name } | ||||
| 
 | ||||
| // Func is the function pointer to the transformer function.
 | ||||
| func (tf Transform) Func() reflect.Value { return tf.trans.fnc } | ||||
| 
 | ||||
| // Option returns the originally constructed Transformer option.
 | ||||
| // The == operator can be used to detect the exact option used.
 | ||||
| func (tf Transform) Option() Option { return tf.trans } | ||||
| 
 | ||||
| // pointerPath represents a dual-stack of pointers encountered when
 | ||||
| // recursively traversing the x and y values. This data structure supports
 | ||||
| // detection of cycles and determining whether the cycles are equal.
 | ||||
| // In Go, cycles can occur via pointers, slices, and maps.
 | ||||
| //
 | ||||
| // The pointerPath uses a map to represent a stack; where descension into a
 | ||||
| // pointer pushes the address onto the stack, and ascension from a pointer
 | ||||
| // pops the address from the stack. Thus, when traversing into a pointer from
 | ||||
| // reflect.Ptr, reflect.Slice element, or reflect.Map, we can detect cycles
 | ||||
| // by checking whether the pointer has already been visited. The cycle detection
 | ||||
| // uses a separate stack for the x and y values.
 | ||||
| //
 | ||||
| // If a cycle is detected we need to determine whether the two pointers
 | ||||
| // should be considered equal. The definition of equality chosen by Equal
 | ||||
| // requires two graphs to have the same structure. To determine this, both the
 | ||||
| // x and y values must have a cycle where the previous pointers were also
 | ||||
| // encountered together as a pair.
 | ||||
| //
 | ||||
| // Semantically, this is equivalent to augmenting Indirect, SliceIndex, and
 | ||||
| // MapIndex with pointer information for the x and y values.
 | ||||
| // Suppose px and py are two pointers to compare, we then search the
 | ||||
| // Path for whether px was ever encountered in the Path history of x, and
 | ||||
| // similarly so with py. If either side has a cycle, the comparison is only
 | ||||
| // equal if both px and py have a cycle resulting from the same PathStep.
 | ||||
| //
 | ||||
| // Using a map as a stack is more performant as we can perform cycle detection
 | ||||
| // in O(1) instead of O(N) where N is len(Path).
 | ||||
| type pointerPath struct { | ||||
| 	// mx is keyed by x pointers, where the value is the associated y pointer.
 | ||||
| 	mx map[value.Pointer]value.Pointer | ||||
| 	// my is keyed by y pointers, where the value is the associated x pointer.
 | ||||
| 	my map[value.Pointer]value.Pointer | ||||
| } | ||||
| 
 | ||||
| func (p *pointerPath) Init() { | ||||
| 	p.mx = make(map[value.Pointer]value.Pointer) | ||||
| 	p.my = make(map[value.Pointer]value.Pointer) | ||||
| } | ||||
| 
 | ||||
| // Push indicates intent to descend into pointers vx and vy where
 | ||||
| // visited reports whether either has been seen before. If visited before,
 | ||||
| // equal reports whether both pointers were encountered together.
 | ||||
| // Pop must be called if and only if the pointers were never visited.
 | ||||
| //
 | ||||
| // The pointers vx and vy must be a reflect.Ptr, reflect.Slice, or reflect.Map
 | ||||
| // and be non-nil.
 | ||||
| func (p pointerPath) Push(vx, vy reflect.Value) (equal, visited bool) { | ||||
| 	px := value.PointerOf(vx) | ||||
| 	py := value.PointerOf(vy) | ||||
| 	_, ok1 := p.mx[px] | ||||
| 	_, ok2 := p.my[py] | ||||
| 	if ok1 || ok2 { | ||||
| 		equal = p.mx[px] == py && p.my[py] == px // Pointers paired together
 | ||||
| 		return equal, true | ||||
| 	} | ||||
| 	p.mx[px] = py | ||||
| 	p.my[py] = px | ||||
| 	return false, false | ||||
| } | ||||
| 
 | ||||
| // Pop ascends from pointers vx and vy.
 | ||||
| func (p pointerPath) Pop(vx, vy reflect.Value) { | ||||
| 	delete(p.mx, value.PointerOf(vx)) | ||||
| 	delete(p.my, value.PointerOf(vy)) | ||||
| } | ||||
| 
 | ||||
| // isExported reports whether the identifier is exported.
 | ||||
| func isExported(id string) bool { | ||||
| 	r, _ := utf8.DecodeRuneInString(id) | ||||
| 	return unicode.IsUpper(r) | ||||
| } | ||||
|  | @ -0,0 +1,54 @@ | |||
| // Copyright 2017, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| // defaultReporter implements the reporter interface.
 | ||||
| //
 | ||||
| // As Equal serially calls the PushStep, Report, and PopStep methods, the
 | ||||
| // defaultReporter constructs a tree-based representation of the compared value
 | ||||
| // and the result of each comparison (see valueNode).
 | ||||
| //
 | ||||
| // When the String method is called, the FormatDiff method transforms the
 | ||||
| // valueNode tree into a textNode tree, which is a tree-based representation
 | ||||
| // of the textual output (see textNode).
 | ||||
| //
 | ||||
| // Lastly, the textNode.String method produces the final report as a string.
 | ||||
| type defaultReporter struct { | ||||
| 	root *valueNode | ||||
| 	curr *valueNode | ||||
| } | ||||
| 
 | ||||
| func (r *defaultReporter) PushStep(ps PathStep) { | ||||
| 	r.curr = r.curr.PushStep(ps) | ||||
| 	if r.root == nil { | ||||
| 		r.root = r.curr | ||||
| 	} | ||||
| } | ||||
| func (r *defaultReporter) Report(rs Result) { | ||||
| 	r.curr.Report(rs) | ||||
| } | ||||
| func (r *defaultReporter) PopStep() { | ||||
| 	r.curr = r.curr.PopStep() | ||||
| } | ||||
| 
 | ||||
| // String provides a full report of the differences detected as a structured
 | ||||
| // literal in pseudo-Go syntax. String may only be called after the entire tree
 | ||||
| // has been traversed.
 | ||||
| func (r *defaultReporter) String() string { | ||||
| 	assert(r.root != nil && r.curr == nil) | ||||
| 	if r.root.NumDiff == 0 { | ||||
| 		return "" | ||||
| 	} | ||||
| 	ptrs := new(pointerReferences) | ||||
| 	text := formatOptions{}.FormatDiff(r.root, ptrs) | ||||
| 	resolveReferences(text) | ||||
| 	return text.String() | ||||
| } | ||||
| 
 | ||||
| func assert(ok bool) { | ||||
| 	if !ok { | ||||
| 		panic("assertion failure") | ||||
| 	} | ||||
| } | ||||
|  | @ -0,0 +1,435 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/value" | ||||
| ) | ||||
| 
 | ||||
| // numContextRecords is the number of surrounding equal records to print.
 | ||||
| const numContextRecords = 2 | ||||
| 
 | ||||
| type diffMode byte | ||||
| 
 | ||||
| const ( | ||||
| 	diffUnknown   diffMode = 0 | ||||
| 	diffIdentical diffMode = ' ' | ||||
| 	diffRemoved   diffMode = '-' | ||||
| 	diffInserted  diffMode = '+' | ||||
| ) | ||||
| 
 | ||||
| type typeMode int | ||||
| 
 | ||||
| const ( | ||||
| 	// emitType always prints the type.
 | ||||
| 	emitType typeMode = iota | ||||
| 	// elideType never prints the type.
 | ||||
| 	elideType | ||||
| 	// autoType prints the type only for composite kinds
 | ||||
| 	// (i.e., structs, slices, arrays, and maps).
 | ||||
| 	autoType | ||||
| ) | ||||
| 
 | ||||
| type formatOptions struct { | ||||
| 	// DiffMode controls the output mode of FormatDiff.
 | ||||
| 	//
 | ||||
| 	// If diffUnknown,   then produce a diff of the x and y values.
 | ||||
| 	// If diffIdentical, then emit values as if they were equal.
 | ||||
| 	// If diffRemoved,   then only emit x values (ignoring y values).
 | ||||
| 	// If diffInserted,  then only emit y values (ignoring x values).
 | ||||
| 	DiffMode diffMode | ||||
| 
 | ||||
| 	// TypeMode controls whether to print the type for the current node.
 | ||||
| 	//
 | ||||
| 	// As a general rule of thumb, we always print the type of the next node
 | ||||
| 	// after an interface, and always elide the type of the next node after
 | ||||
| 	// a slice or map node.
 | ||||
| 	TypeMode typeMode | ||||
| 
 | ||||
| 	// formatValueOptions are options specific to printing reflect.Values.
 | ||||
| 	formatValueOptions | ||||
| } | ||||
| 
 | ||||
| func (opts formatOptions) WithDiffMode(d diffMode) formatOptions { | ||||
| 	opts.DiffMode = d | ||||
| 	return opts | ||||
| } | ||||
| func (opts formatOptions) WithTypeMode(t typeMode) formatOptions { | ||||
| 	opts.TypeMode = t | ||||
| 	return opts | ||||
| } | ||||
| func (opts formatOptions) WithVerbosity(level int) formatOptions { | ||||
| 	opts.VerbosityLevel = level | ||||
| 	opts.LimitVerbosity = true | ||||
| 	return opts | ||||
| } | ||||
| func (opts formatOptions) verbosity() uint { | ||||
| 	switch { | ||||
| 	case opts.VerbosityLevel < 0: | ||||
| 		return 0 | ||||
| 	case opts.VerbosityLevel > 16: | ||||
| 		return 16 // some reasonable maximum to avoid shift overflow
 | ||||
| 	default: | ||||
| 		return uint(opts.VerbosityLevel) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| const maxVerbosityPreset = 6 | ||||
| 
 | ||||
| // verbosityPreset modifies the verbosity settings given an index
 | ||||
| // between 0 and maxVerbosityPreset, inclusive.
 | ||||
| func verbosityPreset(opts formatOptions, i int) formatOptions { | ||||
| 	opts.VerbosityLevel = int(opts.verbosity()) + 2*i | ||||
| 	if i > 0 { | ||||
| 		opts.AvoidStringer = true | ||||
| 	} | ||||
| 	if i >= maxVerbosityPreset { | ||||
| 		opts.PrintAddresses = true | ||||
| 		opts.QualifiedNames = true | ||||
| 	} | ||||
| 	return opts | ||||
| } | ||||
| 
 | ||||
| // FormatDiff converts a valueNode tree into a textNode tree, where the later
 | ||||
| // is a textual representation of the differences detected in the former.
 | ||||
| func (opts formatOptions) FormatDiff(v *valueNode, ptrs *pointerReferences) (out textNode) { | ||||
| 	if opts.DiffMode == diffIdentical { | ||||
| 		opts = opts.WithVerbosity(1) | ||||
| 	} else if opts.verbosity() < 3 { | ||||
| 		opts = opts.WithVerbosity(3) | ||||
| 	} | ||||
| 
 | ||||
| 	// Check whether we have specialized formatting for this node.
 | ||||
| 	// This is not necessary, but helpful for producing more readable outputs.
 | ||||
| 	if opts.CanFormatDiffSlice(v) { | ||||
| 		return opts.FormatDiffSlice(v) | ||||
| 	} | ||||
| 
 | ||||
| 	var parentKind reflect.Kind | ||||
| 	if v.parent != nil && v.parent.TransformerName == "" { | ||||
| 		parentKind = v.parent.Type.Kind() | ||||
| 	} | ||||
| 
 | ||||
| 	// For leaf nodes, format the value based on the reflect.Values alone.
 | ||||
| 	// As a special case, treat equal []byte as a leaf nodes.
 | ||||
| 	isBytes := v.Type.Kind() == reflect.Slice && v.Type.Elem() == reflect.TypeOf(byte(0)) | ||||
| 	isEqualBytes := isBytes && v.NumDiff+v.NumIgnored+v.NumTransformed == 0 | ||||
| 	if v.MaxDepth == 0 || isEqualBytes { | ||||
| 		switch opts.DiffMode { | ||||
| 		case diffUnknown, diffIdentical: | ||||
| 			// Format Equal.
 | ||||
| 			if v.NumDiff == 0 { | ||||
| 				outx := opts.FormatValue(v.ValueX, parentKind, ptrs) | ||||
| 				outy := opts.FormatValue(v.ValueY, parentKind, ptrs) | ||||
| 				if v.NumIgnored > 0 && v.NumSame == 0 { | ||||
| 					return textEllipsis | ||||
| 				} else if outx.Len() < outy.Len() { | ||||
| 					return outx | ||||
| 				} else { | ||||
| 					return outy | ||||
| 				} | ||||
| 			} | ||||
| 
 | ||||
| 			// Format unequal.
 | ||||
| 			assert(opts.DiffMode == diffUnknown) | ||||
| 			var list textList | ||||
| 			outx := opts.WithTypeMode(elideType).FormatValue(v.ValueX, parentKind, ptrs) | ||||
| 			outy := opts.WithTypeMode(elideType).FormatValue(v.ValueY, parentKind, ptrs) | ||||
| 			for i := 0; i <= maxVerbosityPreset && outx != nil && outy != nil && outx.Equal(outy); i++ { | ||||
| 				opts2 := verbosityPreset(opts, i).WithTypeMode(elideType) | ||||
| 				outx = opts2.FormatValue(v.ValueX, parentKind, ptrs) | ||||
| 				outy = opts2.FormatValue(v.ValueY, parentKind, ptrs) | ||||
| 			} | ||||
| 			if outx != nil { | ||||
| 				list = append(list, textRecord{Diff: '-', Value: outx}) | ||||
| 			} | ||||
| 			if outy != nil { | ||||
| 				list = append(list, textRecord{Diff: '+', Value: outy}) | ||||
| 			} | ||||
| 			return opts.WithTypeMode(emitType).FormatType(v.Type, list) | ||||
| 		case diffRemoved: | ||||
| 			return opts.FormatValue(v.ValueX, parentKind, ptrs) | ||||
| 		case diffInserted: | ||||
| 			return opts.FormatValue(v.ValueY, parentKind, ptrs) | ||||
| 		default: | ||||
| 			panic("invalid diff mode") | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Register slice element to support cycle detection.
 | ||||
| 	if parentKind == reflect.Slice { | ||||
| 		ptrRefs := ptrs.PushPair(v.ValueX, v.ValueY, opts.DiffMode, true) | ||||
| 		defer ptrs.Pop() | ||||
| 		defer func() { out = wrapTrunkReferences(ptrRefs, out) }() | ||||
| 	} | ||||
| 
 | ||||
| 	// Descend into the child value node.
 | ||||
| 	if v.TransformerName != "" { | ||||
| 		out := opts.WithTypeMode(emitType).FormatDiff(v.Value, ptrs) | ||||
| 		out = &textWrap{Prefix: "Inverse(" + v.TransformerName + ", ", Value: out, Suffix: ")"} | ||||
| 		return opts.FormatType(v.Type, out) | ||||
| 	} else { | ||||
| 		switch k := v.Type.Kind(); k { | ||||
| 		case reflect.Struct, reflect.Array, reflect.Slice: | ||||
| 			out = opts.formatDiffList(v.Records, k, ptrs) | ||||
| 			out = opts.FormatType(v.Type, out) | ||||
| 		case reflect.Map: | ||||
| 			// Register map to support cycle detection.
 | ||||
| 			ptrRefs := ptrs.PushPair(v.ValueX, v.ValueY, opts.DiffMode, false) | ||||
| 			defer ptrs.Pop() | ||||
| 
 | ||||
| 			out = opts.formatDiffList(v.Records, k, ptrs) | ||||
| 			out = wrapTrunkReferences(ptrRefs, out) | ||||
| 			out = opts.FormatType(v.Type, out) | ||||
| 		case reflect.Ptr: | ||||
| 			// Register pointer to support cycle detection.
 | ||||
| 			ptrRefs := ptrs.PushPair(v.ValueX, v.ValueY, opts.DiffMode, false) | ||||
| 			defer ptrs.Pop() | ||||
| 
 | ||||
| 			out = opts.FormatDiff(v.Value, ptrs) | ||||
| 			out = wrapTrunkReferences(ptrRefs, out) | ||||
| 			out = &textWrap{Prefix: "&", Value: out} | ||||
| 		case reflect.Interface: | ||||
| 			out = opts.WithTypeMode(emitType).FormatDiff(v.Value, ptrs) | ||||
| 		default: | ||||
| 			panic(fmt.Sprintf("%v cannot have children", k)) | ||||
| 		} | ||||
| 		return out | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (opts formatOptions) formatDiffList(recs []reportRecord, k reflect.Kind, ptrs *pointerReferences) textNode { | ||||
| 	// Derive record name based on the data structure kind.
 | ||||
| 	var name string | ||||
| 	var formatKey func(reflect.Value) string | ||||
| 	switch k { | ||||
| 	case reflect.Struct: | ||||
| 		name = "field" | ||||
| 		opts = opts.WithTypeMode(autoType) | ||||
| 		formatKey = func(v reflect.Value) string { return v.String() } | ||||
| 	case reflect.Slice, reflect.Array: | ||||
| 		name = "element" | ||||
| 		opts = opts.WithTypeMode(elideType) | ||||
| 		formatKey = func(reflect.Value) string { return "" } | ||||
| 	case reflect.Map: | ||||
| 		name = "entry" | ||||
| 		opts = opts.WithTypeMode(elideType) | ||||
| 		formatKey = func(v reflect.Value) string { return formatMapKey(v, false, ptrs) } | ||||
| 	} | ||||
| 
 | ||||
| 	maxLen := -1 | ||||
| 	if opts.LimitVerbosity { | ||||
| 		if opts.DiffMode == diffIdentical { | ||||
| 			maxLen = ((1 << opts.verbosity()) >> 1) << 2 // 0, 4, 8, 16, 32, etc...
 | ||||
| 		} else { | ||||
| 			maxLen = (1 << opts.verbosity()) << 1 // 2, 4, 8, 16, 32, 64, etc...
 | ||||
| 		} | ||||
| 		opts.VerbosityLevel-- | ||||
| 	} | ||||
| 
 | ||||
| 	// Handle unification.
 | ||||
| 	switch opts.DiffMode { | ||||
| 	case diffIdentical, diffRemoved, diffInserted: | ||||
| 		var list textList | ||||
| 		var deferredEllipsis bool // Add final "..." to indicate records were dropped
 | ||||
| 		for _, r := range recs { | ||||
| 			if len(list) == maxLen { | ||||
| 				deferredEllipsis = true | ||||
| 				break | ||||
| 			} | ||||
| 
 | ||||
| 			// Elide struct fields that are zero value.
 | ||||
| 			if k == reflect.Struct { | ||||
| 				var isZero bool | ||||
| 				switch opts.DiffMode { | ||||
| 				case diffIdentical: | ||||
| 					isZero = value.IsZero(r.Value.ValueX) || value.IsZero(r.Value.ValueY) | ||||
| 				case diffRemoved: | ||||
| 					isZero = value.IsZero(r.Value.ValueX) | ||||
| 				case diffInserted: | ||||
| 					isZero = value.IsZero(r.Value.ValueY) | ||||
| 				} | ||||
| 				if isZero { | ||||
| 					continue | ||||
| 				} | ||||
| 			} | ||||
| 			// Elide ignored nodes.
 | ||||
| 			if r.Value.NumIgnored > 0 && r.Value.NumSame+r.Value.NumDiff == 0 { | ||||
| 				deferredEllipsis = !(k == reflect.Slice || k == reflect.Array) | ||||
| 				if !deferredEllipsis { | ||||
| 					list.AppendEllipsis(diffStats{}) | ||||
| 				} | ||||
| 				continue | ||||
| 			} | ||||
| 			if out := opts.FormatDiff(r.Value, ptrs); out != nil { | ||||
| 				list = append(list, textRecord{Key: formatKey(r.Key), Value: out}) | ||||
| 			} | ||||
| 		} | ||||
| 		if deferredEllipsis { | ||||
| 			list.AppendEllipsis(diffStats{}) | ||||
| 		} | ||||
| 		return &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| 	case diffUnknown: | ||||
| 	default: | ||||
| 		panic("invalid diff mode") | ||||
| 	} | ||||
| 
 | ||||
| 	// Handle differencing.
 | ||||
| 	var numDiffs int | ||||
| 	var list textList | ||||
| 	var keys []reflect.Value // invariant: len(list) == len(keys)
 | ||||
| 	groups := coalesceAdjacentRecords(name, recs) | ||||
| 	maxGroup := diffStats{Name: name} | ||||
| 	for i, ds := range groups { | ||||
| 		if maxLen >= 0 && numDiffs >= maxLen { | ||||
| 			maxGroup = maxGroup.Append(ds) | ||||
| 			continue | ||||
| 		} | ||||
| 
 | ||||
| 		// Handle equal records.
 | ||||
| 		if ds.NumDiff() == 0 { | ||||
| 			// Compute the number of leading and trailing records to print.
 | ||||
| 			var numLo, numHi int | ||||
| 			numEqual := ds.NumIgnored + ds.NumIdentical | ||||
| 			for numLo < numContextRecords && numLo+numHi < numEqual && i != 0 { | ||||
| 				if r := recs[numLo].Value; r.NumIgnored > 0 && r.NumSame+r.NumDiff == 0 { | ||||
| 					break | ||||
| 				} | ||||
| 				numLo++ | ||||
| 			} | ||||
| 			for numHi < numContextRecords && numLo+numHi < numEqual && i != len(groups)-1 { | ||||
| 				if r := recs[numEqual-numHi-1].Value; r.NumIgnored > 0 && r.NumSame+r.NumDiff == 0 { | ||||
| 					break | ||||
| 				} | ||||
| 				numHi++ | ||||
| 			} | ||||
| 			if numEqual-(numLo+numHi) == 1 && ds.NumIgnored == 0 { | ||||
| 				numHi++ // Avoid pointless coalescing of a single equal record
 | ||||
| 			} | ||||
| 
 | ||||
| 			// Format the equal values.
 | ||||
| 			for _, r := range recs[:numLo] { | ||||
| 				out := opts.WithDiffMode(diffIdentical).FormatDiff(r.Value, ptrs) | ||||
| 				list = append(list, textRecord{Key: formatKey(r.Key), Value: out}) | ||||
| 				keys = append(keys, r.Key) | ||||
| 			} | ||||
| 			if numEqual > numLo+numHi { | ||||
| 				ds.NumIdentical -= numLo + numHi | ||||
| 				list.AppendEllipsis(ds) | ||||
| 				for len(keys) < len(list) { | ||||
| 					keys = append(keys, reflect.Value{}) | ||||
| 				} | ||||
| 			} | ||||
| 			for _, r := range recs[numEqual-numHi : numEqual] { | ||||
| 				out := opts.WithDiffMode(diffIdentical).FormatDiff(r.Value, ptrs) | ||||
| 				list = append(list, textRecord{Key: formatKey(r.Key), Value: out}) | ||||
| 				keys = append(keys, r.Key) | ||||
| 			} | ||||
| 			recs = recs[numEqual:] | ||||
| 			continue | ||||
| 		} | ||||
| 
 | ||||
| 		// Handle unequal records.
 | ||||
| 		for _, r := range recs[:ds.NumDiff()] { | ||||
| 			switch { | ||||
| 			case opts.CanFormatDiffSlice(r.Value): | ||||
| 				out := opts.FormatDiffSlice(r.Value) | ||||
| 				list = append(list, textRecord{Key: formatKey(r.Key), Value: out}) | ||||
| 				keys = append(keys, r.Key) | ||||
| 			case r.Value.NumChildren == r.Value.MaxDepth: | ||||
| 				outx := opts.WithDiffMode(diffRemoved).FormatDiff(r.Value, ptrs) | ||||
| 				outy := opts.WithDiffMode(diffInserted).FormatDiff(r.Value, ptrs) | ||||
| 				for i := 0; i <= maxVerbosityPreset && outx != nil && outy != nil && outx.Equal(outy); i++ { | ||||
| 					opts2 := verbosityPreset(opts, i) | ||||
| 					outx = opts2.WithDiffMode(diffRemoved).FormatDiff(r.Value, ptrs) | ||||
| 					outy = opts2.WithDiffMode(diffInserted).FormatDiff(r.Value, ptrs) | ||||
| 				} | ||||
| 				if outx != nil { | ||||
| 					list = append(list, textRecord{Diff: diffRemoved, Key: formatKey(r.Key), Value: outx}) | ||||
| 					keys = append(keys, r.Key) | ||||
| 				} | ||||
| 				if outy != nil { | ||||
| 					list = append(list, textRecord{Diff: diffInserted, Key: formatKey(r.Key), Value: outy}) | ||||
| 					keys = append(keys, r.Key) | ||||
| 				} | ||||
| 			default: | ||||
| 				out := opts.FormatDiff(r.Value, ptrs) | ||||
| 				list = append(list, textRecord{Key: formatKey(r.Key), Value: out}) | ||||
| 				keys = append(keys, r.Key) | ||||
| 			} | ||||
| 		} | ||||
| 		recs = recs[ds.NumDiff():] | ||||
| 		numDiffs += ds.NumDiff() | ||||
| 	} | ||||
| 	if maxGroup.IsZero() { | ||||
| 		assert(len(recs) == 0) | ||||
| 	} else { | ||||
| 		list.AppendEllipsis(maxGroup) | ||||
| 		for len(keys) < len(list) { | ||||
| 			keys = append(keys, reflect.Value{}) | ||||
| 		} | ||||
| 	} | ||||
| 	assert(len(list) == len(keys)) | ||||
| 
 | ||||
| 	// For maps, the default formatting logic uses fmt.Stringer which may
 | ||||
| 	// produce ambiguous output. Avoid calling String to disambiguate.
 | ||||
| 	if k == reflect.Map { | ||||
| 		var ambiguous bool | ||||
| 		seenKeys := map[string]reflect.Value{} | ||||
| 		for i, currKey := range keys { | ||||
| 			if currKey.IsValid() { | ||||
| 				strKey := list[i].Key | ||||
| 				prevKey, seen := seenKeys[strKey] | ||||
| 				if seen && prevKey.CanInterface() && currKey.CanInterface() { | ||||
| 					ambiguous = prevKey.Interface() != currKey.Interface() | ||||
| 					if ambiguous { | ||||
| 						break | ||||
| 					} | ||||
| 				} | ||||
| 				seenKeys[strKey] = currKey | ||||
| 			} | ||||
| 		} | ||||
| 		if ambiguous { | ||||
| 			for i, k := range keys { | ||||
| 				if k.IsValid() { | ||||
| 					list[i].Key = formatMapKey(k, true, ptrs) | ||||
| 				} | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	return &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| } | ||||
| 
 | ||||
| // coalesceAdjacentRecords coalesces the list of records into groups of
 | ||||
| // adjacent equal, or unequal counts.
 | ||||
| func coalesceAdjacentRecords(name string, recs []reportRecord) (groups []diffStats) { | ||||
| 	var prevCase int // Arbitrary index into which case last occurred
 | ||||
| 	lastStats := func(i int) *diffStats { | ||||
| 		if prevCase != i { | ||||
| 			groups = append(groups, diffStats{Name: name}) | ||||
| 			prevCase = i | ||||
| 		} | ||||
| 		return &groups[len(groups)-1] | ||||
| 	} | ||||
| 	for _, r := range recs { | ||||
| 		switch rv := r.Value; { | ||||
| 		case rv.NumIgnored > 0 && rv.NumSame+rv.NumDiff == 0: | ||||
| 			lastStats(1).NumIgnored++ | ||||
| 		case rv.NumDiff == 0: | ||||
| 			lastStats(1).NumIdentical++ | ||||
| 		case rv.NumDiff > 0 && !rv.ValueY.IsValid(): | ||||
| 			lastStats(2).NumRemoved++ | ||||
| 		case rv.NumDiff > 0 && !rv.ValueX.IsValid(): | ||||
| 			lastStats(2).NumInserted++ | ||||
| 		default: | ||||
| 			lastStats(2).NumModified++ | ||||
| 		} | ||||
| 	} | ||||
| 	return groups | ||||
| } | ||||
|  | @ -0,0 +1,264 @@ | |||
| // Copyright 2020, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 	"strings" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/flags" | ||||
| 	"github.com/google/go-cmp/cmp/internal/value" | ||||
| ) | ||||
| 
 | ||||
| const ( | ||||
| 	pointerDelimPrefix = "⟪" | ||||
| 	pointerDelimSuffix = "⟫" | ||||
| ) | ||||
| 
 | ||||
| // formatPointer prints the address of the pointer.
 | ||||
| func formatPointer(p value.Pointer, withDelims bool) string { | ||||
| 	v := p.Uintptr() | ||||
| 	if flags.Deterministic { | ||||
| 		v = 0xdeadf00f // Only used for stable testing purposes
 | ||||
| 	} | ||||
| 	if withDelims { | ||||
| 		return pointerDelimPrefix + formatHex(uint64(v)) + pointerDelimSuffix | ||||
| 	} | ||||
| 	return formatHex(uint64(v)) | ||||
| } | ||||
| 
 | ||||
| // pointerReferences is a stack of pointers visited so far.
 | ||||
| type pointerReferences [][2]value.Pointer | ||||
| 
 | ||||
| func (ps *pointerReferences) PushPair(vx, vy reflect.Value, d diffMode, deref bool) (pp [2]value.Pointer) { | ||||
| 	if deref && vx.IsValid() { | ||||
| 		vx = vx.Addr() | ||||
| 	} | ||||
| 	if deref && vy.IsValid() { | ||||
| 		vy = vy.Addr() | ||||
| 	} | ||||
| 	switch d { | ||||
| 	case diffUnknown, diffIdentical: | ||||
| 		pp = [2]value.Pointer{value.PointerOf(vx), value.PointerOf(vy)} | ||||
| 	case diffRemoved: | ||||
| 		pp = [2]value.Pointer{value.PointerOf(vx), value.Pointer{}} | ||||
| 	case diffInserted: | ||||
| 		pp = [2]value.Pointer{value.Pointer{}, value.PointerOf(vy)} | ||||
| 	} | ||||
| 	*ps = append(*ps, pp) | ||||
| 	return pp | ||||
| } | ||||
| 
 | ||||
| func (ps *pointerReferences) Push(v reflect.Value) (p value.Pointer, seen bool) { | ||||
| 	p = value.PointerOf(v) | ||||
| 	for _, pp := range *ps { | ||||
| 		if p == pp[0] || p == pp[1] { | ||||
| 			return p, true | ||||
| 		} | ||||
| 	} | ||||
| 	*ps = append(*ps, [2]value.Pointer{p, p}) | ||||
| 	return p, false | ||||
| } | ||||
| 
 | ||||
| func (ps *pointerReferences) Pop() { | ||||
| 	*ps = (*ps)[:len(*ps)-1] | ||||
| } | ||||
| 
 | ||||
| // trunkReferences is metadata for a textNode indicating that the sub-tree
 | ||||
| // represents the value for either pointer in a pair of references.
 | ||||
| type trunkReferences struct{ pp [2]value.Pointer } | ||||
| 
 | ||||
| // trunkReference is metadata for a textNode indicating that the sub-tree
 | ||||
| // represents the value for the given pointer reference.
 | ||||
| type trunkReference struct{ p value.Pointer } | ||||
| 
 | ||||
| // leafReference is metadata for a textNode indicating that the value is
 | ||||
| // truncated as it refers to another part of the tree (i.e., a trunk).
 | ||||
| type leafReference struct{ p value.Pointer } | ||||
| 
 | ||||
| func wrapTrunkReferences(pp [2]value.Pointer, s textNode) textNode { | ||||
| 	switch { | ||||
| 	case pp[0].IsNil(): | ||||
| 		return &textWrap{Value: s, Metadata: trunkReference{pp[1]}} | ||||
| 	case pp[1].IsNil(): | ||||
| 		return &textWrap{Value: s, Metadata: trunkReference{pp[0]}} | ||||
| 	case pp[0] == pp[1]: | ||||
| 		return &textWrap{Value: s, Metadata: trunkReference{pp[0]}} | ||||
| 	default: | ||||
| 		return &textWrap{Value: s, Metadata: trunkReferences{pp}} | ||||
| 	} | ||||
| } | ||||
| func wrapTrunkReference(p value.Pointer, printAddress bool, s textNode) textNode { | ||||
| 	var prefix string | ||||
| 	if printAddress { | ||||
| 		prefix = formatPointer(p, true) | ||||
| 	} | ||||
| 	return &textWrap{Prefix: prefix, Value: s, Metadata: trunkReference{p}} | ||||
| } | ||||
| func makeLeafReference(p value.Pointer, printAddress bool) textNode { | ||||
| 	out := &textWrap{Prefix: "(", Value: textEllipsis, Suffix: ")"} | ||||
| 	var prefix string | ||||
| 	if printAddress { | ||||
| 		prefix = formatPointer(p, true) | ||||
| 	} | ||||
| 	return &textWrap{Prefix: prefix, Value: out, Metadata: leafReference{p}} | ||||
| } | ||||
| 
 | ||||
| // resolveReferences walks the textNode tree searching for any leaf reference
 | ||||
| // metadata and resolves each against the corresponding trunk references.
 | ||||
| // Since pointer addresses in memory are not particularly readable to the user,
 | ||||
| // it replaces each pointer value with an arbitrary and unique reference ID.
 | ||||
| func resolveReferences(s textNode) { | ||||
| 	var walkNodes func(textNode, func(textNode)) | ||||
| 	walkNodes = func(s textNode, f func(textNode)) { | ||||
| 		f(s) | ||||
| 		switch s := s.(type) { | ||||
| 		case *textWrap: | ||||
| 			walkNodes(s.Value, f) | ||||
| 		case textList: | ||||
| 			for _, r := range s { | ||||
| 				walkNodes(r.Value, f) | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Collect all trunks and leaves with reference metadata.
 | ||||
| 	var trunks, leaves []*textWrap | ||||
| 	walkNodes(s, func(s textNode) { | ||||
| 		if s, ok := s.(*textWrap); ok { | ||||
| 			switch s.Metadata.(type) { | ||||
| 			case leafReference: | ||||
| 				leaves = append(leaves, s) | ||||
| 			case trunkReference, trunkReferences: | ||||
| 				trunks = append(trunks, s) | ||||
| 			} | ||||
| 		} | ||||
| 	}) | ||||
| 
 | ||||
| 	// No leaf references to resolve.
 | ||||
| 	if len(leaves) == 0 { | ||||
| 		return | ||||
| 	} | ||||
| 
 | ||||
| 	// Collect the set of all leaf references to resolve.
 | ||||
| 	leafPtrs := make(map[value.Pointer]bool) | ||||
| 	for _, leaf := range leaves { | ||||
| 		leafPtrs[leaf.Metadata.(leafReference).p] = true | ||||
| 	} | ||||
| 
 | ||||
| 	// Collect the set of trunk pointers that are always paired together.
 | ||||
| 	// This allows us to assign a single ID to both pointers for brevity.
 | ||||
| 	// If a pointer in a pair ever occurs by itself or as a different pair,
 | ||||
| 	// then the pair is broken.
 | ||||
| 	pairedTrunkPtrs := make(map[value.Pointer]value.Pointer) | ||||
| 	unpair := func(p value.Pointer) { | ||||
| 		if !pairedTrunkPtrs[p].IsNil() { | ||||
| 			pairedTrunkPtrs[pairedTrunkPtrs[p]] = value.Pointer{} // invalidate other half
 | ||||
| 		} | ||||
| 		pairedTrunkPtrs[p] = value.Pointer{} // invalidate this half
 | ||||
| 	} | ||||
| 	for _, trunk := range trunks { | ||||
| 		switch p := trunk.Metadata.(type) { | ||||
| 		case trunkReference: | ||||
| 			unpair(p.p) // standalone pointer cannot be part of a pair
 | ||||
| 		case trunkReferences: | ||||
| 			p0, ok0 := pairedTrunkPtrs[p.pp[0]] | ||||
| 			p1, ok1 := pairedTrunkPtrs[p.pp[1]] | ||||
| 			switch { | ||||
| 			case !ok0 && !ok1: | ||||
| 				// Register the newly seen pair.
 | ||||
| 				pairedTrunkPtrs[p.pp[0]] = p.pp[1] | ||||
| 				pairedTrunkPtrs[p.pp[1]] = p.pp[0] | ||||
| 			case ok0 && ok1 && p0 == p.pp[1] && p1 == p.pp[0]: | ||||
| 				// Exact pair already seen; do nothing.
 | ||||
| 			default: | ||||
| 				// Pair conflicts with some other pair; break all pairs.
 | ||||
| 				unpair(p.pp[0]) | ||||
| 				unpair(p.pp[1]) | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Correlate each pointer referenced by leaves to a unique identifier,
 | ||||
| 	// and print the IDs for each trunk that matches those pointers.
 | ||||
| 	var nextID uint | ||||
| 	ptrIDs := make(map[value.Pointer]uint) | ||||
| 	newID := func() uint { | ||||
| 		id := nextID | ||||
| 		nextID++ | ||||
| 		return id | ||||
| 	} | ||||
| 	for _, trunk := range trunks { | ||||
| 		switch p := trunk.Metadata.(type) { | ||||
| 		case trunkReference: | ||||
| 			if print := leafPtrs[p.p]; print { | ||||
| 				id, ok := ptrIDs[p.p] | ||||
| 				if !ok { | ||||
| 					id = newID() | ||||
| 					ptrIDs[p.p] = id | ||||
| 				} | ||||
| 				trunk.Prefix = updateReferencePrefix(trunk.Prefix, formatReference(id)) | ||||
| 			} | ||||
| 		case trunkReferences: | ||||
| 			print0 := leafPtrs[p.pp[0]] | ||||
| 			print1 := leafPtrs[p.pp[1]] | ||||
| 			if print0 || print1 { | ||||
| 				id0, ok0 := ptrIDs[p.pp[0]] | ||||
| 				id1, ok1 := ptrIDs[p.pp[1]] | ||||
| 				isPair := pairedTrunkPtrs[p.pp[0]] == p.pp[1] && pairedTrunkPtrs[p.pp[1]] == p.pp[0] | ||||
| 				if isPair { | ||||
| 					var id uint | ||||
| 					assert(ok0 == ok1) // must be seen together or not at all
 | ||||
| 					if ok0 { | ||||
| 						assert(id0 == id1) // must have the same ID
 | ||||
| 						id = id0 | ||||
| 					} else { | ||||
| 						id = newID() | ||||
| 						ptrIDs[p.pp[0]] = id | ||||
| 						ptrIDs[p.pp[1]] = id | ||||
| 					} | ||||
| 					trunk.Prefix = updateReferencePrefix(trunk.Prefix, formatReference(id)) | ||||
| 				} else { | ||||
| 					if print0 && !ok0 { | ||||
| 						id0 = newID() | ||||
| 						ptrIDs[p.pp[0]] = id0 | ||||
| 					} | ||||
| 					if print1 && !ok1 { | ||||
| 						id1 = newID() | ||||
| 						ptrIDs[p.pp[1]] = id1 | ||||
| 					} | ||||
| 					switch { | ||||
| 					case print0 && print1: | ||||
| 						trunk.Prefix = updateReferencePrefix(trunk.Prefix, formatReference(id0)+","+formatReference(id1)) | ||||
| 					case print0: | ||||
| 						trunk.Prefix = updateReferencePrefix(trunk.Prefix, formatReference(id0)) | ||||
| 					case print1: | ||||
| 						trunk.Prefix = updateReferencePrefix(trunk.Prefix, formatReference(id1)) | ||||
| 					} | ||||
| 				} | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Update all leaf references with the unique identifier.
 | ||||
| 	for _, leaf := range leaves { | ||||
| 		if id, ok := ptrIDs[leaf.Metadata.(leafReference).p]; ok { | ||||
| 			leaf.Prefix = updateReferencePrefix(leaf.Prefix, formatReference(id)) | ||||
| 		} | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func formatReference(id uint) string { | ||||
| 	return fmt.Sprintf("ref#%d", id) | ||||
| } | ||||
| 
 | ||||
| func updateReferencePrefix(prefix, ref string) string { | ||||
| 	if prefix == "" { | ||||
| 		return pointerDelimPrefix + ref + pointerDelimSuffix | ||||
| 	} | ||||
| 	suffix := strings.TrimPrefix(prefix, pointerDelimPrefix) | ||||
| 	return pointerDelimPrefix + ref + ": " + suffix | ||||
| } | ||||
|  | @ -0,0 +1,407 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"bytes" | ||||
| 	"fmt" | ||||
| 	"reflect" | ||||
| 	"strconv" | ||||
| 	"strings" | ||||
| 	"unicode" | ||||
| 	"unicode/utf8" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/value" | ||||
| ) | ||||
| 
 | ||||
| type formatValueOptions struct { | ||||
| 	// AvoidStringer controls whether to avoid calling custom stringer
 | ||||
| 	// methods like error.Error or fmt.Stringer.String.
 | ||||
| 	AvoidStringer bool | ||||
| 
 | ||||
| 	// PrintAddresses controls whether to print the address of all pointers,
 | ||||
| 	// slice elements, and maps.
 | ||||
| 	PrintAddresses bool | ||||
| 
 | ||||
| 	// QualifiedNames controls whether FormatType uses the fully qualified name
 | ||||
| 	// (including the full package path as opposed to just the package name).
 | ||||
| 	QualifiedNames bool | ||||
| 
 | ||||
| 	// VerbosityLevel controls the amount of output to produce.
 | ||||
| 	// A higher value produces more output. A value of zero or lower produces
 | ||||
| 	// no output (represented using an ellipsis).
 | ||||
| 	// If LimitVerbosity is false, then the level is treated as infinite.
 | ||||
| 	VerbosityLevel int | ||||
| 
 | ||||
| 	// LimitVerbosity specifies that formatting should respect VerbosityLevel.
 | ||||
| 	LimitVerbosity bool | ||||
| } | ||||
| 
 | ||||
| // FormatType prints the type as if it were wrapping s.
 | ||||
| // This may return s as-is depending on the current type and TypeMode mode.
 | ||||
| func (opts formatOptions) FormatType(t reflect.Type, s textNode) textNode { | ||||
| 	// Check whether to emit the type or not.
 | ||||
| 	switch opts.TypeMode { | ||||
| 	case autoType: | ||||
| 		switch t.Kind() { | ||||
| 		case reflect.Struct, reflect.Slice, reflect.Array, reflect.Map: | ||||
| 			if s.Equal(textNil) { | ||||
| 				return s | ||||
| 			} | ||||
| 		default: | ||||
| 			return s | ||||
| 		} | ||||
| 		if opts.DiffMode == diffIdentical { | ||||
| 			return s // elide type for identical nodes
 | ||||
| 		} | ||||
| 	case elideType: | ||||
| 		return s | ||||
| 	} | ||||
| 
 | ||||
| 	// Determine the type label, applying special handling for unnamed types.
 | ||||
| 	typeName := value.TypeString(t, opts.QualifiedNames) | ||||
| 	if t.Name() == "" { | ||||
| 		// According to Go grammar, certain type literals contain symbols that
 | ||||
| 		// do not strongly bind to the next lexicographical token (e.g., *T).
 | ||||
| 		switch t.Kind() { | ||||
| 		case reflect.Chan, reflect.Func, reflect.Ptr: | ||||
| 			typeName = "(" + typeName + ")" | ||||
| 		} | ||||
| 	} | ||||
| 	return &textWrap{Prefix: typeName, Value: wrapParens(s)} | ||||
| } | ||||
| 
 | ||||
| // wrapParens wraps s with a set of parenthesis, but avoids it if the
 | ||||
| // wrapped node itself is already surrounded by a pair of parenthesis or braces.
 | ||||
| // It handles unwrapping one level of pointer-reference nodes.
 | ||||
| func wrapParens(s textNode) textNode { | ||||
| 	var refNode *textWrap | ||||
| 	if s2, ok := s.(*textWrap); ok { | ||||
| 		// Unwrap a single pointer reference node.
 | ||||
| 		switch s2.Metadata.(type) { | ||||
| 		case leafReference, trunkReference, trunkReferences: | ||||
| 			refNode = s2 | ||||
| 			if s3, ok := refNode.Value.(*textWrap); ok { | ||||
| 				s2 = s3 | ||||
| 			} | ||||
| 		} | ||||
| 
 | ||||
| 		// Already has delimiters that make parenthesis unnecessary.
 | ||||
| 		hasParens := strings.HasPrefix(s2.Prefix, "(") && strings.HasSuffix(s2.Suffix, ")") | ||||
| 		hasBraces := strings.HasPrefix(s2.Prefix, "{") && strings.HasSuffix(s2.Suffix, "}") | ||||
| 		if hasParens || hasBraces { | ||||
| 			return s | ||||
| 		} | ||||
| 	} | ||||
| 	if refNode != nil { | ||||
| 		refNode.Value = &textWrap{Prefix: "(", Value: refNode.Value, Suffix: ")"} | ||||
| 		return s | ||||
| 	} | ||||
| 	return &textWrap{Prefix: "(", Value: s, Suffix: ")"} | ||||
| } | ||||
| 
 | ||||
| // FormatValue prints the reflect.Value, taking extra care to avoid descending
 | ||||
| // into pointers already in ptrs. As pointers are visited, ptrs is also updated.
 | ||||
| func (opts formatOptions) FormatValue(v reflect.Value, parentKind reflect.Kind, ptrs *pointerReferences) (out textNode) { | ||||
| 	if !v.IsValid() { | ||||
| 		return nil | ||||
| 	} | ||||
| 	t := v.Type() | ||||
| 
 | ||||
| 	// Check slice element for cycles.
 | ||||
| 	if parentKind == reflect.Slice { | ||||
| 		ptrRef, visited := ptrs.Push(v.Addr()) | ||||
| 		if visited { | ||||
| 			return makeLeafReference(ptrRef, false) | ||||
| 		} | ||||
| 		defer ptrs.Pop() | ||||
| 		defer func() { out = wrapTrunkReference(ptrRef, false, out) }() | ||||
| 	} | ||||
| 
 | ||||
| 	// Check whether there is an Error or String method to call.
 | ||||
| 	if !opts.AvoidStringer && v.CanInterface() { | ||||
| 		// Avoid calling Error or String methods on nil receivers since many
 | ||||
| 		// implementations crash when doing so.
 | ||||
| 		if (t.Kind() != reflect.Ptr && t.Kind() != reflect.Interface) || !v.IsNil() { | ||||
| 			var prefix, strVal string | ||||
| 			func() { | ||||
| 				// Swallow and ignore any panics from String or Error.
 | ||||
| 				defer func() { recover() }() | ||||
| 				switch v := v.Interface().(type) { | ||||
| 				case error: | ||||
| 					strVal = v.Error() | ||||
| 					prefix = "e" | ||||
| 				case fmt.Stringer: | ||||
| 					strVal = v.String() | ||||
| 					prefix = "s" | ||||
| 				} | ||||
| 			}() | ||||
| 			if prefix != "" { | ||||
| 				return opts.formatString(prefix, strVal) | ||||
| 			} | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Check whether to explicitly wrap the result with the type.
 | ||||
| 	var skipType bool | ||||
| 	defer func() { | ||||
| 		if !skipType { | ||||
| 			out = opts.FormatType(t, out) | ||||
| 		} | ||||
| 	}() | ||||
| 
 | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.Bool: | ||||
| 		return textLine(fmt.Sprint(v.Bool())) | ||||
| 	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: | ||||
| 		return textLine(fmt.Sprint(v.Int())) | ||||
| 	case reflect.Uint, reflect.Uint16, reflect.Uint32, reflect.Uint64: | ||||
| 		return textLine(fmt.Sprint(v.Uint())) | ||||
| 	case reflect.Uint8: | ||||
| 		if parentKind == reflect.Slice || parentKind == reflect.Array { | ||||
| 			return textLine(formatHex(v.Uint())) | ||||
| 		} | ||||
| 		return textLine(fmt.Sprint(v.Uint())) | ||||
| 	case reflect.Uintptr: | ||||
| 		return textLine(formatHex(v.Uint())) | ||||
| 	case reflect.Float32, reflect.Float64: | ||||
| 		return textLine(fmt.Sprint(v.Float())) | ||||
| 	case reflect.Complex64, reflect.Complex128: | ||||
| 		return textLine(fmt.Sprint(v.Complex())) | ||||
| 	case reflect.String: | ||||
| 		return opts.formatString("", v.String()) | ||||
| 	case reflect.UnsafePointer, reflect.Chan, reflect.Func: | ||||
| 		return textLine(formatPointer(value.PointerOf(v), true)) | ||||
| 	case reflect.Struct: | ||||
| 		var list textList | ||||
| 		v := makeAddressable(v) // needed for retrieveUnexportedField
 | ||||
| 		maxLen := v.NumField() | ||||
| 		if opts.LimitVerbosity { | ||||
| 			maxLen = ((1 << opts.verbosity()) >> 1) << 2 // 0, 4, 8, 16, 32, etc...
 | ||||
| 			opts.VerbosityLevel-- | ||||
| 		} | ||||
| 		for i := 0; i < v.NumField(); i++ { | ||||
| 			vv := v.Field(i) | ||||
| 			if value.IsZero(vv) { | ||||
| 				continue // Elide fields with zero values
 | ||||
| 			} | ||||
| 			if len(list) == maxLen { | ||||
| 				list.AppendEllipsis(diffStats{}) | ||||
| 				break | ||||
| 			} | ||||
| 			sf := t.Field(i) | ||||
| 			if supportExporters && !isExported(sf.Name) { | ||||
| 				vv = retrieveUnexportedField(v, sf, true) | ||||
| 			} | ||||
| 			s := opts.WithTypeMode(autoType).FormatValue(vv, t.Kind(), ptrs) | ||||
| 			list = append(list, textRecord{Key: sf.Name, Value: s}) | ||||
| 		} | ||||
| 		return &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| 	case reflect.Slice: | ||||
| 		if v.IsNil() { | ||||
| 			return textNil | ||||
| 		} | ||||
| 
 | ||||
| 		// Check whether this is a []byte of text data.
 | ||||
| 		if t.Elem() == reflect.TypeOf(byte(0)) { | ||||
| 			b := v.Bytes() | ||||
| 			isPrintSpace := func(r rune) bool { return unicode.IsPrint(r) || unicode.IsSpace(r) } | ||||
| 			if len(b) > 0 && utf8.Valid(b) && len(bytes.TrimFunc(b, isPrintSpace)) == 0 { | ||||
| 				out = opts.formatString("", string(b)) | ||||
| 				skipType = true | ||||
| 				return opts.FormatType(t, out) | ||||
| 			} | ||||
| 		} | ||||
| 
 | ||||
| 		fallthrough | ||||
| 	case reflect.Array: | ||||
| 		maxLen := v.Len() | ||||
| 		if opts.LimitVerbosity { | ||||
| 			maxLen = ((1 << opts.verbosity()) >> 1) << 2 // 0, 4, 8, 16, 32, etc...
 | ||||
| 			opts.VerbosityLevel-- | ||||
| 		} | ||||
| 		var list textList | ||||
| 		for i := 0; i < v.Len(); i++ { | ||||
| 			if len(list) == maxLen { | ||||
| 				list.AppendEllipsis(diffStats{}) | ||||
| 				break | ||||
| 			} | ||||
| 			s := opts.WithTypeMode(elideType).FormatValue(v.Index(i), t.Kind(), ptrs) | ||||
| 			list = append(list, textRecord{Value: s}) | ||||
| 		} | ||||
| 
 | ||||
| 		out = &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| 		if t.Kind() == reflect.Slice && opts.PrintAddresses { | ||||
| 			header := fmt.Sprintf("ptr:%v, len:%d, cap:%d", formatPointer(value.PointerOf(v), false), v.Len(), v.Cap()) | ||||
| 			out = &textWrap{Prefix: pointerDelimPrefix + header + pointerDelimSuffix, Value: out} | ||||
| 		} | ||||
| 		return out | ||||
| 	case reflect.Map: | ||||
| 		if v.IsNil() { | ||||
| 			return textNil | ||||
| 		} | ||||
| 
 | ||||
| 		// Check pointer for cycles.
 | ||||
| 		ptrRef, visited := ptrs.Push(v) | ||||
| 		if visited { | ||||
| 			return makeLeafReference(ptrRef, opts.PrintAddresses) | ||||
| 		} | ||||
| 		defer ptrs.Pop() | ||||
| 
 | ||||
| 		maxLen := v.Len() | ||||
| 		if opts.LimitVerbosity { | ||||
| 			maxLen = ((1 << opts.verbosity()) >> 1) << 2 // 0, 4, 8, 16, 32, etc...
 | ||||
| 			opts.VerbosityLevel-- | ||||
| 		} | ||||
| 		var list textList | ||||
| 		for _, k := range value.SortKeys(v.MapKeys()) { | ||||
| 			if len(list) == maxLen { | ||||
| 				list.AppendEllipsis(diffStats{}) | ||||
| 				break | ||||
| 			} | ||||
| 			sk := formatMapKey(k, false, ptrs) | ||||
| 			sv := opts.WithTypeMode(elideType).FormatValue(v.MapIndex(k), t.Kind(), ptrs) | ||||
| 			list = append(list, textRecord{Key: sk, Value: sv}) | ||||
| 		} | ||||
| 
 | ||||
| 		out = &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| 		out = wrapTrunkReference(ptrRef, opts.PrintAddresses, out) | ||||
| 		return out | ||||
| 	case reflect.Ptr: | ||||
| 		if v.IsNil() { | ||||
| 			return textNil | ||||
| 		} | ||||
| 
 | ||||
| 		// Check pointer for cycles.
 | ||||
| 		ptrRef, visited := ptrs.Push(v) | ||||
| 		if visited { | ||||
| 			out = makeLeafReference(ptrRef, opts.PrintAddresses) | ||||
| 			return &textWrap{Prefix: "&", Value: out} | ||||
| 		} | ||||
| 		defer ptrs.Pop() | ||||
| 
 | ||||
| 		// Skip the name only if this is an unnamed pointer type.
 | ||||
| 		// Otherwise taking the address of a value does not reproduce
 | ||||
| 		// the named pointer type.
 | ||||
| 		if v.Type().Name() == "" { | ||||
| 			skipType = true // Let the underlying value print the type instead
 | ||||
| 		} | ||||
| 		out = opts.FormatValue(v.Elem(), t.Kind(), ptrs) | ||||
| 		out = wrapTrunkReference(ptrRef, opts.PrintAddresses, out) | ||||
| 		out = &textWrap{Prefix: "&", Value: out} | ||||
| 		return out | ||||
| 	case reflect.Interface: | ||||
| 		if v.IsNil() { | ||||
| 			return textNil | ||||
| 		} | ||||
| 		// Interfaces accept different concrete types,
 | ||||
| 		// so configure the underlying value to explicitly print the type.
 | ||||
| 		return opts.WithTypeMode(emitType).FormatValue(v.Elem(), t.Kind(), ptrs) | ||||
| 	default: | ||||
| 		panic(fmt.Sprintf("%v kind not handled", v.Kind())) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (opts formatOptions) formatString(prefix, s string) textNode { | ||||
| 	maxLen := len(s) | ||||
| 	maxLines := strings.Count(s, "\n") + 1 | ||||
| 	if opts.LimitVerbosity { | ||||
| 		maxLen = (1 << opts.verbosity()) << 5   // 32, 64, 128, 256, etc...
 | ||||
| 		maxLines = (1 << opts.verbosity()) << 2 //  4, 8, 16, 32, 64, etc...
 | ||||
| 	} | ||||
| 
 | ||||
| 	// For multiline strings, use the triple-quote syntax,
 | ||||
| 	// but only use it when printing removed or inserted nodes since
 | ||||
| 	// we only want the extra verbosity for those cases.
 | ||||
| 	lines := strings.Split(strings.TrimSuffix(s, "\n"), "\n") | ||||
| 	isTripleQuoted := len(lines) >= 4 && (opts.DiffMode == '-' || opts.DiffMode == '+') | ||||
| 	for i := 0; i < len(lines) && isTripleQuoted; i++ { | ||||
| 		lines[i] = strings.TrimPrefix(strings.TrimSuffix(lines[i], "\r"), "\r") // trim leading/trailing carriage returns for legacy Windows endline support
 | ||||
| 		isPrintable := func(r rune) bool { | ||||
| 			return unicode.IsPrint(r) || r == '\t' // specially treat tab as printable
 | ||||
| 		} | ||||
| 		line := lines[i] | ||||
| 		isTripleQuoted = !strings.HasPrefix(strings.TrimPrefix(line, prefix), `"""`) && !strings.HasPrefix(line, "...") && strings.TrimFunc(line, isPrintable) == "" && len(line) <= maxLen | ||||
| 	} | ||||
| 	if isTripleQuoted { | ||||
| 		var list textList | ||||
| 		list = append(list, textRecord{Diff: opts.DiffMode, Value: textLine(prefix + `"""`), ElideComma: true}) | ||||
| 		for i, line := range lines { | ||||
| 			if numElided := len(lines) - i; i == maxLines-1 && numElided > 1 { | ||||
| 				comment := commentString(fmt.Sprintf("%d elided lines", numElided)) | ||||
| 				list = append(list, textRecord{Diff: opts.DiffMode, Value: textEllipsis, ElideComma: true, Comment: comment}) | ||||
| 				break | ||||
| 			} | ||||
| 			list = append(list, textRecord{Diff: opts.DiffMode, Value: textLine(line), ElideComma: true}) | ||||
| 		} | ||||
| 		list = append(list, textRecord{Diff: opts.DiffMode, Value: textLine(prefix + `"""`), ElideComma: true}) | ||||
| 		return &textWrap{Prefix: "(", Value: list, Suffix: ")"} | ||||
| 	} | ||||
| 
 | ||||
| 	// Format the string as a single-line quoted string.
 | ||||
| 	if len(s) > maxLen+len(textEllipsis) { | ||||
| 		return textLine(prefix + formatString(s[:maxLen]) + string(textEllipsis)) | ||||
| 	} | ||||
| 	return textLine(prefix + formatString(s)) | ||||
| } | ||||
| 
 | ||||
| // formatMapKey formats v as if it were a map key.
 | ||||
| // The result is guaranteed to be a single line.
 | ||||
| func formatMapKey(v reflect.Value, disambiguate bool, ptrs *pointerReferences) string { | ||||
| 	var opts formatOptions | ||||
| 	opts.DiffMode = diffIdentical | ||||
| 	opts.TypeMode = elideType | ||||
| 	opts.PrintAddresses = disambiguate | ||||
| 	opts.AvoidStringer = disambiguate | ||||
| 	opts.QualifiedNames = disambiguate | ||||
| 	opts.VerbosityLevel = maxVerbosityPreset | ||||
| 	opts.LimitVerbosity = true | ||||
| 	s := opts.FormatValue(v, reflect.Map, ptrs).String() | ||||
| 	return strings.TrimSpace(s) | ||||
| } | ||||
| 
 | ||||
| // formatString prints s as a double-quoted or backtick-quoted string.
 | ||||
| func formatString(s string) string { | ||||
| 	// Use quoted string if it the same length as a raw string literal.
 | ||||
| 	// Otherwise, attempt to use the raw string form.
 | ||||
| 	qs := strconv.Quote(s) | ||||
| 	if len(qs) == 1+len(s)+1 { | ||||
| 		return qs | ||||
| 	} | ||||
| 
 | ||||
| 	// Disallow newlines to ensure output is a single line.
 | ||||
| 	// Only allow printable runes for readability purposes.
 | ||||
| 	rawInvalid := func(r rune) bool { | ||||
| 		return r == '`' || r == '\n' || !(unicode.IsPrint(r) || r == '\t') | ||||
| 	} | ||||
| 	if utf8.ValidString(s) && strings.IndexFunc(s, rawInvalid) < 0 { | ||||
| 		return "`" + s + "`" | ||||
| 	} | ||||
| 	return qs | ||||
| } | ||||
| 
 | ||||
| // formatHex prints u as a hexadecimal integer in Go notation.
 | ||||
| func formatHex(u uint64) string { | ||||
| 	var f string | ||||
| 	switch { | ||||
| 	case u <= 0xff: | ||||
| 		f = "0x%02x" | ||||
| 	case u <= 0xffff: | ||||
| 		f = "0x%04x" | ||||
| 	case u <= 0xffffff: | ||||
| 		f = "0x%06x" | ||||
| 	case u <= 0xffffffff: | ||||
| 		f = "0x%08x" | ||||
| 	case u <= 0xffffffffff: | ||||
| 		f = "0x%010x" | ||||
| 	case u <= 0xffffffffffff: | ||||
| 		f = "0x%012x" | ||||
| 	case u <= 0xffffffffffffff: | ||||
| 		f = "0x%014x" | ||||
| 	case u <= 0xffffffffffffffff: | ||||
| 		f = "0x%016x" | ||||
| 	} | ||||
| 	return fmt.Sprintf(f, u) | ||||
| } | ||||
|  | @ -0,0 +1,613 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"bytes" | ||||
| 	"fmt" | ||||
| 	"math" | ||||
| 	"reflect" | ||||
| 	"strconv" | ||||
| 	"strings" | ||||
| 	"unicode" | ||||
| 	"unicode/utf8" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/diff" | ||||
| ) | ||||
| 
 | ||||
| // CanFormatDiffSlice reports whether we support custom formatting for nodes
 | ||||
| // that are slices of primitive kinds or strings.
 | ||||
| func (opts formatOptions) CanFormatDiffSlice(v *valueNode) bool { | ||||
| 	switch { | ||||
| 	case opts.DiffMode != diffUnknown: | ||||
| 		return false // Must be formatting in diff mode
 | ||||
| 	case v.NumDiff == 0: | ||||
| 		return false // No differences detected
 | ||||
| 	case !v.ValueX.IsValid() || !v.ValueY.IsValid(): | ||||
| 		return false // Both values must be valid
 | ||||
| 	case v.NumIgnored > 0: | ||||
| 		return false // Some ignore option was used
 | ||||
| 	case v.NumTransformed > 0: | ||||
| 		return false // Some transform option was used
 | ||||
| 	case v.NumCompared > 1: | ||||
| 		return false // More than one comparison was used
 | ||||
| 	case v.NumCompared == 1 && v.Type.Name() != "": | ||||
| 		// The need for cmp to check applicability of options on every element
 | ||||
| 		// in a slice is a significant performance detriment for large []byte.
 | ||||
| 		// The workaround is to specify Comparer(bytes.Equal),
 | ||||
| 		// which enables cmp to compare []byte more efficiently.
 | ||||
| 		// If they differ, we still want to provide batched diffing.
 | ||||
| 		// The logic disallows named types since they tend to have their own
 | ||||
| 		// String method, with nicer formatting than what this provides.
 | ||||
| 		return false | ||||
| 	} | ||||
| 
 | ||||
| 	// Check whether this is an interface with the same concrete types.
 | ||||
| 	t := v.Type | ||||
| 	vx, vy := v.ValueX, v.ValueY | ||||
| 	if t.Kind() == reflect.Interface && !vx.IsNil() && !vy.IsNil() && vx.Elem().Type() == vy.Elem().Type() { | ||||
| 		vx, vy = vx.Elem(), vy.Elem() | ||||
| 		t = vx.Type() | ||||
| 	} | ||||
| 
 | ||||
| 	// Check whether we provide specialized diffing for this type.
 | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.String: | ||||
| 	case reflect.Array, reflect.Slice: | ||||
| 		// Only slices of primitive types have specialized handling.
 | ||||
| 		switch t.Elem().Kind() { | ||||
| 		case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, | ||||
| 			reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr, | ||||
| 			reflect.Bool, reflect.Float32, reflect.Float64, reflect.Complex64, reflect.Complex128: | ||||
| 		default: | ||||
| 			return false | ||||
| 		} | ||||
| 
 | ||||
| 		// Both slice values have to be non-empty.
 | ||||
| 		if t.Kind() == reflect.Slice && (vx.Len() == 0 || vy.Len() == 0) { | ||||
| 			return false | ||||
| 		} | ||||
| 
 | ||||
| 		// If a sufficient number of elements already differ,
 | ||||
| 		// use specialized formatting even if length requirement is not met.
 | ||||
| 		if v.NumDiff > v.NumSame { | ||||
| 			return true | ||||
| 		} | ||||
| 	default: | ||||
| 		return false | ||||
| 	} | ||||
| 
 | ||||
| 	// Use specialized string diffing for longer slices or strings.
 | ||||
| 	const minLength = 32 | ||||
| 	return vx.Len() >= minLength && vy.Len() >= minLength | ||||
| } | ||||
| 
 | ||||
| // FormatDiffSlice prints a diff for the slices (or strings) represented by v.
 | ||||
| // This provides custom-tailored logic to make printing of differences in
 | ||||
| // textual strings and slices of primitive kinds more readable.
 | ||||
| func (opts formatOptions) FormatDiffSlice(v *valueNode) textNode { | ||||
| 	assert(opts.DiffMode == diffUnknown) | ||||
| 	t, vx, vy := v.Type, v.ValueX, v.ValueY | ||||
| 	if t.Kind() == reflect.Interface { | ||||
| 		vx, vy = vx.Elem(), vy.Elem() | ||||
| 		t = vx.Type() | ||||
| 		opts = opts.WithTypeMode(emitType) | ||||
| 	} | ||||
| 
 | ||||
| 	// Auto-detect the type of the data.
 | ||||
| 	var sx, sy string | ||||
| 	var ssx, ssy []string | ||||
| 	var isString, isMostlyText, isPureLinedText, isBinary bool | ||||
| 	switch { | ||||
| 	case t.Kind() == reflect.String: | ||||
| 		sx, sy = vx.String(), vy.String() | ||||
| 		isString = true | ||||
| 	case t.Kind() == reflect.Slice && t.Elem() == reflect.TypeOf(byte(0)): | ||||
| 		sx, sy = string(vx.Bytes()), string(vy.Bytes()) | ||||
| 		isString = true | ||||
| 	case t.Kind() == reflect.Array: | ||||
| 		// Arrays need to be addressable for slice operations to work.
 | ||||
| 		vx2, vy2 := reflect.New(t).Elem(), reflect.New(t).Elem() | ||||
| 		vx2.Set(vx) | ||||
| 		vy2.Set(vy) | ||||
| 		vx, vy = vx2, vy2 | ||||
| 	} | ||||
| 	if isString { | ||||
| 		var numTotalRunes, numValidRunes, numLines, lastLineIdx, maxLineLen int | ||||
| 		for i, r := range sx + sy { | ||||
| 			numTotalRunes++ | ||||
| 			if (unicode.IsPrint(r) || unicode.IsSpace(r)) && r != utf8.RuneError { | ||||
| 				numValidRunes++ | ||||
| 			} | ||||
| 			if r == '\n' { | ||||
| 				if maxLineLen < i-lastLineIdx { | ||||
| 					maxLineLen = i - lastLineIdx | ||||
| 				} | ||||
| 				lastLineIdx = i + 1 | ||||
| 				numLines++ | ||||
| 			} | ||||
| 		} | ||||
| 		isPureText := numValidRunes == numTotalRunes | ||||
| 		isMostlyText = float64(numValidRunes) > math.Floor(0.90*float64(numTotalRunes)) | ||||
| 		isPureLinedText = isPureText && numLines >= 4 && maxLineLen <= 1024 | ||||
| 		isBinary = !isMostlyText | ||||
| 
 | ||||
| 		// Avoid diffing by lines if it produces a significantly more complex
 | ||||
| 		// edit script than diffing by bytes.
 | ||||
| 		if isPureLinedText { | ||||
| 			ssx = strings.Split(sx, "\n") | ||||
| 			ssy = strings.Split(sy, "\n") | ||||
| 			esLines := diff.Difference(len(ssx), len(ssy), func(ix, iy int) diff.Result { | ||||
| 				return diff.BoolResult(ssx[ix] == ssy[iy]) | ||||
| 			}) | ||||
| 			esBytes := diff.Difference(len(sx), len(sy), func(ix, iy int) diff.Result { | ||||
| 				return diff.BoolResult(sx[ix] == sy[iy]) | ||||
| 			}) | ||||
| 			efficiencyLines := float64(esLines.Dist()) / float64(len(esLines)) | ||||
| 			efficiencyBytes := float64(esBytes.Dist()) / float64(len(esBytes)) | ||||
| 			isPureLinedText = efficiencyLines < 4*efficiencyBytes | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Format the string into printable records.
 | ||||
| 	var list textList | ||||
| 	var delim string | ||||
| 	switch { | ||||
| 	// If the text appears to be multi-lined text,
 | ||||
| 	// then perform differencing across individual lines.
 | ||||
| 	case isPureLinedText: | ||||
| 		list = opts.formatDiffSlice( | ||||
| 			reflect.ValueOf(ssx), reflect.ValueOf(ssy), 1, "line", | ||||
| 			func(v reflect.Value, d diffMode) textRecord { | ||||
| 				s := formatString(v.Index(0).String()) | ||||
| 				return textRecord{Diff: d, Value: textLine(s)} | ||||
| 			}, | ||||
| 		) | ||||
| 		delim = "\n" | ||||
| 
 | ||||
| 		// If possible, use a custom triple-quote (""") syntax for printing
 | ||||
| 		// differences in a string literal. This format is more readable,
 | ||||
| 		// but has edge-cases where differences are visually indistinguishable.
 | ||||
| 		// This format is avoided under the following conditions:
 | ||||
| 		//	• A line starts with `"""`
 | ||||
| 		//	• A line starts with "..."
 | ||||
| 		//	• A line contains non-printable characters
 | ||||
| 		//	• Adjacent different lines differ only by whitespace
 | ||||
| 		//
 | ||||
| 		// For example:
 | ||||
| 		//		"""
 | ||||
| 		//		... // 3 identical lines
 | ||||
| 		//		foo
 | ||||
| 		//		bar
 | ||||
| 		//	-	baz
 | ||||
| 		//	+	BAZ
 | ||||
| 		//		"""
 | ||||
| 		isTripleQuoted := true | ||||
| 		prevRemoveLines := map[string]bool{} | ||||
| 		prevInsertLines := map[string]bool{} | ||||
| 		var list2 textList | ||||
| 		list2 = append(list2, textRecord{Value: textLine(`"""`), ElideComma: true}) | ||||
| 		for _, r := range list { | ||||
| 			if !r.Value.Equal(textEllipsis) { | ||||
| 				line, _ := strconv.Unquote(string(r.Value.(textLine))) | ||||
| 				line = strings.TrimPrefix(strings.TrimSuffix(line, "\r"), "\r") // trim leading/trailing carriage returns for legacy Windows endline support
 | ||||
| 				normLine := strings.Map(func(r rune) rune { | ||||
| 					if unicode.IsSpace(r) { | ||||
| 						return -1 // drop whitespace to avoid visually indistinguishable output
 | ||||
| 					} | ||||
| 					return r | ||||
| 				}, line) | ||||
| 				isPrintable := func(r rune) bool { | ||||
| 					return unicode.IsPrint(r) || r == '\t' // specially treat tab as printable
 | ||||
| 				} | ||||
| 				isTripleQuoted = !strings.HasPrefix(line, `"""`) && !strings.HasPrefix(line, "...") && strings.TrimFunc(line, isPrintable) == "" | ||||
| 				switch r.Diff { | ||||
| 				case diffRemoved: | ||||
| 					isTripleQuoted = isTripleQuoted && !prevInsertLines[normLine] | ||||
| 					prevRemoveLines[normLine] = true | ||||
| 				case diffInserted: | ||||
| 					isTripleQuoted = isTripleQuoted && !prevRemoveLines[normLine] | ||||
| 					prevInsertLines[normLine] = true | ||||
| 				} | ||||
| 				if !isTripleQuoted { | ||||
| 					break | ||||
| 				} | ||||
| 				r.Value = textLine(line) | ||||
| 				r.ElideComma = true | ||||
| 			} | ||||
| 			if !(r.Diff == diffRemoved || r.Diff == diffInserted) { // start a new non-adjacent difference group
 | ||||
| 				prevRemoveLines = map[string]bool{} | ||||
| 				prevInsertLines = map[string]bool{} | ||||
| 			} | ||||
| 			list2 = append(list2, r) | ||||
| 		} | ||||
| 		if r := list2[len(list2)-1]; r.Diff == diffIdentical && len(r.Value.(textLine)) == 0 { | ||||
| 			list2 = list2[:len(list2)-1] // elide single empty line at the end
 | ||||
| 		} | ||||
| 		list2 = append(list2, textRecord{Value: textLine(`"""`), ElideComma: true}) | ||||
| 		if isTripleQuoted { | ||||
| 			var out textNode = &textWrap{Prefix: "(", Value: list2, Suffix: ")"} | ||||
| 			switch t.Kind() { | ||||
| 			case reflect.String: | ||||
| 				if t != reflect.TypeOf(string("")) { | ||||
| 					out = opts.FormatType(t, out) | ||||
| 				} | ||||
| 			case reflect.Slice: | ||||
| 				// Always emit type for slices since the triple-quote syntax
 | ||||
| 				// looks like a string (not a slice).
 | ||||
| 				opts = opts.WithTypeMode(emitType) | ||||
| 				out = opts.FormatType(t, out) | ||||
| 			} | ||||
| 			return out | ||||
| 		} | ||||
| 
 | ||||
| 	// If the text appears to be single-lined text,
 | ||||
| 	// then perform differencing in approximately fixed-sized chunks.
 | ||||
| 	// The output is printed as quoted strings.
 | ||||
| 	case isMostlyText: | ||||
| 		list = opts.formatDiffSlice( | ||||
| 			reflect.ValueOf(sx), reflect.ValueOf(sy), 64, "byte", | ||||
| 			func(v reflect.Value, d diffMode) textRecord { | ||||
| 				s := formatString(v.String()) | ||||
| 				return textRecord{Diff: d, Value: textLine(s)} | ||||
| 			}, | ||||
| 		) | ||||
| 
 | ||||
| 	// If the text appears to be binary data,
 | ||||
| 	// then perform differencing in approximately fixed-sized chunks.
 | ||||
| 	// The output is inspired by hexdump.
 | ||||
| 	case isBinary: | ||||
| 		list = opts.formatDiffSlice( | ||||
| 			reflect.ValueOf(sx), reflect.ValueOf(sy), 16, "byte", | ||||
| 			func(v reflect.Value, d diffMode) textRecord { | ||||
| 				var ss []string | ||||
| 				for i := 0; i < v.Len(); i++ { | ||||
| 					ss = append(ss, formatHex(v.Index(i).Uint())) | ||||
| 				} | ||||
| 				s := strings.Join(ss, ", ") | ||||
| 				comment := commentString(fmt.Sprintf("%c|%v|", d, formatASCII(v.String()))) | ||||
| 				return textRecord{Diff: d, Value: textLine(s), Comment: comment} | ||||
| 			}, | ||||
| 		) | ||||
| 
 | ||||
| 	// For all other slices of primitive types,
 | ||||
| 	// then perform differencing in approximately fixed-sized chunks.
 | ||||
| 	// The size of each chunk depends on the width of the element kind.
 | ||||
| 	default: | ||||
| 		var chunkSize int | ||||
| 		if t.Elem().Kind() == reflect.Bool { | ||||
| 			chunkSize = 16 | ||||
| 		} else { | ||||
| 			switch t.Elem().Bits() { | ||||
| 			case 8: | ||||
| 				chunkSize = 16 | ||||
| 			case 16: | ||||
| 				chunkSize = 12 | ||||
| 			case 32: | ||||
| 				chunkSize = 8 | ||||
| 			default: | ||||
| 				chunkSize = 8 | ||||
| 			} | ||||
| 		} | ||||
| 		list = opts.formatDiffSlice( | ||||
| 			vx, vy, chunkSize, t.Elem().Kind().String(), | ||||
| 			func(v reflect.Value, d diffMode) textRecord { | ||||
| 				var ss []string | ||||
| 				for i := 0; i < v.Len(); i++ { | ||||
| 					switch t.Elem().Kind() { | ||||
| 					case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: | ||||
| 						ss = append(ss, fmt.Sprint(v.Index(i).Int())) | ||||
| 					case reflect.Uint, reflect.Uint16, reflect.Uint32, reflect.Uint64: | ||||
| 						ss = append(ss, fmt.Sprint(v.Index(i).Uint())) | ||||
| 					case reflect.Uint8, reflect.Uintptr: | ||||
| 						ss = append(ss, formatHex(v.Index(i).Uint())) | ||||
| 					case reflect.Bool, reflect.Float32, reflect.Float64, reflect.Complex64, reflect.Complex128: | ||||
| 						ss = append(ss, fmt.Sprint(v.Index(i).Interface())) | ||||
| 					} | ||||
| 				} | ||||
| 				s := strings.Join(ss, ", ") | ||||
| 				return textRecord{Diff: d, Value: textLine(s)} | ||||
| 			}, | ||||
| 		) | ||||
| 	} | ||||
| 
 | ||||
| 	// Wrap the output with appropriate type information.
 | ||||
| 	var out textNode = &textWrap{Prefix: "{", Value: list, Suffix: "}"} | ||||
| 	if !isMostlyText { | ||||
| 		// The "{...}" byte-sequence literal is not valid Go syntax for strings.
 | ||||
| 		// Emit the type for extra clarity (e.g. "string{...}").
 | ||||
| 		if t.Kind() == reflect.String { | ||||
| 			opts = opts.WithTypeMode(emitType) | ||||
| 		} | ||||
| 		return opts.FormatType(t, out) | ||||
| 	} | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.String: | ||||
| 		out = &textWrap{Prefix: "strings.Join(", Value: out, Suffix: fmt.Sprintf(", %q)", delim)} | ||||
| 		if t != reflect.TypeOf(string("")) { | ||||
| 			out = opts.FormatType(t, out) | ||||
| 		} | ||||
| 	case reflect.Slice: | ||||
| 		out = &textWrap{Prefix: "bytes.Join(", Value: out, Suffix: fmt.Sprintf(", %q)", delim)} | ||||
| 		if t != reflect.TypeOf([]byte(nil)) { | ||||
| 			out = opts.FormatType(t, out) | ||||
| 		} | ||||
| 	} | ||||
| 	return out | ||||
| } | ||||
| 
 | ||||
| // formatASCII formats s as an ASCII string.
 | ||||
| // This is useful for printing binary strings in a semi-legible way.
 | ||||
| func formatASCII(s string) string { | ||||
| 	b := bytes.Repeat([]byte{'.'}, len(s)) | ||||
| 	for i := 0; i < len(s); i++ { | ||||
| 		if ' ' <= s[i] && s[i] <= '~' { | ||||
| 			b[i] = s[i] | ||||
| 		} | ||||
| 	} | ||||
| 	return string(b) | ||||
| } | ||||
| 
 | ||||
| func (opts formatOptions) formatDiffSlice( | ||||
| 	vx, vy reflect.Value, chunkSize int, name string, | ||||
| 	makeRec func(reflect.Value, diffMode) textRecord, | ||||
| ) (list textList) { | ||||
| 	eq := func(ix, iy int) bool { | ||||
| 		return vx.Index(ix).Interface() == vy.Index(iy).Interface() | ||||
| 	} | ||||
| 	es := diff.Difference(vx.Len(), vy.Len(), func(ix, iy int) diff.Result { | ||||
| 		return diff.BoolResult(eq(ix, iy)) | ||||
| 	}) | ||||
| 
 | ||||
| 	appendChunks := func(v reflect.Value, d diffMode) int { | ||||
| 		n0 := v.Len() | ||||
| 		for v.Len() > 0 { | ||||
| 			n := chunkSize | ||||
| 			if n > v.Len() { | ||||
| 				n = v.Len() | ||||
| 			} | ||||
| 			list = append(list, makeRec(v.Slice(0, n), d)) | ||||
| 			v = v.Slice(n, v.Len()) | ||||
| 		} | ||||
| 		return n0 - v.Len() | ||||
| 	} | ||||
| 
 | ||||
| 	var numDiffs int | ||||
| 	maxLen := -1 | ||||
| 	if opts.LimitVerbosity { | ||||
| 		maxLen = (1 << opts.verbosity()) << 2 // 4, 8, 16, 32, 64, etc...
 | ||||
| 		opts.VerbosityLevel-- | ||||
| 	} | ||||
| 
 | ||||
| 	groups := coalesceAdjacentEdits(name, es) | ||||
| 	groups = coalesceInterveningIdentical(groups, chunkSize/4) | ||||
| 	groups = cleanupSurroundingIdentical(groups, eq) | ||||
| 	maxGroup := diffStats{Name: name} | ||||
| 	for i, ds := range groups { | ||||
| 		if maxLen >= 0 && numDiffs >= maxLen { | ||||
| 			maxGroup = maxGroup.Append(ds) | ||||
| 			continue | ||||
| 		} | ||||
| 
 | ||||
| 		// Print equal.
 | ||||
| 		if ds.NumDiff() == 0 { | ||||
| 			// Compute the number of leading and trailing equal bytes to print.
 | ||||
| 			var numLo, numHi int | ||||
| 			numEqual := ds.NumIgnored + ds.NumIdentical | ||||
| 			for numLo < chunkSize*numContextRecords && numLo+numHi < numEqual && i != 0 { | ||||
| 				numLo++ | ||||
| 			} | ||||
| 			for numHi < chunkSize*numContextRecords && numLo+numHi < numEqual && i != len(groups)-1 { | ||||
| 				numHi++ | ||||
| 			} | ||||
| 			if numEqual-(numLo+numHi) <= chunkSize && ds.NumIgnored == 0 { | ||||
| 				numHi = numEqual - numLo // Avoid pointless coalescing of single equal row
 | ||||
| 			} | ||||
| 
 | ||||
| 			// Print the equal bytes.
 | ||||
| 			appendChunks(vx.Slice(0, numLo), diffIdentical) | ||||
| 			if numEqual > numLo+numHi { | ||||
| 				ds.NumIdentical -= numLo + numHi | ||||
| 				list.AppendEllipsis(ds) | ||||
| 			} | ||||
| 			appendChunks(vx.Slice(numEqual-numHi, numEqual), diffIdentical) | ||||
| 			vx = vx.Slice(numEqual, vx.Len()) | ||||
| 			vy = vy.Slice(numEqual, vy.Len()) | ||||
| 			continue | ||||
| 		} | ||||
| 
 | ||||
| 		// Print unequal.
 | ||||
| 		len0 := len(list) | ||||
| 		nx := appendChunks(vx.Slice(0, ds.NumIdentical+ds.NumRemoved+ds.NumModified), diffRemoved) | ||||
| 		vx = vx.Slice(nx, vx.Len()) | ||||
| 		ny := appendChunks(vy.Slice(0, ds.NumIdentical+ds.NumInserted+ds.NumModified), diffInserted) | ||||
| 		vy = vy.Slice(ny, vy.Len()) | ||||
| 		numDiffs += len(list) - len0 | ||||
| 	} | ||||
| 	if maxGroup.IsZero() { | ||||
| 		assert(vx.Len() == 0 && vy.Len() == 0) | ||||
| 	} else { | ||||
| 		list.AppendEllipsis(maxGroup) | ||||
| 	} | ||||
| 	return list | ||||
| } | ||||
| 
 | ||||
| // coalesceAdjacentEdits coalesces the list of edits into groups of adjacent
 | ||||
| // equal or unequal counts.
 | ||||
| //
 | ||||
| // Example:
 | ||||
| //
 | ||||
| //	Input:  "..XXY...Y"
 | ||||
| //	Output: [
 | ||||
| //		{NumIdentical: 2},
 | ||||
| //		{NumRemoved: 2, NumInserted 1},
 | ||||
| //		{NumIdentical: 3},
 | ||||
| //		{NumInserted: 1},
 | ||||
| //	]
 | ||||
| //
 | ||||
| func coalesceAdjacentEdits(name string, es diff.EditScript) (groups []diffStats) { | ||||
| 	var prevMode byte | ||||
| 	lastStats := func(mode byte) *diffStats { | ||||
| 		if prevMode != mode { | ||||
| 			groups = append(groups, diffStats{Name: name}) | ||||
| 			prevMode = mode | ||||
| 		} | ||||
| 		return &groups[len(groups)-1] | ||||
| 	} | ||||
| 	for _, e := range es { | ||||
| 		switch e { | ||||
| 		case diff.Identity: | ||||
| 			lastStats('=').NumIdentical++ | ||||
| 		case diff.UniqueX: | ||||
| 			lastStats('!').NumRemoved++ | ||||
| 		case diff.UniqueY: | ||||
| 			lastStats('!').NumInserted++ | ||||
| 		case diff.Modified: | ||||
| 			lastStats('!').NumModified++ | ||||
| 		} | ||||
| 	} | ||||
| 	return groups | ||||
| } | ||||
| 
 | ||||
| // coalesceInterveningIdentical coalesces sufficiently short (<= windowSize)
 | ||||
| // equal groups into adjacent unequal groups that currently result in a
 | ||||
| // dual inserted/removed printout. This acts as a high-pass filter to smooth
 | ||||
| // out high-frequency changes within the windowSize.
 | ||||
| //
 | ||||
| // Example:
 | ||||
| //
 | ||||
| //	WindowSize: 16,
 | ||||
| //	Input: [
 | ||||
| //		{NumIdentical: 61},              // group 0
 | ||||
| //		{NumRemoved: 3, NumInserted: 1}, // group 1
 | ||||
| //		{NumIdentical: 6},               // ├── coalesce
 | ||||
| //		{NumInserted: 2},                // ├── coalesce
 | ||||
| //		{NumIdentical: 1},               // ├── coalesce
 | ||||
| //		{NumRemoved: 9},                 // └── coalesce
 | ||||
| //		{NumIdentical: 64},              // group 2
 | ||||
| //		{NumRemoved: 3, NumInserted: 1}, // group 3
 | ||||
| //		{NumIdentical: 6},               // ├── coalesce
 | ||||
| //		{NumInserted: 2},                // ├── coalesce
 | ||||
| //		{NumIdentical: 1},               // ├── coalesce
 | ||||
| //		{NumRemoved: 7},                 // ├── coalesce
 | ||||
| //		{NumIdentical: 1},               // ├── coalesce
 | ||||
| //		{NumRemoved: 2},                 // └── coalesce
 | ||||
| //		{NumIdentical: 63},              // group 4
 | ||||
| //	]
 | ||||
| //	Output: [
 | ||||
| //		{NumIdentical: 61},
 | ||||
| //		{NumIdentical: 7, NumRemoved: 12, NumInserted: 3},
 | ||||
| //		{NumIdentical: 64},
 | ||||
| //		{NumIdentical: 8, NumRemoved: 12, NumInserted: 3},
 | ||||
| //		{NumIdentical: 63},
 | ||||
| //	]
 | ||||
| //
 | ||||
| func coalesceInterveningIdentical(groups []diffStats, windowSize int) []diffStats { | ||||
| 	groups, groupsOrig := groups[:0], groups | ||||
| 	for i, ds := range groupsOrig { | ||||
| 		if len(groups) >= 2 && ds.NumDiff() > 0 { | ||||
| 			prev := &groups[len(groups)-2] // Unequal group
 | ||||
| 			curr := &groups[len(groups)-1] // Equal group
 | ||||
| 			next := &groupsOrig[i]         // Unequal group
 | ||||
| 			hadX, hadY := prev.NumRemoved > 0, prev.NumInserted > 0 | ||||
| 			hasX, hasY := next.NumRemoved > 0, next.NumInserted > 0 | ||||
| 			if ((hadX || hasX) && (hadY || hasY)) && curr.NumIdentical <= windowSize { | ||||
| 				*prev = prev.Append(*curr).Append(*next) | ||||
| 				groups = groups[:len(groups)-1] // Truncate off equal group
 | ||||
| 				continue | ||||
| 			} | ||||
| 		} | ||||
| 		groups = append(groups, ds) | ||||
| 	} | ||||
| 	return groups | ||||
| } | ||||
| 
 | ||||
| // cleanupSurroundingIdentical scans through all unequal groups, and
 | ||||
| // moves any leading sequence of equal elements to the preceding equal group and
 | ||||
| // moves and trailing sequence of equal elements to the succeeding equal group.
 | ||||
| //
 | ||||
| // This is necessary since coalesceInterveningIdentical may coalesce edit groups
 | ||||
| // together such that leading/trailing spans of equal elements becomes possible.
 | ||||
| // Note that this can occur even with an optimal diffing algorithm.
 | ||||
| //
 | ||||
| // Example:
 | ||||
| //
 | ||||
| //	Input: [
 | ||||
| //		{NumIdentical: 61},
 | ||||
| //		{NumIdentical: 1 , NumRemoved: 11, NumInserted: 2}, // assume 3 leading identical elements
 | ||||
| //		{NumIdentical: 67},
 | ||||
| //		{NumIdentical: 7, NumRemoved: 12, NumInserted: 3},  // assume 10 trailing identical elements
 | ||||
| //		{NumIdentical: 54},
 | ||||
| //	]
 | ||||
| //	Output: [
 | ||||
| //		{NumIdentical: 64}, // incremented by 3
 | ||||
| //		{NumRemoved: 9},
 | ||||
| //		{NumIdentical: 67},
 | ||||
| //		{NumRemoved: 9},
 | ||||
| //		{NumIdentical: 64}, // incremented by 10
 | ||||
| //	]
 | ||||
| //
 | ||||
| func cleanupSurroundingIdentical(groups []diffStats, eq func(i, j int) bool) []diffStats { | ||||
| 	var ix, iy int // indexes into sequence x and y
 | ||||
| 	for i, ds := range groups { | ||||
| 		// Handle equal group.
 | ||||
| 		if ds.NumDiff() == 0 { | ||||
| 			ix += ds.NumIdentical | ||||
| 			iy += ds.NumIdentical | ||||
| 			continue | ||||
| 		} | ||||
| 
 | ||||
| 		// Handle unequal group.
 | ||||
| 		nx := ds.NumIdentical + ds.NumRemoved + ds.NumModified | ||||
| 		ny := ds.NumIdentical + ds.NumInserted + ds.NumModified | ||||
| 		var numLeadingIdentical, numTrailingIdentical int | ||||
| 		for j := 0; j < nx && j < ny && eq(ix+j, iy+j); j++ { | ||||
| 			numLeadingIdentical++ | ||||
| 		} | ||||
| 		for j := 0; j < nx && j < ny && eq(ix+nx-1-j, iy+ny-1-j); j++ { | ||||
| 			numTrailingIdentical++ | ||||
| 		} | ||||
| 		if numIdentical := numLeadingIdentical + numTrailingIdentical; numIdentical > 0 { | ||||
| 			if numLeadingIdentical > 0 { | ||||
| 				// Remove leading identical span from this group and
 | ||||
| 				// insert it into the preceding group.
 | ||||
| 				if i-1 >= 0 { | ||||
| 					groups[i-1].NumIdentical += numLeadingIdentical | ||||
| 				} else { | ||||
| 					// No preceding group exists, so prepend a new group,
 | ||||
| 					// but do so after we finish iterating over all groups.
 | ||||
| 					defer func() { | ||||
| 						groups = append([]diffStats{{Name: groups[0].Name, NumIdentical: numLeadingIdentical}}, groups...) | ||||
| 					}() | ||||
| 				} | ||||
| 				// Increment indexes since the preceding group would have handled this.
 | ||||
| 				ix += numLeadingIdentical | ||||
| 				iy += numLeadingIdentical | ||||
| 			} | ||||
| 			if numTrailingIdentical > 0 { | ||||
| 				// Remove trailing identical span from this group and
 | ||||
| 				// insert it into the succeeding group.
 | ||||
| 				if i+1 < len(groups) { | ||||
| 					groups[i+1].NumIdentical += numTrailingIdentical | ||||
| 				} else { | ||||
| 					// No succeeding group exists, so append a new group,
 | ||||
| 					// but do so after we finish iterating over all groups.
 | ||||
| 					defer func() { | ||||
| 						groups = append(groups, diffStats{Name: groups[len(groups)-1].Name, NumIdentical: numTrailingIdentical}) | ||||
| 					}() | ||||
| 				} | ||||
| 				// Do not increment indexes since the succeeding group will handle this.
 | ||||
| 			} | ||||
| 
 | ||||
| 			// Update this group since some identical elements were removed.
 | ||||
| 			nx -= numIdentical | ||||
| 			ny -= numIdentical | ||||
| 			groups[i] = diffStats{Name: ds.Name, NumRemoved: nx, NumInserted: ny} | ||||
| 		} | ||||
| 		ix += nx | ||||
| 		iy += ny | ||||
| 	} | ||||
| 	return groups | ||||
| } | ||||
|  | @ -0,0 +1,431 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import ( | ||||
| 	"bytes" | ||||
| 	"fmt" | ||||
| 	"math/rand" | ||||
| 	"strings" | ||||
| 	"time" | ||||
| 	"unicode/utf8" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp/internal/flags" | ||||
| ) | ||||
| 
 | ||||
| var randBool = rand.New(rand.NewSource(time.Now().Unix())).Intn(2) == 0 | ||||
| 
 | ||||
| const maxColumnLength = 80 | ||||
| 
 | ||||
| type indentMode int | ||||
| 
 | ||||
| func (n indentMode) appendIndent(b []byte, d diffMode) []byte { | ||||
| 	// The output of Diff is documented as being unstable to provide future
 | ||||
| 	// flexibility in changing the output for more humanly readable reports.
 | ||||
| 	// This logic intentionally introduces instability to the exact output
 | ||||
| 	// so that users can detect accidental reliance on stability early on,
 | ||||
| 	// rather than much later when an actual change to the format occurs.
 | ||||
| 	if flags.Deterministic || randBool { | ||||
| 		// Use regular spaces (U+0020).
 | ||||
| 		switch d { | ||||
| 		case diffUnknown, diffIdentical: | ||||
| 			b = append(b, "  "...) | ||||
| 		case diffRemoved: | ||||
| 			b = append(b, "- "...) | ||||
| 		case diffInserted: | ||||
| 			b = append(b, "+ "...) | ||||
| 		} | ||||
| 	} else { | ||||
| 		// Use non-breaking spaces (U+00a0).
 | ||||
| 		switch d { | ||||
| 		case diffUnknown, diffIdentical: | ||||
| 			b = append(b, "  "...) | ||||
| 		case diffRemoved: | ||||
| 			b = append(b, "- "...) | ||||
| 		case diffInserted: | ||||
| 			b = append(b, "+ "...) | ||||
| 		} | ||||
| 	} | ||||
| 	return repeatCount(n).appendChar(b, '\t') | ||||
| } | ||||
| 
 | ||||
| type repeatCount int | ||||
| 
 | ||||
| func (n repeatCount) appendChar(b []byte, c byte) []byte { | ||||
| 	for ; n > 0; n-- { | ||||
| 		b = append(b, c) | ||||
| 	} | ||||
| 	return b | ||||
| } | ||||
| 
 | ||||
| // textNode is a simplified tree-based representation of structured text.
 | ||||
| // Possible node types are textWrap, textList, or textLine.
 | ||||
| type textNode interface { | ||||
| 	// Len reports the length in bytes of a single-line version of the tree.
 | ||||
| 	// Nested textRecord.Diff and textRecord.Comment fields are ignored.
 | ||||
| 	Len() int | ||||
| 	// Equal reports whether the two trees are structurally identical.
 | ||||
| 	// Nested textRecord.Diff and textRecord.Comment fields are compared.
 | ||||
| 	Equal(textNode) bool | ||||
| 	// String returns the string representation of the text tree.
 | ||||
| 	// It is not guaranteed that len(x.String()) == x.Len(),
 | ||||
| 	// nor that x.String() == y.String() implies that x.Equal(y).
 | ||||
| 	String() string | ||||
| 
 | ||||
| 	// formatCompactTo formats the contents of the tree as a single-line string
 | ||||
| 	// to the provided buffer. Any nested textRecord.Diff and textRecord.Comment
 | ||||
| 	// fields are ignored.
 | ||||
| 	//
 | ||||
| 	// However, not all nodes in the tree should be collapsed as a single-line.
 | ||||
| 	// If a node can be collapsed as a single-line, it is replaced by a textLine
 | ||||
| 	// node. Since the top-level node cannot replace itself, this also returns
 | ||||
| 	// the current node itself.
 | ||||
| 	//
 | ||||
| 	// This does not mutate the receiver.
 | ||||
| 	formatCompactTo([]byte, diffMode) ([]byte, textNode) | ||||
| 	// formatExpandedTo formats the contents of the tree as a multi-line string
 | ||||
| 	// to the provided buffer. In order for column alignment to operate well,
 | ||||
| 	// formatCompactTo must be called before calling formatExpandedTo.
 | ||||
| 	formatExpandedTo([]byte, diffMode, indentMode) []byte | ||||
| } | ||||
| 
 | ||||
| // textWrap is a wrapper that concatenates a prefix and/or a suffix
 | ||||
| // to the underlying node.
 | ||||
| type textWrap struct { | ||||
| 	Prefix   string      // e.g., "bytes.Buffer{"
 | ||||
| 	Value    textNode    // textWrap | textList | textLine
 | ||||
| 	Suffix   string      // e.g., "}"
 | ||||
| 	Metadata interface{} // arbitrary metadata; has no effect on formatting
 | ||||
| } | ||||
| 
 | ||||
| func (s *textWrap) Len() int { | ||||
| 	return len(s.Prefix) + s.Value.Len() + len(s.Suffix) | ||||
| } | ||||
| func (s1 *textWrap) Equal(s2 textNode) bool { | ||||
| 	if s2, ok := s2.(*textWrap); ok { | ||||
| 		return s1.Prefix == s2.Prefix && s1.Value.Equal(s2.Value) && s1.Suffix == s2.Suffix | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
| func (s *textWrap) String() string { | ||||
| 	var d diffMode | ||||
| 	var n indentMode | ||||
| 	_, s2 := s.formatCompactTo(nil, d) | ||||
| 	b := n.appendIndent(nil, d)      // Leading indent
 | ||||
| 	b = s2.formatExpandedTo(b, d, n) // Main body
 | ||||
| 	b = append(b, '\n')              // Trailing newline
 | ||||
| 	return string(b) | ||||
| } | ||||
| func (s *textWrap) formatCompactTo(b []byte, d diffMode) ([]byte, textNode) { | ||||
| 	n0 := len(b) // Original buffer length
 | ||||
| 	b = append(b, s.Prefix...) | ||||
| 	b, s.Value = s.Value.formatCompactTo(b, d) | ||||
| 	b = append(b, s.Suffix...) | ||||
| 	if _, ok := s.Value.(textLine); ok { | ||||
| 		return b, textLine(b[n0:]) | ||||
| 	} | ||||
| 	return b, s | ||||
| } | ||||
| func (s *textWrap) formatExpandedTo(b []byte, d diffMode, n indentMode) []byte { | ||||
| 	b = append(b, s.Prefix...) | ||||
| 	b = s.Value.formatExpandedTo(b, d, n) | ||||
| 	b = append(b, s.Suffix...) | ||||
| 	return b | ||||
| } | ||||
| 
 | ||||
| // textList is a comma-separated list of textWrap or textLine nodes.
 | ||||
| // The list may be formatted as multi-lines or single-line at the discretion
 | ||||
| // of the textList.formatCompactTo method.
 | ||||
| type textList []textRecord | ||||
| type textRecord struct { | ||||
| 	Diff       diffMode     // e.g., 0 or '-' or '+'
 | ||||
| 	Key        string       // e.g., "MyField"
 | ||||
| 	Value      textNode     // textWrap | textLine
 | ||||
| 	ElideComma bool         // avoid trailing comma
 | ||||
| 	Comment    fmt.Stringer // e.g., "6 identical fields"
 | ||||
| } | ||||
| 
 | ||||
| // AppendEllipsis appends a new ellipsis node to the list if none already
 | ||||
| // exists at the end. If cs is non-zero it coalesces the statistics with the
 | ||||
| // previous diffStats.
 | ||||
| func (s *textList) AppendEllipsis(ds diffStats) { | ||||
| 	hasStats := !ds.IsZero() | ||||
| 	if len(*s) == 0 || !(*s)[len(*s)-1].Value.Equal(textEllipsis) { | ||||
| 		if hasStats { | ||||
| 			*s = append(*s, textRecord{Value: textEllipsis, ElideComma: true, Comment: ds}) | ||||
| 		} else { | ||||
| 			*s = append(*s, textRecord{Value: textEllipsis, ElideComma: true}) | ||||
| 		} | ||||
| 		return | ||||
| 	} | ||||
| 	if hasStats { | ||||
| 		(*s)[len(*s)-1].Comment = (*s)[len(*s)-1].Comment.(diffStats).Append(ds) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func (s textList) Len() (n int) { | ||||
| 	for i, r := range s { | ||||
| 		n += len(r.Key) | ||||
| 		if r.Key != "" { | ||||
| 			n += len(": ") | ||||
| 		} | ||||
| 		n += r.Value.Len() | ||||
| 		if i < len(s)-1 { | ||||
| 			n += len(", ") | ||||
| 		} | ||||
| 	} | ||||
| 	return n | ||||
| } | ||||
| 
 | ||||
| func (s1 textList) Equal(s2 textNode) bool { | ||||
| 	if s2, ok := s2.(textList); ok { | ||||
| 		if len(s1) != len(s2) { | ||||
| 			return false | ||||
| 		} | ||||
| 		for i := range s1 { | ||||
| 			r1, r2 := s1[i], s2[i] | ||||
| 			if !(r1.Diff == r2.Diff && r1.Key == r2.Key && r1.Value.Equal(r2.Value) && r1.Comment == r2.Comment) { | ||||
| 				return false | ||||
| 			} | ||||
| 		} | ||||
| 		return true | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
| 
 | ||||
| func (s textList) String() string { | ||||
| 	return (&textWrap{Prefix: "{", Value: s, Suffix: "}"}).String() | ||||
| } | ||||
| 
 | ||||
| func (s textList) formatCompactTo(b []byte, d diffMode) ([]byte, textNode) { | ||||
| 	s = append(textList(nil), s...) // Avoid mutating original
 | ||||
| 
 | ||||
| 	// Determine whether we can collapse this list as a single line.
 | ||||
| 	n0 := len(b) // Original buffer length
 | ||||
| 	var multiLine bool | ||||
| 	for i, r := range s { | ||||
| 		if r.Diff == diffInserted || r.Diff == diffRemoved { | ||||
| 			multiLine = true | ||||
| 		} | ||||
| 		b = append(b, r.Key...) | ||||
| 		if r.Key != "" { | ||||
| 			b = append(b, ": "...) | ||||
| 		} | ||||
| 		b, s[i].Value = r.Value.formatCompactTo(b, d|r.Diff) | ||||
| 		if _, ok := s[i].Value.(textLine); !ok { | ||||
| 			multiLine = true | ||||
| 		} | ||||
| 		if r.Comment != nil { | ||||
| 			multiLine = true | ||||
| 		} | ||||
| 		if i < len(s)-1 { | ||||
| 			b = append(b, ", "...) | ||||
| 		} | ||||
| 	} | ||||
| 	// Force multi-lined output when printing a removed/inserted node that
 | ||||
| 	// is sufficiently long.
 | ||||
| 	if (d == diffInserted || d == diffRemoved) && len(b[n0:]) > maxColumnLength { | ||||
| 		multiLine = true | ||||
| 	} | ||||
| 	if !multiLine { | ||||
| 		return b, textLine(b[n0:]) | ||||
| 	} | ||||
| 	return b, s | ||||
| } | ||||
| 
 | ||||
| func (s textList) formatExpandedTo(b []byte, d diffMode, n indentMode) []byte { | ||||
| 	alignKeyLens := s.alignLens( | ||||
| 		func(r textRecord) bool { | ||||
| 			_, isLine := r.Value.(textLine) | ||||
| 			return r.Key == "" || !isLine | ||||
| 		}, | ||||
| 		func(r textRecord) int { return utf8.RuneCountInString(r.Key) }, | ||||
| 	) | ||||
| 	alignValueLens := s.alignLens( | ||||
| 		func(r textRecord) bool { | ||||
| 			_, isLine := r.Value.(textLine) | ||||
| 			return !isLine || r.Value.Equal(textEllipsis) || r.Comment == nil | ||||
| 		}, | ||||
| 		func(r textRecord) int { return utf8.RuneCount(r.Value.(textLine)) }, | ||||
| 	) | ||||
| 
 | ||||
| 	// Format lists of simple lists in a batched form.
 | ||||
| 	// If the list is sequence of only textLine values,
 | ||||
| 	// then batch multiple values on a single line.
 | ||||
| 	var isSimple bool | ||||
| 	for _, r := range s { | ||||
| 		_, isLine := r.Value.(textLine) | ||||
| 		isSimple = r.Diff == 0 && r.Key == "" && isLine && r.Comment == nil | ||||
| 		if !isSimple { | ||||
| 			break | ||||
| 		} | ||||
| 	} | ||||
| 	if isSimple { | ||||
| 		n++ | ||||
| 		var batch []byte | ||||
| 		emitBatch := func() { | ||||
| 			if len(batch) > 0 { | ||||
| 				b = n.appendIndent(append(b, '\n'), d) | ||||
| 				b = append(b, bytes.TrimRight(batch, " ")...) | ||||
| 				batch = batch[:0] | ||||
| 			} | ||||
| 		} | ||||
| 		for _, r := range s { | ||||
| 			line := r.Value.(textLine) | ||||
| 			if len(batch)+len(line)+len(", ") > maxColumnLength { | ||||
| 				emitBatch() | ||||
| 			} | ||||
| 			batch = append(batch, line...) | ||||
| 			batch = append(batch, ", "...) | ||||
| 		} | ||||
| 		emitBatch() | ||||
| 		n-- | ||||
| 		return n.appendIndent(append(b, '\n'), d) | ||||
| 	} | ||||
| 
 | ||||
| 	// Format the list as a multi-lined output.
 | ||||
| 	n++ | ||||
| 	for i, r := range s { | ||||
| 		b = n.appendIndent(append(b, '\n'), d|r.Diff) | ||||
| 		if r.Key != "" { | ||||
| 			b = append(b, r.Key+": "...) | ||||
| 		} | ||||
| 		b = alignKeyLens[i].appendChar(b, ' ') | ||||
| 
 | ||||
| 		b = r.Value.formatExpandedTo(b, d|r.Diff, n) | ||||
| 		if !r.ElideComma { | ||||
| 			b = append(b, ',') | ||||
| 		} | ||||
| 		b = alignValueLens[i].appendChar(b, ' ') | ||||
| 
 | ||||
| 		if r.Comment != nil { | ||||
| 			b = append(b, " // "+r.Comment.String()...) | ||||
| 		} | ||||
| 	} | ||||
| 	n-- | ||||
| 
 | ||||
| 	return n.appendIndent(append(b, '\n'), d) | ||||
| } | ||||
| 
 | ||||
| func (s textList) alignLens( | ||||
| 	skipFunc func(textRecord) bool, | ||||
| 	lenFunc func(textRecord) int, | ||||
| ) []repeatCount { | ||||
| 	var startIdx, endIdx, maxLen int | ||||
| 	lens := make([]repeatCount, len(s)) | ||||
| 	for i, r := range s { | ||||
| 		if skipFunc(r) { | ||||
| 			for j := startIdx; j < endIdx && j < len(s); j++ { | ||||
| 				lens[j] = repeatCount(maxLen - lenFunc(s[j])) | ||||
| 			} | ||||
| 			startIdx, endIdx, maxLen = i+1, i+1, 0 | ||||
| 		} else { | ||||
| 			if maxLen < lenFunc(r) { | ||||
| 				maxLen = lenFunc(r) | ||||
| 			} | ||||
| 			endIdx = i + 1 | ||||
| 		} | ||||
| 	} | ||||
| 	for j := startIdx; j < endIdx && j < len(s); j++ { | ||||
| 		lens[j] = repeatCount(maxLen - lenFunc(s[j])) | ||||
| 	} | ||||
| 	return lens | ||||
| } | ||||
| 
 | ||||
| // textLine is a single-line segment of text and is always a leaf node
 | ||||
| // in the textNode tree.
 | ||||
| type textLine []byte | ||||
| 
 | ||||
| var ( | ||||
| 	textNil      = textLine("nil") | ||||
| 	textEllipsis = textLine("...") | ||||
| ) | ||||
| 
 | ||||
| func (s textLine) Len() int { | ||||
| 	return len(s) | ||||
| } | ||||
| func (s1 textLine) Equal(s2 textNode) bool { | ||||
| 	if s2, ok := s2.(textLine); ok { | ||||
| 		return bytes.Equal([]byte(s1), []byte(s2)) | ||||
| 	} | ||||
| 	return false | ||||
| } | ||||
| func (s textLine) String() string { | ||||
| 	return string(s) | ||||
| } | ||||
| func (s textLine) formatCompactTo(b []byte, d diffMode) ([]byte, textNode) { | ||||
| 	return append(b, s...), s | ||||
| } | ||||
| func (s textLine) formatExpandedTo(b []byte, _ diffMode, _ indentMode) []byte { | ||||
| 	return append(b, s...) | ||||
| } | ||||
| 
 | ||||
| type diffStats struct { | ||||
| 	Name         string | ||||
| 	NumIgnored   int | ||||
| 	NumIdentical int | ||||
| 	NumRemoved   int | ||||
| 	NumInserted  int | ||||
| 	NumModified  int | ||||
| } | ||||
| 
 | ||||
| func (s diffStats) IsZero() bool { | ||||
| 	s.Name = "" | ||||
| 	return s == diffStats{} | ||||
| } | ||||
| 
 | ||||
| func (s diffStats) NumDiff() int { | ||||
| 	return s.NumRemoved + s.NumInserted + s.NumModified | ||||
| } | ||||
| 
 | ||||
| func (s diffStats) Append(ds diffStats) diffStats { | ||||
| 	assert(s.Name == ds.Name) | ||||
| 	s.NumIgnored += ds.NumIgnored | ||||
| 	s.NumIdentical += ds.NumIdentical | ||||
| 	s.NumRemoved += ds.NumRemoved | ||||
| 	s.NumInserted += ds.NumInserted | ||||
| 	s.NumModified += ds.NumModified | ||||
| 	return s | ||||
| } | ||||
| 
 | ||||
| // String prints a humanly-readable summary of coalesced records.
 | ||||
| //
 | ||||
| // Example:
 | ||||
| //	diffStats{Name: "Field", NumIgnored: 5}.String() => "5 ignored fields"
 | ||||
| func (s diffStats) String() string { | ||||
| 	var ss []string | ||||
| 	var sum int | ||||
| 	labels := [...]string{"ignored", "identical", "removed", "inserted", "modified"} | ||||
| 	counts := [...]int{s.NumIgnored, s.NumIdentical, s.NumRemoved, s.NumInserted, s.NumModified} | ||||
| 	for i, n := range counts { | ||||
| 		if n > 0 { | ||||
| 			ss = append(ss, fmt.Sprintf("%d %v", n, labels[i])) | ||||
| 		} | ||||
| 		sum += n | ||||
| 	} | ||||
| 
 | ||||
| 	// Pluralize the name (adjusting for some obscure English grammar rules).
 | ||||
| 	name := s.Name | ||||
| 	if sum > 1 { | ||||
| 		name += "s" | ||||
| 		if strings.HasSuffix(name, "ys") { | ||||
| 			name = name[:len(name)-2] + "ies" // e.g., "entrys" => "entries"
 | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	// Format the list according to English grammar (with Oxford comma).
 | ||||
| 	switch n := len(ss); n { | ||||
| 	case 0: | ||||
| 		return "" | ||||
| 	case 1, 2: | ||||
| 		return strings.Join(ss, " and ") + " " + name | ||||
| 	default: | ||||
| 		return strings.Join(ss[:n-1], ", ") + ", and " + ss[n-1] + " " + name | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| type commentString string | ||||
| 
 | ||||
| func (s commentString) String() string { return string(s) } | ||||
|  | @ -0,0 +1,121 @@ | |||
| // Copyright 2019, The Go Authors. All rights reserved.
 | ||||
| // Use of this source code is governed by a BSD-style
 | ||||
| // license that can be found in the LICENSE file.
 | ||||
| 
 | ||||
| package cmp | ||||
| 
 | ||||
| import "reflect" | ||||
| 
 | ||||
| // valueNode represents a single node within a report, which is a
 | ||||
| // structured representation of the value tree, containing information
 | ||||
| // regarding which nodes are equal or not.
 | ||||
| type valueNode struct { | ||||
| 	parent *valueNode | ||||
| 
 | ||||
| 	Type   reflect.Type | ||||
| 	ValueX reflect.Value | ||||
| 	ValueY reflect.Value | ||||
| 
 | ||||
| 	// NumSame is the number of leaf nodes that are equal.
 | ||||
| 	// All descendants are equal only if NumDiff is 0.
 | ||||
| 	NumSame int | ||||
| 	// NumDiff is the number of leaf nodes that are not equal.
 | ||||
| 	NumDiff int | ||||
| 	// NumIgnored is the number of leaf nodes that are ignored.
 | ||||
| 	NumIgnored int | ||||
| 	// NumCompared is the number of leaf nodes that were compared
 | ||||
| 	// using an Equal method or Comparer function.
 | ||||
| 	NumCompared int | ||||
| 	// NumTransformed is the number of non-leaf nodes that were transformed.
 | ||||
| 	NumTransformed int | ||||
| 	// NumChildren is the number of transitive descendants of this node.
 | ||||
| 	// This counts from zero; thus, leaf nodes have no descendants.
 | ||||
| 	NumChildren int | ||||
| 	// MaxDepth is the maximum depth of the tree. This counts from zero;
 | ||||
| 	// thus, leaf nodes have a depth of zero.
 | ||||
| 	MaxDepth int | ||||
| 
 | ||||
| 	// Records is a list of struct fields, slice elements, or map entries.
 | ||||
| 	Records []reportRecord // If populated, implies Value is not populated
 | ||||
| 
 | ||||
| 	// Value is the result of a transformation, pointer indirect, of
 | ||||
| 	// type assertion.
 | ||||
| 	Value *valueNode // If populated, implies Records is not populated
 | ||||
| 
 | ||||
| 	// TransformerName is the name of the transformer.
 | ||||
| 	TransformerName string // If non-empty, implies Value is populated
 | ||||
| } | ||||
| type reportRecord struct { | ||||
| 	Key   reflect.Value // Invalid for slice element
 | ||||
| 	Value *valueNode | ||||
| } | ||||
| 
 | ||||
| func (parent *valueNode) PushStep(ps PathStep) (child *valueNode) { | ||||
| 	vx, vy := ps.Values() | ||||
| 	child = &valueNode{parent: parent, Type: ps.Type(), ValueX: vx, ValueY: vy} | ||||
| 	switch s := ps.(type) { | ||||
| 	case StructField: | ||||
| 		assert(parent.Value == nil) | ||||
| 		parent.Records = append(parent.Records, reportRecord{Key: reflect.ValueOf(s.Name()), Value: child}) | ||||
| 	case SliceIndex: | ||||
| 		assert(parent.Value == nil) | ||||
| 		parent.Records = append(parent.Records, reportRecord{Value: child}) | ||||
| 	case MapIndex: | ||||
| 		assert(parent.Value == nil) | ||||
| 		parent.Records = append(parent.Records, reportRecord{Key: s.Key(), Value: child}) | ||||
| 	case Indirect: | ||||
| 		assert(parent.Value == nil && parent.Records == nil) | ||||
| 		parent.Value = child | ||||
| 	case TypeAssertion: | ||||
| 		assert(parent.Value == nil && parent.Records == nil) | ||||
| 		parent.Value = child | ||||
| 	case Transform: | ||||
| 		assert(parent.Value == nil && parent.Records == nil) | ||||
| 		parent.Value = child | ||||
| 		parent.TransformerName = s.Name() | ||||
| 		parent.NumTransformed++ | ||||
| 	default: | ||||
| 		assert(parent == nil) // Must be the root step
 | ||||
| 	} | ||||
| 	return child | ||||
| } | ||||
| 
 | ||||
| func (r *valueNode) Report(rs Result) { | ||||
| 	assert(r.MaxDepth == 0) // May only be called on leaf nodes
 | ||||
| 
 | ||||
| 	if rs.ByIgnore() { | ||||
| 		r.NumIgnored++ | ||||
| 	} else { | ||||
| 		if rs.Equal() { | ||||
| 			r.NumSame++ | ||||
| 		} else { | ||||
| 			r.NumDiff++ | ||||
| 		} | ||||
| 	} | ||||
| 	assert(r.NumSame+r.NumDiff+r.NumIgnored == 1) | ||||
| 
 | ||||
| 	if rs.ByMethod() { | ||||
| 		r.NumCompared++ | ||||
| 	} | ||||
| 	if rs.ByFunc() { | ||||
| 		r.NumCompared++ | ||||
| 	} | ||||
| 	assert(r.NumCompared <= 1) | ||||
| } | ||||
| 
 | ||||
| func (child *valueNode) PopStep() (parent *valueNode) { | ||||
| 	if child.parent == nil { | ||||
| 		return nil | ||||
| 	} | ||||
| 	parent = child.parent | ||||
| 	parent.NumSame += child.NumSame | ||||
| 	parent.NumDiff += child.NumDiff | ||||
| 	parent.NumIgnored += child.NumIgnored | ||||
| 	parent.NumCompared += child.NumCompared | ||||
| 	parent.NumTransformed += child.NumTransformed | ||||
| 	parent.NumChildren += child.NumChildren + 1 | ||||
| 	if parent.MaxDepth < child.MaxDepth+1 { | ||||
| 		parent.MaxDepth = child.MaxDepth + 1 | ||||
| 	} | ||||
| 	return parent | ||||
| } | ||||
|  | @ -17,6 +17,16 @@ This package provides various compression algorithms. | |||
| 
 | ||||
| # changelog | ||||
| 
 | ||||
| * July 13, 2022 (v1.15.8) | ||||
| 
 | ||||
| 	* gzip: fix stack exhaustion bug in Reader.Read https://github.com/klauspost/compress/pull/641 | ||||
| 	* s2: Add Index header trim/restore https://github.com/klauspost/compress/pull/638 | ||||
| 	* zstd: Optimize seqdeq amd64 asm by @greatroar in https://github.com/klauspost/compress/pull/636 | ||||
| 	* zstd: Improve decoder memcopy https://github.com/klauspost/compress/pull/637 | ||||
| 	* huff0: Pass a single bitReader pointer to asm by @greatroar in https://github.com/klauspost/compress/pull/634 | ||||
| 	* zstd: Branchless getBits for amd64 w/o BMI2 by @greatroar in https://github.com/klauspost/compress/pull/640 | ||||
| 	* gzhttp: Remove header before writing https://github.com/klauspost/compress/pull/639 | ||||
| 
 | ||||
| * June 29, 2022 (v1.15.7) | ||||
| 
 | ||||
| 	* s2: Fix absolute forward seeks  https://github.com/klauspost/compress/pull/633 | ||||
|  |  | |||
|  | @ -23,7 +23,7 @@ type byteBuffer interface { | |||
| 	readByte() (byte, error) | ||||
| 
 | ||||
| 	// Skip n bytes.
 | ||||
| 	skipN(n int) error | ||||
| 	skipN(n int64) error | ||||
| } | ||||
| 
 | ||||
| // in-memory buffer
 | ||||
|  | @ -62,9 +62,12 @@ func (b *byteBuf) readByte() (byte, error) { | |||
| 	return r, nil | ||||
| } | ||||
| 
 | ||||
| func (b *byteBuf) skipN(n int) error { | ||||
| func (b *byteBuf) skipN(n int64) error { | ||||
| 	bb := *b | ||||
| 	if len(bb) < n { | ||||
| 	if n < 0 { | ||||
| 		return fmt.Errorf("negative skip (%d) requested", n) | ||||
| 	} | ||||
| 	if int64(len(bb)) < n { | ||||
| 		return io.ErrUnexpectedEOF | ||||
| 	} | ||||
| 	*b = bb[n:] | ||||
|  | @ -120,9 +123,9 @@ func (r *readerWrapper) readByte() (byte, error) { | |||
| 	return r.tmp[0], nil | ||||
| } | ||||
| 
 | ||||
| func (r *readerWrapper) skipN(n int) error { | ||||
| 	n2, err := io.CopyN(ioutil.Discard, r.r, int64(n)) | ||||
| 	if n2 != int64(n) { | ||||
| func (r *readerWrapper) skipN(n int64) error { | ||||
| 	n2, err := io.CopyN(ioutil.Discard, r.r, n) | ||||
| 	if n2 != n { | ||||
| 		err = io.ErrUnexpectedEOF | ||||
| 	} | ||||
| 	return err | ||||
|  |  | |||
|  | @ -348,6 +348,9 @@ func (d *Decoder) DecodeAll(input, dst []byte) ([]byte, error) { | |||
| 			frame.history.setDict(&dict) | ||||
| 		} | ||||
| 		if frame.WindowSize > d.o.maxWindowSize { | ||||
| 			if debugDecoder { | ||||
| 				println("window size exceeded:", frame.WindowSize, ">", d.o.maxWindowSize) | ||||
| 			} | ||||
| 			return dst, ErrWindowSizeExceeded | ||||
| 		} | ||||
| 		if frame.FrameContentSize != fcsUnknown { | ||||
|  |  | |||
|  | @ -528,8 +528,8 @@ func (e *Encoder) EncodeAll(src, dst []byte) []byte { | |||
| 		// If a non-single block is needed the encoder will reset again.
 | ||||
| 		e.encoders <- enc | ||||
| 	}() | ||||
| 	// Use single segments when above minimum window and below 1MB.
 | ||||
| 	single := len(src) < 1<<20 && len(src) > MinWindowSize | ||||
| 	// Use single segments when above minimum window and below window size.
 | ||||
| 	single := len(src) <= e.o.windowSize && len(src) > MinWindowSize | ||||
| 	if e.o.single != nil { | ||||
| 		single = *e.o.single | ||||
| 	} | ||||
|  |  | |||
|  | @ -283,7 +283,7 @@ func WithNoEntropyCompression(b bool) EOption { | |||
| // a decoder is allowed to reject a compressed frame which requests a memory size beyond decoder's authorized range.
 | ||||
| // For broader compatibility, decoders are recommended to support memory sizes of at least 8 MB.
 | ||||
| // This is only a recommendation, each decoder is free to support higher or lower limits, depending on local limitations.
 | ||||
| // If this is not specified, block encodes will automatically choose this based on the input size.
 | ||||
| // If this is not specified, block encodes will automatically choose this based on the input size and the window size.
 | ||||
| // This setting has no effect on streamed encodes.
 | ||||
| func WithSingleSegment(b bool) EOption { | ||||
| 	return func(o *encoderOptions) error { | ||||
|  |  | |||
|  | @ -106,7 +106,7 @@ func (d *frameDec) reset(br byteBuffer) error { | |||
| 		} | ||||
| 		n := uint32(b[0]) | (uint32(b[1]) << 8) | (uint32(b[2]) << 16) | (uint32(b[3]) << 24) | ||||
| 		println("Skipping frame with", n, "bytes.") | ||||
| 		err = br.skipN(int(n)) | ||||
| 		err = br.skipN(int64(n)) | ||||
| 		if err != nil { | ||||
| 			if debugDecoder { | ||||
| 				println("Reading discarded frame", err) | ||||
|  | @ -231,20 +231,27 @@ func (d *frameDec) reset(br byteBuffer) error { | |||
| 		d.crc.Reset() | ||||
| 	} | ||||
| 
 | ||||
| 	if d.WindowSize > d.o.maxWindowSize { | ||||
| 		if debugDecoder { | ||||
| 			printf("window size %d > max %d\n", d.WindowSize, d.o.maxWindowSize) | ||||
| 		} | ||||
| 		return ErrWindowSizeExceeded | ||||
| 	} | ||||
| 
 | ||||
| 	if d.WindowSize == 0 && d.SingleSegment { | ||||
| 		// We may not need window in this case.
 | ||||
| 		d.WindowSize = d.FrameContentSize | ||||
| 		if d.WindowSize < MinWindowSize { | ||||
| 			d.WindowSize = MinWindowSize | ||||
| 		} | ||||
| 		if d.WindowSize > d.o.maxDecodedSize { | ||||
| 			if debugDecoder { | ||||
| 				printf("window size %d > max %d\n", d.WindowSize, d.o.maxWindowSize) | ||||
| 			} | ||||
| 			return ErrDecoderSizeExceeded | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	if d.WindowSize > uint64(d.o.maxWindowSize) { | ||||
| 		if debugDecoder { | ||||
| 			printf("window size %d > max %d\n", d.WindowSize, d.o.maxWindowSize) | ||||
| 		} | ||||
| 		return ErrWindowSizeExceeded | ||||
| 	} | ||||
| 	// The minimum Window_Size is 1 KB.
 | ||||
| 	if d.WindowSize < MinWindowSize { | ||||
| 		if debugDecoder { | ||||
|  |  | |||
|  | @ -34,8 +34,8 @@ const ( | |||
| // buildDtable will build the decoding table.
 | ||||
| func (s *fseDecoder) buildDtable() error { | ||||
| 	ctx := buildDtableAsmContext{ | ||||
| 		stateTable: (*uint16)(&s.stateTable[0]), | ||||
| 		norm:       (*int16)(&s.norm[0]), | ||||
| 		stateTable: &s.stateTable[0], | ||||
| 		norm:       &s.norm[0], | ||||
| 		dt:         (*uint64)(&s.dt[0]), | ||||
| 	} | ||||
| 	code := buildDtable_asm(s, &ctx) | ||||
|  |  | |||
|  | @ -55,16 +55,22 @@ func (s *sequenceDecs) decodeSyncSimple(hist []byte) (bool, error) { | |||
| 	if s.maxSyncLen == 0 && cap(s.out)-len(s.out) < maxCompressedBlockSize { | ||||
| 		return false, nil | ||||
| 	} | ||||
| 	useSafe := false | ||||
| 	if s.maxSyncLen == 0 && cap(s.out)-len(s.out) < maxCompressedBlockSizeAlloc { | ||||
| 		useSafe = true | ||||
| 	} | ||||
| 	if s.maxSyncLen > 0 && cap(s.out)-len(s.out)-compressedBlockOverAlloc < int(s.maxSyncLen) { | ||||
| 		useSafe = true | ||||
| 	} | ||||
| 	if cap(s.literals) < len(s.literals)+compressedBlockOverAlloc { | ||||
| 		useSafe = true | ||||
| 	} | ||||
| 
 | ||||
| 	// FIXME: Using unsafe memory copies leads to rare, random crashes
 | ||||
| 	// with fuzz testing. It is therefore disabled for now.
 | ||||
| 	const useSafe = true | ||||
| 	/* | ||||
| 		useSafe := false | ||||
| 		if s.maxSyncLen == 0 && cap(s.out)-len(s.out) < maxCompressedBlockSizeAlloc { | ||||
| 			useSafe = true | ||||
| 		} | ||||
| 		if s.maxSyncLen > 0 && cap(s.out)-len(s.out)-compressedBlockOverAlloc < int(s.maxSyncLen) { | ||||
| 			useSafe = true | ||||
| 		} | ||||
| 		if cap(s.literals) < len(s.literals)+compressedBlockOverAlloc { | ||||
| 			useSafe = true | ||||
| 		} | ||||
| 	*/ | ||||
| 
 | ||||
| 	br := s.br | ||||
| 
 | ||||
|  |  | |||
|  | @ -52,34 +52,46 @@ sequenceDecs_decode_amd64_fill_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decode_amd64_fill_end: | ||||
| 	// Update offset | ||||
| 	MOVQ    R9, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, 16(R10) | ||||
| 	MOVQ  R9, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_amd64_of_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_amd64_of_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_amd64_of_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_of_update_zero: | ||||
| 	MOVQ AX, 16(R10) | ||||
| 
 | ||||
| 	// Update match length | ||||
| 	MOVQ    R8, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, 8(R10) | ||||
| 	MOVQ  R8, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_amd64_ml_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_amd64_ml_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_amd64_ml_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_ml_update_zero: | ||||
| 	MOVQ AX, 8(R10) | ||||
| 
 | ||||
| 	// Fill bitreader to have enough for the remaining | ||||
| 	CMPQ SI, $0x08 | ||||
|  | @ -107,19 +119,25 @@ sequenceDecs_decode_amd64_fill_2_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decode_amd64_fill_2_end: | ||||
| 	// Update literal length | ||||
| 	MOVQ    DI, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, (R10) | ||||
| 	MOVQ  DI, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_amd64_ll_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_amd64_ll_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_amd64_ll_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_ll_update_zero: | ||||
| 	MOVQ AX, (R10) | ||||
| 
 | ||||
| 	// Fill bitreader for state updates | ||||
| 	MOVQ    R14, (SP) | ||||
|  | @ -198,7 +216,7 @@ sequenceDecs_decode_amd64_skip_update: | |||
| 	MOVQ R12, R13 | ||||
| 	MOVQ R11, R12 | ||||
| 	MOVQ CX, R11 | ||||
| 	JMP  sequenceDecs_decode_amd64_adjust_end | ||||
| 	JMP  sequenceDecs_decode_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_adjust_offsetB_1_or_0: | ||||
| 	CMPQ (R10), $0x00000000 | ||||
|  | @ -210,7 +228,7 @@ sequenceDecs_decode_amd64_adjust_offset_maybezero: | |||
| 	TESTQ CX, CX | ||||
| 	JNZ   sequenceDecs_decode_amd64_adjust_offset_nonzero | ||||
| 	MOVQ  R11, CX | ||||
| 	JMP   sequenceDecs_decode_amd64_adjust_end | ||||
| 	JMP   sequenceDecs_decode_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_adjust_offset_nonzero: | ||||
| 	CMPQ CX, $0x01 | ||||
|  | @ -247,7 +265,7 @@ sequenceDecs_decode_amd64_adjust_temp_valid: | |||
| 	MOVQ    AX, R11 | ||||
| 	MOVQ    AX, CX | ||||
| 
 | ||||
| sequenceDecs_decode_amd64_adjust_end: | ||||
| sequenceDecs_decode_amd64_after_adjust: | ||||
| 	MOVQ CX, 16(R10) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -356,49 +374,67 @@ sequenceDecs_decode_56_amd64_fill_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decode_56_amd64_fill_end: | ||||
| 	// Update offset | ||||
| 	MOVQ    R9, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, 16(R10) | ||||
| 	MOVQ  R9, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_56_amd64_of_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_56_amd64_of_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_56_amd64_of_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_of_update_zero: | ||||
| 	MOVQ AX, 16(R10) | ||||
| 
 | ||||
| 	// Update match length | ||||
| 	MOVQ    R8, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, 8(R10) | ||||
| 	MOVQ  R8, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_56_amd64_ml_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_56_amd64_ml_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_56_amd64_ml_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_ml_update_zero: | ||||
| 	MOVQ AX, 8(R10) | ||||
| 
 | ||||
| 	// Update literal length | ||||
| 	MOVQ    DI, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R15 | ||||
| 	SHLQ    CL, R15 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R15 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R15 | ||||
| 	ADDQ    R15, AX | ||||
| 	MOVQ    AX, (R10) | ||||
| 	MOVQ  DI, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R15 | ||||
| 	SHLQ  CL, R15 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decode_56_amd64_ll_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decode_56_amd64_ll_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decode_56_amd64_ll_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R15 | ||||
| 	ADDQ  R15, AX | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_ll_update_zero: | ||||
| 	MOVQ AX, (R10) | ||||
| 
 | ||||
| 	// Fill bitreader for state updates | ||||
| 	MOVQ    R14, (SP) | ||||
|  | @ -477,7 +513,7 @@ sequenceDecs_decode_56_amd64_skip_update: | |||
| 	MOVQ R12, R13 | ||||
| 	MOVQ R11, R12 | ||||
| 	MOVQ CX, R11 | ||||
| 	JMP  sequenceDecs_decode_56_amd64_adjust_end | ||||
| 	JMP  sequenceDecs_decode_56_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_adjust_offsetB_1_or_0: | ||||
| 	CMPQ (R10), $0x00000000 | ||||
|  | @ -489,7 +525,7 @@ sequenceDecs_decode_56_amd64_adjust_offset_maybezero: | |||
| 	TESTQ CX, CX | ||||
| 	JNZ   sequenceDecs_decode_56_amd64_adjust_offset_nonzero | ||||
| 	MOVQ  R11, CX | ||||
| 	JMP   sequenceDecs_decode_56_amd64_adjust_end | ||||
| 	JMP   sequenceDecs_decode_56_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_adjust_offset_nonzero: | ||||
| 	CMPQ CX, $0x01 | ||||
|  | @ -526,7 +562,7 @@ sequenceDecs_decode_56_amd64_adjust_temp_valid: | |||
| 	MOVQ    AX, R11 | ||||
| 	MOVQ    AX, CX | ||||
| 
 | ||||
| sequenceDecs_decode_56_amd64_adjust_end: | ||||
| sequenceDecs_decode_56_amd64_after_adjust: | ||||
| 	MOVQ CX, 16(R10) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -757,7 +793,7 @@ sequenceDecs_decode_bmi2_skip_update: | |||
| 	MOVQ R11, R12 | ||||
| 	MOVQ R10, R11 | ||||
| 	MOVQ CX, R10 | ||||
| 	JMP  sequenceDecs_decode_bmi2_adjust_end | ||||
| 	JMP  sequenceDecs_decode_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_bmi2_adjust_offsetB_1_or_0: | ||||
| 	CMPQ (R9), $0x00000000 | ||||
|  | @ -769,7 +805,7 @@ sequenceDecs_decode_bmi2_adjust_offset_maybezero: | |||
| 	TESTQ CX, CX | ||||
| 	JNZ   sequenceDecs_decode_bmi2_adjust_offset_nonzero | ||||
| 	MOVQ  R10, CX | ||||
| 	JMP   sequenceDecs_decode_bmi2_adjust_end | ||||
| 	JMP   sequenceDecs_decode_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_bmi2_adjust_offset_nonzero: | ||||
| 	CMPQ CX, $0x01 | ||||
|  | @ -806,7 +842,7 @@ sequenceDecs_decode_bmi2_adjust_temp_valid: | |||
| 	MOVQ    R13, R10 | ||||
| 	MOVQ    R13, CX | ||||
| 
 | ||||
| sequenceDecs_decode_bmi2_adjust_end: | ||||
| sequenceDecs_decode_bmi2_after_adjust: | ||||
| 	MOVQ CX, 16(R9) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -1012,7 +1048,7 @@ sequenceDecs_decode_56_bmi2_skip_update: | |||
| 	MOVQ R11, R12 | ||||
| 	MOVQ R10, R11 | ||||
| 	MOVQ CX, R10 | ||||
| 	JMP  sequenceDecs_decode_56_bmi2_adjust_end | ||||
| 	JMP  sequenceDecs_decode_56_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_56_bmi2_adjust_offsetB_1_or_0: | ||||
| 	CMPQ (R9), $0x00000000 | ||||
|  | @ -1024,7 +1060,7 @@ sequenceDecs_decode_56_bmi2_adjust_offset_maybezero: | |||
| 	TESTQ CX, CX | ||||
| 	JNZ   sequenceDecs_decode_56_bmi2_adjust_offset_nonzero | ||||
| 	MOVQ  R10, CX | ||||
| 	JMP   sequenceDecs_decode_56_bmi2_adjust_end | ||||
| 	JMP   sequenceDecs_decode_56_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decode_56_bmi2_adjust_offset_nonzero: | ||||
| 	CMPQ CX, $0x01 | ||||
|  | @ -1061,7 +1097,7 @@ sequenceDecs_decode_56_bmi2_adjust_temp_valid: | |||
| 	MOVQ    R13, R10 | ||||
| 	MOVQ    R13, CX | ||||
| 
 | ||||
| sequenceDecs_decode_56_bmi2_adjust_end: | ||||
| sequenceDecs_decode_56_bmi2_after_adjust: | ||||
| 	MOVQ CX, 16(R9) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -1749,6 +1785,10 @@ TEXT ·sequenceDecs_decodeSync_amd64(SB), $64-32 | |||
| 	MOVQ    72(AX), DI | ||||
| 	MOVQ    80(AX), R8 | ||||
| 	MOVQ    88(AX), R9 | ||||
| 	XORQ    CX, CX | ||||
| 	MOVQ    CX, 8(SP) | ||||
| 	MOVQ    CX, 16(SP) | ||||
| 	MOVQ    CX, 24(SP) | ||||
| 	MOVQ    112(AX), R10 | ||||
| 	MOVQ    128(AX), CX | ||||
| 	MOVQ    CX, 32(SP) | ||||
|  | @ -1798,34 +1838,46 @@ sequenceDecs_decodeSync_amd64_fill_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_fill_end: | ||||
| 	// Update offset | ||||
| 	MOVQ    R9, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 8(SP) | ||||
| 	MOVQ  R9, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_amd64_of_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_amd64_of_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_amd64_of_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_of_update_zero: | ||||
| 	MOVQ AX, 8(SP) | ||||
| 
 | ||||
| 	// Update match length | ||||
| 	MOVQ    R8, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 16(SP) | ||||
| 	MOVQ  R8, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_amd64_ml_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_amd64_ml_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_amd64_ml_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_ml_update_zero: | ||||
| 	MOVQ AX, 16(SP) | ||||
| 
 | ||||
| 	// Fill bitreader to have enough for the remaining | ||||
| 	CMPQ SI, $0x08 | ||||
|  | @ -1853,19 +1905,25 @@ sequenceDecs_decodeSync_amd64_fill_2_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_fill_2_end: | ||||
| 	// Update literal length | ||||
| 	MOVQ    DI, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 24(SP) | ||||
| 	MOVQ  DI, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_amd64_ll_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_amd64_ll_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_amd64_ll_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_ll_update_zero: | ||||
| 	MOVQ AX, 24(SP) | ||||
| 
 | ||||
| 	// Fill bitreader for state updates | ||||
| 	MOVQ    R13, (SP) | ||||
|  | @ -1945,7 +2003,7 @@ sequenceDecs_decodeSync_amd64_skip_update: | |||
| 	MOVUPS 144(CX), X0 | ||||
| 	MOVQ   R13, 144(CX) | ||||
| 	MOVUPS X0, 152(CX) | ||||
| 	JMP    sequenceDecs_decodeSync_amd64_adjust_end | ||||
| 	JMP    sequenceDecs_decodeSync_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_adjust_offsetB_1_or_0: | ||||
| 	CMPQ 24(SP), $0x00000000 | ||||
|  | @ -1957,7 +2015,7 @@ sequenceDecs_decodeSync_amd64_adjust_offset_maybezero: | |||
| 	TESTQ R13, R13 | ||||
| 	JNZ   sequenceDecs_decodeSync_amd64_adjust_offset_nonzero | ||||
| 	MOVQ  144(CX), R13 | ||||
| 	JMP   sequenceDecs_decodeSync_amd64_adjust_end | ||||
| 	JMP   sequenceDecs_decodeSync_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_adjust_offset_nonzero: | ||||
| 	MOVQ    R13, AX | ||||
|  | @ -1966,8 +2024,7 @@ sequenceDecs_decodeSync_amd64_adjust_offset_nonzero: | |||
| 	CMPQ    R13, $0x03 | ||||
| 	CMOVQEQ R14, AX | ||||
| 	CMOVQEQ R15, R14 | ||||
| 	LEAQ    144(CX), R15 | ||||
| 	ADDQ    (R15)(AX*8), R14 | ||||
| 	ADDQ    144(CX)(AX*8), R14 | ||||
| 	JNZ     sequenceDecs_decodeSync_amd64_adjust_temp_valid | ||||
| 	MOVQ    $0x00000001, R14 | ||||
| 
 | ||||
|  | @ -1983,7 +2040,7 @@ sequenceDecs_decodeSync_amd64_adjust_skip: | |||
| 	MOVQ R14, 144(CX) | ||||
| 	MOVQ R14, R13 | ||||
| 
 | ||||
| sequenceDecs_decodeSync_amd64_adjust_end: | ||||
| sequenceDecs_decodeSync_amd64_after_adjust: | ||||
| 	MOVQ R13, 8(SP) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -2280,6 +2337,10 @@ TEXT ·sequenceDecs_decodeSync_bmi2(SB), $64-32 | |||
| 	MOVQ    72(CX), SI | ||||
| 	MOVQ    80(CX), DI | ||||
| 	MOVQ    88(CX), R8 | ||||
| 	XORQ    R9, R9 | ||||
| 	MOVQ    R9, 8(SP) | ||||
| 	MOVQ    R9, 16(SP) | ||||
| 	MOVQ    R9, 24(SP) | ||||
| 	MOVQ    112(CX), R9 | ||||
| 	MOVQ    128(CX), R10 | ||||
| 	MOVQ    R10, 32(SP) | ||||
|  | @ -2452,7 +2513,7 @@ sequenceDecs_decodeSync_bmi2_skip_update: | |||
| 	MOVUPS 144(CX), X0 | ||||
| 	MOVQ   R13, 144(CX) | ||||
| 	MOVUPS X0, 152(CX) | ||||
| 	JMP    sequenceDecs_decodeSync_bmi2_adjust_end | ||||
| 	JMP    sequenceDecs_decodeSync_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_bmi2_adjust_offsetB_1_or_0: | ||||
| 	CMPQ 24(SP), $0x00000000 | ||||
|  | @ -2464,7 +2525,7 @@ sequenceDecs_decodeSync_bmi2_adjust_offset_maybezero: | |||
| 	TESTQ R13, R13 | ||||
| 	JNZ   sequenceDecs_decodeSync_bmi2_adjust_offset_nonzero | ||||
| 	MOVQ  144(CX), R13 | ||||
| 	JMP   sequenceDecs_decodeSync_bmi2_adjust_end | ||||
| 	JMP   sequenceDecs_decodeSync_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_bmi2_adjust_offset_nonzero: | ||||
| 	MOVQ    R13, R12 | ||||
|  | @ -2473,8 +2534,7 @@ sequenceDecs_decodeSync_bmi2_adjust_offset_nonzero: | |||
| 	CMPQ    R13, $0x03 | ||||
| 	CMOVQEQ R14, R12 | ||||
| 	CMOVQEQ R15, R14 | ||||
| 	LEAQ    144(CX), R15 | ||||
| 	ADDQ    (R15)(R12*8), R14 | ||||
| 	ADDQ    144(CX)(R12*8), R14 | ||||
| 	JNZ     sequenceDecs_decodeSync_bmi2_adjust_temp_valid | ||||
| 	MOVQ    $0x00000001, R14 | ||||
| 
 | ||||
|  | @ -2490,7 +2550,7 @@ sequenceDecs_decodeSync_bmi2_adjust_skip: | |||
| 	MOVQ R14, 144(CX) | ||||
| 	MOVQ R14, R13 | ||||
| 
 | ||||
| sequenceDecs_decodeSync_bmi2_adjust_end: | ||||
| sequenceDecs_decodeSync_bmi2_after_adjust: | ||||
| 	MOVQ R13, 8(SP) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -2787,6 +2847,10 @@ TEXT ·sequenceDecs_decodeSync_safe_amd64(SB), $64-32 | |||
| 	MOVQ    72(AX), DI | ||||
| 	MOVQ    80(AX), R8 | ||||
| 	MOVQ    88(AX), R9 | ||||
| 	XORQ    CX, CX | ||||
| 	MOVQ    CX, 8(SP) | ||||
| 	MOVQ    CX, 16(SP) | ||||
| 	MOVQ    CX, 24(SP) | ||||
| 	MOVQ    112(AX), R10 | ||||
| 	MOVQ    128(AX), CX | ||||
| 	MOVQ    CX, 32(SP) | ||||
|  | @ -2836,34 +2900,46 @@ sequenceDecs_decodeSync_safe_amd64_fill_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_fill_end: | ||||
| 	// Update offset | ||||
| 	MOVQ    R9, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 8(SP) | ||||
| 	MOVQ  R9, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_safe_amd64_of_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_safe_amd64_of_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_safe_amd64_of_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_of_update_zero: | ||||
| 	MOVQ AX, 8(SP) | ||||
| 
 | ||||
| 	// Update match length | ||||
| 	MOVQ    R8, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 16(SP) | ||||
| 	MOVQ  R8, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_safe_amd64_ml_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_safe_amd64_ml_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_safe_amd64_ml_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_ml_update_zero: | ||||
| 	MOVQ AX, 16(SP) | ||||
| 
 | ||||
| 	// Fill bitreader to have enough for the remaining | ||||
| 	CMPQ SI, $0x08 | ||||
|  | @ -2891,19 +2967,25 @@ sequenceDecs_decodeSync_safe_amd64_fill_2_byte_by_byte: | |||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_fill_2_end: | ||||
| 	// Update literal length | ||||
| 	MOVQ    DI, AX | ||||
| 	MOVQ    BX, CX | ||||
| 	MOVQ    DX, R14 | ||||
| 	SHLQ    CL, R14 | ||||
| 	MOVB    AH, CL | ||||
| 	ADDQ    CX, BX | ||||
| 	NEGL    CX | ||||
| 	SHRQ    CL, R14 | ||||
| 	SHRQ    $0x20, AX | ||||
| 	TESTQ   CX, CX | ||||
| 	CMOVQEQ CX, R14 | ||||
| 	ADDQ    R14, AX | ||||
| 	MOVQ    AX, 24(SP) | ||||
| 	MOVQ  DI, AX | ||||
| 	MOVQ  BX, CX | ||||
| 	MOVQ  DX, R14 | ||||
| 	SHLQ  CL, R14 | ||||
| 	MOVB  AH, CL | ||||
| 	SHRQ  $0x20, AX | ||||
| 	TESTQ CX, CX | ||||
| 	JZ    sequenceDecs_decodeSync_safe_amd64_ll_update_zero | ||||
| 	ADDQ  CX, BX | ||||
| 	CMPQ  BX, $0x40 | ||||
| 	JA    sequenceDecs_decodeSync_safe_amd64_ll_update_zero | ||||
| 	CMPQ  CX, $0x40 | ||||
| 	JAE   sequenceDecs_decodeSync_safe_amd64_ll_update_zero | ||||
| 	NEGQ  CX | ||||
| 	SHRQ  CL, R14 | ||||
| 	ADDQ  R14, AX | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_ll_update_zero: | ||||
| 	MOVQ AX, 24(SP) | ||||
| 
 | ||||
| 	// Fill bitreader for state updates | ||||
| 	MOVQ    R13, (SP) | ||||
|  | @ -2983,7 +3065,7 @@ sequenceDecs_decodeSync_safe_amd64_skip_update: | |||
| 	MOVUPS 144(CX), X0 | ||||
| 	MOVQ   R13, 144(CX) | ||||
| 	MOVUPS X0, 152(CX) | ||||
| 	JMP    sequenceDecs_decodeSync_safe_amd64_adjust_end | ||||
| 	JMP    sequenceDecs_decodeSync_safe_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_adjust_offsetB_1_or_0: | ||||
| 	CMPQ 24(SP), $0x00000000 | ||||
|  | @ -2995,7 +3077,7 @@ sequenceDecs_decodeSync_safe_amd64_adjust_offset_maybezero: | |||
| 	TESTQ R13, R13 | ||||
| 	JNZ   sequenceDecs_decodeSync_safe_amd64_adjust_offset_nonzero | ||||
| 	MOVQ  144(CX), R13 | ||||
| 	JMP   sequenceDecs_decodeSync_safe_amd64_adjust_end | ||||
| 	JMP   sequenceDecs_decodeSync_safe_amd64_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_adjust_offset_nonzero: | ||||
| 	MOVQ    R13, AX | ||||
|  | @ -3004,8 +3086,7 @@ sequenceDecs_decodeSync_safe_amd64_adjust_offset_nonzero: | |||
| 	CMPQ    R13, $0x03 | ||||
| 	CMOVQEQ R14, AX | ||||
| 	CMOVQEQ R15, R14 | ||||
| 	LEAQ    144(CX), R15 | ||||
| 	ADDQ    (R15)(AX*8), R14 | ||||
| 	ADDQ    144(CX)(AX*8), R14 | ||||
| 	JNZ     sequenceDecs_decodeSync_safe_amd64_adjust_temp_valid | ||||
| 	MOVQ    $0x00000001, R14 | ||||
| 
 | ||||
|  | @ -3021,7 +3102,7 @@ sequenceDecs_decodeSync_safe_amd64_adjust_skip: | |||
| 	MOVQ R14, 144(CX) | ||||
| 	MOVQ R14, R13 | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_amd64_adjust_end: | ||||
| sequenceDecs_decodeSync_safe_amd64_after_adjust: | ||||
| 	MOVQ R13, 8(SP) | ||||
| 
 | ||||
| 	// Check values | ||||
|  | @ -3420,6 +3501,10 @@ TEXT ·sequenceDecs_decodeSync_safe_bmi2(SB), $64-32 | |||
| 	MOVQ    72(CX), SI | ||||
| 	MOVQ    80(CX), DI | ||||
| 	MOVQ    88(CX), R8 | ||||
| 	XORQ    R9, R9 | ||||
| 	MOVQ    R9, 8(SP) | ||||
| 	MOVQ    R9, 16(SP) | ||||
| 	MOVQ    R9, 24(SP) | ||||
| 	MOVQ    112(CX), R9 | ||||
| 	MOVQ    128(CX), R10 | ||||
| 	MOVQ    R10, 32(SP) | ||||
|  | @ -3592,7 +3677,7 @@ sequenceDecs_decodeSync_safe_bmi2_skip_update: | |||
| 	MOVUPS 144(CX), X0 | ||||
| 	MOVQ   R13, 144(CX) | ||||
| 	MOVUPS X0, 152(CX) | ||||
| 	JMP    sequenceDecs_decodeSync_safe_bmi2_adjust_end | ||||
| 	JMP    sequenceDecs_decodeSync_safe_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_bmi2_adjust_offsetB_1_or_0: | ||||
| 	CMPQ 24(SP), $0x00000000 | ||||
|  | @ -3604,7 +3689,7 @@ sequenceDecs_decodeSync_safe_bmi2_adjust_offset_maybezero: | |||
| 	TESTQ R13, R13 | ||||
| 	JNZ   sequenceDecs_decodeSync_safe_bmi2_adjust_offset_nonzero | ||||
| 	MOVQ  144(CX), R13 | ||||
| 	JMP   sequenceDecs_decodeSync_safe_bmi2_adjust_end | ||||
| 	JMP   sequenceDecs_decodeSync_safe_bmi2_after_adjust | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_bmi2_adjust_offset_nonzero: | ||||
| 	MOVQ    R13, R12 | ||||
|  | @ -3613,8 +3698,7 @@ sequenceDecs_decodeSync_safe_bmi2_adjust_offset_nonzero: | |||
| 	CMPQ    R13, $0x03 | ||||
| 	CMOVQEQ R14, R12 | ||||
| 	CMOVQEQ R15, R14 | ||||
| 	LEAQ    144(CX), R15 | ||||
| 	ADDQ    (R15)(R12*8), R14 | ||||
| 	ADDQ    144(CX)(R12*8), R14 | ||||
| 	JNZ     sequenceDecs_decodeSync_safe_bmi2_adjust_temp_valid | ||||
| 	MOVQ    $0x00000001, R14 | ||||
| 
 | ||||
|  | @ -3630,7 +3714,7 @@ sequenceDecs_decodeSync_safe_bmi2_adjust_skip: | |||
| 	MOVQ R14, 144(CX) | ||||
| 	MOVQ R14, R13 | ||||
| 
 | ||||
| sequenceDecs_decodeSync_safe_bmi2_adjust_end: | ||||
| sequenceDecs_decodeSync_safe_bmi2_after_adjust: | ||||
| 	MOVQ R13, 8(SP) | ||||
| 
 | ||||
| 	// Check values | ||||
|  |  | |||
|  | @ -1,3 +1,26 @@ | |||
| ## 1.20.0 | ||||
| 
 | ||||
| ## Features | ||||
| - New [`gleak`](https://onsi.github.io/gomega/#codegleakcode-finding-leaked-goroutines) experimental goroutine leak detection package! (#538) [85ba7bc] | ||||
| - New `BeComparableTo` matcher(#546) that uses `gocmp` to make comparisons [e77ea75] | ||||
| - New `HaveExistingField` matcher (#553) [fd130e1] | ||||
| - Document how to wrap Gomega (#539) [56714a4] | ||||
| 
 | ||||
| ## Fixes | ||||
| - Support pointer receivers in HaveField; fixes #543 (#544) [8dab36e] | ||||
| 
 | ||||
| ## Maintenance | ||||
| - Bump various dependencies: | ||||
|     - Upgrade to yaml.v3 (#556) [f5a83b1] | ||||
|     - Bump github/codeql-action from 1 to 2 (#549) [52f5adf] | ||||
|     - Bump github.com/google/go-cmp from 0.5.7 to 0.5.8 (#551) [5f3942d] | ||||
|     - Bump nokogiri from 1.13.4 to 1.13.6 in /docs (#554) [eb4b4c2] | ||||
|     - Use latest ginkgo (#535) [1c29028] | ||||
|     - Bump nokogiri from 1.13.3 to 1.13.4 in /docs (#541) [1ce84d5] | ||||
|     - Bump actions/setup-go from 2 to 3 (#540) [755485e] | ||||
|     - Bump nokogiri from 1.12.5 to 1.13.3 in /docs (#522) [4fbb0dc] | ||||
|     - Bump actions/checkout from 2 to 3 (#526) [ac49202] | ||||
| 
 | ||||
| ## 1.19.0 | ||||
| 
 | ||||
| ## Features | ||||
|  |  | |||
|  | @ -4,13 +4,14 @@ go 1.18 | |||
| 
 | ||||
| require ( | ||||
| 	github.com/golang/protobuf v1.5.2 | ||||
| 	github.com/onsi/ginkgo/v2 v2.1.3 | ||||
| 	golang.org/x/net v0.0.0-20220225172249-27dd8689420f | ||||
| 	gopkg.in/yaml.v2 v2.4.0 | ||||
| 	github.com/google/go-cmp v0.5.8 | ||||
| 	github.com/onsi/ginkgo/v2 v2.1.4 | ||||
| 	golang.org/x/net v0.0.0-20220425223048-2871e0cb64e4 | ||||
| 	gopkg.in/yaml.v3 v3.0.1 | ||||
| ) | ||||
| 
 | ||||
| require ( | ||||
| 	golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e // indirect | ||||
| 	golang.org/x/sys v0.0.0-20220422013727-9388b58f7150 // indirect | ||||
| 	golang.org/x/text v0.3.7 // indirect | ||||
| 	google.golang.org/protobuf v1.26.0 // indirect | ||||
| 	google.golang.org/protobuf v1.28.0 // indirect | ||||
| ) | ||||
|  |  | |||
|  | @ -1,101 +1,23 @@ | |||
| github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI= | ||||
| github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI= | ||||
| github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU= | ||||
| github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= | ||||
| github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= | ||||
| github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo= | ||||
| github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ= | ||||
| github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg7847qk6SyHyPtNmDHnmrv/HOrqktSC+C9fM+CJOE= | ||||
| github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= | ||||
| github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= | ||||
| github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= | ||||
| github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= | ||||
| github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= | ||||
| github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= | ||||
| github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= | ||||
| github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= | ||||
| github.com/golang/protobuf v1.5.2 h1:ROPKBNFfQgOUMifHyP+KYbvpjbdoFNs+aK7DXlji0Tw= | ||||
| github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= | ||||
| github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= | ||||
| github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= | ||||
| github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= | ||||
| github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU= | ||||
| github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= | ||||
| github.com/google/pprof v0.0.0-20210407192527-94a9f03dee38/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE= | ||||
| github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= | ||||
| github.com/ianlancetaylor/demangle v0.0.0-20200824232613-28f6c0f3b639/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc= | ||||
| github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A= | ||||
| github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU= | ||||
| github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= | ||||
| github.com/onsi/ginkgo v1.12.1/go.mod h1:zj2OWP4+oCPe1qIXoGWkgMRwljMUYCdkwsT2108oapk= | ||||
| github.com/onsi/ginkgo v1.16.4/go.mod h1:dX+/inL/fNMqNlz0e9LfyB9TswhZpCVdJM/Z6Vvnwo0= | ||||
| github.com/onsi/ginkgo/v2 v2.1.3 h1:e/3Cwtogj0HA+25nMP1jCMDIf8RtRYbGwGGuBIFztkc= | ||||
| github.com/onsi/ginkgo/v2 v2.1.3/go.mod h1:vw5CSIxN1JObi/U8gcbwft7ZxR2dgaR70JSE3/PpL4c= | ||||
| github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY= | ||||
| github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1ybHNo= | ||||
| github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= | ||||
| github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= | ||||
| github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= | ||||
| github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= | ||||
| github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= | ||||
| golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= | ||||
| golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= | ||||
| golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= | ||||
| golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= | ||||
| golang.org/x/net v0.0.0-20180906233101-161cd47e91fd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= | ||||
| golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= | ||||
| golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= | ||||
| golang.org/x/net v0.0.0-20200520004742-59133d7f0dd7/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= | ||||
| golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= | ||||
| golang.org/x/net v0.0.0-20210428140749-89ef3d95e781/go.mod h1:OJAsFXCWl8Ukc7SiCT/9KSuxbyM7479/AVlXFRxuMCk= | ||||
| golang.org/x/net v0.0.0-20220225172249-27dd8689420f h1:oA4XRj0qtSt8Yo1Zms0CUlsT3KG69V2UGQWPBxujDmc= | ||||
| golang.org/x/net v0.0.0-20220225172249-27dd8689420f/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= | ||||
| golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= | ||||
| golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= | ||||
| golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= | ||||
| golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= | ||||
| golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= | ||||
| golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20190904154756-749cb33beabd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20191005200804-aed5e4c7ecf9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20191120155948-bd437916bb0e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20191204072324-ce4227a45e2e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20210112080510-489259a85091/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= | ||||
| golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e h1:fLOSk5Q00efkSvAm+4xcoXD+RRmLmmulPn5I3Y9F2EM= | ||||
| golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= | ||||
| golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= | ||||
| golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= | ||||
| golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= | ||||
| github.com/google/go-cmp v0.5.8 h1:e6P7q2lk1O+qJJb4BtCQXlK8vWEO8V1ZeuEdJNOqZyg= | ||||
| github.com/google/go-cmp v0.5.8/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= | ||||
| github.com/onsi/ginkgo/v2 v2.1.4 h1:GNapqRSid3zijZ9H77KrgVG4/8KqiyRsxcSxe+7ApXY= | ||||
| github.com/onsi/ginkgo/v2 v2.1.4/go.mod h1:um6tUpWM/cxCK3/FK8BXqEiUMUwRgSM4JXG47RKZmLU= | ||||
| golang.org/x/net v0.0.0-20220425223048-2871e0cb64e4 h1:HVyaeDAYux4pnY+D/SiwmLOR36ewZ4iGQIIrtnuCjFA= | ||||
| golang.org/x/net v0.0.0-20220425223048-2871e0cb64e4/go.mod h1:CfG3xpIq0wQ8r1q4Su4UZFWDARRcnwPjda9FqA0JpMk= | ||||
| golang.org/x/sys v0.0.0-20220422013727-9388b58f7150 h1:xHms4gcpe1YE7A3yIllJXP16CMAGuqwO2lX1mTyyRRc= | ||||
| golang.org/x/sys v0.0.0-20220422013727-9388b58f7150/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= | ||||
| golang.org/x/text v0.3.7 h1:olpwvP2KacW1ZWvsR7uQhoyTYvKAupfQrRGBFM352Gk= | ||||
| golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= | ||||
| golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= | ||||
| golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= | ||||
| golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= | ||||
| golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= | ||||
| golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= | ||||
| golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= | ||||
| golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= | ||||
| golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= | ||||
| google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= | ||||
| google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= | ||||
| google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= | ||||
| google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= | ||||
| google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= | ||||
| google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= | ||||
| google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= | ||||
| google.golang.org/protobuf v1.26.0 h1:bxAC2xTBsZGibn2RTntX0oH50xLsqy1OxA9tTL3p/lk= | ||||
| google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= | ||||
| google.golang.org/protobuf v1.28.0 h1:w43yiav+6bVFTBQFZX0r7ipe9JQ1QsbMgHwbBziscLw= | ||||
| google.golang.org/protobuf v1.28.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I= | ||||
| gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM= | ||||
| gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= | ||||
| gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys= | ||||
| gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw= | ||||
| gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= | ||||
| gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= | ||||
| gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= | ||||
| gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY= | ||||
| gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ= | ||||
| gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= | ||||
| gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= | ||||
|  |  | |||
|  | @ -22,7 +22,7 @@ import ( | |||
| 	"github.com/onsi/gomega/types" | ||||
| ) | ||||
| 
 | ||||
| const GOMEGA_VERSION = "1.19.0" | ||||
| const GOMEGA_VERSION = "1.20.0" | ||||
| 
 | ||||
| const nilGomegaPanic = `You are trying to make an assertion, but haven't registered Gomega's fail handler. | ||||
| If you're using Ginkgo then you probably forgot to put your assertion in an It(). | ||||
|  |  | |||
|  | @ -3,6 +3,7 @@ package gomega | |||
| import ( | ||||
| 	"time" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp" | ||||
| 	"github.com/onsi/gomega/matchers" | ||||
| 	"github.com/onsi/gomega/types" | ||||
| ) | ||||
|  | @ -26,6 +27,15 @@ func BeEquivalentTo(expected interface{}) types.GomegaMatcher { | |||
| 	} | ||||
| } | ||||
| 
 | ||||
| //BeComparableTo uses gocmp.Equal to compare. You can pass cmp.Option as options.
 | ||||
| //It is an error for actual and expected to be nil.  Use BeNil() instead.
 | ||||
| func BeComparableTo(expected interface{}, opts ...cmp.Option) types.GomegaMatcher { | ||||
| 	return &matchers.BeComparableToMatcher{ | ||||
| 		Expected: expected, | ||||
| 		Options:  opts, | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| //BeIdenticalTo uses the == operator to compare actual with expected.
 | ||||
| //BeIdenticalTo is strict about types when performing comparisons.
 | ||||
| //It is an error for both actual and expected to be nil.  Use BeNil() instead.
 | ||||
|  | @ -394,6 +404,19 @@ func HaveField(field string, expected interface{}) types.GomegaMatcher { | |||
| 	} | ||||
| } | ||||
| 
 | ||||
| // HaveExistingField succeeds if actual is a struct and the specified field
 | ||||
| // exists.
 | ||||
| //
 | ||||
| // HaveExistingField can be combined with HaveField in order to cover use cases
 | ||||
| // with optional fields. HaveField alone would trigger an error in such situations.
 | ||||
| //
 | ||||
| //     Expect(MrHarmless).NotTo(And(HaveExistingField("Title"), HaveField("Title", "Supervillain")))
 | ||||
| func HaveExistingField(field string) types.GomegaMatcher { | ||||
| 	return &matchers.HaveExistingFieldMatcher{ | ||||
| 		Field: field, | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // HaveValue applies the given matcher to the value of actual, optionally and
 | ||||
| // repeatedly dereferencing pointers or taking the concrete value of interfaces.
 | ||||
| // Thus, the matcher will always be applied to non-pointer and non-interface
 | ||||
|  |  | |||
							
								
								
									
										49
									
								
								vendor/github.com/onsi/gomega/matchers/be_comparable_to_matcher.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										49
									
								
								vendor/github.com/onsi/gomega/matchers/be_comparable_to_matcher.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,49 @@ | |||
| package matchers | ||||
| 
 | ||||
| import ( | ||||
| 	"bytes" | ||||
| 	"fmt" | ||||
| 
 | ||||
| 	"github.com/google/go-cmp/cmp" | ||||
| 	"github.com/onsi/gomega/format" | ||||
| ) | ||||
| 
 | ||||
| type BeComparableToMatcher struct { | ||||
| 	Expected interface{} | ||||
| 	Options  cmp.Options | ||||
| } | ||||
| 
 | ||||
| func (matcher *BeComparableToMatcher) Match(actual interface{}) (success bool, matchErr error) { | ||||
| 	if actual == nil && matcher.Expected == nil { | ||||
| 		return false, fmt.Errorf("Refusing to compare <nil> to <nil>.\nBe explicit and use BeNil() instead.  This is to avoid mistakes where both sides of an assertion are erroneously uninitialized.") | ||||
| 	} | ||||
| 	// Shortcut for byte slices.
 | ||||
| 	// Comparing long byte slices with reflect.DeepEqual is very slow,
 | ||||
| 	// so use bytes.Equal if actual and expected are both byte slices.
 | ||||
| 	if actualByteSlice, ok := actual.([]byte); ok { | ||||
| 		if expectedByteSlice, ok := matcher.Expected.([]byte); ok { | ||||
| 			return bytes.Equal(actualByteSlice, expectedByteSlice), nil | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	defer func() { | ||||
| 		if r := recover(); r != nil { | ||||
| 			success = false | ||||
| 			if err, ok := r.(error); ok { | ||||
| 				matchErr = err | ||||
| 			} else if errMsg, ok := r.(string); ok { | ||||
| 				matchErr = fmt.Errorf(errMsg) | ||||
| 			} | ||||
| 		} | ||||
| 	}() | ||||
| 
 | ||||
| 	return cmp.Equal(actual, matcher.Expected, matcher.Options...), nil | ||||
| } | ||||
| 
 | ||||
| func (matcher *BeComparableToMatcher) FailureMessage(actual interface{}) (message string) { | ||||
| 	return cmp.Diff(matcher.Expected, actual, matcher.Options) | ||||
| } | ||||
| 
 | ||||
| func (matcher *BeComparableToMatcher) NegatedFailureMessage(actual interface{}) (message string) { | ||||
| 	return format.Message(actual, "not to equal", matcher.Expected) | ||||
| } | ||||
							
								
								
									
										36
									
								
								vendor/github.com/onsi/gomega/matchers/have_existing_field_matcher.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							
							
						
						
									
										36
									
								
								vendor/github.com/onsi/gomega/matchers/have_existing_field_matcher.go
								
								
									generated
								
								
									vendored
								
								
									Normal file
								
							|  | @ -0,0 +1,36 @@ | |||
| package matchers | ||||
| 
 | ||||
| import ( | ||||
| 	"errors" | ||||
| 	"fmt" | ||||
| 
 | ||||
| 	"github.com/onsi/gomega/format" | ||||
| ) | ||||
| 
 | ||||
| type HaveExistingFieldMatcher struct { | ||||
| 	Field string | ||||
| } | ||||
| 
 | ||||
| func (matcher *HaveExistingFieldMatcher) Match(actual interface{}) (success bool, err error) { | ||||
| 	// we don't care about the field's actual value, just about any error in
 | ||||
| 	// trying to find the field (or method).
 | ||||
| 	_, err = extractField(actual, matcher.Field, "HaveExistingField") | ||||
| 	if err == nil { | ||||
| 		return true, nil | ||||
| 	} | ||||
| 	var mferr missingFieldError | ||||
| 	if errors.As(err, &mferr) { | ||||
| 		// missing field errors aren't errors in this context, but instead
 | ||||
| 		// unsuccessful matches.
 | ||||
| 		return false, nil | ||||
| 	} | ||||
| 	return false, err | ||||
| } | ||||
| 
 | ||||
| func (matcher *HaveExistingFieldMatcher) FailureMessage(actual interface{}) (message string) { | ||||
| 	return fmt.Sprintf("Expected\n%s\nto have field '%s'", format.Object(actual, 1), matcher.Field) | ||||
| } | ||||
| 
 | ||||
| func (matcher *HaveExistingFieldMatcher) NegatedFailureMessage(actual interface{}) (message string) { | ||||
| 	return fmt.Sprintf("Expected\n%s\nnot to have field '%s'", format.Object(actual, 1), matcher.Field) | ||||
| } | ||||
|  | @ -8,7 +8,16 @@ import ( | |||
| 	"github.com/onsi/gomega/format" | ||||
| ) | ||||
| 
 | ||||
| func extractField(actual interface{}, field string) (interface{}, error) { | ||||
| // missingFieldError represents a missing field extraction error that
 | ||||
| // HaveExistingFieldMatcher can ignore, as opposed to other, sever field
 | ||||
| // extraction errors, such as nil pointers, et cetera.
 | ||||
| type missingFieldError string | ||||
| 
 | ||||
| func (e missingFieldError) Error() string { | ||||
| 	return string(e) | ||||
| } | ||||
| 
 | ||||
| func extractField(actual interface{}, field string, matchername string) (interface{}, error) { | ||||
| 	fields := strings.SplitN(field, ".", 2) | ||||
| 	actualValue := reflect.ValueOf(actual) | ||||
| 
 | ||||
|  | @ -16,36 +25,39 @@ func extractField(actual interface{}, field string) (interface{}, error) { | |||
| 		actualValue = actualValue.Elem() | ||||
| 	} | ||||
| 	if actualValue == (reflect.Value{}) { | ||||
| 		return nil, fmt.Errorf("HaveField encountered nil while dereferencing a pointer of type %T.", actual) | ||||
| 		return nil, fmt.Errorf("%s encountered nil while dereferencing a pointer of type %T.", matchername, actual) | ||||
| 	} | ||||
| 
 | ||||
| 	if actualValue.Kind() != reflect.Struct { | ||||
| 		return nil, fmt.Errorf("HaveField encountered:\n%s\nWhich is not a struct.", format.Object(actual, 1)) | ||||
| 		return nil, fmt.Errorf("%s encountered:\n%s\nWhich is not a struct.", matchername, format.Object(actual, 1)) | ||||
| 	} | ||||
| 
 | ||||
| 	var extractedValue reflect.Value | ||||
| 
 | ||||
| 	if strings.HasSuffix(fields[0], "()") { | ||||
| 		extractedValue = actualValue.MethodByName(strings.TrimSuffix(fields[0], "()")) | ||||
| 		if extractedValue == (reflect.Value{}) && actualValue.CanAddr() { | ||||
| 			extractedValue = actualValue.Addr().MethodByName(strings.TrimSuffix(fields[0], "()")) | ||||
| 		} | ||||
| 		if extractedValue == (reflect.Value{}) { | ||||
| 			return nil, fmt.Errorf("HaveField could not find method named '%s' in struct of type %T.", fields[0], actual) | ||||
| 			return nil, missingFieldError(fmt.Sprintf("%s could not find method named '%s' in struct of type %T.", matchername, fields[0], actual)) | ||||
| 		} | ||||
| 		t := extractedValue.Type() | ||||
| 		if t.NumIn() != 0 || t.NumOut() != 1 { | ||||
| 			return nil, fmt.Errorf("HaveField found an invalid method named '%s' in struct of type %T.\nMethods must take no arguments and return exactly one value.", fields[0], actual) | ||||
| 			return nil, fmt.Errorf("%s found an invalid method named '%s' in struct of type %T.\nMethods must take no arguments and return exactly one value.", matchername, fields[0], actual) | ||||
| 		} | ||||
| 		extractedValue = extractedValue.Call([]reflect.Value{})[0] | ||||
| 	} else { | ||||
| 		extractedValue = actualValue.FieldByName(fields[0]) | ||||
| 		if extractedValue == (reflect.Value{}) { | ||||
| 			return nil, fmt.Errorf("HaveField could not find field named '%s' in struct:\n%s", fields[0], format.Object(actual, 1)) | ||||
| 			return nil, missingFieldError(fmt.Sprintf("%s could not find field named '%s' in struct:\n%s", matchername, fields[0], format.Object(actual, 1))) | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	if len(fields) == 1 { | ||||
| 		return extractedValue.Interface(), nil | ||||
| 	} else { | ||||
| 		return extractField(extractedValue.Interface(), fields[1]) | ||||
| 		return extractField(extractedValue.Interface(), fields[1], matchername) | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
|  | @ -58,7 +70,7 @@ type HaveFieldMatcher struct { | |||
| } | ||||
| 
 | ||||
| func (matcher *HaveFieldMatcher) Match(actual interface{}) (success bool, err error) { | ||||
| 	matcher.extractedField, err = extractField(actual, matcher.Field) | ||||
| 	matcher.extractedField, err = extractField(actual, matcher.Field, "HaveField") | ||||
| 	if err != nil { | ||||
| 		return false, err | ||||
| 	} | ||||
|  |  | |||
|  | @ -5,7 +5,7 @@ import ( | |||
| 	"strings" | ||||
| 
 | ||||
| 	"github.com/onsi/gomega/format" | ||||
| 	"gopkg.in/yaml.v2" | ||||
| 	"gopkg.in/yaml.v3" | ||||
| ) | ||||
| 
 | ||||
| type MatchYAMLMatcher struct { | ||||
|  |  | |||
|  | @ -114,7 +114,7 @@ github.com/containers/buildah/pkg/rusage | |||
| github.com/containers/buildah/pkg/sshagent | ||||
| github.com/containers/buildah/pkg/util | ||||
| github.com/containers/buildah/util | ||||
| # github.com/containers/common v0.48.1-0.20220720145307-26032247af78 | ||||
| # github.com/containers/common v0.49.1-0.20220729221035-246800047d46 | ||||
| ## explicit | ||||
| github.com/containers/common/libimage | ||||
| github.com/containers/common/libimage/define | ||||
|  | @ -167,7 +167,7 @@ github.com/containers/common/version | |||
| # github.com/containers/conmon v2.0.20+incompatible | ||||
| ## explicit | ||||
| github.com/containers/conmon/runner/config | ||||
| # github.com/containers/image/v5 v5.21.2-0.20220721072459-bf19265865b7 | ||||
| # github.com/containers/image/v5 v5.22.0 | ||||
| ## explicit | ||||
| github.com/containers/image/v5/copy | ||||
| github.com/containers/image/v5/directory | ||||
|  | @ -257,7 +257,7 @@ github.com/containers/psgo/internal/dev | |||
| github.com/containers/psgo/internal/host | ||||
| github.com/containers/psgo/internal/proc | ||||
| github.com/containers/psgo/internal/process | ||||
| # github.com/containers/storage v1.41.1-0.20220718173332-b10c469fda0a | ||||
| # github.com/containers/storage v1.42.0 | ||||
| ## explicit | ||||
| github.com/containers/storage | ||||
| github.com/containers/storage/drivers | ||||
|  | @ -433,6 +433,12 @@ github.com/golang/protobuf/ptypes | |||
| github.com/golang/protobuf/ptypes/any | ||||
| github.com/golang/protobuf/ptypes/duration | ||||
| github.com/golang/protobuf/ptypes/timestamp | ||||
| # github.com/google/go-cmp v0.5.8 | ||||
| github.com/google/go-cmp/cmp | ||||
| github.com/google/go-cmp/cmp/internal/diff | ||||
| github.com/google/go-cmp/cmp/internal/flags | ||||
| github.com/google/go-cmp/cmp/internal/function | ||||
| github.com/google/go-cmp/cmp/internal/value | ||||
| # github.com/google/go-containerregistry v0.10.0 | ||||
| github.com/google/go-containerregistry/pkg/name | ||||
| # github.com/google/go-intervals v0.0.2 | ||||
|  | @ -470,7 +476,7 @@ github.com/jinzhu/copier | |||
| # github.com/json-iterator/go v1.1.12 | ||||
| ## explicit | ||||
| github.com/json-iterator/go | ||||
| # github.com/klauspost/compress v1.15.8 | ||||
| # github.com/klauspost/compress v1.15.9 | ||||
| github.com/klauspost/compress | ||||
| github.com/klauspost/compress/flate | ||||
| github.com/klauspost/compress/fse | ||||
|  | @ -560,7 +566,7 @@ github.com/onsi/ginkgo/reporters/stenographer | |||
| github.com/onsi/ginkgo/reporters/stenographer/support/go-colorable | ||||
| github.com/onsi/ginkgo/reporters/stenographer/support/go-isatty | ||||
| github.com/onsi/ginkgo/types | ||||
| # github.com/onsi/gomega v1.19.0 | ||||
| # github.com/onsi/gomega v1.20.0 | ||||
| ## explicit | ||||
| github.com/onsi/gomega | ||||
| github.com/onsi/gomega/format | ||||
|  |  | |||
		Loading…
	
		Reference in New Issue