imageproxy/data/data.go

// Package data provides common shared data structures for go-imageproxy.
package data

import (
	"fmt"
	"net/url"
	"strconv"
	"strings"
	"time"
)

// Options specifies transformations that can be performed on a
// requested image.
type Options struct {
	Width  int // requested width, in pixels
	Height int // requested height, in pixels

	// If true, resize the image to fit in the specified dimensions.  Image
	// will not be cropped, and aspect ratio will be maintained.
	Fit bool
}

func (o Options) String() string {
	return fmt.Sprintf("%dx%d", o.Width, o.Height)
}

func ParseOptions(str string) *Options {
	o := new(Options)
	var h, w string

	parts := strings.Split(str, ",")

	// parse size
	size := strings.SplitN(parts[0], "x", 2)
	w = size[0]
	if len(size) > 1 {
		h = size[1]
	} else {
		h = w
	}

	if w != "" {
		o.Width, _ = strconv.Atoi(w)
	}
	if h != "" {
		o.Height, _ = strconv.Atoi(h)
	}

	for _, part := range parts[1:] {
		if part == "fit" {
			o.Fit = true
		}
	}

	return o
}

type Request struct {
	URL     *url.URL // URL of the image to proxy
	Options *Options // Image transformation to perform
}

// Image represents a remote image that is being proxied.  It tracks where
// the image was originally retrieved from and how long the image can be cached.
type Image struct {
	// URL of original remote image.
	URL string

	// Expires is the cache expiration time for the original image, as
	// returned by the remote server.
	Expires time.Time

	// Etag returned from server when fetching image.
	Etag string

	// Bytes contains the actual image.
	Bytes []byte
}