api

Documentation

Index

• Variables
• type Client
  • func NewClient(c *config.Config) *Client
  • func (c *Client) Demo() ([]*Problem, error)
  • func (c *Client) Do(req *http.Request, v interface{}) (*http.Response, error)
  • func (c *Client) Download(submissionID string) (*Submission, error)
  • func (c *Client) Fetch(args []string) ([]*Problem, error)
  • func (c *Client) List(language string) ([]string, error)
  • func (c *Client) NewRequest(method, url string, body io.Reader) (*http.Request, error)
  • func (c *Client) Restore() ([]*Problem, error)
  • func (c *Client) Submission(language, excercise string) (*Submission, error)
  • func (c *Client) Submissions() (map[string][]SubmissionInfo, error)
  • func (c *Client) Submit(iter *Iteration) (*Submission, error)
  • func (c *Client) Tracks() ([]*Track, error)
  • func (c *Client) Unsubmit() error
• type Iteration
  • func (iter *Iteration) Identify() error
  • func (iter *Iteration) RelativePath() string
• type PayloadError
• type PayloadProblems
• type PayloadSubmission
• type Problem
  • func (p *Problem) String() string
• type Submission
• type SubmissionInfo
• type Track
  • func (t *Track) Len() int
  • func (t *Track) String() string

Variables

var (
	// ErrUnknownLanguage represents an error returned when the language requested does not exist
	ErrUnknownLanguage = errors.New("the language is unknown")
)

var (
	// UserAgent lets the API know where the call is being made from.
	// It's set from main() so that we have access to the version.
	UserAgent string
)

Types

type Client

type Client struct {
	APIHost  string
	XAPIHost string
	APIKey   string
	// contains filtered or unexported fields
}

Client contains the necessary information to contact the Exercism APIs

func NewClient

func NewClient(c *config.Config) *Client

NewClient returns an Exercism API Client

func (*Client) Demo

func (c *Client) Demo() ([]*Problem, error)

Demo fetches the first problem in each language track.

func (*Client) Do

func (c *Client) Do(req *http.Request, v interface{}) (*http.Response, error)

Do performs an http.Request and optionally parses the response body into the given interface

func (*Client) Download

func (c *Client) Download(submissionID string) (*Submission, error)

Download fetches a solution by submission key and writes it to disk.

func (*Client) Fetch

func (c *Client) Fetch(args []string) ([]*Problem, error)

Fetch retrieves problems from the API. In most cases these problems consist of a test suite and a README from the x-api, but it is also used when restoring earlier iterations.

func (*Client) List

func (c *Client) List(language string) ([]string, error)

List available problems for a language

func (*Client) NewRequest

func (c *Client) NewRequest(method, url string, body io.Reader) (*http.Request, error)

NewRequest returns an http.Request with information for the Exercism API

func (*Client) Restore

func (c *Client) Restore() ([]*Problem, error)

Restore fetches the latest revision of a solution and writes it to disk.

func (*Client) Submission

func (c *Client) Submission(language, excercise string) (*Submission, error)

Submission get the latest submitted exercise for the given language and exercise

func (*Client) Submissions

func (c *Client) Submissions() (map[string][]SubmissionInfo, error)

Submissions gets a list of submitted exercises and their current acceptance state.

func (*Client) Submit

func (c *Client) Submit(iter *Iteration) (*Submission, error)

Submit posts code to the API

func (*Client) Tracks

func (c *Client) Tracks() ([]*Track, error)

Tracks gets the current list of active and inactive language tracks.

func (*Client) Unsubmit

func (c *Client) Unsubmit() error

Unsubmit deletes a submission.

type Iteration

type Iteration struct {
	Key      string `json:"key"`
	Code     string `json:"code"`
	Path     string `json:"path"`
	Dir      string `json:"dir"`
	File     string `json:"-"`
	Language string `json:"-"`
	Problem  string `json:"-"`
}

Iteration represents a version of a particular exercise. This gets submitted to the API.

func (*Iteration) Identify

func (iter *Iteration) Identify() error

Identify attempts to determine the track and problem of an iteration.

func (*Iteration) RelativePath

func (iter *Iteration) RelativePath() string

RelativePath returns the path relative to the exercism dir.

type PayloadError

type PayloadError struct {
	Error string `json:"error"`
}

PayloadError represents an error message from the API.

type PayloadProblems

type PayloadProblems struct {
	Problems []*Problem
	PayloadError
}

PayloadProblems represents a response containing problems.

type PayloadSubmission

type PayloadSubmission struct {
	*Submission
	PayloadError
}

PayloadSubmission represents metadata about a successful submission.

type Problem

type Problem struct {
	ID        string            `json:"id"`
	TrackID   string            `json:"track_id"`
	Language  string            `json:"language"`
	Slug      string            `json:"slug"`
	Name      string            `json:"name"`
	Files     map[string]string `json:"files"`
	Submitted bool
}

Problem represents a specific problem in a given language track.

func (*Problem) String

func (p *Problem) String() string

type Submission

type Submission struct {
	URL           string            `json:"url"`
	TrackID       string            `json:"track_id"`
	Language      string            `json:"language"`
	Slug          string            `json:"slug"`
	Name          string            `json:"name"`
	Username      string            `json:"username"`
	ProblemFiles  map[string]string `json:"problem_files"`
	SolutionFiles map[string]string `json:"solution_files"`
}

Submission is an iteration that has been submitted to the API.

type SubmissionInfo

type SubmissionInfo struct {
	Slug  string `json:"slug"`
	State string `json:"state"`
}

SubmissionInfo contains state information about a submission.

type Track

type Track struct {
	ID       string   `json:"id"`
	Language string   `json:"language"`
	Active   bool     `json:"active"`
	Problems []string `json:"problems"`
}

Track is a collection of problems in a given language.

func (*Track) Len

func (t *Track) Len() int

Len lists the number of problems a track has.

func (*Track) String

func (t *Track) String() string