verifier

Documentation

Index

• Constants
• type BatchResult
• type NameInput
• type Option
  • func OptBatchSize(n int) Option
  • func OptSources(s []int) Option
  • func OptURL(url string) Option
  • func OptWorkers(n int) Option
• type Output
• type Verification
• type Verifier
  • func NewVerifier(opts ...Option) *Verifier
  • func (v *Verifier) Run(names []string) Output

Constants

const GNindexURL = "http://index.globalnames.org/api/graphql"

Types

type BatchResult

type BatchResult struct {
	Names    []string
	Response *graphqlResponse
	Retries  int
	Error    error
}

type NameInput

type NameInput struct {
	Value string `json:"value"`
}

type Option

type Option func(*Verifier)

Option type for changing Verifier.

func OptBatchSize

func OptBatchSize(n int) Option

OptBatchSize sets the batch size of name-strings to send to the verification service.

func OptSources

func OptSources(s []int) Option

OptSources is an option that sets IDs of data sources used for verification. Results from these sources (if any) will be returned no matter what is the best matching result.

func OptURL

func OptURL(url string) Option

OptURL option sets a new url for name verification service.

func OptWorkers

func OptWorkers(n int) Option

OptWorkers option sets the number of workers to process name-verification jobs.

type Output

type Output map[string]*Verification

type Verification

type Verification struct {
	// DataSourceID is the ID of the DataSource of the returned best match result.
	DataSourceID int `json:"dataSourceId,omitempty"`
	// DataSourceTitle is the Title of the DataSource of the returned best match result.
	DataSourceTitle string `json:"dataSourceTitle,omitempty"`
	// TaxonID identifier of a taxon
	TaxonID string `json:"taxonId,omitempty"`
	// MatchedName is a verbatim name-string from the matched result.
	MatchedName string `json:"matchedName,omitempty"`
	// MatchedCanonical is a canonical form of a matched name
	MatchedCanonical string `json:"matchedCanonical,omitempty"`
	// CurrentName is a currently accepted name according to the matched result.
	CurrentName string `json:"currentName,omitempty"`
	// Synonym is true when the name is not the same as currently accepted.
	Synonym bool `json:"isSynonym,omitempty"`
	// ClassificationPath of the matched result.
	ClassificationPath string `json:"classificationPath,omitempty"`
	// DataSourcesNum tells how many databases matched by the name-string.
	DataSourcesNum int `json:"dataSourcesNum,omitempty"`
	// DataSourceQuality shows if a name-string was found in curated or
	// auto-curated data sources.
	DataSourceQuality string `json:"dataSourceQuality,omitempty"`
	// EditDistance tells how many changes needs to be done to apply fuzzy
	// match to requested name.
	EditDistance int `json:"editDistance,omitempty"`
	// StemEditDistance tells how many changes needs to be done to apply fuzzy
	// match to stemmed name.
	StemEditDistance int `json:"stemEditDistance,omitempty"`
	// MatchType tells what kind of verification occurred if any.
	MatchType string `json:"matchType,omitempty"`
	// PreferredResults contains matches for data sources the user has a
	// particular interest.
	PreferredResults []preferredResultSingle `json:"preferredResults,omitempty"`
	// Retries is number of attempted retries.
	Retries int `json:"retries,omitempty"`
	// ErrorString explains what happened if resolution did not work.
	Error string `json:"error,omitempty"`
}

Verification presents data of an attempted remote verification of a name-string.

type Verifier

type Verifier struct {
	// URL of name-verification service.
	URL string
	// BatchSize of a name-strings' slice sent for verification.
	BatchSize int
	// Workers is a number of workers that send batches of name strings to
	// verification service.
	Workers int
	// WaitTimeout defines how long to wait for a response from
	// verification service.
	WaitTimeout time.Duration
	// Sources is a slice of Data Source IDs. Results from these
	// Data Sources will always be provided unless they are empty.
	Sources []int
}

Verifier is responsible for estimating validity of found name-strings.

func NewVerifier

func NewVerifier(opts ...Option) *Verifier

func (*Verifier) Run

func (v *Verifier) Run(names []string) Output