resources

package

v0.7.0 Latest Latest Go to latest Published: Feb 22, 2020 License: BSD-3-Clause Imports: 12 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ooni/probe-engine

Links

Open Source Insights

Documentation ¶

Overview ¶

Package resources contains code to download resources.

Index ¶

Constants
Variables
type Client
- func (c *Client) Ensure(ctx context.Context) error
- func (c *Client) EnsureForSingleResource(ctx context.Context, name string, resource ResourceInfo, ...) error
type ResourceInfo

Constants ¶

View Source

const (
	// Version contains the assets version.
	Version = 20191226162429

	// ASNDatabaseName is the ASN-DB file name
	ASNDatabaseName = "asn.mmdb"

	// CABundleName is the name of the CA bundle file
	CABundleName = "ca-bundle.pem"

	// CountryDatabaseName is country-DB file name
	CountryDatabaseName = "country.mmdb"

	// RepositoryURL is the asset's repository URL
	RepositoryURL = "https://github.com/ooni/probe-assets"
)

Variables ¶

View Source

var All = map[string]ResourceInfo{
	"asn.mmdb": ResourceInfo{
		URLPath:  "/releases/download/20191226162429/asn.mmdb.gz",
		GzSHA256: "f4be54217b08761aa61315680eba2a9371b5b68aeb037e0c901773c43481530c",
		SHA256:   "479218cd19f52f9826bc836646a4bec1b04022e3fc42015d2aa577cdf2017f1a",
	},
	"ca-bundle.pem": ResourceInfo{
		URLPath:  "/releases/download/20191226162429/ca-bundle.pem.gz",
		GzSHA256: "790ad79619bbfc75e4c8b4aef8fe6371d10f36f6071ec774d8cc0c27a848222a",
		SHA256:   "0d98a1a961aab523c9dc547e315e1d79e887dea575426ff03567e455fc0b66b4",
	},
	"country.mmdb": ResourceInfo{
		URLPath:  "/releases/download/20191226162429/country.mmdb.gz",
		GzSHA256: "e694431e766fdf76105b5c14ed43551bc9b4ca2e3bd282a41c3c36175e17a7e4",
		SHA256:   "9aedbe59990318581ec5d880716d3415e40bfc07280107112d6d7328c771e059",
	},
}

All contains info on all known assets.

Functions ¶

This section is empty.

Types ¶

type Client ¶

type Client struct {
	// HTTPClient is the HTTP client to use.
	HTTPClient *http.Client

	// Logger is the logger to use.
	Logger log.Logger

	// OSMkdirAll allows testing os.MkdirAll failures.
	OSMkdirAll func(path string, perm os.FileMode) error

	// UserAgent is the user agent to use.
	UserAgent string

	// WorkDir is the directory where to save resources.
	WorkDir string
}

Client is a client for fetching resources.

func (*Client) Ensure ¶

func (c *Client) Ensure(ctx context.Context) error

Ensure ensures that resources are downloaded and current.

func (*Client) EnsureForSingleResource ¶

func (c *Client) EnsureForSingleResource(
	ctx context.Context, name string, resource ResourceInfo,
	equal func(real, expected string) bool,
	gzipNewReader func(r io.Reader) (*gzip.Reader, error),
	ioutilReadAll func(r io.Reader) ([]byte, error),
) error

EnsureForSingleResource ensures that a single resource is downloaded and is current.

type ResourceInfo ¶

type ResourceInfo struct {
	// URLPath is the resource's URL path.
	URLPath string

	// GzSHA256 is used to validate the downloaded file.
	GzSHA256 string

	// SHA256 is used to check whether the assets file
	// stored locally is still up-to-date.
	SHA256 string
}

ResourceInfo contains information on a resource.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL