feat: implement caldav search

vendor/github.com/dolanor/caldav-go/icalendar/components/calendar.go

@@ -0,0 +1,87 @@
+package components
+
+import (
+	"fmt"
+	"github.com/dolanor/caldav-go/icalendar/values"
+	"github.com/dolanor/caldav-go/utils"
+	"time"
+)
+
+type Calendar struct {
+
+	// specifies the identifier corresponding to the highest version number or the minimum and maximum
+	// range of the iCalendar specification that is required in order to interpret the iCalendar object.
+	Version string `ical:",2.0"`
+
+	// specifies the identifier for the product that created the iCalendar object
+	ProductId string `ical:"prodid,-//dolanor/caldav-go//NONSGML v1.0.0//EN"`
+
+	// specifies the text value that uniquely identifies the "VTIMEZONE" calendar component.
+	TimeZoneId string `ical:"tzid,omitempty"`
+
+	// defines the iCalendar object method associated with the calendar object.
+	Method values.Method `ical:",omitempty"`
+
+	// defines the calendar scale used for the calendar information specified in the iCalendar object.
+	CalScale values.CalScale `ical:",omitempty"`
+
+	// defines the different timezones used by the various components nested within
+	TimeZones []*TimeZone `ical:",omitempty"`
+
+	// unique events to be stored together in the icalendar file
+	Events []*Event `ical:",omitempty"`
+}
+
+func (c *Calendar) UseTimeZone(location *time.Location) *TimeZone {
+	tz := NewDynamicTimeZone(location)
+	c.TimeZones = append(c.TimeZones, tz)
+	c.TimeZoneId = tz.Id
+	return tz
+}
+
+func (c *Calendar) UsingTimeZone() bool {
+	return len(c.TimeZoneId) > 0
+}
+
+func (c *Calendar) UsingGlobalTimeZone() bool {
+	return c.UsingTimeZone() && c.TimeZoneId[0] == '/'
+}
+
+func (c *Calendar) ValidateICalValue() error {
+
+	for i, e := range c.Events {
+
+		if e == nil {
+			continue // skip nil events
+		}
+
+		if err := e.ValidateICalValue(); err != nil {
+			msg := fmt.Sprintf("event %d failed validation", i)
+			return utils.NewError(c.ValidateICalValue, msg, c, err)
+		}
+
+		if e.DateStart == nil && c.Method == "" {
+			msg := fmt.Sprintf("no value for method and no start date defined on event %d", i)
+			return utils.NewError(c.ValidateICalValue, msg, c, nil)
+		}
+
+	}
+
+	if c.UsingTimeZone() && !c.UsingGlobalTimeZone() {
+		for i, t := range c.TimeZones {
+			if t == nil || t.Id != c.TimeZoneId {
+				msg := fmt.Sprintf("timezone ID does not match timezone %d", i)
+				return utils.NewError(c.ValidateICalValue, msg, c, nil)
+			}
+		}
+	}
+
+	return nil
+
+}
+
+func NewCalendar(events ...*Event) *Calendar {
+	cal := new(Calendar)
+	cal.Events = events
+	return cal
+}

vendor/github.com/dolanor/caldav-go/icalendar/components/event.go

