Skip to main content

A versioned wine-prefix management tool with memory-shared prefixes.

This tool simplifies the maintenance of individual wine-prefixes per executable. Each prefix is version-controlled using git, allowing for reproducible setups. Furthermore (if supported by host system), the prefixes are stored as subvolumes on a BTRFS image. This makes storing them more memory efficient by only saving differences between each installation.

Installation

wine_wrap can be installed using pip:

$ pip install wine_wrap

Usage

$ wine_wrap --help
Usage: wine_wrap [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  clear      Clear all associations.
  configure  Associate script with given wine-prefix.
  run        Execute given script in wine-prefix.
  scan       Scan for executables in given prefix.
  set        Associate script with given wine-prefix.
  show       Show current setup.

Getting started

A typical use-case would be to first run an installer, and then the created executable in the same wine-prefix. To do so, first run the installer (as well as winecfg beforehand) and name the used prefix:

$ wine_wrap run --configure --name MyOwnPrefix installer.exe
[..]

Afterwards, find the newly installed executable within this prefix and associate it correctly:

$ wine_wrap scan MyOwnPrefix
[..]
 > "/path/to/executable.exe"
[..]
$ wine_wrap set "/path/to/executable.exe" MyOwnPrefix

We can then make sure that the correct script-prefix associations are set:

$ wine_wrap show
--- MyOwnPrefix ---
 > installer.exe
 > executable.exe

It is then possible to simply run the executable in the correct wine-prefix:

$ wine_wrap run /path/to/executable.exe
[..]

If we don’t need the scripts anymore, we can delete them in the end:

$ wine_wrap clear --delete-prefixes --prefix MyOwnPrefix
[..]

Metadata

Release files for wine-wrap 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wine-wrap 0.1.0
File Size Uploaded
wine_wrap-0.1.0.tar.gz 6.8 kB Details

Release files / wine_wrap-0.1.0.tar.gz

Download URL wine_wrap-0.1.0.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
e2cb143da6b644135402723290a952d9f48149a777db2f431b3084998e2bcee7
BLAKE2b-256 checksum
How to use checksums
00077e146dd64d057ddd40fb3fb5494dba8824ee5b9dfd45e4e160a9ff0ffe2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page