blob: 4f9245d9d3e38f4c1549205a058d2b11a31d5f5b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
FreePort
========
Get a free open TCP port that is ready to use.
## Command Line Example:
```bash
# Ask the kernel to give us an open port.
export port=$(freeport)
# Start standalone httpd server for testing
httpd -X -c "Listen $port" &
# Curl local server on the selected port
curl localhost:$port
```
## Golang example:
```go
package main
import "github.com/phayes/freeport"
func main() {
port, err := freeport.GetFreePort()
if err != nil {
log.Fatal(err)
}
// port is ready to listen on
}
```
## Installation
#### CentOS and other RPM based systems
```bash
wget https://github.com/phayes/freeport/releases/download/0.1.2/freeport_0.1.2_linux_386.rpm
rpm -Uvh freeport_0.1.2_linux_386.rpm
```
#### Ubuntu and other DEB based systems
```bash
wget wget https://github.com/phayes/freeport/releases/download/0.1.2/freeport_0.1.2_linux_amd64.deb
dpkg -i freeport_0.1.2_linux_amd64.deb
```
## Building From Source
```bash
sudo apt-get install golang # Download go. Alternativly build from source: https://golang.org/doc/install/source
mkdir ~/.gopath && export GOPATH=~/.gopath # Replace with desired GOPATH
export PATH=$PATH:$GOPATH/bin # For convenience, add go's bin dir to your PATH
go get github.com/phayes/freeport/cmd/freeport
```
|
