Public/Get-TogglEntry.ps1

function Get-TogglEntry() {
    <#
    .SYNOPSIS
        Gets Toggl Time Entries

    .DESCRIPTION
        This Cmdlet queries the Toggl API for Time Entries (time_entries). It returns all Entries, if no parameter is given.
        You can search Entries by its Description, specify a Workspace, and a time span.

        You can pipe any PSToggl object which belongs to a time entry to this Cmdlet, like:
        * Workspace: Returns Time Entries for the given Workspace.
        * Project: Returns Time Entries whose pid matches the given project.
        * Client: Returns Time Entries for the given client. (performance hint: Need to obtain all projects to match pid to customer)
        *(WIP) User (This is a special case, a user contains its time entries as array. If not, will query for it and return))

    .PARAMETER Current
        If set, only the currently running timer is returned. If no time entry is running, it returns nothing.

    .PARAMETER Description
        Specifies the Description of the items to return.

    .PARAMETER From
        Will only return Entries created after the specified datetime.

    .PARAMETER To
        Will only return Entries created before the specified datetime.

    .PARAMETER Workspace
        Specifies the Workspace Id. Defaults to your primary Workspace.

    .INPUTS
        PSToggl.Workspace
        PSToggl.Project
        PSToggl.Client
        ?PSToggl.User?

    .OUTPUTS
        PSToggl.Entry

    .EXAMPLE
        Get-TogglEntry -Name

    .EXAMPLE
        Get-TogglProjcet -Name "Antons Website" | Get-TogglEntry

    .NOTES
        Version: 1.0
        Author: Clijsters
        Creation Date: 03.04.2017
        Purpose/Change: Add -Workspace parameter, supplement comment based help
    #>

    [CmdletBinding(DefaultParameterSetName = "all")]
    [OutputType("PSToggl.Entry")]
    param(
        # Get currently running Entry
        [Parameter(Position = 1, Mandatory = $false, ParameterSetName = "current")]
        [switch] $Current,

        # Entry name
        [Parameter(Position = 1, Mandatory = $true, ParameterSetName = "byDescription")]
        [string] $Description,

        # Entry name
        [Parameter(Position = 1, Mandatory = $true, ParameterSetName = "byObject", ValueFromPipeline = $true)]
        [psobject[]] $InputObject,

        # Start Date (convert to ISO 8601)
        [Parameter(Position = 1, Mandatory = $false, ParameterSetName = "all")]
        [Parameter(Position = 2, Mandatory = $false, ParameterSetName = "byDescription")]
        [Parameter(Position = 2, Mandatory = $false, ParameterSetName = "byObject")]
        [datetime] $From,

        # End Date
        [Parameter(Position = 2, Mandatory = $false, ParameterSetName = "all")]
        [Parameter(Position = 3, Mandatory = $false, ParameterSetName = "byDescription")]
        [Parameter(Position = 3, Mandatory = $false, ParameterSetName = "byObject")]
        [datetime] $To
    )

    Begin {
        New-Item function::local:Write-Verbose -Value (
            New-Module -ScriptBlock { param($verb, $fixedName, $verbose) } -ArgumentList @((Get-Command Write-Verbose), $PSCmdlet.MyInvocation.InvocationName, $PSCmdlet.MyInvocation.BoundParameters["Verbose"].IsPresent)
        ).NewBoundScriptBlock{
            param($Message)
            if ($verbose) {
                & $verb -Message "=>$fixedName $Message" -Verbose
            }
            else {
                & $verb -Message "=>$fixedName $Message"
            }
        } | Write-Verbose

        Write-Debug "Parameterset: `"$($PsCmdlet.ParameterSetName)`""
        $suffix = if ($Current) {"/current"} else {""}
        Write-Verbose "Querying API for Toggl Entries..."
        Write-Verbose "Suffix: `"$suffix`""
        #TODO Workspaces - not for current?
        $allEntries = Invoke-TogglMethod -UrlSuffix ("time_entries" + $suffix) -Method "GET"
        if ($From -or $To) {
            Write-Warning "`$From and `$To are not yet supported"
        }
    }

    Process {
        switch ($PsCmdlet.ParameterSetName) {
            "byObject" {
                Write-Verbose "Processing InputObject of type `"$($InputObject[0].psobject.TypeNames[0])`""
                switch ($InputObject[0].psobject.TypeNames[0]) {
                    "PSToggl.Entry" {
                        $entriesLambda = {
                            param($obj)
                            $obj
                        }
                    }
                    "PSToggl.Project" {
                        $entriesLambda = {
                            param($obj)
                            $allEntries | Where-Object {$_.pid -eq $obj.id}
                        }
                    }
                    "PSToggl.Tag" {
                        $entriesLambda = {
                            param($obj)
                            $allEntries | Where-Object {$_.tags -contains $obj.name} #or id??
                        }
                    }
                    "PSToggl.Client" {
                        $entriesLambda = {
                            param($obj)
                            $allProjects = $obj | Get-TogglProject -Workspace $Workspace | Select-Object id
                            $allEntries | Where-Object {$_.pid -in $allProjects}
                        }
                    }
                }
                $tmpList = New-Object -TypeName System.Collections.ArrayList
                foreach ($item in $InputObject) {
                    $entriesLambda.Invoke($item) | Foreach-Object {$tmpList.Add($_) | Out-Null}
                }
                $entries = $tmpList
            }

            "byDescription" {
                $entries = $allEntries | Where-Object {$_.Description -like $Description}
            }

            "all" {
                $entries = $allEntries
            }
            "current" {
                $entries = $allEntries.data
            }
        }
    }


    End {
        return $entries | ConvertTo-TogglEntry
    }
}