Fix formatting of go DESCR files. Some of the contents still leave a lot to be
desired.
This commit is contained in:
parent
c70530d870
commit
92e3e961e6
35 changed files with 164 additions and 71 deletions
|
@ -2,4 +2,6 @@ Go client for etcd.
|
|||
|
||||
etcd now has an official Go client, which has a nicer API and better support.
|
||||
|
||||
We strongly suggest you use the official Go client instead of go-etcd in your new projects. For existing projects, we suggest you migrate to the official Go client.
|
||||
We strongly suggest you use the official Go client instead of go-etcd in your
|
||||
new projects. For existing projects, we suggest you migrate to the official Go
|
||||
client.
|
||||
|
|
|
@ -1,7 +1,17 @@
|
|||
Afero is an filesystem framework providing a simple, uniform and universal API interacting with any filesystem, as an abstraction layer providing interfaces, types and methods. Afero has an exceptionally clean interface and simple design without needless constructors or initialization methods.
|
||||
Afero is an filesystem framework providing a simple, uniform and universal API
|
||||
interacting with any filesystem, as an abstraction layer providing interfaces,
|
||||
types and methods. Afero has an exceptionally clean interface and simple design
|
||||
without needless constructors or initialization methods.
|
||||
|
||||
Afero is also a library providing a base set of interoperable backend filesystems that make it easy to work with afero while retaining all the power and benefit of the os and ioutil packages.
|
||||
Afero is also a library providing a base set of interoperable backend
|
||||
filesystems that make it easy to work with afero while retaining all the power
|
||||
and benefit of the os and ioutil packages.
|
||||
|
||||
Afero provides significant improvements over using the os package alone, most notably the ability to create mock and testing filesystems without relying on the disk.
|
||||
Afero provides significant improvements over using the os package alone, most
|
||||
notably the ability to create mock and testing filesystems without relying on
|
||||
the disk.
|
||||
|
||||
It is suitable for use in a any situation where you would consider using the OS package as it provides an additional abstraction that makes it easy to use a memory backed file system during testing. It also adds support for the http filesystem for full interoperability.
|
||||
It is suitable for use in a any situation where you would consider using the OS
|
||||
package as it provides an additional abstraction that makes it easy to use a
|
||||
memory backed file system during testing. It also adds support for the http
|
||||
filesystem for full interoperability.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Amber is an elegant templating engine for Go Programming Language It is inspired from HAML and Jade
|
||||
Amber is an elegant templating engine for Go Programming Language. It is
|
||||
inspired from HAML and Jade
|
||||
|
|
|
@ -1,5 +1,9 @@
|
|||
Blackfriday is a Markdown processor implemented in Go. It is paranoid about its input (so you can safely feed it user-supplied data), it is fast, it supports common extensions (tables, smart punctuation substitutions, etc.), and it is safe for all utf-8 (unicode) input.
|
||||
Blackfriday is a Markdown processor implemented in Go. It is paranoid about its
|
||||
input (so you can safely feed it user-supplied data), it is fast, it supports
|
||||
common extensions (tables, smart punctuation substitutions, etc.), and it is
|
||||
safe for all utf-8 (unicode) input.
|
||||
|
||||
HTML output is currently supported, along with Smartypants extensions. An experimental LaTeX output engine is also included.
|
||||
HTML output is currently supported, along with Smartypants extensions. An
|
||||
experimental LaTeX output engine is also included.
|
||||
|
||||
It started as a translation from C of Sundown.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Buffruneio is a wrapper around bufio to provide buffered runes access with unlimited unreads.
|
||||
Buffruneio is a wrapper around bufio to provide buffered runes access with
|
||||
unlimited unreads.
|
||||
|
|
|
@ -1,3 +1 @@
|
|||
Easy and safe casting from one type to another in Go
|
||||
|
||||
Don’t Panic! ... Cast
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Cobra is both a library for creating powerful modern CLI applications as well as a program to generate applications and command files.
|
||||
Cobra is both a library for creating powerful modern CLI applications as well
|
||||
as a program to generate applications and command files.
|
||||
|
|
|
@ -1,3 +1,4 @@
|
|||
This package provides the consulapi package which attempts to provide programmatic access to the full Consul API.
|
||||
This package provides the consulapi package which attempts to provide
|
||||
programmatic access to the full Consul API.
|
||||
|
||||
Currently, all of the Consul APIs included in version 0.4 are supported.
|
||||
|
|
|
@ -6,4 +6,7 @@ if err != nil {
|
|||
return err
|
||||
}
|
||||
|
||||
which applied recursively up the call stack results in error reports without context or debugging information. The errors package allows programmers to add context to the failure path in their code in a way that does not destroy the original value of the error.
|
||||
which applied recursively up the call stack results in error reports without
|
||||
context or debugging information. The errors package allows programmers to add
|
||||
context to the failure path in their code in a way that does not destroy the
|
||||
original value of the error.
|
||||
|
|
|
@ -1,3 +1,6 @@
|
|||
A fairly fast way to create a map from all the filenames to info objects for a given revision of a Git repo.
|
||||
A fairly fast way to create a map from all the filenames to info objects for a
|
||||
given revision of a Git repo.
|
||||
|
||||
This library uses os/exec to talk to Git. There are faster ways to do this by using some Go Git-lib or C bindings, but that adds dependencies I really don't want or need.
|
||||
This library uses os/exec to talk to Git. There are faster ways to do this by
|
||||
using some Go Git-lib or C bindings, but that adds dependencies I really don't
|
||||
want or need.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
This provides the lru package which implements a fixed-size thread safe LRU cache. It is based on the cache in Groupcache.
|
||||
This provides the lru package which implements a fixed-size thread safe LRU
|
||||
cache. It is based on the cache in Groupcache.
|
||||
|
|
|
@ -2,7 +2,10 @@ goorgeous is a Go Org to HTML Parser.
|
|||
|
||||
Pronounced: Go? Org? Yes!
|
||||
|
||||
"Org mode is for keeping notes, maintaining TODO lists, planning projects, and authoring documents with a fast and effective plain-text system."
|
||||
"Org mode is for keeping notes, maintaining TODO lists, planning projects,
|
||||
and authoring documents with a fast and effective plain-text system."
|
||||
orgmode.org
|
||||
|
||||
The purpose of this package is to come as close as possible as parsing an *.org document into HTML, the same way one might publish with org-publish-html from Emacs.
|
||||
The purpose of this package is to come as close as possible as parsing an
|
||||
*.org document into HTML, the same way one might publish with org-publish-html
|
||||
from Emacs.
|
||||
|
|
|
@ -1,5 +1,12 @@
|
|||
This is a Go library for detecting the user's home directory without the use of cgo, so the library can be used in cross-compilation environments.
|
||||
This is a Go library for detecting the user's home directory without the use of
|
||||
cgo, so the library can be used in cross-compilation environments.
|
||||
|
||||
Usage is incredibly simple, just call homedir.Dir() to get the home directory for a user, and homedir.Expand() to expand the ~ in a path to the home directory.
|
||||
Usage is incredibly simple, just call homedir.Dir() to get the home directory
|
||||
for a user, and homedir.Expand() to expand the ~ in a path to the home
|
||||
directory.
|
||||
|
||||
Why not just use os/user? The built-in os/user package requires cgo on Darwin systems. This means that any Go code that uses that package cannot cross compile. But 99% of the time the use for os/user is just to retrieve the home directory, which we can do for the current user without cgo. This library does that, enabling cross-compilation.
|
||||
Why not just use os/user? The built-in os/user package requires cgo on Darwin
|
||||
systems. This means that any Go code that uses that package cannot cross
|
||||
compile. But 99% of the time the use for os/user is just to retrieve the home
|
||||
directory, which we can do for the current user without cgo. This library does
|
||||
that, enabling cross-compilation.
|
||||
|
|
|
@ -1,8 +1,9 @@
|
|||
go-i18n is a Go package and a command that helps you translate Go programs into multiple languages.
|
||||
|
||||
Supports pluralized strings for all 200+ languages in the Unicode Common Locale Data Repository (CLDR).
|
||||
Code and tests are automatically generated from CLDR data
|
||||
Supports strings with named variables using text/template syntax.
|
||||
Translation files are simple JSON, TOML or YAML.
|
||||
Documented and tested!
|
||||
go-i18n is a Go package and a command that helps you translate Go programs into
|
||||
multiple languages.
|
||||
|
||||
* Supports pluralized strings for all 200+ languages in the Unicode Common
|
||||
Locale Data Repository (CLDR).
|
||||
* Code and tests are automatically generated from CLDR data
|
||||
* Supports strings with named variables using text/template syntax.
|
||||
* Translation files are simple JSON, TOML or YAML.
|
||||
* Documented and tested!
|
||||
|
|
|
@ -1,11 +1,15 @@
|
|||
Provides the iradix package that implements an immutable radix tree. The package only provides a single Tree implementation, optimized for sparse nodes.
|
||||
Provides the iradix package that implements an immutable radix tree. The
|
||||
package only provides a single Tree implementation, optimized for sparse nodes.
|
||||
|
||||
As a radix tree, it provides the following:
|
||||
|
||||
O(k) operations. In many cases, this can be faster than a hash table since the hash function is an O(k) operation, and hash tables have very poor cache locality.
|
||||
Minimum / Maximum value lookups
|
||||
Ordered iteration
|
||||
* O(k) operations. In many cases, this can be faster than a hash table since
|
||||
the hash function is an O(k) operation, and hash tables have very poor cache
|
||||
locality.
|
||||
* Minimum / Maximum value lookups
|
||||
* Ordered iteration
|
||||
|
||||
A tree supports using a transaction to batch multiple updates (insert, delete) in a more efficient manner than performing each operation one at a time.
|
||||
A tree supports using a transaction to batch multiple updates (insert, delete)
|
||||
in a more efficient manner than performing each operation one at a time.
|
||||
|
||||
For a mutable variant, see go-radix.
|
||||
|
|
|
@ -1,19 +1,23 @@
|
|||
jWalterWeatherman
|
||||
|
||||
Seamless printing to the terminal (stdout) and logging to a io.Writer (file) that’s as easy to use as fmt.Println.
|
||||
Seamless printing to the terminal (stdout) and logging to a io.Writer (file)
|
||||
that's as easy to use as fmt.Println.
|
||||
|
||||
JWW is primarily a wrapper around the excellent standard log library. It provides a few advantages over using the standard log library alone.
|
||||
JWW is primarily a wrapper around the excellent standard log library. It
|
||||
provides a few advantages over using the standard log library alone.
|
||||
|
||||
1. Ready to go out of the box.
|
||||
2. One library for both printing to the terminal and logging (to files).
|
||||
3. Really easy to log to either a temp file or a file you specify.
|
||||
|
||||
I really wanted a very straightforward library that could seamlessly do the following things.
|
||||
I really wanted a very straightforward library that could seamlessly do the
|
||||
following things.
|
||||
|
||||
1. Replace all the println, printf, etc statements thought my code with something more useful
|
||||
1. Replace all the println, printf, etc statements thought my code with
|
||||
something more useful
|
||||
2. Allow the user to easily control what levels are printed to stdout
|
||||
3. Allow the user to easily control what levels are logged
|
||||
4. Provide an easy mechanism (like fmt.Println) to print info to the user which can be easily logged as well
|
||||
4. Provide an easy mechanism (like fmt.Println) to print info to the user
|
||||
which can be easily logged as well
|
||||
5. Due to 2 & 3 provide easy verbose mode for output and logs
|
||||
6. Not have any unnecessary initialization cruft. Just use it.
|
||||
|
||||
|
|
|
@ -1,3 +1,8 @@
|
|||
mapstructure is a Go library for decoding generic map values to structures and vice versa, while providing helpful error handling.
|
||||
mapstructure is a Go library for decoding generic map values to structures and
|
||||
vice versa, while providing helpful error handling.
|
||||
|
||||
This library is most useful when decoding values from some data stream (JSON, Gob, etc.) where you don't quite know the structure of the underlying data until you read a part of it. You can therefore read a map[string]interface{} and use this library to decode it into the proper underlying native Go structure.
|
||||
This library is most useful when decoding values from some data stream (JSON,
|
||||
Gob, etc.) where you don't quite know the structure of the underlying data
|
||||
until you read a part of it. You can therefore read a map[string]interface{}
|
||||
and use this library to decode it into the proper underlying native Go
|
||||
structure.
|
||||
|
|
|
@ -1 +1,3 @@
|
|||
Nitro is a quick and easy performance analyzer library for golang. It is useful for comparing A/B against different drafts of functions or different functions.
|
||||
Nitro is a quick and easy performance analyzer library for golang. It is
|
||||
useful for comparing A/B against different drafts of functions or different
|
||||
functions.
|
||||
|
|
|
@ -1,7 +1,11 @@
|
|||
Extensions to the "os" package.
|
||||
Find the current Executable and ExecutableFolder.
|
||||
|
||||
There is sometimes utility in finding the current executable file that is running. This can be used for upgrading the current executable or finding resources located relative to the executable file. Both working directory and the os.Args[0] value are arbitrary and cannot be relied on; os.Args[0] can be "faked".
|
||||
There is sometimes utility in finding the current executable file that is
|
||||
running. This can be used for upgrading the current executable or finding
|
||||
resources located relative to the executable file. Both working directory and
|
||||
the os.Args[0] value are arbitrary and cannot be relied on; os.Args[0] can be
|
||||
"faked".
|
||||
|
||||
Multi-platform and supports:
|
||||
|
||||
|
|
|
@ -1,5 +1,9 @@
|
|||
pflag is a drop-in replacement for Go's flag package, implementing POSIX/GNU-style --flags.
|
||||
pflag is a drop-in replacement for Go's flag package, implementing
|
||||
POSIX/GNU-style --flags.
|
||||
|
||||
pflag is compatible with the GNU extensions to the POSIX recommendations for command-line options. For a more precise description, see the "Command-line flag syntax" section below.
|
||||
pflag is compatible with the GNU extensions to the POSIX recommendations for
|
||||
command-line options. For a more precise description, see the "Command-line
|
||||
flag syntax" section below.
|
||||
|
||||
pflag is available under the same style of BSD license as the Go language, which can be found in the LICENSE file.
|
||||
pflag is available under the same style of BSD license as the Go language,
|
||||
which can be found in the LICENSE file.
|
||||
|
|
|
@ -1,11 +1,20 @@
|
|||
properties is a Go library for reading and writing properties files.
|
||||
|
||||
It supports reading from multiple files or URLs and Spring style recursive property expansion of expressions like ${key} to their corresponding value. Value expressions can refer to other keys like in ${key} or to environment variables like in ${USER}. Filenames can also contain environment variables like in /home/${USER}/myapp.properties.
|
||||
It supports reading from multiple files or URLs and Spring style recursive
|
||||
property expansion of expressions like ${key} to their corresponding value.
|
||||
Value expressions can refer to other keys like in ${key} or to environment
|
||||
variables like in ${USER}. Filenames can also contain environment variables
|
||||
like in /home/${USER}/myapp.properties.
|
||||
|
||||
Properties can be decoded into structs, maps, arrays and values through struct tags.
|
||||
Properties can be decoded into structs, maps, arrays and values through struct
|
||||
tags.
|
||||
|
||||
Comments and the order of keys are preserved. Comments can be modified and can be written to the output.
|
||||
Comments and the order of keys are preserved. Comments can be modified and can
|
||||
be written to the output.
|
||||
|
||||
The properties library supports both ISO-8859-1 and UTF-8 encoded data.
|
||||
|
||||
Starting from version 1.3.0 the behavior of the MustXXX() functions is configurable by providing a custom ErrorHandler function. The default has changed from panic to log.Fatal but this is configurable and custom error handling functions can be provided. See the package documentation for details.
|
||||
Starting from version 1.3.0 the behavior of the MustXXX() functions is
|
||||
configurable by providing a custom ErrorHandler function. The default has
|
||||
changed from panic to log.Fatal but this is configurable and custom error
|
||||
handling functions can be provided. See the package documentation for details.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Purell is a tiny Go library to normalize URLs. It returns a pure URL. Pure-ell. Sanitizer and all. Yeah, I know...
|
||||
Purell is a tiny Go library to normalize URLs. It returns a pure URL. Pure-ell.
|
||||
Sanitizer and all. Yeah, I know...
|
||||
|
|
|
@ -1,5 +1,7 @@
|
|||
Package sanitized_anchor_name provides a func to create sanitized anchor names.
|
||||
|
||||
Its logic can be reused by multiple packages to create interoperable anchor names and links to those anchors.
|
||||
Its logic can be reused by multiple packages to create interoperable anchor
|
||||
names and links to those anchors.
|
||||
|
||||
At this time, it does not try to ensure that generated anchor names are unique, that responsibility falls on the caller.
|
||||
At this time, it does not try to ensure that generated anchor names are unique,
|
||||
that responsibility falls on the caller.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Package shuffle provides primitives for shuffling slices and user-defined collections.
|
||||
Package shuffle provides primitives for shuffling slices and user-defined
|
||||
collections.
|
||||
|
|
|
@ -1,5 +1,10 @@
|
|||
HCL (HashiCorp Configuration Language) is a configuration language built by HashiCorp. The goal of HCL is to build a structured configuration language that is both human and machine friendly for use with command-line tools, but specifically targeted towards DevOps tools, servers, etc.
|
||||
HCL (HashiCorp Configuration Language) is a configuration language built by
|
||||
HashiCorp. The goal of HCL is to build a structured configuration language that
|
||||
is both human and machine friendly for use with command-line tools, but
|
||||
specifically targeted towards DevOps tools, servers, etc.
|
||||
|
||||
HCL is also fully JSON compatible. That is, JSON can be used as completely valid input to a system expecting HCL. This helps makes systems interoperable with other systems.
|
||||
HCL is also fully JSON compatible. That is, JSON can be used as completely
|
||||
valid input to a system expecting HCL. This helps makes systems interoperable
|
||||
with other systems.
|
||||
|
||||
HCL is heavily inspired by libucl, nginx configuration, and others similar.
|
||||
|
|
|
@ -1,4 +1,3 @@
|
|||
A statistics package with many functions missing from the Golang standard library. See the CHANGELOG.md for API changes and tagged releases you can vendor into your projects.
|
||||
|
||||
Statistics are used much like a drunk uses a lamppost: for support, not illumination. - Vin Scully
|
||||
|
||||
A statistics package with many functions missing from the Golang standard
|
||||
library. See the CHANGELOG.md for API changes and tagged releases you can
|
||||
vendor into your projects.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
The Gorilla WebSocket package provides a complete and tested implementation of the WebSocket protocol. The package API is stable.
|
||||
The Gorilla WebSocket package provides a complete and tested implementation of
|
||||
the WebSocket protocol. The package API is stable.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
The sftp package provides support for file system operations on remote ssh servers using the SFTP subsystem.
|
||||
The sftp package provides support for file system operations on remote ssh
|
||||
servers using the SFTP subsystem.
|
||||
|
|
|
@ -1,10 +1,10 @@
|
|||
go-md2man
|
||||
|
||||
** Work in Progress ** This still needs a lot of help to be complete, or even usable!
|
||||
** Work in Progress ** This still needs a lot of help to be complete, or even
|
||||
usable!
|
||||
|
||||
Uses blackfriday to process markdown into man pages.
|
||||
|
||||
Usage
|
||||
|
||||
./md2man -in /path/to/markdownfile.md -out /manfile/output/path
|
||||
|
||||
|
|
|
@ -1 +1,3 @@
|
|||
Mmark is a powerful markdown processor Go geared towards writing IETF document.s It is, however, also suited for writing books and other technical documentation.
|
||||
Mmark is a powerful markdown processor Go geared towards writing IETF
|
||||
documents. It is, however, also suited for writing books and other technical
|
||||
documentation.
|
||||
|
|
|
@ -1 +1,4 @@
|
|||
prose is Go library for text (primarily English at the moment) processing that supports tokenization, part-of-speech tagging, named-entity extraction, and more. The library's functionality is split into subpackages designed for modular use. See the documentation for more information.
|
||||
prose is Go library for text (primarily English at the moment) processing that
|
||||
supports tokenization, part-of-speech tagging, named-entity extraction, and
|
||||
more. The library's functionality is split into subpackages designed for
|
||||
modular use. See the documentation for more information.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
Ace is an HTML template engine for Go. This is inspired by Slim and Jade. This is a refinement of Gold.
|
||||
Ace is an HTML template engine for Go. This is inspired by Slim and Jade. This
|
||||
is a refinement of Gold.
|
||||
|
|
|
@ -1 +1,2 @@
|
|||
GoHTML is an HTML formatter for Go. You can format HTML source codes by using this package.
|
||||
GoHTML is an HTML formatter for Go. You can format HTML source codes by using
|
||||
this package.
|
||||
|
|
|
@ -1 +1,5 @@
|
|||
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a reflection interface similar to Go's standard library json and xml packages. This package also supports the encoding.TextUnmarshaler and encoding.TextMarshaler interfaces so that you can define custom data representations.
|
||||
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a
|
||||
reflection interface similar to Go's standard library json and xml packages.
|
||||
This package also supports the encoding.TextUnmarshaler and
|
||||
encoding.TextMarshaler interfaces so that you can define custom data
|
||||
representations.
|
||||
|
|
|
@ -1 +1,5 @@
|
|||
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a reflection interface similar to Go's standard library json and xml packages. This package also supports the encoding.TextUnmarshaler and encoding.TextMarshaler interfaces so that you can define custom data representations.
|
||||
TOML stands for Tom's Obvious, Minimal Language. This Go package provides a
|
||||
reflection interface similar to Go's standard library json and xml packages.
|
||||
This package also supports the encoding.TextUnmarshaler and
|
||||
encoding.TextMarshaler interfaces so that you can define custom data
|
||||
representations.
|
||||
|
|
Loading…
Reference in a new issue