/google-calendar-simple-api

Pythonic wrapper for the Google Calendar API

Primary LanguagePythonMIT LicenseMIT

Google Calendar Simple API

PyPi Package Documentation Status Tests Discord

Google Calendar Simple API or gcsa is a library that simplifies event management in Google Calendars. It is a Pythonic object oriented adapter for the official API.

Installation

pip install gcsa

from sources:

git clone git@github.com:kuzmoyev/google-calendar-simple-api.git
cd google-calendar-simple-api
python setup.py install

See Getting started page for more details.

Example usage

List events

from gcsa.google_calendar import GoogleCalendar

calendar = GoogleCalendar('your_email@gmail.com')
for event in calendar:
    print(event)

Create event

from gcsa.event import Event

event = Event(
    'The Glass Menagerie',
    start=datetime(2020, 7, 10, 19, 0),
    location='Záhřebská 468/21',
    minutes_before_popup_reminder=15
)
calendar.add_event(event)

Create recurring event

from gcsa.recurrence import Recurrence, DAILY

event = Event(
    'Breakfast',
    start=date(2020, 7, 16),
    recurrence=Recurrence.rule(freq=DAILY)
)
calendar.add_event(event)

Suggestion: use beautiful_date to create date and datetime objects in your projects (because its beautiful... just like you).

References

Template for setup.py was taken from kennethreitz/setup.py