time-handler

Contents

• About
• Requirements
• Installation
• Usage
  • CLI
    • examples
    • options
  • Environment varibles
  • Application inputs
• First run
• New Token
• Config files

About

Time-handler is simple console application to count time spent on events from Google Calendar. Based on official Google tutorial

Requirements

• node.js
• npm

Installation

npm i -g time-handler

Usage

You have to input some data (date range and users) to make time-handler working. There are 3 ways to input data:

• CLI arguments (highest priority)
• environment variables
• .env file (from dotenv package style) (less priority than environment variables)
• app inputs (available only when variable is not defined by other way)

CLI

To run app you can use:

time-handler <args>

from directory with time-handler

examples

time-handler --help

time-handler -S 2021-04-06 -e 2021-04-08 -u "[email protected] as User1, [email protected]"

time-handler --this_month -u [email protected]

options

• --token/-T/-t - [string] Name of token json file
• --client_id - [string] Google API client ID
• --client_secret - [string] Google API client secret
• --redirect_uri - [string] Google API redirect_uri (first element of array)
• --hourly_rate - [number] Hourly rate (if value 1 money reward in summary will be skipped)
• --start/-S/-s - [string] [YYYY-MM-DD] (or any string parsable to JS Date object) - Start date (of date range)
• --end/-E/-e - [string] [YYYY-MM-DD] (or any string parsable to JS Date object) - End date (of date range)
• --users/--user/-U/-u - [string] Calendar ID (mostly email address), optionally you can set alias f.e. [email protected] as User One. If you have many users use coma as separator f.e [email protected] as User One, [email protected] (in this case [email protected] won't have alias)
• --this_month - [boolean] Set date range to this month (overwrite others dates)
• --verbose - [boolean] Print events summary

Environment varibles:

Every value set by CLI options can be set in environment variables also.

List of variables:

• TOKEN
• CLIENT_ID
• CLIENT_SECRET
• REDIRECT_URI
• HOURLY_RATE
• START
• END
• USERS
• THIS_MONTH
• VERBOSE

Application inputs

If you didn't set date range or users application will ask you about missing value, you can just type value and press enter.

First run

If you run app first time, you will be asked for access token (and API's credentials if you didn't set it, (check a tutorial how to get the credentials)). To generate it follow the messages that app will print:

Authorize this app by visiting this url: https://[...]

Open link, grant access to Time-handler and copy token generated by Google Calendar and paste it after:

Enter the code from that page here:

New token

If you want to generate new token (for new account) you need to set new token file name. You can do it by --token CLI option or TOKEN environment variable. By default token file will be named as token.json.

Config files

Config files (.env, token.json(or named differently)) are stored in:

Windows: C:/Users/(user)/.local/share/.time-handler

Linux: /home/(user)/.local/share/.time-handler

Powershell, Git Bash, Bash:

cd $HOME/.local/share/.time-handler

cmd:

cd %USERPROFILE%/.local/share/.time-handler