{"id":4432,"library":"asciitree","title":"ASCII Tree Generator","description":"asciitree is a Python library that enables the drawing of tree structures using ASCII characters directly in the terminal. It is currently at version 0.3.3, with its last release in 2016, suggesting a maintenance or inactive release cadence.","status":"maintenance","version":"0.3.3","language":"en","source_language":"en","source_url":"http://github.com/mbr/asciitree","tags":["ascii","tree","visualization","cli","rendering"],"install":[{"cmd":"pip install asciitree","lang":"bash","label":"Install latest version"}],"dependencies":[],"imports":[{"note":"While some older examples or alternative libraries might use `ascii_tree`, the core library and its primary documentation use `from asciitree import LeftAligned` for rendering.","wrong":"from ascii_tree import make_and_print_tree","symbol":"LeftAligned","correct":"from asciitree import LeftAligned"}],"quickstart":{"code":"from asciitree import LeftAligned\nfrom collections import OrderedDict as OD\n\ntree_data = {\n    'root': OD([\n        ('child1', {\n            'grandchild1_1': {},\n            'grandchild1_2': {'subgrandchild': {}}\n        }),\n        ('child2', {\n            'grandchild2_1': {},\n        }),\n        ('child3', {})\n    ])\n}\n\ntr = LeftAligned()\nprint(tr(tree_data))","lang":"python","description":"This quickstart demonstrates how to create a hierarchical dictionary structure, using `OrderedDict` for predictable child ordering, and then render it into an ASCII tree using the `LeftAligned` renderer."},"warnings":[{"fix":"Consider testing thoroughly with your target Python environment. For new projects, evaluate more actively maintained alternatives if long-term support is crucial.","message":"The library has not been updated since September 2016. While it functions, it may not receive further bug fixes or new features and might have compatibility issues with very recent Python versions or dependencies not yet discovered.","severity":"deprecated","affected_versions":"<=0.3.3"},{"fix":"Ensure your project's environment is running Python 3 or higher.","message":"The library explicitly states support only for Python 3. Attempting to use it with Python 2 environments will likely result in errors.","severity":"gotcha","affected_versions":"<=0.3.3"},{"fix":"Always verify the PyPI package name and the GitHub repository (`mbr/asciitree`) to ensure you are using the intended library.","message":"There are multiple Python, Go, and JavaScript libraries that share the 'asciitree' or 'ascii tree' name. Ensure you are importing and using the correct Python library 'asciitree' by Marc Brinkmann (mbr).","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}