mechanics.go

package gw2api

import "net/url"

// Trait overview with facts
type Trait struct {
	ID             int           `json:"id"`
	Name           string        `json:"icon"`
	Icon           string        `json:"icon"`
	Description    string        `json:"description"`
	Specialization int           `json:"specialization"`
	Tier           int           `json:"tier"`
	Order          int           `josn:"order"`
	Slot           string        `json:"slot"`
	Facts          []Fact        `json:"facts"`
	TraitedFacts   []TraitedFact `json:"traited_facts"`
	Skills         []Skill       `json:"skills"`
}

// Skill with associated facts
type Skill struct {
	ID           int           `json:"id"`
	Name         string        `json:"name"`
	Description  string        `json:"description"`
	Icon         string        `json:"icon"`
	Facts        []Fact        `json:"facts"`
	TraitedFacts []TraitedFact `json:"traited_facts"`
}

// FactType - One of the types a fact can be
// Set fields depend on the Type
type FactType struct {
	//Common fields
	Text        string `json:"text"`
	Type        string `json:"type"`
	Icon        string `json:"icon"`
	Description string `json:"description"`
	Percent     int    `json:"percent"`
	Target      string `json:"target"`
	Duration    int    `json:"duration"`
	Status      string `json:"status"`
	ApplyCount  int    `json:"apply_count"`
	Value       int    `json:"value"`

	// AttributeAdjustFact

	// BuffFact

	// BuffConversionFact
	Source string `json:"source"`

	// ComboFieldFact
	FinisherType string `json:"finisher_type"`

	// DamageFact
	HitCount int `json:"hit_count"`

	// DistanceFact
	Distance int `json:"distance"`

	// NoDataFact

	// PercentFact

	// PrefixedBuffFact
	Prefix Fact `json:"prefix"`

	// RadiusFact

	// RangeFact

	// RechargeFact

	// TimeFact

	// UnblockableFact
}

// Fact associated with a trait or skill
type Fact struct {
	Text  string     `json:"text"`
	Icon  string     `json:"icon"`
	Type  string     `json:"type"`
	Facts []FactType `json:"facts"`

	// Only as TraitedFact
	RequiresTrait int `json:"requires_trait"`
	Overrides     int `json:"overrides"`
}

// TraitedFact has some extra attributes
type TraitedFact Fact

// Traits a list of all traits
func (gw2 *GW2Api) Traits() (res []int, err error) {
	ver := "v2"
	tag := "traits"
	err = gw2.fetchEndpoint(ver, tag, nil, &res)
	return
}

// TraitIds details on the requested traits. Localized to lang
func (gw2 *GW2Api) TraitIds(lang string, ids ...int) (traits []Trait, err error) {
	ver := "v2"
	tag := "traits"
	params := url.Values{}
	if lang != "" {
		params.Add("lang", lang)
	}
	params.Add("ids", commaList(stringSlice(ids)))
	err = gw2.fetchEndpoint(ver, tag, params, &traits)
	return
}

// DetailSpecialization spec lines and their traits
type DetailSpecialization struct {
	ID          int    `json:"id"`
	Name        string `json:"name"`
	Elite       bool   `json:"elite"`
	Icon        string `json:"icon"`
	Background  string `json:"background"`
	MinorTraits []int  `json:"minor_traits"`
	MajorTraits []int  `json:"major_traits"`
}

// Specializations returns the list of all
func (gw2 *GW2Api) Specializations() (res []int, err error) {
	ver := "v2"
	tag := "specializations"
	err = gw2.fetchEndpoint(ver, tag, nil, &res)
	return
}

// SpecializationIds returns a localized detail object for the requested ids
func (gw2 *GW2Api) SpecializationIds(lang string, ids ...int) (specs []DetailSpecialization, err error) {
	ver := "v2"
	tag := "specializations"
	params := url.Values{}
	if lang != "" {
		params.Add("lang", lang)
	}
	params.Add("ids", commaList(stringSlice(ids)))
	err = gw2.fetchEndpoint(ver, tag, params, &specs)
	return
}