zugbruecke

Calling routines in Windows DLLs from Python scripts running under Linux, MacOS or BSD

/ˈt͡suːkˌbʁʏkə/ - German, noun, feminine: drawbridge

User’s guide

zugbruecke is a drop-in replacement for ctypes with minimal, ctypes-compatible syntax extensions.

Warning

This manual describes what makes zugbruecke special and how it differs from ctypes. It does NOT substitute the ctypes documentation. Please read the latter first if you have never called foreign functions with ctypes from Python scripts.

Introduction

• About zugbruecke
  • Synopsis
  • Motivation & Alternatives
  • Implementation
  • Use Cases
• Installation
  • Getting Wine
  • Getting zugbruecke
  • Installing zugbruecke in Development Mode
• Getting Started
  • Minimal Example
  • Optional argtypes and restype annotations
  • Platform-Independent Code
  • Shared Objects and DLLs
  • 32 bit and 64 bit DLLs
  • Platform-Dependent Integer Widths
  • Platform-Dependent Floating-Point Behaviour
  • Calling Conventions
  • Memory Synchronization
  • Further Examples

Reference

• Session Model
  • Working with Sessions
  • The zugbruecke.CtypesSession class
• Configuration
  • Configuration Strategy and Parameters
  • The zugbruecke.Config class
• Pointers & Memory Synchronization
  • Introduction to Memory Synchronization
  • The Memory Synchronization Protocol
  • The memsync attribute
• Platform Interoperability
• Wine Python Environment
  • The wenv package
  • The zugbruecke.Env class

Advanced

• Benchmarks
• Security
• Bugs & Known Issues
  • How to bisect issues
  • Known issues: Failing to import modules
  • Known issues: Running on CentOS
• Changes
  • 0.2.1 (2023-01-01)
  • 0.2.0 (2022-12-29)
  • 0.1.0 (2022-09-11)
  • 0.0.15 (2020-07-10)
  • 0.0.14 (2019-05-21)
  • 0.0.13 (2019-02-03)
  • 0.0.12 (2019-02-02)
  • 0.0.11 (2018-04-10)
  • 0.0.10 (2018-03-23)
  • 0.0.9 (2018-03-21)
  • 0.0.8 (2018-03-18)
  • 0.0.7 (2018-03-05)
  • 0.0.6 (2017-12-06)
  • 0.0.5 (2017-11-13)
  • 0.0.4 (2017-11-05)
  • 0.0.3 (2017-11-02)
  • 0.0.2 (2017-07-28)
  • 0.0.1 (2017-07-28)
• FAQ
  • Why? Seriously, why?
  • What are actual use cases for this project?
  • How does it work?
  • Is it secure?
  • How fast/slow is it?
  • Can it handle structures?
  • Can it handle pointers?
  • How are integer widths handled for long integer types?
  • What about long doubles and half precision?
  • Is it thread-safe?
  • Something is off by 8 bytes. What happened?
• Getting Help
  • Mailing List
  • Chat
  • Reporting Bugs / Issues
  • Paid Support

Interested in contributing?

Indices and tables

• Index

• Search Page