{"id":13638472,"url":"https://github.com/vaaaaanquish/xontrib-readable-traceback","last_synced_at":"2026-06-06T15:01:35.068Z","repository":{"id":60723512,"uuid":"181192692","full_name":"vaaaaanquish/xontrib-readable-traceback","owner":"vaaaaanquish","description":"xonsh readable traceback","archived":false,"fork":false,"pushed_at":"2022-09-06T19:43:38.000Z","size":306,"stargazers_count":12,"open_issues_count":4,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-11-29T00:55:05.081Z","etag":null,"topics":["shell","xonsh","xontrib"],"latest_commit_sha":null,"homepage":"","language":"Xonsh","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vaaaaanquish.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"vaaaaanquish"}},"created_at":"2019-04-13T15:40:58.000Z","updated_at":"2025-07-08T18:55:29.000Z","dependencies_parsed_at":"2022-10-03T21:34:31.187Z","dependency_job_id":null,"html_url":"https://github.com/vaaaaanquish/xontrib-readable-traceback","commit_stats":null,"previous_names":["6syun9/xontrib-readable-traceback"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/vaaaaanquish/xontrib-readable-traceback","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaaaaanquish%2Fxontrib-readable-traceback","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaaaaanquish%2Fxontrib-readable-traceback/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaaaaanquish%2Fxontrib-readable-traceback/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaaaaanquish%2Fxontrib-readable-traceback/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vaaaaanquish","download_url":"https://codeload.github.com/vaaaaanquish/xontrib-readable-traceback/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaaaaanquish%2Fxontrib-readable-traceback/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33986901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["shell","xonsh","xontrib"],"created_at":"2024-08-02T01:00:46.457Z","updated_at":"2026-06-06T15:01:35.043Z","avatar_url":"https://github.com/vaaaaanquish.png","language":"Xonsh","funding_links":["https://github.com/sponsors/vaaaaanquish"],"categories":["Plugins"],"sub_categories":["Prompt tweaks"],"readme":"# xontrib-readable-traceback\nMake traceback easier to see for xonsh.\n\nPython work very often with large libraries like pandas, or matplotlib. This means that exceptions often produce long stack traces. Since we don't need to see the library detail in the vast majority of cases. Especially with a shell like xonsh.\n\nThis xontrib making readable and short traceback.\n\nexample:\nSimple division by zero error.\n\n\u003cimg src='https://github.com/6syun9/xontrib-readable-traceback/blob/master/img/division.png?raw=true'\u003e\n\nexample:\nThis simple pandas error produces a stacktrace containing 28 lines. But xontrib load...\n\n\u003cimg src='https://github.com/6syun9/xontrib-readable-traceback/blob/master/img/pandas.png?raw=true' width='450px'\u003e\n\n# Install\nInstall using pip\n\n```\npip install xontrib-readable-traceback\n```\n\nWrite .xonshrc\n```\nxontrib load readable-traceback\n```\n\n# Usage\n\nThis xontrib use [backtrace package](https://github.com/nir0s/backtrace).\n\nFor the main usage, please refer to the following.\n\nhttps://github.com/nir0s/backtrace#usage\n\n## Example xonshrc\n\nxonshrc sample.\n```\n~~~\nxontrib load readable-traceback\n$READABLE_TRACE_STRIP_PATH_ENV=True\n$READABLE_TRACE_REVERSE=True\n~~~\n```\n\n## Setting backtrace\n\nThe correspondence with the variable of [backtrace](https://github.com/nir0s/backtrace) is as follows.\n\n| backtrace | xontrib-readable-traceback | Type |\n----|----|----|\n| reverse | $READABLE_TRACE_REVERSE | bool |\n| align | $READABLE_TRACE_ALIGN | bool |\n| strip_path | $READABLE_TRACE_STRIP_PATH_ENV | bool |\n| enable_on_envvar_only | $READABLE_TRACE_ENVVAR_ONLY | bool |\n| on_tty | $READABLE_TRACE_ON_TTY | bool |\n| conservative | $READABLE_TRACE_CONSERVATIVE | bool |\n| style | $READABLE_TRACE_STYLES | dict |\n\nFor details of `style` please refer to [backtrace#style](https://github.com/nir0s/backtrace#styles) and [colorama](https://github.com/tartley/colorama).\n\n## Switching readable-traceback\n\nIf we want to turn trace off, we can use:\n```\n$XONSH_READABLE_TRACEBACK=False\n```\n\nIf so, the notation of traceback follows xonsh_env(`$XONSH_SHOW_TRACEBACK`).\n\n## Xonsh traceback log\n\nXonsh can keep a log of traceback.\u003cbr\u003e\nTo keep the log, write `\"ABSOLUTE PATH TO TRACEBACK LOG\"` below.\n```\n$XONSH_TRACEBACK_LOGFILE=\"PATH\"\n```\nIf it is None, no log is kept.\nDefault is None.\n\n# Thanks\n\nThanks\n - https://github.com/xonsh/xonsh \n - https://github.com/nir0s/backtrace\n - https://github.com/laerus/cookiecutter-xontrib\n\nI appreciate all Python's assets and xonsh.\u003cbr\u003e\nIf there is something problem, up to github issue.\u003cbr\u003e\n[@vaaaaanquish](https://twitter.com/vaaaaanquish)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaaaaanquish%2Fxontrib-readable-traceback","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaaaaanquish%2Fxontrib-readable-traceback","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaaaaanquish%2Fxontrib-readable-traceback/lists"}