.editorconfig

@@ -3,23 +3,15 @@ root = true
 [Makefile]
 indent_style = tab
 
-[*.{html,py,js,yml}]
+[*.{py,yml}]
 charset = utf-8
 
-[*.js]
-indent_style = space
-indent_size = 2
-
 [*.yml]
 indent_style = space
 indent_size = 2
 
-[*.html]
-indent_style = space
-indent_size = 4
-
 [*.py]
 indent_style = space
 indent_size = 4
-line_length = 79
+line_length = 100
 multi_line_output = 3

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Report a problem and provide necessary context
+title: 'Fix ...'
+labels: 'bug'
+
+---
+
+<!--
+Hi, thanks for submitting a bug. We appreciate that.
+
+But, we will need some information about what's wrong to help you.
+-->
+## What's wrong
+
+<!-- Describe what is not working. -->
+
+## How it should work?
+
+<!-- Describe how it should work. -->
+
+## Checklist before calling for maintainers
+
+* [ ] Have you checked to ensure there aren't other open [Issues](../issues) for the same problem?
+

.github/actions/large-pr-check/action.yaml

@@ -0,0 +1,49 @@
+name: "Large PR checker"
+description: "Blocks PR if number of lines changed is excessive. Modified version of https://github.com/adolfosilva/gh-large-pr-check/blob/main/action.yml"
+
+inputs:
+  max_lines_changed:
+    description: "Maximum number of lines changed allowed"
+    required: true
+    default: "500"
+  target_branch:
+    description: The branch to compare against
+    required: true
+    default: main
+outputs:
+  total_lines_changed:
+    description: "Total lines changed in this PR"
+    value: ${{ steps.get_total_lines_changed.outputs.total_lines_changed }}
+
+runs:
+  using: "composite"
+  steps:
+    - id: fetch_target_branch
+      run: |
+        git fetch origin ${{ inputs.target_branch }}
+      shell: bash
+    - id: get_total_lines_changed
+      run: |
+        size=$(git diff --shortstat origin/${{ inputs.target_branch }} ':(exclude)*.lock' \
+        | awk '{ print $4+$6 }' \
+        | awk -F- '{print $NF}' \
+        | bc)
+
+        echo ""
+        echo "Total lines changed (note: *.lock files are excluded from this count): $size"
+        echo "total_lines_changed=$size" >> $GITHUB_OUTPUT
+      shell: bash
+    - name: Comment PR
+      if: ${{ fromJSON(steps.get_total_lines_changed.outputs.total_lines_changed) > fromJSON(inputs.max_lines_changed) }}
+      uses: thollander/actions-comment-pull-request@v2
+      with:
+        comment_tag: pr_size
+        mode: recreate
+        message: |
+          :boom: :boom: :boom:
+          Total lines changed ${{ steps.get_total_lines_changed.outputs.total_lines_changed }} is greater than ${{ inputs.max_lines_changed }}.
+          Please consider breaking this PR down.
+    - id: fail
+      if: ${{ fromJSON(steps.get_total_lines_changed.outputs.total_lines_changed) > fromJSON(inputs.max_lines_changed) }}
+      run: exit 1
+      shell: bash

.github/pull_request_template.md

@@ -0,0 +1,11 @@
+## #(issue number): Summarize your changes
+
+<!--Please include the reasons behind these changes and any relevant context.
+This project only accepts pull requests related to open issues -->
+<!--- Special phrase to auto-close the issue that your PR fixes -->
+Closes # (issue number)
+
+## Checklist before requesting a review
+
+- [ ] Have you followed the guidelines in [CONTRIBUTING.md](../CONTRIBUTING.md)?
+- [ ] Have you performed a self-review?

.github/workflows/pr.yml

@@ -0,0 +1,89 @@
+name: pr
+
+on:
+  - pull_request
+
+permissions:
+  contents: read
+  pull-requests: read
+  checks: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  PYTHON_VERSION: "3.8"
+  POETRY_VERSION: "1.8.3"
+  RUFF_VERSION: "0.6.7"
+
+jobs:
+  check-pr-diff:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check PR diff size
+        uses: ./.github/actions/large-pr-check
+        with:
+          target_branch: ${{ github.event.pull_request.base.ref }}
+          max_lines_changed: 300
+
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install ruff==${{ env.RUFF_VERSION }}
+
+      - name: Run Ruff
+        run: ruff check --output-format=github .
+
+      - name: Spell Check
+        uses: crate-ci/typos@master
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13.0-rc.2"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: 'pip'
+
+      - name: Install Poetry
+        run: pip install poetry==${{ env.POETRY_VERSION }}
+
+      - name: Restore dependencies from cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: dependencies-cache-${{ runner.os }}-${{ env.PYTHON_VERSION }}-${{ env.POETRY_VERSION }}
+          restore-keys: |
+            dependencies-cache-${{ runner.os }}-${{ env.PYTHON_VERSION }}-
+
+      - name: Install dependencies
+        if: steps.setup-python.outputs.cache-hit != 'true'
+        run: |
+          poetry config virtualenvs.create false
+          poetry install --no-root --no-interaction
+
+      - name: Run Pytest on Python ${{ matrix.python }}
+        run: poetry run pytest -m "not integration"

.github/workflows/release.yml

@@ -0,0 +1,56 @@
+name: Manually Upload Python Package to Pypi
+
+on: workflow_dispatch
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.8"
+  POETRY_CORE_VERSION: "1.9.0"
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build poetry-core==${{ env.POETRY_CORE_VERSION }}
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+
+    needs:
+      - release-build
+
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/toggl_python
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test_release.yml

@@ -0,0 +1,60 @@
+name: Upload Python Package to Test Pypi
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.8"
+  POETRY_CORE_VERSION: "1.9.0"
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build poetry-core==${{ env.POETRY_CORE_VERSION }}
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+
+    needs:
+      - release-build
+
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    environment:
+      name: test_pypi
+      url: https://test.pypi.org/p/toggl_python
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

.gitignore

@@ -47,39 +47,9 @@ coverage.xml
 .hypothesis/
 .pytest_cache/
 
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
 # pyenv
 .python-version
 
-# celery beat schedule file
-celerybeat-schedule
-
-# SageMath parsed files
-*.sage.py
-
 # dotenv
 .env
 
@@ -88,23 +58,13 @@ celerybeat-schedule
 venv/
 ENV/
 
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
 # mypy
 .mypy_cache/
 
+.ruff_cache
+
 # IDE settings
 .vscode/
 local_*.py
 .idea/
-
-# readthedocs sphinx generated documentation
-_build/
+pyrightconfig.json