Added helper scripts

- load .env file
- cleanup workspace

Author: alan-null

.env.example

@@ -0,0 +1,2 @@
+TOGGL_API_TOKEN={YOUR_API_TOKEN}
+TOGGL_WORKSPACE_ID={YOUR_WORKSPACE_ID}

.gitignore

@@ -1 +1,2 @@
-Tests/config.json
+Tests/config.json
+.env

README.md

@@ -27,4 +27,15 @@ PowerShell module to interact with the [**Toggl API**](https://engineering.toggl
 - **Remove-TogglTimeEntry**: Deletes a time entry.
 
 ### Authentication
-- **Get-TogglAuthHeader**: Generates the authentication header from the API token.
+- **Get-TogglAuthHeader**: Generates the authentication header from the API token.
+
+## Development
+
+### Tests
+To run tests you need to have your own API key and workspace. Once you have it create `.env` using `.env.example` as an example.
+
+To load environment variables to current session use `.\scripts\load-env.ps1`
+
+To cleanup workspace use `.\scripts\cleanup-workspace.ps1`
+
+Tests load settins either from environment variables or from `.\Tests\config.json`

scripts/cleanup-workspace.ps1

@@ -0,0 +1,49 @@
+param (
+    [Parameter(Mandatory = $false)]
+    [string]$ApiToken = $env:TOGGL_API_TOKEN,
+
+    [Parameter(Mandatory = $false)]
+    [int]$WorkspaceId = [int]$env:TOGGL_WORKSPACE_ID
+)
+
+if (-not $ApiToken) {
+    Write-Error "ApiToken is required."
+    return
+}
+
+if (-not $WorkspaceId) {
+    Write-Error "WorkspaceId is required."
+    return
+}
+
+Clear-Host
+Import-Module .\Toggl.API\Toggl.API.psm1 -Force
+
+Write-Host "Cleaning up the workspace"
+
+Write-Host "Removing projects" -ForegroundColor DarkGreen
+Get-TogglProjects -ApiToken $ApiToken -WorkspaceId $WorkspaceId  | % {
+    Write-Host "Removing project: $($_.name)" -ForegroundColor DarkGray
+    Remove-TogglProject `
+        -ApiToken $ApiToken `
+        -WorkspaceId $WorkspaceId `
+        -ProjectId $_.id
+}
+
+Write-Host "Removing tags" -ForegroundColor DarkGreen
+Get-TogglTags -ApiToken $ApiToken -WorkspaceId $WorkspaceId | % {
+    Write-Host "Removing tag: $($_.name)" -ForegroundColor DarkGray
+    Remove-TogglTag `
+        -ApiToken $ApiToken `
+        -WorkspaceId $WorkspaceId `
+        -TagId $_.id
+}
+
+Write-Host "Removing time entries" -ForegroundColor DarkGreen
+Get-TogglTimeEntries -ApiToken $ApiToken | ? { $_.wid -eq $WorkspaceId }  | ? { $_.server_deleted_at -eq $null } | % {
+    Write-Host "Removing time entry: $($_.description)" -ForegroundColor DarkGray
+    Remove-TogglTimeEntry `
+        -ApiToken $ApiToken `
+        -WorkspaceId $WorkspaceId `
+        -TimeEntryId $_.id
+}

scripts/load-env.ps1

@@ -0,0 +1,8 @@
+Get-Content "$PSScriptRoot\..\.env" | ForEach-Object {
+    if ($_ -match '^(.*?)=(.*)$') {
+        $key = $matches[1].Trim()
+        $value = $matches[2].Trim()
+        Write-Host "Setting environment variable: $key=$value" -ForegroundColor Green
+        Set-Item "env:$key" $value
+    }
+}