pax_global_header00006660000000000000000000000064140251646560014523gustar00rootroot0000000000000052 comment=38f8067bcf5aa9757803ff65d054299f244c0f87 browser-1.1.0/000077500000000000000000000000001402516465600132055ustar00rootroot00000000000000browser-1.1.0/.github/000077500000000000000000000000001402516465600145455ustar00rootroot00000000000000browser-1.1.0/.github/workflows/000077500000000000000000000000001402516465600166025ustar00rootroot00000000000000browser-1.1.0/.github/workflows/push.yml000066400000000000000000000006611402516465600203070ustar00rootroot00000000000000on: [push, pull_request] name: CI jobs: test: strategy: matrix: go: [ '1.13', '1.15' ] os: [ ubuntu-latest, macos-latest, windows-latest ] fail-fast: false runs-on: ${{ matrix.os }} name: Test suite steps: - uses: actions/checkout@v2 - name: Setup go uses: actions/setup-go@v1 with: go-version: ${{ matrix.go }} - run: go test -v ./... browser-1.1.0/LICENSE000066400000000000000000000024401402516465600142120ustar00rootroot00000000000000Copyright (c) 2014, Dave Cheney All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. browser-1.1.0/README.md000066400000000000000000000005221402516465600144630ustar00rootroot00000000000000 # browser Helpers to open URLs, readers, or files in the system default web browser. This fork adds: - `OpenReader` error wrapping; - `ErrNotFound` error wrapping on BSD; - Go 1.13 support. ## Usage ``` go import "github.com/cli/browser" err = browser.OpenURL(url) err = browser.OpenFile(path) err = browser.OpenReader(reader) ``` browser-1.1.0/browser.go000066400000000000000000000031721402516465600152220ustar00rootroot00000000000000// Package browser provides helpers to open files, readers, and urls in a browser window. // // The choice of which browser is started is entirely client dependant. package browser import ( "fmt" "io" "io/ioutil" "os" "os/exec" "path/filepath" ) // Stdout is the io.Writer to which executed commands write standard output. var Stdout io.Writer = os.Stdout // Stderr is the io.Writer to which executed commands write standard error. var Stderr io.Writer = os.Stderr // OpenFile opens new browser window for the file path. func OpenFile(path string) error { path, err := filepath.Abs(path) if err != nil { return err } return OpenURL("file://" + path) } // OpenReader consumes the contents of r and presents the // results in a new browser window. func OpenReader(r io.Reader) error { f, err := ioutil.TempFile("", "browser") if err != nil { return fmt.Errorf("browser: could not create temporary file: %w", err) } if _, err := io.Copy(f, r); err != nil { f.Close() return fmt.Errorf("browser: caching temporary file failed: %w", err) } if err := f.Close(); err != nil { return fmt.Errorf("browser: caching temporary file failed: %w", err) } oldname := f.Name() newname := oldname + ".html" if err := os.Rename(oldname, newname); err != nil { return fmt.Errorf("browser: renaming temporary file failed: %w", err) } return OpenFile(newname) } // OpenURL opens a new browser window pointing to url. func OpenURL(url string) error { return openBrowser(url) } func runCmd(prog string, args ...string) error { cmd := exec.Command(prog, args...) cmd.Stdout = Stdout cmd.Stderr = Stderr setFlags(cmd) return cmd.Run() } browser-1.1.0/browser_darwin.go000066400000000000000000000002071402516465600165620ustar00rootroot00000000000000package browser import "os/exec" func openBrowser(url string) error { return runCmd("open", url) } func setFlags(cmd *exec.Cmd) {} browser-1.1.0/browser_freebsd.go000066400000000000000000000004301402516465600167060ustar00rootroot00000000000000package browser import ( "errors" "fmt" "os/exec" ) func openBrowser(url string) error { err := runCmd("xdg-open", url) if errors.Is(err, exec.ErrNotFound) { return fmt.Errorf("%w - install xdg-utils from ports(8)", err) } return err } func setFlags(cmd *exec.Cmd) {} browser-1.1.0/browser_linux.go000066400000000000000000000011371402516465600164400ustar00rootroot00000000000000package browser import ( "os/exec" "strings" ) func openBrowser(url string) error { providers := []string{"xdg-open", "x-www-browser", "www-browser", "wslview"} // There are multiple possible providers to open a browser on linux // One of them is xdg-open, another is x-www-browser, then there's www-browser, etc. // Look for one that exists and run it for _, provider := range providers { if _, err := exec.LookPath(provider); err == nil { return runCmd(provider, url) } } return &exec.Error{Name: strings.Join(providers, ","), Err: exec.ErrNotFound} } func setFlags(cmd *exec.Cmd) {} browser-1.1.0/browser_openbsd.go000066400000000000000000000004301402516465600167260ustar00rootroot00000000000000package browser import ( "errors" "fmt" "os/exec" ) func openBrowser(url string) error { err := runCmd("xdg-open", url) if errors.Is(err, exec.ErrNotFound) { return fmt.Errorf("%w - install xdg-utils from ports(8)", err) } return err } func setFlags(cmd *exec.Cmd) {} browser-1.1.0/browser_unsupported.go000066400000000000000000000004111402516465600176630ustar00rootroot00000000000000// +build !linux,!windows,!darwin,!openbsd,!freebsd package browser import ( "fmt" "os/exec" "runtime" ) func openBrowser(url string) error { return fmt.Errorf("openBrowser: unsupported operating system: %v", runtime.GOOS) } func setFlags(cmd *exec.Cmd) {} browser-1.1.0/browser_windows.go000066400000000000000000000006101402516465600167660ustar00rootroot00000000000000//go:generate mkwinsyscall -output zbrowser_windows.go browser_windows.go //sys shellExecute(hwnd int, verb string, file string, args string, cwd string, showCmd int) (err error) = shell32.ShellExecuteW package browser import "os/exec" const sW_SHOWNORMAL = 1 func openBrowser(url string) error { return shellExecute(0, "", url, "", "", sW_SHOWNORMAL) } func setFlags(cmd *exec.Cmd) { } browser-1.1.0/example_test.go000066400000000000000000000012411402516465600162240ustar00rootroot00000000000000package browser import "strings" func ExampleOpenFile() { _ = OpenFile("index.html") } func ExampleOpenReader() { // https://github.com/rust-lang/rust/issues/13871 const quote = `There was a night when winds from unknown spaces whirled us irresistibly into limitless vacum beyond all thought and entity. Perceptions of the most maddeningly untransmissible sort thronged upon us; perceptions of infinity which at the time convulsed us with joy, yet which are now partly lost to my memory and partly incapable of presentation to others.` r := strings.NewReader(quote) _ = OpenReader(r) } func ExampleOpenURL() { const url = "http://golang.org/" _ = OpenURL(url) } browser-1.1.0/examples/000077500000000000000000000000001402516465600150235ustar00rootroot00000000000000browser-1.1.0/examples/Open/000077500000000000000000000000001402516465600157245ustar00rootroot00000000000000browser-1.1.0/examples/Open/main.go000066400000000000000000000016761402516465600172110ustar00rootroot00000000000000// Open is a simple example of the github.com/pkg/browser package. // // Usage: // // # Open a file in a browser window // Open $FILE // // # Open a URL in a browser window // Open $URL // // # Open the contents of stdin in a browser window // cat $SOMEFILE | Open package main import ( "flag" "fmt" "log" "os" "path/filepath" "strings" "github.com/cli/browser" ) func usage() { fmt.Fprintf(os.Stderr, "Usage:\n %s { | | -}\n", filepath.Base(os.Args[0])) flag.PrintDefaults() } func init() { flag.Usage = usage flag.Parse() } func check(err error) { if err != nil { log.Fatal(err) } } func main() { args := flag.Args() if len(args) != 1 { usage() os.Exit(1) } if args[0] == "-" { check(browser.OpenReader(os.Stdin)) return } if strings.HasPrefix(args[0], "http:") || strings.HasPrefix(args[0], "https:") { check(browser.OpenURL(args[0])) return } check(browser.OpenFile(args[0])) } browser-1.1.0/go.mod000066400000000000000000000001441402516465600143120ustar00rootroot00000000000000module github.com/cli/browser go 1.13 require golang.org/x/sys v0.0.0-20210319071255-635bc2c9138d browser-1.1.0/go.sum000066400000000000000000000003171402516465600143410ustar00rootroot00000000000000golang.org/x/sys v0.0.0-20210319071255-635bc2c9138d h1:jbzgAvDZn8aEnytae+4ou0J0GwFZoHR0hOrTg4qH8GA= golang.org/x/sys v0.0.0-20210319071255-635bc2c9138d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= browser-1.1.0/zbrowser_windows.go000066400000000000000000000033631402516465600171700ustar00rootroot00000000000000// Code generated by 'go generate'; DO NOT EDIT. package browser import ( "syscall" "unsafe" "golang.org/x/sys/windows" ) var _ unsafe.Pointer // Do the interface allocations only once for common // Errno values. const ( errnoERROR_IO_PENDING = 997 ) var ( errERROR_IO_PENDING error = syscall.Errno(errnoERROR_IO_PENDING) errERROR_EINVAL error = syscall.EINVAL ) // errnoErr returns common boxed Errno values, to prevent // allocations at runtime. func errnoErr(e syscall.Errno) error { switch e { case 0: return errERROR_EINVAL case errnoERROR_IO_PENDING: return errERROR_IO_PENDING } // TODO: add more here, after collecting data on the common // error values see on Windows. (perhaps when running // all.bat?) return e } var ( modshell32 = windows.NewLazySystemDLL("shell32.dll") procShellExecuteW = modshell32.NewProc("ShellExecuteW") ) func shellExecute(hwnd int, verb string, file string, args string, cwd string, showCmd int) (err error) { var _p0 *uint16 _p0, err = syscall.UTF16PtrFromString(verb) if err != nil { return } var _p1 *uint16 _p1, err = syscall.UTF16PtrFromString(file) if err != nil { return } var _p2 *uint16 _p2, err = syscall.UTF16PtrFromString(args) if err != nil { return } var _p3 *uint16 _p3, err = syscall.UTF16PtrFromString(cwd) if err != nil { return } return _shellExecute(hwnd, _p0, _p1, _p2, _p3, showCmd) } func _shellExecute(hwnd int, verb *uint16, file *uint16, args *uint16, cwd *uint16, showCmd int) (err error) { r1, _, e1 := syscall.Syscall6(procShellExecuteW.Addr(), 6, uintptr(hwnd), uintptr(unsafe.Pointer(verb)), uintptr(unsafe.Pointer(file)), uintptr(unsafe.Pointer(args)), uintptr(unsafe.Pointer(cwd)), uintptr(showCmd)) if r1 == 0 { err = errnoErr(e1) } return }