Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dtgoitia/billy


https://github.com/dtgoitia/billy

Last synced: 25 days ago
JSON representation

Awesome Lists containing this project

README

        

## Set up

* Install:

```shell
git clone [email protected]:dtgoitia/billy.git
cd billy/

# Create and activate Python virtual environment
python3 -m venv .venv
. .venv/bin/activate

# install repo dependencies locally
make install
```

* Configuration (mandatory):

At `~/.config/billy/config.jsonc`:

```json
{
"projects": [
{ "id": 123, "alias": "my super project" },
{ "id": 456, "alias": "another project" }
]
}
```

* Credentials (mandatory):

At `~/.config/billy/secrets.jsonc`:

```jsonc
{
// Get API token at https://track.toggl.com/profile
"gsheet_url": "https://url.to/my/google/spreadsheet",
"toggle_api_token": "_____INSERT_API_TOKEN_HERE_____"
}
```

Follow [this instructions][1] to obtain Google Spreadsheet credentials and enable required GCP APIs. Copy the obtained client secret JSON file at `~/.config/billy/gspread_credentials.json`.

[1]: https://docs.gspread.org/en/latest/oauth2.html#for-end-users-using-oauth-client-id "How to obtain Google Spreadsheet credentials"