uca

README

uca-print

uca-print is a set of tools to print documents from the command-line.

Installation

$> go install git.sr.ht/~sbinet/uca-print/cmd/uca-print

Examples

$> uca-print -h
Usage: uca-print [options] file1.pdf [file2.odt [...]]

ex:
 $> uca-print ./file1.pdf
 $> uca-print -u username ./file1.pdf ./file2.pdf
 $> uca-print -u username -p s3cr3t ./file1.pdf ./file2.pdf

options:
  -p string
    	password for papercut
  -t duration
    	timeout for sending files to print (default 20s)
  -u string
    	username for papercut

Credentials for uca-print can also be stored in $HOME/.config/uca-print/auth.cfg:

$> cat ~/.config/uca-print/auth.cfg
user     my-username
cred-cmd some authentication command # optional.

cred-cmd would typically point at, e.g.:

cred-cmd pass uca.fr/me

uca-print-srv

uca-print also provides a REST-like server that can forward printing requests:

$> go install git.sr.ht/~sbinet/uca-print/cmd/uca-print-srv
$> uca-print-srv -addr :8080 -cert ./cert/server.crt -priv ./cert/server.key

and, in another terminal:

$> curl -X POST \
    -k ## to allow self-signed certificates \
    -u username:s3cr3t \
    --form file='@path-to-file1.pdf' \
    --form file='@path-to-file2.pdf' \
    --form file='@path-to-file3.pdf' \
    https://localhost:8080

Documentation

Overview

Package uca provides tools to send files to print to papercut.

Index

• Variables
• type Client
  • func NewClient(opts ...Option) (*Client, error)
  • func (cli *Client) Close() error
  • func (cli *Client) Send(ctx context.Context, fnames []string) error
• type Option
  • func WithAuth(usr, pwd string) Option
  • func WithUser(usr string) Option

Variables

var (
	ErrInvalidAuth = errors.New("invalid authentication")
)

Types

type Client

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

Client provides a means to authenticate with and send files to a PaperCut web-print server.

func NewClient

func NewClient(opts ...Option) (*Client, error)

NewClient creates a new PaperCut client with the provided options.

By default, the client will try to locate the credentials file named $HOME/.config/uca-print/auth.cfg.

func (*Client) Close

func (cli *Client) Close() error

func (*Client) Send

func (cli *Client) Send(ctx context.Context, fnames []string) error

Send sends the files to be printed to the web-print PaperCut server.

type Option

type Option func(c *Client) error

Option configures a client.

func WithAuth

func WithAuth(usr, pwd string) Option

WithAuth provides the user+password authentication mechanism to a PaperCut web-print server.

func WithUser

func WithUser(usr string) Option

WithAuth provides the user name to authenticate with a PaperCut web-print server. The user is prompted to provide their password interactively.