fetch

package
v0.34.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 7, 2026 License: MIT Imports: 16 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	EventDateStart   = "DTSTART"
	EventDescription = "DESCRIPTION"
	EventSummary     = "SUMMARY"

	LayoutISO8601CompactZ    = "20060102T150405Z0700"
	LayoutISO8601CompactNoTZ = "20060102T150405"
	LayoutISO8601Short       = "20060102"
)
View Source 
const (
	Timeout  = 120 * time.Second                                                                                                 // site can get really slow sometimes
	ChromeUA = "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Mobile Safari/537.36" // ChromeUA is a user agent string mimicking Chrome on Android.
)
View Source 
const (
	BaseURL        = "https://ocjene.skole.hr"
	LoginURL       = "https://ocjene.skole.hr/login"
	ClassURL       = "https://ocjene.skole.hr/class"
	ClassActionURL = "https://ocjene.skole.hr/class_action/%v/course"
	GradeAllURL    = "https://ocjene.skole.hr/grade/all"
	CalendarURL    = "https://ocjene.skole.hr/exam/ical"
	CourseURL      = "https://ocjene.skole.hr/course"

	MaxBodySize = 32 * 1024 * 1024 // 32 MiB upper bound for any single response

	// AcceptLanguageHR forces Croatian responses; the login alert matcher and subject names depend on it.
	AcceptLanguageHR = "hr,hr-HR;q=0.9,en;q=0.1"
)

Variables

View Source 
var (
	ErrUnexpectedStatus = errors.New("unexpected status code")
	ErrCSRFToken        = errors.New("could not find CSRF token")
	ErrNilBody          = errors.New("client body is nil")
	ErrInvalidLogin     = errors.New("unable to login")
	ErrBodyTooLarge     = errors.New("response body exceeds size limit")
	ErrInvalidClassID   = errors.New("invalid class ID — refusing to construct URL")
	ErrInvalidHost      = errors.New("portal href resolves to non-portal host — refusing to fetch")
)
View Source 
var (
	ErrParseTimestamp = errors.New("failed to parse timestamp")
)

Functions

This section is empty.

Types

type Class 

type Class struct {
	ID     string
	Name   string
	Year   string
	School string
}

Class structure holds all active classes.

type Classes 

type Classes []Class

Classes is a slice of Class structure.

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) CloseConnections 

func (c *Client) CloseConnections()

CloseConnections closes all connections on its transport.

func (*Client) GetClassEvents 

func (c *Client) GetClassEvents(classID string) ([]byte, Events, error)

GetClassEvents attempts to fetch all subjects and their grades, as well as all calendar events for exams in ICS format, returning raw grades listing body bytes, parsed exam events and optional error.

func (*Client) GetClasses 

func (c *Client) GetClasses() ([]byte, error)

GetClasses attempts to fetch all courses where a student has been previously enlisted or still is (multiple active classes possible).

func (*Client) GetCourse 

func (c *Client) GetCourse(dest string) ([]byte, error)

GetCourse fetches the course with the given destination URL and returns its raw body, or an error.

func (*Client) GetCourses 

func (c *Client) GetCourses() ([]byte, error)

GetCourses attempts to fetch all active courses.

func (*Client) Login 

func (c *Client) Login() error

Login attempts get CSRF Token and do SSO/SAML authentication with random User-Agent per session.

type Course 

type Course struct {
	URL  string
	Name string
}

type Courses 

type Courses []Course

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, _ 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.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.