Skip to content
Go library for PHP community with convenient functions
Go
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update go.yml Dec 5, 2019
html #12. Add sdipping on excluded tags Feb 15, 2019
.gitattributes #42: Add Rand func to generate a pseudo-random integer between min an… Jan 19, 2020
.gitignore #4. Add tests for FilePutContents, change flows for file get contents Dec 29, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Dec 26, 2018
CONTRIBUTING.md #6. Add http requests to FileGetContents as in php, Fix errors handli… Dec 31, 2018
LICENSE Initial commit Dec 26, 2018
README.md #43: Add HashFile function to README.md menu Mar 19, 2020
array.go #30. Fix step > 1 + readme Apr 28, 2019
array_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
collection.go Feature/39 priority queue (#40) Dec 23, 2019
collection_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
core.go #5. Add more coverage on StrIReplace with slices Jan 9, 2019
core_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
crypto.go #43: Add HashFile function Mar 18, 2020
crypto_test.go #43: Add HashFile function Mar 18, 2020
date.go #36: Fix optimize perf for milli/micro funcs via const division Dec 5, 2019
date_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
files.go #33: Fix cap letter in err, Remove unused const Nov 12, 2019
files_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
go.mod #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
math.go #42: Add Rand func to generate a pseudo-random integer between min an… Jan 19, 2020
math_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
net.go #32: Add GetMxrr Nov 10, 2019
net_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020
request.go #10. Remove needless consts that are in http/net/method.go package Jan 22, 2019
str.go #18. Add ArrayCountValues + change file names Mar 19, 2019
str_test.go #hotfix: Fix module definition in go.mod + tests Apr 6, 2020

README.md

pgo

Go library for PHP community with convenient functions

Mentioned in Awesome Go Go Report Card Build and test codecov License: MIT GoDoc

Installation

Via go get command:

go get github.com/arthurkushman/pgo

Imagine that you need to write Go code every day and also have a convenient functions in memory from PHP experience

Date

You can use date function with similar formatting for PHP e.g.:

dateStr := pgo.Date("Y-m-d H:i:s") // 2019-03-28 12:23:03

pgo.Date("j D, M") // 27 Wed, Mar

pgo.Date("Q") // 3 (of 1,2,3,4 quarters)

Milli/Micro

nowMicro := pgo.UnixMicro() // get current unix microseconds
nowMilli := pgo.UnixMilli() // get current unix milliseconds

// get current millis + 3ms 
nowMillisPlusThree := pgo.Time(time.Now().Add(time.Millisecond * 3)).Milliseconds()
// get current microseconds + 7μs 
nowMicroPlusSeven := pgo.Time(now.Add(time.Microsecond * 7)).Microseconds()

Strings

StrReplace

replace sub-strings with StrReplace:

subject := "The quick brown fox jumped over the lazy dog"

str, err := pgo.StrReplace([]string{"fox", "dog"}, []string{"cat", "elephant"}, subject)

// and if case-insensitive replace needed - pgo.StrIReplace([]string{"DOG", "QuiCK"}, []string{"fox", "slow"}, subject) 

HTTPBuildQuery

Bulding a http query string:

queryStr := pgo.HTTPBuildQuery(map[string]string{
	"foo": "bar",
	"bar": "baz",
}) // bar=baz&foo=bar

StripTags

Strip tags with exclusion rules:

html := "<div>Lorem <span>ipsum dolor sit amet</span>, consectetur adipiscing elit, sed do eiusmod <a href=\"http://example.com\">tempor incididunt</a> ut labore <strong>et dolore</strong> magna aliqua.</div>"

str := html.StripTags(html, []string{"a", "span"}) // results in: "Lorem <span>ipsum dolor sit amet</span>, consectetur adipiscing elit, sed do eiusmod <a href=\"http://example.com\">tempor incididunt</a> ut labore et dolore magna aliqua."

UPD: As had been stated here - https://github.com/golang/go/issues/22639 There is a very handy "stripTags" function in html/template, then guys from official team as fast as they got dislike on their negative comment, closed the thread. That is why libs like pgo is appearing and will be move forward/evelove, bypassing strict rules that sometimes looking nonsence.

Files

FileGetContents

Read files with offset/limit:

content, err := pgo.FileGetContents("somefile.txt", 0, 1024)

FilePutContents

reflexively write to files with:

n, err := pgo.FilePutContents("somefile.txt", strToWrite, pgo.FileAppend)

Read from context (via http(s)):

content, err := pgo.FileGetContents("http://google.com", pgo.NewContext())

MoveUploadedFile

Uploading files from web-forms to your server:

ctx := pgo.NewContext()
ctx.Req = YourReq
ctx.UploadMaxFileSize = 10 << 25

uploaded := ctx.MoveUploadedFile("foo", "/srv/images/pic123.png")

FileExists

Checking for file existence

if pgo.FileExists("file1.txt") == true {
	// do something with existent file
}

IsFile/IsDir/IsLink

Check if it is file/dir/symlink

if pgo.IsFile("someFile.txt") {
	// do something with file
}

if pgo.IsDir("someDir/") {
	// do something with dir
}

if pgo.IsLink("someLink") {
	// do somthing with symlink
}

Arrays

InArray

Check if an array contains an element

pgo.InArray(3, []int{1, 2, 3}) // true
pgo.InArray("bar33", []string{"foo", "bar", "baz"}) // false
pgo.InArray(3.14159, []float64{33.12, 12.333, 3.14159, 78.4429}) // true

ArrayChunk

Split an array by chunks (with auto-tailing)

pgo.ArrayChunk([]int{1, 2, 3, 4, 5, 6, 7, 8}, 2) // [][]int{[]int{1, 2}, []int{3, 4}, []int{5, 6}, []int{7, 8}}

pgo.ArrayChunk([]string{"foo", "bar", "baz", "fizz", "buzz"}, 3) // [][]string{[]string{"foo", "bar", "baz"}, []string{"fizz", "buzz"}}

ArrayCombine

Create an array by using one array for keys and another for its values

pgo.ArrayCombine([]int{11, 32, 13, 14, 51, 46, 17, 88}, []string{"foo", "bar", "baz", "fizz", "buzz", "mazz", "freez", "lorum"})
/*
map[int]string{
		11: "foo",
		32: "bar",
		13: "baz",
		14: "fizz",
		51: "buzz",
		46: "mazz",
		17: "freez",
		88: "lorum",
	}	
*/
pgo.ArrayCombine([]string{"foo", "bar", "baz", "fizz", "buzz"}, []float64{11.32, 32.42, 13.246, 14.41, 51.98})
/*
map[string]float64{
			"foo":  11.32,
			"bar":  32.42,
			"baz":  13.246,
			"fizz": 14.41,
			"buzz": 51.98,
		}
*/

ArrayCountValues

Count all the values of an array/slice

pgo.ArrayCountValues([]string{"foo", "bar", "foo", "baz", "bar", "bar"}) // map[string]int{"foo": 2, "bar": 3, "baz": 1}

pgo.ArrayCountValues([]float64{3.14159, 43.03, 8, 3.14159, 43.02, 8}) // map[float64]int{3.14159: 2, 8: 2, 43.03: 1, 43.02: 1}

ArrayMap

Apply the callback to the elements of the given arrays

pgo.ArrayMap([]string{"foo", "bar", "baz"}, func(v string) string {
		return strings.ToUpper(v)
	}) // []string{"FOO", "BAR", "BAZ"}

pgo.ArrayMap([]float64{1, 2, 3, 4, 5}, func(v float64) float64 {
		return math.Pow(v, 2)
	}) // []float64{1, 4, 9, 16, 25}

ArrayFilter

filters elements of an array using a callback function

pgo.ArrayFilter([]float64{1, 2, 3, 4, 5}, func(v float64) bool {
		return v > 2.718
	}) // []float64{3, 4, 5}

ArrayDiff

returns the values in array1 that are not present in any of the other arrays

pgo.ArrayDiff([]string{"foo", "bar", "fizz", "baz"}, []string{"foo", "bar"}) // []string{"fizz", "baz"}
pgo.ArrayDiff([]int{3, 43, 8, 4, 9}, []int{3, 8, 9, 4}) // []int{43}

ArraySum

calculate the sum of values in an array

pgo.ArraySum([]int{12, 54, 32, 12, 33}) // int: 143

ArrayIntersect

computes the intersection of arrays

pgo.ArrayIntersect([]int{12, 54, 32, 12, 33}, []int{3, 12, 54, 9}, []int{12, 33, 9}) // []int{12, 54, 33}

pgo.ArrayIntersect([]string{"foo", "bar", "baz", "fizz", "bazz", "fizz", "fizz"}, []string{"bar", "fizz"}, []string{"foo", "bar", "hey"}) // []string{"foo", "bar", "fizz"}

Range

creates an int slice of min to max range

pgo.Range(3, 9) // []int{3, 4, 5, 6, 7, 8, 9}

// If a step value is given, it will be used as the increment between elements in the sequence.
pgo.Range(-3, 7, 5) // []int{-3, 2, 7}

See more examples in *_test.go files.

Collections

Priority Queue

	// Some items and their priorities.
	items := map[string]int{
		"banana": 3, "apple": 2, "pear": 4, "peach": 1, "plum": 6,
	}

	// Create a Priority queue, put the items in it, and
	// establish the Priority queue (heap) invariants.
	pq := make(pgo.PriorityQueue, len(items))
	i := 0
	for value, priority := range items {
		pq[i] = &pgo.Item{
			Value:    value,
			Priority: priority,
			Index:    i,
		}
		i++
	}
	pq.Init()

	// Insert a new item and then modify its Priority.
	item := &pgo.Item{
		Value:    "orange",
		Priority: 1,
	}
	pq.Push(item)
	pq.Update(item, item.Value, 5)
	
	item := pq.Pop().(*pgo.Item) // 06:plum
	item := pq.Pop().(*pgo.Item) // 05:orange
	item := pq.Pop().(*pgo.Item) // 04:pear
	item := pq.Pop().(*pgo.Item) // 03:banana
	// ... 

Network

IP2Long/Long2Ip

long, _ := pgo.IP2long("176.59.34.117") // 2956665461

ip := pgo.Long2ip(2956665461) // "176.59.34.117"

GetMxrr

isMx, mxs, _ := pgo.GetMxrr("google.com") // e.g.: true, n

Math

Rand

rand := pgo.Rand(1, 100)

Crypto

Md5

pgo.Md5("abc123") // e99a18c428cb38d5f260853678922e03

Sha1

pgo.Sha1("abc123") // 6367c48dd193d56ea7b0baad25b19455e529f5ee

Sha2

pgo.Sha2("abc123") // 6ca13d52ca70c883e0f0bb101e425a89e8624de51db2d2392593af6a84118090

HashFile

hex, err := pgo.HashFile("sha1", "example.txt") // 6367c48dd193d56ea7b0baad25b19455e529f5ee
You can’t perform that action at this time.