all: rename mime to format

Author: changkun

README.md

@@ -18,16 +18,16 @@ Quick start:
 
 ```go
 // write texts to the clipboard
-clipboard.Write(clipboard.MIMEText, []byte("text data"))
+clipboard.Write(clipboard.FmtText, []byte("text data"))
 
 // read texts from the clipboard
-clipboard.Read(clipboard.MIMEText)
+clipboard.Read(clipboard.FmtText)
 
 // write image to the clipboard, assume image bytes are png encoded.
-clipboard.Write(clipboard.MIMEImage, []byte("image data"))
+clipboard.Write(clipboard.FmtImage, []byte("image data"))
 
 // read image from the clipboard
-clipboard.Read(clipboard.MIMEImage)
+clipboard.Read(clipboard.FmtImage)
 ```
 
 In addition, the `clipboard.Write` API returns a channel that
@@ -37,7 +37,7 @@ the clipboard has been overwritten by others and the previously
 written data is lost. For instance:
 
 ```go
-changed := clipboard.Write(clipboard.MIMEText, []byte("text data"))
+changed := clipboard.Write(clipboard.FmtText, []byte("text data"))
 
 select {
 case <-changed:

clipboard.go

@@ -10,15 +10,15 @@ import (
 	"sync"
 )
 
-// MIMEType represents the MIME type of clipboard data.
-type MIMEType int
+// Format represents the MIME type of clipboard data.
+type Format int
 
 // All sorts of supported clipboard data
 const (
-	// MIMEText indicates plain text MIME format
-	MIMEText MIMEType = iota
-	// MIMEImage indicates image/png MIME format
-	MIMEImage
+	// FmtText indicates plain text MIME format
+	FmtText Format = iota
+	// FmtImage indicates image/png MIME format
+	FmtImage
 )
 
 // Due to the limitation on operating systems (such as darwin),
@@ -27,7 +27,7 @@ const (
 var lock = sync.Mutex{}
 
 // Read reads and returns the clipboard data.
-func Read(t MIMEType) []byte {
+func Read(t Format) []byte {
 	lock.Lock()
 	defer lock.Unlock()
 
@@ -40,7 +40,7 @@ func Read(t MIMEType) []byte {
 //
 // If the MIME type indicates an image, then the given buf assumes
 // the image data is PNG encoded.
-func Write(t MIMEType, buf []byte) <-chan struct{} {
+func Write(t Format, buf []byte) <-chan struct{} {
 	lock.Lock()
 	defer lock.Unlock()
 

clipboard_darwin.go

@@ -27,15 +27,15 @@ import (
 	"unsafe"
 )
 
-func read(t MIMEType) (buf []byte) {
+func read(t Format) (buf []byte) {
 	var (
 		data unsafe.Pointer
 		n    C.uint
 	)
 	switch t {
-	case MIMEText:
+	case FmtText:
 		n = C.clipboard_read_string(&data)
-	case MIMEImage:
+	case FmtImage:
 		n = C.clipboard_read_image(&data)
 	}
 	if data == nil {
@@ -50,13 +50,13 @@ func read(t MIMEType) (buf []byte) {
 
 // write writes the given data to clipboard and
 // returns true if success or false if failed.
-func write(t MIMEType, buf []byte) (bool, <-chan struct{}) {
+func write(t Format, buf []byte) (bool, <-chan struct{}) {
 	var ok C.int
 	switch t {
-	case MIMEText:
+	case FmtText:
 		ok = C.clipboard_write_string(unsafe.Pointer(&buf[0]),
 			C.NSInteger(len(buf)))
-	case MIMEImage:
+	case FmtImage:
 		ok = C.clipboard_write_image(unsafe.Pointer(&buf[0]),
 			C.NSInteger(len(buf)))
 	}

clipboard_linux.go

@@ -45,11 +45,11 @@ func init() {
 	}
 }
 
-func read(t MIMEType) (buf []byte) {
+func read(t Format) (buf []byte) {
 	switch t {
-	case MIMEText:
+	case FmtText:
 		return readc("UTF8_STRING")
-	case MIMEImage:
+	case FmtImage:
 		return readc("image/png")
 	}
 	return nil
@@ -74,12 +74,12 @@ func readc(t string) []byte {
 
 // write writes the given data to clipboard and
 // returns true if success or false if failed.
-func write(t MIMEType, buf []byte) (bool, <-chan struct{}) {
+func write(t Format, buf []byte) (bool, <-chan struct{}) {
 	var s string
 	switch t {
-	case MIMEText:
+	case FmtText:
 		s = "UTF8_STRING"
-	case MIMEImage:
+	case FmtImage:
 		s = "image/png"
 	}
 

clipboard_test.go

@@ -22,14 +22,14 @@ func TestClipboard(t *testing.T) {
 		if err != nil {
 			t.Fatalf("failed to read gold file: %v", err)
 		}
-		clipboard.Write(clipboard.MIMEImage, data)
+		clipboard.Write(clipboard.FmtImage, data)
 
-		b := clipboard.Read(clipboard.MIMEText)
+		b := clipboard.Read(clipboard.FmtText)
 		if b != nil {
 			t.Fatalf("read clipboard that stores image data as text should fail, but got len: %d", len(b))
 		}
 
-		b = clipboard.Read(clipboard.MIMEImage)
+		b = clipboard.Read(clipboard.FmtImage)
 		if b == nil {
 			t.Fatalf("read clipboard that stores image data as image should success, but got: nil")
 		}
@@ -41,13 +41,13 @@ func TestClipboard(t *testing.T) {
 
 	t.Run("text", func(t *testing.T) {
 		data := []byte("golang.design/x/clipboard")
-		clipboard.Write(clipboard.MIMEText, data)
+		clipboard.Write(clipboard.FmtText, data)
 
-		b := clipboard.Read(clipboard.MIMEImage)
+		b := clipboard.Read(clipboard.FmtImage)
 		if b != nil {
 			t.Fatalf("read clipboard that stores text data as image should fail, but got len: %d", len(b))
 		}
-		b = clipboard.Read(clipboard.MIMEText)
+		b = clipboard.Read(clipboard.FmtText)
 		if b == nil {
 			t.Fatal("read clipboard taht stores text data as text should success, but got: nil")
 		}
@@ -63,10 +63,10 @@ func TestClipboardMultipleWrites(t *testing.T) {
 	if err != nil {
 		t.Fatalf("failed to read gold file: %v", err)
 	}
-	chg := clipboard.Write(clipboard.MIMEImage, data)
+	chg := clipboard.Write(clipboard.FmtImage, data)
 
 	data = []byte("golang.design/x/clipboard")
-	clipboard.Write(clipboard.MIMEText, data)
+	clipboard.Write(clipboard.FmtText, data)
 
 	ctx, cancel := context.WithTimeout(context.Background(), time.Second*2)
 	defer cancel()
@@ -84,12 +84,12 @@ func TestClipboardMultipleWrites(t *testing.T) {
 		t.Fatalf("changed channel should be closed after receiving the notification")
 	}
 
-	b := clipboard.Read(clipboard.MIMEImage)
+	b := clipboard.Read(clipboard.FmtImage)
 	if b != nil {
 		t.Fatalf("read clipboard that should store text data as image should fail, but got: %d", len(b))
 	}
 
-	b = clipboard.Read(clipboard.MIMEText)
+	b = clipboard.Read(clipboard.FmtText)
 	if b == nil {
 		t.Fatalf("read clipboard that should store text data as text should success, got: nil")
 	}
@@ -107,8 +107,8 @@ func BenchmarkClipboard(b *testing.B) {
 		b.ReportAllocs()
 		b.ResetTimer()
 		for i := 0; i < b.N; i++ {
-			clipboard.Write(clipboard.MIMEText, data)
-			_ = clipboard.Read(clipboard.MIMEText)
+			clipboard.Write(clipboard.FmtText, data)
+			_ = clipboard.Read(clipboard.FmtText)
 		}
 	})
 }

clipboard_windows.go

@@ -9,12 +9,12 @@
 
 package clipboard
 
-func read(t MIMEType) (buf []byte) {
+func read(t Format) (buf []byte) {
 	panic("unsupported")
 }
 
 // write writes the given data to clipboard and
 // returns true if success or false if failed.
-func write(t MIMEType, buf []byte) bool {
+func write(t Format, buf []byte) (bool, <-chan struct{}) {
 	panic("unsupported")
 }

cmd/gclip/main.go

@@ -67,16 +67,16 @@ func main() {
 }
 
 func cpy() error {
-	t := clipboard.MIMEText
+	t := clipboard.FmtText
 	ext := filepath.Ext(*file)
 
 	switch ext {
 	case ".png":
-		t = clipboard.MIMEImage
+		t = clipboard.FmtImage
 	case ".txt":
 		fallthrough
 	default:
-		t = clipboard.MIMEText
+		t = clipboard.FmtText
 	}
 
 	var (
@@ -105,9 +105,9 @@ func cpy() error {
 func pst() (err error) {
 	var b []byte
 
-	b = clipboard.Read(clipboard.MIMEText)
+	b = clipboard.Read(clipboard.FmtText)
 	if b == nil {
-		b = clipboard.Read(clipboard.MIMEImage)
+		b = clipboard.Read(clipboard.FmtImage)
 	}
 
 	if *file != "" && b != nil {