gcalendar

A command line tool for Google Calendar that uses Python

Getting Started

Prerequisites

The latest version of Python

Installing

git clone (this repository)
Open the command line and change to the directory of where you cloned this repository'.
(Optional) set up a virtaul environment. Do pip install virtualenv if you do not already have it installed. Otherwise, go to the project directory and type in virtualenv venv. This will create a virtual environment and will be ignored when committing.
Type in pip install --editable ..
Do gcalendar --help to check if you installed it correctly.

Starting Google Calendar API

Go to this website
Scroll down and click on the big blue button that says "Enable The Google Calendar Api"
Follow the steps to set it up.
Copy your client_id and your client_secret.
Open the command line and type in gcalendar authorize -ci (your client_id) -cs (your client_secret).
Allow quickstart access to your Google Calendar.
You are now set up.

Usage

Supported Commands:

  authorize       Authorizes credentials for Google Api
  copy            Copies a schedule from a day to another day
  delete          Delete events from a specific day
  list            List events from a file or day
  list-schedules  Lists all of the schedules that are currently saved
  spawn           Spawns an instance of Google Calendar in a web browser
  save            Save a schedule of events to a file
  upload          Upload events from a file to a specific date

Do gcalendar (command) --help for more info.

Running tests

Do python -m unittest (test_file). Each one starts with a test_ prefix.

Dependencies

Google Api Client - Calendar API
click - Command line tool
oauth2 - Used for authorizing applications

License

This project is licensed under the MIT License - see the LICENSE.md file for details

iCodeCoolStuff/gcalendar