Metadata-Version: 2.1
Name: pylnk3
Version: 0.4.2
Summary: Windows LNK File Parser and Creator
Home-page: https://github.com/strayge/pylnk
Author: strayge
Author-email: strayge@gmail.com
License: GNU Library or Lesser General Public License (LGPL)
Description: # PyLnk 3
        
        [![PyPI version shields.io](https://img.shields.io/pypi/v/pylnk3.svg)](https://pypi.python.org/pypi/pylnk3/)
        [![PyPI pyversions](https://img.shields.io/pypi/pyversions/pylnk3.svg)](https://pypi.python.org/pypi/pylnk3/)
        [![PyPI download month](https://img.shields.io/pypi/dm/pylnk3.svg)](https://pypi.python.org/pypi/pylnk3/)
        
        Python library for reading and writing Windows shortcut files (.lnk).  
        Converted to support python 3.
        
        This library can parse .lnk files and extract all relevant information from
        them. Parsing a .lnk file yields a LNK object which can be altered and saved
        again. Moreover, .lnk file can be created from scratch be creating a LNK
        object, populating it with data and then saving it to a file. As that
        process requires some knowledge about the internals of .lnk files, some
        convenience functions are provided.
        
        Limitation: Windows knows lots of different types of shortcuts which all have
        different formats. This library currently only supports shortcuts to files and
        folders on the local machine. 
        
        ## CLI
        
        Mainly tool has two basic commands.
        
        #### Parse existed lnk file
        
        ```sh
        pylnk3 parse [-h] filename [props [props ...]]
        
        positional arguments:
          filename    lnk filename to read
          props       props path to read
        
        optional arguments:
          -h, --help  show this help message and exit
        ```
        
        #### Create new lnk file
        
        ```sh
        usage: pylnk3 create [-h] [--arguments [ARGUMENTS]] [--description [DESCRIPTION]] [--icon [ICON]]
                             [--icon-index [ICON_INDEX]] [--workdir [WORKDIR]] [--mode [{Maximized,Normal,Minimized}]]
                             target name
        
        positional arguments:
          target                target path
          name                  lnk filename to create
        
        optional arguments:
          -h, --help            show this help message and exit
          --arguments [ARGUMENTS], -a [ARGUMENTS]
                                additional arguments
          --description [DESCRIPTION], -d [DESCRIPTION]
                                description
          --icon [ICON], -i [ICON]
                                icon filename
          --icon-index [ICON_INDEX], -ii [ICON_INDEX]
                                icon index
          --workdir [WORKDIR], -w [WORKDIR]
                                working directory
          --mode [{Maximized,Normal,Minimized}], -m [{Maximized,Normal,Minimized}]
                                window mode
        ```
        
        #### Examples
        ```sh
        pylnk3 p filename.lnk
        pylnk3 c c:\prog.exe shortcut.lnk
        pylnk3 c \\192.168.1.1\share\file.doc doc.lnk
        pylnk3 create c:\1.txt text.lnk -m Minimized -d "Description"
        ```
        
        ## Changes
        
        **0.4.2**  
        changed logic for Lnk.path choose (in case of different paths presents at different structures)  
        read links with root as GUID of KNOWN_FOLDER  
        [FIX] disabled padding for writing LinkInfo.local_base_path  
        
        **0.4.0**  
        added support for network links  
        reworked CLI (added more options for creating links)  
        added entry point for call tool just like `pylnk3`  
        [FIX] allow build links for non-existed (from this machine) paths  
        [FIX] correct building links on Linux (now expect Windows-like path)  
        [FIX] fixed path priority at parsing with both local & remote presents  
        
        
        **0.3.0**  
        added support links to UWP apps  
        
        
        **0.2.1**  
        released to PyPI
        
          
        **0.2.0**  
        converted to python 3  
        
Keywords: lnk,shortcut,windows
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown