{"library":"runez","title":"Runez Library","description":"Runez is a friendly, pure Python convenience library offering utilities for common operations such as file manipulation, process execution, and logging that developers often find themselves rewriting. It stands alone without external dependencies, focusing on robust handling of edge cases and providing clear error reporting. The current version is 5.7.1, with a regular release cadence.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install runez"],"cli":null},"imports":["import runez"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import runez\nimport os\n\n# Example 1: Running a command\nprint(\"--- Running a command ---\")\ntry:\n    output = runez.run(\"echo\", \"Hello from runez!\", capture_output=True)\n    print(f\"Command output: {output.strip()}\")\n\n    # Example of a command that might fail gracefully\n    print(\"\\n--- Running a command that might fail (fatal=False) ---\")\n    result = runez.run(\"this-command-does-not-exist\", fatal=False, capture_output=True)\n    if result is False:\n        print(\"Command failed gracefully as expected.\")\n    else:\n        print(\"Unexpected success or output:\", result)\n\nexcept Exception as e:\n    print(f\"Error running command: {e}\")\n\n# Example 2: File operations\nprint(\"\\n--- File operations ---\")\nfilename = \"my_runez_file.txt\"\nif os.path.exists(filename):\n    runez.delete(filename)\n\nrunez.write(filename, \"First line\\nSecond line\\n\")\nprint(f\"Content written to {filename}\")\n\ncontent = runez.readlines(filename)\nprint(f\"Content read from {filename}: {content}\")\n\nrunez.delete(filename)\nprint(f\"Deleted {filename}\")","lang":"python","description":"This quickstart demonstrates how to execute shell commands and perform basic file operations using `runez`. It shows handling both successful and potentially failing commands, as well as writing to and reading from a file.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"5.6.6","pypi_latest":"5.9.1","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.6,"avg_import_s":0.17,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.17,"mem_mb":6.6,"disk_size":"18.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.13,"mem_mb":6.6,"disk_size":"19M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.22,"mem_mb":7.5,"disk_size":"20.8M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.21,"mem_mb":7.5,"disk_size":"21M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.19,"mem_mb":7.2,"disk_size":"12.6M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.2,"mem_mb":7.2,"disk_size":"13M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.16,"mem_mb":6.5,"disk_size":"12.3M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.16,"mem_mb":6.5,"disk_size":"13M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.12,"mem_mb":5.3,"disk_size":"18.2M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"runez","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.8,"import_time_s":0.11,"mem_mb":5.3,"disk_size":"19M"}]}}