@@ -0,0 +1,172 @@
+package components
+
+import (
+	"github.com/dolanor/caldav-go/icalendar/values"
+	"github.com/dolanor/caldav-go/utils"
+	"time"
+)
+
+type Event struct {
+
+	// defines the persistent, globally unique identifier for the calendar component.
+	UID string `ical:",required"`
+
+	// indicates the date/time that the instance of the iCalendar object was created.
+	DateStamp *values.DateTime `ical:"dtstamp,required"`
+
+	// specifies when the calendar component begins.
+	DateStart *values.DateTime `ical:"dtstart,required"`
+
+	// specifies the date and time that a calendar component ends.
+	DateEnd *values.DateTime `ical:"dtend,omitempty"`
+
+	// specifies a positive duration of time.
+	Duration *values.Duration `ical:",omitempty"`
+
+	// defines the access classification for a calendar component.
+	AccessClassification values.EventAccessClassification `ical:"class,omitempty"`
+
+	// specifies the date and time that the calendar information was created by the calendar user agent in the
+	// calendar store.
+	// Note: This is analogous to the creation date and time for a file in the file system.
+	Created *values.DateTime `ical:",omitempty"`
+
+	// provides a more complete description of the calendar component, than that provided by the Summary property.
+	Description string `ical:",omitempty"`
+
+	// specifies information related to the global position for the activity specified by a calendar component.
+	Geo *values.Geo `ical:",omitempty"`
+
+	// specifies the date and time that the information associated with the calendar component was last revised in the
+	// calendar store.
+	// Note: This is analogous to the modification date and time for a file in the file system.
+	LastModified *values.DateTime `ical:"last-modified,omitempty"`
+
+	// defines the intended venue for the activity defined by a calendar component.
+	Location *values.Location `ical:",omitempty"`
+
+	// defines the organizer for a calendar component.
+	Organizer *values.OrganizerContact `ical:",omitempty"`
+
+	// defines the relative priority for a calendar component.
+	Priority int `ical:",omitempty"`
+
+	// defines the revision sequence number of the calendar component within a sequence of revisions.
+	Sequence int `ical:",omitempty"`
+
+	// efines the overall status or confirmation for the calendar component.
+	Status values.EventStatus `ical:",omitempty"`
+
+	// defines a short summary or subject for the calendar component.
+	Summary string `ical:",omitempty"`
+
+	// defines whether an event is transparent or not to busy time searches.
+	values.TimeTransparency `ical:"transp,omitempty"`
+
+	// defines a Uniform Resource Locator (URL) associated with the iCalendar object.
+	Url *values.Url `ical:",omitempty"`
+
+	// used in conjunction with the "UID" and "SEQUENCE" property to identify a specific instance of a recurring
+	// event calendar component. The property value is the effective value of the DateStart property of the
+	// recurrence instance.
+	RecurrenceId *values.DateTime `ical:"recurrence_id,omitempty"`
+
+	// defines a rule or repeating pattern for recurring events, to-dos, or time zone definitions.
+	RecurrenceRules []*values.RecurrenceRule `ical:",omitempty"`
+
+	// property provides the capability to associate a document object with a calendar component.
+	Attachment *values.Url `ical:"attach,omitempty"`
+
+	// defines an "Attendee" within a calendar component.
+	Attendees []*values.AttendeeContact `ical:",omitempty"`
+
+	// defines the categories for a calendar component.
+	Categories *values.CSV `ical:",omitempty"`
+
+	// specifies non-processing information intended to provide a comment to the calendar user.
+	Comments []values.Comment `ical:",omitempty"`
+
+	// used to represent contact information or alternately a reference to contact information associated with the calendar component.
+	ContactInfo *values.CSV `ical:"contact,omitempty"`
+
+	// defines the list of date/time exceptions for a recurring calendar component.
+	*values.ExceptionDateTimes `ical:",omitempty"`
+
+	// defines the list of date/times for a recurrence set.
+	*values.RecurrenceDateTimes `ical:",omitempty"`
+
+	// used to represent a relationship or reference between one calendar component and another.
+	RelatedTo *values.Url `ical:"related-to,omitempty"`
+
+	// defines the equipment or resources anticipated for an activity specified by a calendar entity.
+	Resources *values.CSV `ical:",omitempty"`
+}
+
+// validates the event internals
+func (e *Event) ValidateICalValue() error {
+
+	if e.UID == "" {
+		return utils.NewError(e.ValidateICalValue, "the UID value must be set", e, nil)
+	}
+
+	if e.DateStart == nil {
+		return utils.NewError(e.ValidateICalValue, "event start date must be set", e, nil)
+	}
+
+	if e.DateEnd == nil && e.Duration == nil {
+		return utils.NewError(e.ValidateICalValue, "event end date or duration must be set", e, nil)
+	}
+
+	if e.DateEnd != nil && e.Duration != nil {
+		return utils.NewError(e.ValidateICalValue, "event end date and duration are mutually exclusive fields", e, nil)
+	}
+
+	return nil
+
+}
+
+// adds one or more recurrence rule to the event
+func (e *Event) AddRecurrenceRules(r ...*values.RecurrenceRule) {
+	e.RecurrenceRules = append(e.RecurrenceRules, r...)
+}
+
+// adds one or more recurrence rule exception to the event
+func (e *Event) AddRecurrenceExceptions(d ...*values.DateTime) {
+	if e.ExceptionDateTimes == nil {
+		e.ExceptionDateTimes = new(values.ExceptionDateTimes)
+	}
+	*e.ExceptionDateTimes = append(*e.ExceptionDateTimes, d...)
+}
+
+// checks to see if the event is a recurrence
+func (e *Event) IsRecurrence() bool {
+	return e.RecurrenceId != nil
+}
+
+// checks to see if the event is a recurrence override
+func (e *Event) IsOverride() bool {
+	return e.IsRecurrence() && !e.RecurrenceId.Equals(e.DateStart)
+}
+
+// creates a new iCalendar event with no end time
+func NewEvent(uid string, start time.Time) *Event {
+	e := new(Event)
+	e.UID = uid
+	e.DateStamp = values.NewDateTime(time.Now().UTC())
+	e.DateStart = values.NewDateTime(start)
+	return e
+}
+
+// creates a new iCalendar event that lasts a certain duration
+func NewEventWithDuration(uid string, start time.Time, duration time.Duration) *Event {
+	e := NewEvent(uid, start)
+	e.Duration = values.NewDuration(duration)
+	return e
+}
+
+// creates a new iCalendar event that has an explicit start and end time
+func NewEventWithEnd(uid string, start time.Time, end time.Time) *Event {
+	e := NewEvent(uid, start)
+	e.DateEnd = values.NewDateTime(end)
+	return e
+}

vendor/github.com/dolanor/caldav-go/icalendar/components/timezone.go

@@ -0,0 +1,40 @@
+package components
+
+import (
+	"fmt"
+	"github.com/dolanor/caldav-go/icalendar/values"
+	"net/url"
+	"time"
+)
+
+type TimeZone struct {
+
+	// defines the persistent, globally unique identifier for the calendar component.
+	Id string `ical:"tzid,required"`
+
+	// the location name, as defined by the standards body
+	ExtLocationName string `ical:"x-lic-location,omitempty"`
+
+	// defines a Uniform Resource Locator (URL) associated with the iCalendar object.
+	Url *values.Url `ical:"tzurl,omitempty"`
+
+	// specifies the date and time that the information associated with the calendar component was last revised in the
+	// calendar store.
+	// Note: This is analogous to the modification date and time for a file in the file system.
+	LastModified *values.DateTime `ical:"last-modified,omitempty"`
+
+	// TODO need to figure out how to handle standard and daylight savings time
+
+}
+
+func NewDynamicTimeZone(location *time.Location) *TimeZone {
+	t := new(TimeZone)
+	t.Id = location.String()
+	t.ExtLocationName = location.String()
+	t.Url = values.NewUrl(url.URL{
+		Scheme: "http",
+		Host:   "tzurl.org",
+		Path:   fmt.Sprintf("/zoneinfo/%s", t.Id),
+	})
+	return t
+}