README
¶
tawesoft/golib
A monorepo for small Go modules maintained by Tawesoft®. Open source (MIT).
This is modern code with generics, for go v1.19
Packages
| Name | /v2 | /v3 | Description |
|---|---|---|---|
| dialog | stable | - | cross-platform message boxes & file pickers |
| digraph | unstable | - | directed graphs (including DAGs) |
| drop | TODO | - | drop process privileges and inherit handles |
| fun/maybe | candidate | - | Maybe sum type |
| fun/partial | candidate | - | partial function application |
| fun/result | candidate | - | Result sum type |
| grace | TODO | - | start and gracefully shutdown processes |
| humanize | TODO | - | locale-aware parsing & formatting of times & quantities |
| iter | unstable | - | composable lazy iteration over sequences |
| ks | unstable | - | "kitchen sink" of misc helpful things |
| loader | unstable | - | concurrent dependency graph solver |
| must | candidate | - | assertions |
| numbers | unstable | - | helpful things for number types |
| text/ccc | candidate | - | Unicode Canonical Combining Class values |
| text/dm | candidate | - | Unicode decomposition mappings & selective decompositions |
| text/fallback | candidate | - | Unicode Character Fallback Substitutions |
| text/fold | candidate | - | selectively merge distinctions in Unicode text |
| view | unstable | - | dynamic views over collections |
Note: Additional v2/legacy packages exist for users migrating from
tawesoft.co.uk/go. See MIGRATIONS.md.
Note: Packages have the normal stability guarantees expected for a Go package of v2 or higher, except where marked "partial", "candidate", or "unstable". See MIGRATIONS.md for the meaning of other terms.
Support
Free and Community Support
Use the tawesoft/golib issue tracker, powered by GitHub issues.
Commercial Support
Open source software from Tawesoft® is backed by commercial support options. Email opensource@tawesoft.co.uk or visit tawesoft.co.uk/products/open-source-software to learn more.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package dialog implements native, cross-platform message boxes, yes/no/okay/cancel confirmation prompts, file pickers, and others.
|
Package dialog implements native, cross-platform message boxes, yes/no/okay/cancel confirmation prompts, file pickers, and others. |
|
Package digraph implements a directed graph (a "digraph") and related operations.
|
Package digraph implements a directed graph (a "digraph") and related operations. |
|
fun
|
|
|
maybe
Package maybe implements a Maybe{value, ok} "sum type" that has a value only when ok is true.
|
Package maybe implements a Maybe{value, ok} "sum type" that has a value only when ok is true. |
|
partial
Package partial provides helpers for partial function application.
|
Package partial provides helpers for partial function application. |
|
result
Package result implements a Result{value, error} "sum type" that has a value only when error is nil.
|
Package result implements a Result{value, error} "sum type" that has a value only when error is nil. |
|
internal
|
|
|
unicode/gen-13.0.0/ccc
Command gen.go generates Canonical Combining Class information
|
Command gen.go generates Canonical Combining Class information |
|
unicode/gen-13.0.0/dm
Command gen.go generates decomposition mappings from Unicode data.
|
Command gen.go generates decomposition mappings from Unicode data. |
|
unicode/gen-13.0.0/fallback
Command gen.go generates a mapping from the first character of a decomposition to an ordered list of codepoints whose decomposition starts with that first character.
|
Command gen.go generates a mapping from the first character of a decomposition to an ordered list of codepoints whose decomposition starts with that first character. |
|
unicode/gen-cldr-41.0/fallback
Command gen.go generates a list of Unicode fallback substitutions
|
Command gen.go generates a list of Unicode fallback substitutions |
|
Package lazy implements lazy evaluation (strictly typed with Go generics).
|
Package lazy implements lazy evaluation (strictly typed with Go generics). |
|
Package ks ("kitchen sink") implements assorted helpful things that don't fit anywhere else.
|
Package ks ("kitchen sink") implements assorted helpful things that don't fit anywhere else. |
|
legacy
|
|
|
humanize
Package humanize is an elegant, general-purpose, extensible, modular, locale-aware way to format and parse numbers and quantities - like distances, bytes, and time - in a human-readable way ideal for config files and as a building-block for fully translated ergonomic user interfaces.
|
Package humanize is an elegant, general-purpose, extensible, modular, locale-aware way to format and parse numbers and quantities - like distances, bytes, and time - in a human-readable way ideal for config files and as a building-block for fully translated ergonomic user interfaces. |
|
humanize/_examples/custom-durations
Example leveraging the raw parts of FormatParts to handle durations in a custom even nicer way for the english language.
|
Example leveraging the raw parts of FormatParts to handle durations in a custom even nicer way for the english language. |
|
humanize/_examples/custom-factors
Example using custom time factors from the Battlestar Galactica 1978 TV series.
|
Example using custom time factors from the Battlestar Galactica 1978 TV series. |
|
humanize/_examples/simple
Example formatting and parsing Byte quantities in various locales
|
Example formatting and parsing Byte quantities in various locales |
|
localize
Package localize is an attempt at implementing locale-aware parsing of numbers, integrating with golang.org/x/text.
|
Package localize is an attempt at implementing locale-aware parsing of numbers, integrating with golang.org/x/text. |
|
operator
Package operator implements logical, arithmetic, bitwise and comparison operators as functions (like the Python operator module).
|
Package operator implements logical, arithmetic, bitwise and comparison operators as functions (like the Python operator module). |
|
Package loader implements the ability to define a graph of tasks and dependencies that produce results, and solve the graph incrementally or totally, including concurrently.
|
Package loader implements the ability to define a graph of tasks and dependencies that produce results, and solve the graph incrementally or totally, including concurrently. |
|
Package must implements
|
Package must implements |
|
Package numbers implements assorted things that operate on numbers, such as generic access to limits, addition checked for integer overflow, and functions implementing builtin operators like addition so that they can be passed to higher order functions.
|
Package numbers implements assorted things that operate on numbers, such as generic access to limits, addition checked for integer overflow, and functions implementing builtin operators like addition so that they can be passed to higher order functions. |
|
text
|
|
|
ccc
Package ccc returns the Unicode [Canonical Combining Class] value for a codepoint.
|
Package ccc returns the Unicode [Canonical Combining Class] value for a codepoint. |
|
dm
Package dm provides a way to query Unicode decomposition mappings and perform a custom compatibility decomposition using [compatibility mapping tags].
|
Package dm provides a way to query Unicode decomposition mappings and perform a custom compatibility decomposition using [compatibility mapping tags]. |
|
fallback
Package fallback implements [Unicode Character Fallback Substitutions] using the Unicode CLDR 41.0 supplemental data file characters.xml, and an algorithm for enumerating every canonically equivalent string.
|
Package fallback implements [Unicode Character Fallback Substitutions] using the Unicode CLDR 41.0 supplemental data file characters.xml, and an algorithm for enumerating every canonically equivalent string. |
|
fold
Package fold implements operations that map similar characters to a common target.
|
Package fold implements operations that map similar characters to a common target. |
|
Package view provides customisable abstractions over collections.
|
Package view provides customisable abstractions over collections. |
Click to show internal directories.
Click to hide internal directories.