tessl/pypi-comtypes

Pure Python COM package for Windows COM automation and interoperability

0.98x

Overview

Eval results

Files

Windows Shortcut Manager

Name: tessl/pypi-comtypes
Rating: 0.88 (1 reviews)
Author: tessl

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

Install with Tessl CLI

npx tessl i tessl/pypi-comtypes