TODO: write godoc. It is expected that context cancellation will be honored (i.e. return if the context has an error or its done channel is closed), a

ItemClassByExtension uses the file extension to return a best-guess item classification. It returns false if no matching classification could be found

Message updates the current job message or status to show the user.

SetKey sets the retrieval key for this item. It should be a globally unique value; note that other data sources may collaborate on the same item if th

directoryEmpty returns true if dirPath is an empty directory except for some common, but non-critical, OS files. If false, the name of the first disco

fileIDToPath converts a fileID (the checksum by which it is organized in the backup) to the absolute path it can be accessed on disk. The return value

fileIDToRelativePath returns the path to the file relative to the root folder of the backup. The term "relative path" here is NOT the same as the "rel

sanitizeFlag turns a flag string like "--foo-bar" into "foo_bar"; i.e. it strips the flag prefix and standardizes its format.

splitCamelCaseIntoWords splits camel-cased strings into words by inserting spaces at the most sensible places. This algorithm isn't perfect as it does

userHomeDir returns the best guess of the user's home directory, or "." (current directory) if the home directory is unknown (to make it safe to use i

AddMetadata adds meta to the item's metadata with the given merge policy.

ConnectMotionPhoto connects a motion photo for the item represented by ig, at path pictureFile in the fsys, if one exists. It looks for sidecars and e

Contains returns true if the circle approximately contains the given coordinate.

Continue should be called by all job actions frequently, typically at the beginning of their main loop (and any longer-running inner loops). It blocks

FromEntityWithValue connects entity to g with a relation that has the given value.

* Motion pictures ("live photos" and similar) are little videos that some cameras take along with a still capture. This is a well-known feature of G

NormalizePhoneNumber attempts to parse number and returns a standardized version in E164 format. If the number does not have an explicit region/countr

Obfuscate returns obfuscated lat/lon values.

Progress updates the progress of the job in the DB by adding delta, which is work completed since the previous update, towards the expected total. Thi

func (a App) AddAccount(repoID string, dataSourceID string, auth bool, dsOpt json.RawMessage) (timeline.Account, error) { tl, err := getOpenTimeline(

Serve serves the application server only if it is not already running (possibly in another process). It returns true if it started the application ser

autoType returns the value of str in its JSON type.

filenameHasJSONExtAndContains returns true if filename has a ".json" extension and contains one of the strings in the list.

match returns a mapping of canonical field names to the matched column indices of the header row.

openFile opens a file given its domain and path. The manifest DB maps domain+path to file ID. We look up the file ID from the manifest and then use th

optimizeDB runs ANALYZE on the database. It can be very slow. Recommended to run in a goroutine.

scanItemRow reads an item from row and returns the structured ItemRow. The item must have been queried to select all of itemDBColumns. It scans column

sqlArray builds a placeholder array for SQL queries that will have all the row IDs in it, e.g. "(?, ?, ?)" for use with 'IN' clauses, returning the ar

Checkpoint creates a checkpoint and syncs the job state with the database. When creating a checkpoint, the total, progress, and message data should be

CocoaNanoToTime converts Apple timestamp in nanoseconds to a normal timestamp.

CocoaSecondsToTime converts Apple timestamp in seconds to a normal timestamp.

CreateJob creates and runs a job described by action, with an estimated total units of work, to be repeated after a certain interval (if > 0). If an i

DefaultConfigFilePath returns the file path where configuration is persisted.

DownloadData returns a function that opens the response body for the given url.

FloatStringToIntE7 is the same thing as FloatToIntE7, but takes a string representation of a float as input.

GetContentType returns the Content-Type of the endpoint considering its default of JSON if method is POST, PUT, PATCH, or DELETE.

NormalizePhoneNumber tries to NormalizePhoneNumber the ID (phone number), and simply returns the input if it fails.

ParseBirthday parses bday in one of these formats: - "--MMDD" (year is omitted, and as such, the Unix timestamp of the date will compute to be over 2

TODO: Standardize these function names. It's Core Data API, Cocoa Epoch. ParseCocoaDate converts a date represented by a string of the decimal number

Set the total size of the job in the DB. Ideally, this should only be set once the total size is properly known, not accumulated as you go, since prog

Size returns the number of bytes written, not including the response headers.

WriteHeader writes the headers with statusCode to the wrapped ResponseWriter unless the response is to be buffered instead. 1xx responses are never bu

TODO: favorites? or maybe a more flexible albums/lists feature? what to call it... "scrapbooks" or "curations"?

entityFromSenderCiteTag returns the entity described by the given selection, which should be a <cite class="sender"> tag.

flagValPairs parses args and associates flags with their values.

haversineDistanceEarth computes the great-circle distance in kilometers between two points on Earth. The latitude and longitude values must be integer

homeDirUnsafe is a low-level function that returns the user's home directory from environment variables. Careful: if it cannot be determined, an empty

id returns either the item ID or the attribute ID, whichever is set.

identifyingAttributeID returns either the known row ID of the attribute identifying the entity, or it will create a pass-thru attribute for the entity

isNil returns true if v is nil. It returns true even if v is a non-nil interface (has a type) which has a nil value.

isoIEC14496Timestamp converts the number of seconds since January 1, 1904 (as defined by ISO/IEC 14496-12 5th Edition [2015], page 23) to a normal tim