or run

tessl search
Log in

Version

Workspace
tessl
Visibility
Public
Created
Last updated
Describes
pypipkg:pypi/comtypes@1.4.x
tile.json

tessl/pypi-comtypes

tessl install tessl/pypi-comtypes@1.4.0

Pure Python COM package for Windows COM automation and interoperability

Agent Success

Agent success rate when using this tile

88%

Improvement

Agent success rate improvement when using this tile compared to baseline

0.99x

Baseline

Agent success rate without this tile

89%

task.mdevals/scenario-2/

Windows Shortcut Manager

A utility for creating and reading Windows shortcut (.lnk) files with customizable properties.

Capabilities

Create Windows Shortcuts

Create shortcut files that link to target files or directories with customizable properties.

  • Creates a shortcut file at a specified path that links to a target file @test
  • Creates a shortcut with a custom description property @test
  • Creates a shortcut with a working directory property @test

Read Shortcut Properties

Read and extract information from existing Windows shortcut files.

  • Reads the target path from an existing shortcut file @test
  • Reads the description property from a shortcut file @test
  • Reads the working directory property from a shortcut file @test

Implementation

@generates

API

def create_shortcut(shortcut_path: str, target_path: str, description: str = "", working_dir: str = "") -> None:
    """
    Creates a Windows shortcut (.lnk) file.

    Args:
        shortcut_path: Path where the shortcut file will be created
        target_path: Path to the target file or directory
        description: Optional description for the shortcut
        working_dir: Optional working directory for the shortcut

    Raises:
        ValueError: If shortcut_path or target_path is empty
        OSError: If there are issues creating the shortcut file
    """
    pass

def read_shortcut(shortcut_path: str) -> dict:
    """
    Reads properties from an existing Windows shortcut file.

    Args:
        shortcut_path: Path to the shortcut file to read

    Returns:
        Dictionary containing:
            - 'target': Target path of the shortcut
            - 'description': Description property (empty string if not set)
            - 'working_dir': Working directory property (empty string if not set)

    Raises:
        ValueError: If shortcut_path is empty
        FileNotFoundError: If the shortcut file does not exist
        OSError: If there are issues reading the shortcut file
    """
    pass

Dependencies { .dependencies }

comtypes { .dependency }

Provides COM interface access for Windows Shell objects and persistence operations.

@satisfied-by