Tags

Author: alan-null

Tests/Integration/Tags.Tests.ps1

@@ -0,0 +1,39 @@
+Import-Module -Name Pester -Force
+Import-Module .\Toggl.API\Toggl.API.psm1 -Force
+
+$configPath = Join-Path -Path $PSScriptRoot -ChildPath "..\config.json"
+$config = Get-Content -Path $configPath | ConvertFrom-Json
+
+$apiToken = $config.apiToken
+$workspaceId = $config.workspaceId
+
+Describe 'Toggl Tag Integration Tests' {
+    $tagName = "TestTagToRemove"
+
+    Context "New-TogglTag" {
+        It "should create a new tag in the workspace" {
+            $newTag = New-TogglTag -ApiToken $apiToken -WorkspaceId $workspaceId -Name $tagName
+            $newTag | Should -Not -BeNullOrEmpty
+            $newTag.name | Should -BeExactly $tagName
+            $Script:tagId = $newTag.id
+        }
+    }
+
+    Context "Get-TogglTags" {
+        It "should retrieve the list of tags for the workspace" -Skip:($Script:tagId -eq $null) {
+            $tags = Get-TogglTags -ApiToken $apiToken -WorkspaceId $workspaceId
+            $tags | Should -Not -BeNullOrEmpty
+            $tags | Where-Object { $_.name -eq $tagName } | Should -Not -BeNullOrEmpty
+        }
+    }
+
+    Context "Remove-TogglTag" {
+        It "should delete the tag from the workspace" -Skip:($Script:tagId -eq $null) {
+            Remove-TogglTag -ApiToken $apiToken -WorkspaceId $workspaceId -TagId $Script:tagId
+
+            # Verify the tag was deleted
+            $tags = Get-TogglTags -ApiToken $apiToken -WorkspaceId $workspaceId
+            $tags | Where-Object { $_.id -eq $Script:tagId } | Should BeNullOrEmpty
+        }
+    }
+}

Toggl.API/Public/Tags/Get-TogglTags.ps1

@@ -0,0 +1,40 @@
+<#
+.SYNOPSIS
+Lists workspace tags from Toggl.
+
+.DESCRIPTION
+This cmdlet retrieves the list of tags for a specified workspace from Toggl. It sends a GET request to the Toggl API.
+
+.PARAMETER ApiToken
+The API token for authentication. (Mandatory)
+
+.PARAMETER WorkspaceId
+Numeric ID of the workspace. (Mandatory)
+
+.EXAMPLE
+Get-TogglTags -ApiToken "your_api_token" -WorkspaceId 123456
+#>
+function Get-TogglTags {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $true)]
+        [string]$ApiToken,
+
+        [Parameter(Mandatory = $true)]
+        [int]$WorkspaceId
+    )
+
+    $url = "$Global:TogglBaseUrl/workspaces/$WorkspaceId/tags"
+
+    $headers = Get-TogglAuthHeader -ApiToken $ApiToken
+
+    try {
+        $response = Invoke-RestMethod -Uri $url -Headers $headers -Method Get
+        return $response
+    }
+    catch {
+        Write-Error "Failed to retrieve tags: $_"
+    }
+}
+
+Export-ModuleMember -Function Get-TogglTags

Toggl.API/Public/Tags/New-TogglTag.ps1

@@ -0,0 +1,53 @@
+<#
+.SYNOPSIS
+Creates a new tag in a specified workspace in Toggl.
+
+.DESCRIPTION
+This cmdlet creates a new tag in a specified workspace in Toggl. It sends a POST request to the Toggl API.
+
+.PARAMETER ApiToken
+The API token for authentication. (Mandatory)
+
+.PARAMETER WorkspaceId
+Numeric ID of the workspace. (Mandatory)
+
+.PARAMETER Name
+The name of the tag. (Mandatory)
+
+.EXAMPLE
+New-TogglTag -ApiToken "your_api_token" -WorkspaceId 123456 -Name "NewTag"
+#>
+function New-TogglTag {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $true)]
+        [string]$ApiToken,
+
+        [Parameter(Mandatory = $true)]
+        [int]$WorkspaceId,
+
+        [Parameter(Mandatory = $true)]
+        [string]$Name
+    )
+
+    $url = "$Global:TogglBaseUrl/workspaces/$WorkspaceId/tags"
+
+    $body = @{
+        name = $Name
+    }
+
+    $jsonBody = $body | ConvertTo-Json -Compress -Depth 10
+
+    $headers = Get-TogglAuthHeader -ApiToken $ApiToken
+    $headers.Add("Content-Type", "application/json")
+
+    try {
+        $response = Invoke-RestMethod -Uri $url -Method Post -Headers $headers -Body $jsonBody
+        return $response
+    }
+    catch {
+        Write-Error "Failed to create tag: $_"
+    }
+}
+
+Export-ModuleMember -Function New-TogglTag

Toggl.API/Public/Tags/Remove-TogglTag.ps1

@@ -0,0 +1,46 @@
+<#
+.SYNOPSIS
+Deletes a tag in a specified workspace in Toggl.
+
+.DESCRIPTION
+This cmdlet deletes a tag in a specified workspace in Toggl. It sends a DELETE request to the Toggl API.
+
+.PARAMETER ApiToken
+The API token for authentication. (Mandatory)
+
+.PARAMETER WorkspaceId
+Numeric ID of the workspace. (Mandatory)
+
+.PARAMETER TagId
+Numeric ID of the tag. (Mandatory)
+
+.EXAMPLE
+Remove-TogglTag -ApiToken "your_api_token" -WorkspaceId 123456 -TagId 789012
+#>
+function Remove-TogglTag {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory = $true)]
+        [string]$ApiToken,
+
+        [Parameter(Mandatory = $true)]
+        [int]$WorkspaceId,
+
+        [Parameter(Mandatory = $true)]
+        [int]$TagId
+    )
+
+    $url = "$Global:TogglBaseUrl/workspaces/$WorkspaceId/tags/$TagId"
+
+    $headers = Get-TogglAuthHeader -ApiToken $ApiToken
+
+    try {
+        Invoke-RestMethod -Uri $url -Method Delete -Headers $headers
+        Write-Output "Tag deleted successfully."
+    }
+    catch {
+        Write-Error "Failed to delete tag: $_"
+    }
+}
+
+Export-ModuleMember -Function Remove-TogglTag