initial commit

.travis.yml

@@ -0,0 +1,28 @@
+language: go
+go:
+  - "1.13.x"
+  - "1.14.x"
+  - "1.x"
+
+env:
+  - GO111MODULE=on GOFLAGS=-mod=readonly GOPROXY=https://proxy.golang.org
+
+cache:
+  directories:
+    - $GOPATH/pkg/mod
+
+before_install:
+  - curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $GOPATH/bin
+  - go mod download
+  - go get github.com/mattn/goveralls
+
+script:
+  - golangci-lint run ./...
+  - go vet ./...
+  - go test -covermode=count -coverprofile=profile.cov ./...
+  - goveralls -coverprofile=profile.cov -service=travis-ci
+
+notifications:
+  email:
+    on_success: never
+    on_failure: always

CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at [email protected]. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Nicholas Wiersma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1 @@
+include github.com/hamba/make/golang

README.md

@@ -0,0 +1,75 @@
+![Logo](http://svg.wiersma.co.za/hamba/project?title=slices&tag=Slice%20helper%20functions)
+
+[![Go Report Card](https://goreportcard.com/badge/github.com/hamba/slices)](https://goreportcard.com/report/github.com/hamba/slices)
+[![Build Status](https://travis-ci.com/hamba/slices.svg?branch=master)](https://travis-ci.com/hamba/slices)
+[![Coverage Status](https://coveralls.io/repos/github/hamba/slices/badge.svg?branch=master)](https://coveralls.io/github/hamba/slices?branch=master)
+[![GoDoc](https://godoc.org/github.com/hamba/slices?status.svg)](https://godoc.org/github.com/hamba/slices)
+[![GitHub release](https://img.shields.io/github/release/hamba/slices.svg)](https://github.com/hamba/slices/releases)
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/hamba/slices/master/LICENSE)
+
+A fast Go slices codec
+
+## Overview
+
+Install with:
+
+```shell
+go get github.com/hamba/slices
+```
+
+## Usage
+
+### Contains
+
+Contains is a generic slice contains function.
+
+Supports: bool, string, int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64
+
+```go
+slice := []string{"foo", "bar"}
+v := "bar"
+
+fmt.Println(slices.Contains(slice, v))
+// Outputs: true
+```
+
+### GreaterOf
+
+GreaterOf returns a greater function for the given slice type for slice sorting.
+
+Supports: bool, string, int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64
+
+```go
+slice := []string{"foo", "bar"}
+sort.Slice(slice, slices.GreaterOf(slice))
+
+fmt.Println(slice)
+// Outputs: [foo bar]
+```
+
+### LesserOf
+
+LesserOf returns a lesser function for the given slice type for slice sorting.
+
+Supports: bool, string, int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64, float32, float64
+
+```go
+slice := []string{"foo", "bar"}
+sort.Slice(slice, slices.LesserOf(slice))
+
+fmt.Println(slice)
+// Outputs: [bar foo]
+```
+
+## Benchmark
+
+```
+BenchmarkContains-8          	36659943	        30.0 ns/op	       0 B/op	       0 allocs/op
+BenchmarkContainsNative-8    	48539482	        24.9 ns/op	       0 B/op	       0 allocs/op
+BenchmarkGreaterOf-8         	 6257299	       193 ns/op	      80 B/op	       3 allocs/op
+BenchmarkGreaterOfNative-8   	 7963461	       149 ns/op	      64 B/op	       2 allocs/op
+BenchmarkLesserOf-8          	 6122317	       192 ns/op	      80 B/op	       3 allocs/op
+BenchmarkLesserOfNative-8    	 7947242	       152 ns/op	      64 B/op	       2 allocs/op
+```
+
+Always benchmark with your own workload. The result depends heavily on the data input.