fetch

Documentation

Index

• Constants
• type Client
  • func NewClientWithContext(ctx context.Context, username, password string) (*Client, error)
  • func (c *Client) GetResponse() (string, Events, error)
• type Event
• type Events
  • func (e *Events) ConsumeICal(c *goics.Calendar, err error) error

Constants

const (
	EventDateStart   = "DTSTART"
	EventDescription = "DESCRIPTION"
	EventSummary     = "SUMMARY"
)

const (
	LoginURL    = "https://ocjene.skole.hr/login"
	GradeAllURL = "https://ocjene.skole.hr/grade/all"
	CalendarURL = "https://ocjene.skole.hr/exam/ical"
	Timeout     = 60 * time.Second // site can get really slow sometimes
)

const (
	ErrUnexpectedStatus = "unexpected status code %v"
	ErrCSRFToken        = "could not find CSRF token"
)

Types

type Client

type Client struct {
	URL *url.URL
	// contains filtered or unexported fields
}

Client structure holds all HTTP Client related fields.

func NewClientWithContext

func NewClientWithContext(ctx context.Context, username, password string) (*Client, error)

NewClientWithContext creates new *Client, initializing HTTP Cookie Jar, context and username with password.

func (*Client) GetResponse

func (c *Client) GetResponse() (string, Events, error)

GetResponse attempts to fetch CSRF Token, do SSO/SAML request to have proper security and authentication cookies populated and then proceeds to fetch all subjects and their grades, as well as all calendar events for exams in ICS format, returning raw grades listing body, parsed exam events and optional error.

type Event

type Event struct {
	Start                time.Time
	Description, Summary string
}

Event structure holds ICS event-related fields.

type Events

type Events []Event

Events is a slice of Event structure.

func (*Events) ConsumeICal

func (e *Events) ConsumeICal(c *goics.Calendar, err error) error

ConsumeICal is a ICS data decoder that extracts DTSTART, DESCRIPTION and SUMMARY values, parsing timestamp with maximum flexibility and in local timezone, returning optional error.