httplab

README

HTTPLab

An interactive web server .

HTTPLabs let you inspect HTTP requests and forge responses.

Install

Golang

go install github.com/gchaincl/httplab/cmd/httplab

Archlinux

yaourt httplab

Snap

On systems where snap is supported:

snap install httplab

Binary distribution

Each release provides pre-built binaries for different architectures, you can download them here: https://github.com/gchaincl/httplab/releases/latest

Help

Usage of httplab:
  -config string
        Specifies custom config path.
  -port int
        Specifies the port where HTTPLab will bind to. (default 10080)
  -version
        Prints current version.

Key Bindings

Key	Description
Tab	Next Input
Shift+Tab	Previous Input
Ctrl+a	Apply Response changes
Ctrl+r	Resets Request history
Ctrl+s	Save Response as
Ctrl+f	Save Request as
Ctrl+l	Toggle Responses list
Ctrl+t	Toggle Response builder
Ctrl+o	Open Body file
Ctrl+b	Switch Body mode
Ctrl+h	Toggle Help
q	Close popup
PgUp	Previous Request
PgDown	Next Request
Ctrl+c	Quit

HTTPLab uses file to store pre-built responses, it will look for a file called .httplab on the current directory if not found it will fallback to $HOME. A sample file can be found here.

HTTPLab is heavily inspired by wuzz

Documentation

Index

• func Decolorize(s []byte) []byte
• func DumpRequest(req *http.Request) ([]byte, error)
• func ExpandPath(path string) string
• type Body
  • func (body *Body) Info() []byte
  • func (body *Body) Payload() []byte
  • func (body *Body) SetFile(path string) error
• type BodyMode
  • func (m BodyMode) String() string
• type Response
  • func NewResponse(status, headers, body string) (*Response, error)
  • func (r *Response) MarshalJSON() ([]byte, error)
  • func (r *Response) UnmarshalJSON(data []byte) error
  • func (r *Response) Write(w http.ResponseWriter) error
• type ResponsesList
  • func NewResponsesList() *ResponsesList
  • func (rl *ResponsesList) Add(key string, r *Response) *ResponsesList
  • func (rl *ResponsesList) Cur() *Response
  • func (rl *ResponsesList) Del(key string) bool
  • func (rl *ResponsesList) Get(key string) *Response
  • func (rl *ResponsesList) Index() int
  • func (rl *ResponsesList) Keys() []string
  • func (rl *ResponsesList) Len() int
  • func (rl *ResponsesList) Load(path string) error
  • func (rl *ResponsesList) Next()
  • func (rl *ResponsesList) Prev()
  • func (rl *ResponsesList) Save(path string) error

Functions

func Decolorize

func Decolorize(s []byte) []byte

func DumpRequest

func DumpRequest(req *http.Request) ([]byte, error)

func ExpandPath

func ExpandPath(path string) string

Types

type Body

type Body struct {
	Mode  BodyMode
	Input []byte
	File  *os.File
}

func (*Body) Info

func (body *Body) Info() []byte

func (*Body) Payload

func (body *Body) Payload() []byte

func (*Body) SetFile

func (body *Body) SetFile(path string) error

type BodyMode

type BodyMode uint

BodyMode represent the current Body mode

const (
	BodyInput BodyMode = iota + 1
	BodyFile
)

func (BodyMode) String

func (m BodyMode) String() string

type Response

type Response struct {
	Status  int
	Headers http.Header
	Body    Body
	Delay   time.Duration
}

func NewResponse

func NewResponse(status, headers, body string) (*Response, error)

func (*Response) MarshalJSON

func (r *Response) MarshalJSON() ([]byte, error)

func (*Response) UnmarshalJSON

func (r *Response) UnmarshalJSON(data []byte) error

func (*Response) Write

func (r *Response) Write(w http.ResponseWriter) error

type ResponsesList

type ResponsesList struct {
	List map[string]*Response
	// contains filtered or unexported fields
}

func NewResponsesList

func NewResponsesList() *ResponsesList

func (*ResponsesList) Add

func (rl *ResponsesList) Add(key string, r *Response) *ResponsesList

func (*ResponsesList) Cur

func (rl *ResponsesList) Cur() *Response

func (*ResponsesList) Del

func (rl *ResponsesList) Del(key string) bool

func (*ResponsesList) Get

func (rl *ResponsesList) Get(key string) *Response

func (*ResponsesList) Index

func (rl *ResponsesList) Index() int

func (*ResponsesList) Keys

func (rl *ResponsesList) Keys() []string

func (*ResponsesList) Len

func (rl *ResponsesList) Len() int

func (*ResponsesList) Load

func (rl *ResponsesList) Load(path string) error

func (*ResponsesList) Next

func (rl *ResponsesList) Next()

func (*ResponsesList) Prev

func (rl *ResponsesList) Prev()

func (*ResponsesList) Save

func (rl *ResponsesList) Save(path string) error