passwordpwned

Documentation

Overview

Package passwordpwned allows to verify if a password was pwned via the haveibeenpwned.com (HIBP) service API.

Ref.: https://haveibeenpwned.com/API/v3#PwnedPasswords

Index

• type Client
  • func New(opts ...Option) (*Client, error)
  • func (c *Client) HealthCheck(_ context.Context) error
  • func (c *Client) IsPwnedPassword(ctx context.Context, password string) (bool, error)
• type HTTPClient
• type Option
  • func WithHTTPClient(hc HTTPClient) Option
  • func WithRetryAttempts(attempts uint) Option
  • func WithRetryDelay(value time.Duration) Option
  • func WithTimeout(timeout time.Duration) Option
  • func WithURL(addr string) Option
  • func WithUserAgent(s string) Option

Types

type Client

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

Client represents the config options required by the Accounts client.

func New

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

New creates a new client instance.

func (*Client) HealthCheck

func (c *Client) HealthCheck(_ context.Context) error

HealthCheck performs a status check on this service.

func (*Client) IsPwnedPassword

func (c *Client) IsPwnedPassword(ctx context.Context, password string) (bool, error)

IsPwnedPassword returns true if the password has been found pwned.

type HTTPClient

type HTTPClient interface {
	Do(req *http.Request) (*http.Response, error)
}

HTTPClient contains the function to perform the actual HTTP request.

type Option

type Option func(c *Client)

Option is the interface that allows to set client options.

func WithHTTPClient

func WithHTTPClient(hc HTTPClient) Option

WithHTTPClient overrides the default HTTP client.

func WithRetryAttempts

func WithRetryAttempts(attempts uint) Option

WithRetryAttempts overrides the default HTTP client.

func WithRetryDelay

func WithRetryDelay(value time.Duration) Option

WithRetryDelay sets the delay to apply after the first failed attempt.

func WithTimeout

func WithTimeout(timeout time.Duration) Option

WithTimeout overrides the default request timeout.

func WithURL

func WithURL(addr string) Option

WithURL overrides the default service base URL.

func WithUserAgent

func WithUserAgent(s string) Option

WithUserAgent overrides the default user-agent for service requests.