simple

Documentation

Overview

Package simple provides functions for handling string or integer input data.

Index

• Constants
• Variables
• func AssetSrc(abs, dir, unid, ext string) string
• func BytesHuman(i int64) string
• func DemozooGetLink(filename, filesize, demozoo, unid any) template.HTML
• func DownloadB(i any) template.HTML
• func ImageSample(unid, previewDir string) template.HTML
• func ImageSampleStat(unid, previewDir string) bool
• func ImageXY(name string) [2]string
• func LinkID(id any, elem string) (string, error)
• func LinkPreviewTip(name, platform string) string
• func LinkRelations(val string) template.HTML
• func LinkRelr(name string) (string, error)
• func LinkSites(val string) template.HTML
• func MIME(name string) string
• func MagicAsTitle(name string) string
• func MakeLink(name, class string, performant bool) (string, error)
• func MkContent(src string) string
• func ReleaserPair(a, b any) [2]string
• func Releasers(prime, second string, magazine bool) template.HTML
• func Screenshot(unid, desc, previewDir string) template.HTML
• func StatHumanize(name string) (string, string, string)
• func Thumb(unid, desc, thumbDir string, bottom bool) template.HTML
• func ThumbSample(unid, thumbDir string) template.HTML
• func Updated(t any, s string) string

Constants

const (
	YYYYMMDD = "2006-Jan-02"
)

Variables

var (
	ErrLinkType = errors.New("the id value is an invalid type")
	ErrNegative = errors.New("value cannot be a negative number")
)

Functions

func AssetSrc

func AssetSrc(abs, dir, unid, ext string) string

ArtifactSrc returns a URL to an artifact asset with an cache busting hash. The named dir is the directory where the asset is stored, the unid is the unique identifier of the asset and the ext is the file extension of the expected asset.

func BytesHuman

func BytesHuman(i int64) string

BytesHuman returns the file size for the file record.

func DemozooGetLink

func DemozooGetLink(filename, filesize, demozoo, unid any) template.HTML

DemozooGetLink returns a HTML link to the Demozoo download links.

func DownloadB

func DownloadB(i any) template.HTML

DownloadB returns a human readable string of the file size.

func ImageSample

func ImageSample(unid, previewDir string) template.HTML

ImageSample returns a HTML image tag for the given unid.

func ImageSampleStat

func ImageSampleStat(unid, previewDir string) bool

ImageSampleStat returns true if the image sample file exists and is not a 0 byte file.

func ImageXY

func ImageXY(name string) [2]string

ImageXY returns the image file size and dimensions.

func LinkID

func LinkID(id any, elem string) (string, error)

LinkID creates a URL to link to the record. The id is obfuscated to prevent direct linking. The elem is the element to link to, such as 'f' for file or 'd' for download.

func LinkPreviewTip

func LinkPreviewTip(name, platform string) string

LinkPreviewTip returns a tooltip to describe the preview link.

func LinkRelations

func LinkRelations(val string) template.HTML

LinkRelations returns a collection of HTML anchor links that point to artifacts.

The val string is a list of artifact descriptions and their URL ID separated by a semicolon ";". Multiple artifact entries are separated by a pipe "|".

For example, "NFO;9f1c2|Intro;a92116e".

func LinkRelr

func LinkRelr(name string) (string, error)

LinkRelr returns a link to the named group page.

func LinkSites

func LinkSites(val string) template.HTML

LinkSites returns a collection of HTML anchor links that point to websites.

The val string is a list of website descriptions and their URL ID separated by a semicolon ";". Multiple website entries are separated by a pipe "|".

For example, "Site;example.com|Documentation;example.com/doc".

func MIME

func MIME(name string) string

MIME returns the MIME type for the named file.

func MagicAsTitle

func MagicAsTitle(name string) string

MagicAsTitle returns the magic number description for the named file.

func MakeLink

func MakeLink(name, class string, performant bool) (string, error)

MakeLink returns a HTML anchor link to the named group page. When the performant flag is false, the link will apply additional typography to the group name. But this should not be used for large lists of links as it will significantly slow down the page rendering.

For example supplying the name "tport"

• with performant false will return a link displaying "tPORt"
• with performant true will return a link displaying "Tport"

func MkContent

func MkContent(src string) string

MkContent makes and/or returns a distinct directory path in the temp directory that is used to extract the contents of the content of the file download archive. To make the directory distinct it is prefixed with the basename of the src file.

func ReleaserPair

func ReleaserPair(a, b any) [2]string

ReleaserPair returns the primary and secondary releaser groups as two strings.

func Releasers

func Releasers(prime, second string, magazine bool) template.HTML

Releasers returns a HTML links for the primary and secondary group names.

func Screenshot

func Screenshot(unid, desc, previewDir string) template.HTML

Screenshot returns a picture elment with screenshots for the given unid. The unid is the filename of the screenshot image without an extension. The desc is the description of the image used for the alt attribute in the img tag. Supported formats are webp, png, jpg and avif.

func StatHumanize

func StatHumanize(name string) (string, string, string)

StatHumanize returns the last modified date, size in bytes and size formatted of the named file.

func Thumb

func Thumb(unid, desc, thumbDir string, bottom bool) template.HTML

Thumb returns a HTML image tag or picture element for the given unid. The unid is the filename of the thumbnail image without an extension. The desc is the description of the image.

func ThumbSample

func ThumbSample(unid, thumbDir string) template.HTML

ThumbSample returns a HTML image tag for the given unid.

func Updated

func Updated(t any, s string) string

Updated returns a string of the time since the given time t. The time is formatted as "Last updated 1 hour ago". If the time is not valid, an empty string is returned.