leakless

README

leakless

Run sub-process and make sure to kill it when the parent process exits. The way how it works is to check parent tcp connection with an uuid.

Not using the pid is because after a process exits, newly created process may have the same pid.

How to Use

See the examples

Deploy

godev build -d ./cmd/leakless

Documentation

Index

• type Launcher
  • func New() *Launcher
  • func (l *Launcher) Bin(path string) *Launcher
  • func (l *Launcher) Command(name string, arg ...string) *exec.Cmd
  • func (l *Launcher) Host(host string) *Launcher
  • func (l *Launcher) Pid() chan int

Examples

• New

Types

type Launcher

type Launcher struct {
	// contains filtered or unexported fields
}

Launcher struct

func New

func New() *Launcher

New leakless instance

Example

package main

import (
	"fmt"
	"time"

	"github.com/ysmood/leakless"
)

func main() {
	ll := leakless.New()

	// just like using the exec.Command
	_ = ll.Command("sleep", "3").Start()

	// get the pid of the guarded sub-process
	select {
	case <-time.Tick(3 * time.Second):
		panic("timeout")
	case pid := <-ll.Pid():
		fmt.Println(pid)
	}
}

func (*Launcher) Bin

func (l *Launcher) Bin(path string) *Launcher

Bin sets the leakless bin location

func (*Launcher) Command

func (l *Launcher) Command(name string, arg ...string) *exec.Cmd

Command will try to download the leakless bin and prefix the exec.Cmd with the leakless options.

func (*Launcher) Host

func (l *Launcher) Host(host string) *Launcher

Host sets the host to download leakless bin

func (*Launcher) Pid

func (l *Launcher) Pid() chan int

Pid signals the pid of the guarded sub-process. The channel may never receive the pid.