/golib

A core library of Go packages

Primary LanguageGoMIT LicenseMIT

A core library of Go packages

golib is a collection of Go packages that provide various helpful functions and types for many common use cases. It is designed with and for projects that follow the DRY, KISS and/or Unix principles to improve the reuse of code while reducing “Copy-and-paste programming“ and duplicated code as much as possible. The packages are created to be flexible for universal usage and composition for different use cases and environments.

Please always keep in mind that golib was mainly created for usage in my open source and personal projects! Even though this module follows the SemVer 2.0.0 specification and development of the provided packages take stability and backwards compatibility into account, there might be (possibly breaking) changes, at least while this module in SemVer major version zero. Also note that packages might be extracted into own modules if the scope exceeds the goal of golib. Such changes will be communicated by raising the Go module major version. Most packages are independent from each other and strive to depend on as few external packages as possible, but ensure that you're aware of the internal structure of the packages you're using.

Overview

This is an rough overview of the packages included in this module. Please refer to the individual package documentations for more details.

  • pkg/io/fs — provides I/O utility functions for filesystem interactions. Please note that it makes use of the underlying filesystem and only serves as additional utility for the os Go standard library package. For more advanced and extended features see packages like github.com/spf13/afero instead.
  • pkg/io/fs/filepath — provides utility functions for manipulating filename paths for the target operating system-defined file paths, using either forward slashes or backslashes. It extends the path/filepath Go standard library package with more utilities. Please note that some functions interact with the underlying filesystem through on-disk operations.
  • pkg/vcs — provides packages and utility functions to interact with version control systems.
    • pkg/vcs/git — provides VCS utility functions to interact with Git repositories.

Contributing

golib is an open source project and contributions are always welcome!

There are many ways to contribute, from writing- and improving documentation and tutorials, reporting bugs, submitting enhancement suggestions that can be added to golib by submitting pull requests.

Please take a moment to read the contributing guide to learn about the development process, the styleguides to which this project adheres as well as the branch organization and versioning model.

The guide also includes information about minimal, complete, and verifiable examples and other ways to contribute to the project like improving existing issues and giving feedback on issues and pull requests.

Copyright © 2020-present Sven Greb