Metadata-Version: 1.1
Name: pathfix.py
Version: 0.3
Summary: Translate OS X / Windows file URLs to directory paths
Home-page: https://github.com/jimr/pathfix.py
Author: James Rutherford
Author-email: jim@jimr.org
License: MIT
Description: ==========
        pathfix.py
        ==========
        
        Using Linux? Tired of receiving emails with links to files of the form ``X:\some%20path\on\remote%20share\spreadsheet.xls``? Then we can help!
        
        ``pathfix.py`` takes an unusable path as input and prints a useful one as output. That's it.
        
        It can handle Windows drive prefixes (if configured), and will also sort out ``file://`` and ``smb://`` prefixes.
        
        Installation
        ============
        
        It's as easy as ``pip install pathfix.py``.
        
        Should work with Python 2.4 - 3.3 and pypy (probably more, but that's as far as it's been tested).
        
        There are no requirements unless you're using Python 2.4-2.6, or 3.0-3.1, in which case (if you're installing from source) you need ``argparse``::
        
            pip install -r requirements.txt
        
        To make sure it'll work with your environment, run the tests::
        
            python setup.py test
        
        Configuration
        =============
        
        Before using, you need to create a ``config.ini`` file that contains the root of your network mounts and any drive mappings (see ``config.example.ini`` to get started).
        
        We assume all your network shares are mounted under a common root, with the form::
        
            /<network mount root>/<host name>/<share name>
        
        If you installed from source, you may find it helpful to symlink ``pathfix.py`` to ``/usr/local/bin`` or somewhere else on your ``PATH``, or you can just ``python setup.py install`` and you'll get the ``pathfix`` executable on your path.
        
        If you installed with ``pip``, you should probably make a ``config.ini`` somewhere in your home directory and set up an alias, e.g.::
        
            alias pathfix="pathfix --config $HOME/.config/pathfix.ini"
        
        Usage
        =====
        
        For example, if you have this in your ``config.ini``::
        
            [main]
            network_root = /media/network
        
            [drive_maps]
            x = host1:share1
            y = host2:share2
        
        Then you can do, for example::
        
            % pathfix "X:\some%20path\on\remote%20share\spreadsheet.xls"
            /media/network/host1/share1/some path/on/remote share/spreadsheet.xls
        
        Which you can use in subshells to fix arguments to other applications, for example::
        
            % libreoffice "$(pathfix "X:\some%20path\on\remote%20share\spreadsheet.xls")"
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: PyPy
Provides: pathfix.py
