Skip to main content

Capture C-level output in context managers

Project description

Wurlitzer

Capture C-level stdout/stderr pipes in Python via os.dup2.

For more details on why this is needed, please read this blog post.

Install

pip install wurlitzer

Usage

Capture stdout/stderr in pipes:

from wurlitzer import pipes

with pipes() as (out, err):
    call_some_c_function()

stdout = out.read()

Capture stdout/stderr in StringIO:

from io import StringIO
from wurlitzer import pipes, STDOUT

out = StringIO()
with pipes(stdout=out, stderr=STDOUT):
    call_some_c_function()

stdout = out.getvalue()

Forward C-level stdout/stderr to Python sys.stdout/stderr, which may already be forwarded somewhere by the environment, e.g. IPython:

from wurlitzer import sys_pipes

with sys_pipes():
    call_some_c_function()

Or even simpler, enable it as an IPython extension:

%load_ext wurlitzer

To forward all C-level output to IPython during execution.

Acknowledgments

This package is based on stuff we learned with @takluyver and @karies while working on capturing output from the Cling Kernel for Jupyter.

Wurlitzer?!

Wurlitzer makes pipe organs. Get it? Pipes? Naming is hard.

Project details


Download files

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

Source Distribution

wurlitzer-3.0.1.tar.gz (9.8 kB view details)

Uploaded Source

Built Distribution

wurlitzer-3.0.1-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file wurlitzer-3.0.1.tar.gz.

File metadata

  • Download URL: wurlitzer-3.0.1.tar.gz
  • Upload date:
  • Size: 9.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.11

File hashes

Hashes for wurlitzer-3.0.1.tar.gz
Algorithm Hash digest
SHA256 2a20270b23854493c6cf701ac3a1d30638b90281d80a42f9d91e258f6a0fa20d
MD5 59ca7be1e5049865b1d4ba10c2c657b5
BLAKE2b-256 b1b235bbff3ac6722129c12b9bd097722f6d5e06ee89de5344f253d20ae699b2

See more details on using hashes here.

File details

Details for the file wurlitzer-3.0.1-py3-none-any.whl.

File metadata

  • Download URL: wurlitzer-3.0.1-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.11

File hashes

Hashes for wurlitzer-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 73641f9b818564996565876780ff730623946b02faa77977507b02833d5d7062
MD5 88ca33d2ab06b9871fa7ca6897e74a89
BLAKE2b-256 20e5f74e79aaa06bda412e45ccc40bc3c6046d5afdc499f071accc8b23371c1d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page