Skip to main content

Retrieves common Windows folders as Unicode strings

Project description

WinPath

PyPi Build status Coverage License

WinPath is a python module for retrieving common Windows system paths as Unicode strings. It is especially useful in cases where the default path to a system file has been changed by the user. i.e When a user has changed the default path to their Documents folder.

WinPath is a fork of the original WinPaths module by Ryan Ginstrom. It includes bug fixes for issues present in the WinPaths module and allows its inclusion in platform agnostic projects.

Installing

Install and update using pip:

pip install -U winpath

A Simple Example

WinPath can be imported and used within your own project like so.

The following example assumes that the user has chosen to sync their Documents directory with Onedrive.

import sys
import winpath

if sys.platform == "win32": # WinPath will only work on Windows
    my_documents = winpath.get_my_documents()
    print(my_documents) # C:\\Users\\username\\Onedrive\\Documents

Available Functions

  • get_local_appdata: Path to %LOCALAPPDATA%

  • get_appdata: Path to %APPDATA%

  • get_desktop: Path to the logged in user's desktop folder

  • get_programs: current user -> Start menu -> Programs

  • get_admin_tools: current user -> Start menu -> Programs -> Admin tools

  • get_common_admin_tools: all users -> Start menu -> Programs -> Admin tools

  • get_common_appdata: Path to program data folder

  • get_common_documents: Path to public documents folder

  • get_cookies: Path to internet explorer cookies folder

  • get_history: Path to internet explorer history folder

  • get_internet_cache: Path to internet explorer cache folder

  • get_my_pictures: Path to the logged in user's pictures folder

  • get_my_documents: Path to the logged in user's documents folder

  • get_program_files: Path to Windows program files folder

  • get_program_files_common: Path to Windows' program files -> common files folder

  • get_system: Path to Windows' System32 folder

  • get_windows: Path to Windows folder

  • get_favorites: Path to the logged in user's favorites folder

  • get_startup: current user -> start menu -> programs -> startup

  • get_recent: Path to the logged in user's recently used files folder

License

This project is licensed under the terms of the MIT license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for winpath, version 202002.2
Filename, size File type Python version Upload date Hashes
Filename, size winpath-202002.2-py3-none-any.whl (5.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size winpath-202002.2.tar.gz (8.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page