flexablelib 3.2.0__tar.gz → 3.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. flexablelib-3.3.0/.coveragerc +10 -0
  2. {flexablelib-3.2.0 → flexablelib-3.3.0}/CHANGELOG.md +58 -0
  3. {flexablelib-3.2.0 → flexablelib-3.3.0}/MANIFEST.in +1 -0
  4. flexablelib-3.3.0/PKG-INFO +485 -0
  5. flexablelib-3.3.0/README.md +411 -0
  6. flexablelib-3.3.0/examples/admin.py +258 -0
  7. flexablelib-3.3.0/flexablelib/__init__.py +59 -0
  8. flexablelib-3.3.0/flexablelib/_frames.py +213 -0
  9. flexablelib-3.3.0/flexablelib/_legacy/__init__.py +5 -0
  10. {flexablelib-3.2.0/flexablelib → flexablelib-3.3.0/flexablelib/_legacy}/screen.py +3 -3
  11. {flexablelib-3.2.0/flexablelib → flexablelib-3.3.0/flexablelib/_legacy}/widgets.py +3 -3
  12. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/layout.py +132 -54
  13. flexablelib-3.3.0/flexablelib/screen.py +23 -0
  14. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/table.py +29 -4
  15. flexablelib-3.3.0/flexablelib/widgets.py +27 -0
  16. flexablelib-3.3.0/flexablelib.egg-info/PKG-INFO +485 -0
  17. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib.egg-info/SOURCES.txt +11 -0
  18. flexablelib-3.3.0/flexablelib.egg-info/requires.txt +26 -0
  19. {flexablelib-3.2.0 → flexablelib-3.3.0}/package.json +1 -1
  20. {flexablelib-3.2.0 → flexablelib-3.3.0}/setup.py +12 -3
  21. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/conftest.py +10 -2
  22. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v217_features.py +11 -7
  23. flexablelib-3.3.0/tests/test_v330_components.py +1403 -0
  24. flexablelib-3.3.0/tests/test_v330_frames.py +231 -0
  25. flexablelib-3.3.0/tests/test_v330_layout.py +259 -0
  26. flexablelib-3.3.0/tests/test_v330_tui.py +672 -0
  27. flexablelib-3.3.0/tools/bench_frames.py +114 -0
  28. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/generate_width_tables.py +5 -2
  29. flexablelib-3.2.0/PKG-INFO +0 -674
  30. flexablelib-3.2.0/README.md +0 -609
  31. flexablelib-3.2.0/flexablelib/__init__.py +0 -12
  32. flexablelib-3.2.0/flexablelib.egg-info/PKG-INFO +0 -674
  33. flexablelib-3.2.0/flexablelib.egg-info/requires.txt +0 -14
  34. {flexablelib-3.2.0 → flexablelib-3.3.0}/LICENSE +0 -0
  35. {flexablelib-3.2.0 → flexablelib-3.3.0}/examples/dashboard.py +0 -0
  36. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/_speedups.c +0 -0
  37. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/_width_tables.h +0 -0
  38. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/box_topology.py +0 -0
  39. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/cells.py +0 -0
  40. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/colors.py +0 -0
  41. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/columns.py +0 -0
  42. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/fast.py +0 -0
  43. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/merges.py +0 -0
  44. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/options.py +0 -0
  45. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/py.typed +0 -0
  46. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/readers.py +0 -0
  47. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/style_compositions.py +0 -0
  48. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/table_strings.py +0 -0
  49. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/text_width.py +0 -0
  50. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/utils.py +0 -0
  51. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib/writers.py +0 -0
  52. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib.egg-info/dependency_links.txt +0 -0
  53. {flexablelib-3.2.0 → flexablelib-3.3.0}/flexablelib.egg-info/top_level.txt +0 -0
  54. {flexablelib-3.2.0 → flexablelib-3.3.0}/pytest.ini +0 -0
  55. {flexablelib-3.2.0 → flexablelib-3.3.0}/setup.cfg +0 -0
  56. {flexablelib-3.2.0 → flexablelib-3.3.0}/style_examples.md +0 -0
  57. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/helpers.py +0 -0
  58. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_align_indicators.py +0 -0
  59. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_box_topology.py +0 -0
  60. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_cells.py +0 -0
  61. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_columns.py +0 -0
  62. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_excel.py +0 -0
  63. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_features.py +0 -0
  64. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_issues.py +0 -0
  65. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_merge_edge_matrix.py +0 -0
  66. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_merge_fill.py +0 -0
  67. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_merges.py +0 -0
  68. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_public_api_edges.py +0 -0
  69. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_readme_examples.py +0 -0
  70. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_stress_matrix.py +0 -0
  71. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_style_line_widths.py +0 -0
  72. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_styles.py +0 -0
  73. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_text_width.py +0 -0
  74. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_two_pass_measurement.py +0 -0
  75. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_upstream_issues.py +0 -0
  76. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v2021_fixes.py +0 -0
  77. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v210_rows_copy.py +0 -0
  78. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v2110_fixes.py +0 -0
  79. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v211_fixes.py +0 -0
  80. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v213_features.py +0 -0
  81. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v214_features.py +0 -0
  82. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v215_features.py +0 -0
  83. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v216_features.py +0 -0
  84. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v218_features.py +0 -0
  85. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v219_coverage.py +0 -0
  86. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v219_fixes.py +0 -0
  87. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v220_exports.py +0 -0
  88. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v221_fixes.py +0 -0
  89. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v222_fixes.py +0 -0
  90. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v223_fixes.py +0 -0
  91. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v224_fixes.py +0 -0
  92. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v230_none.py +0 -0
  93. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v231_fixes.py +0 -0
  94. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v232_merge_ansi.py +0 -0
  95. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v300_style_names.py +0 -0
  96. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v310_layout.py +0 -0
  97. {flexablelib-3.2.0 → flexablelib-3.3.0}/tests/test_v320_tui.py +0 -0
  98. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/benchmark.py +0 -0
  99. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/readme_gallery.py +0 -0
  100. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/stress_matrix.py +0 -0
  101. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/style_examples.py +0 -0
  102. {flexablelib-3.2.0 → flexablelib-3.3.0}/tools/text_to_png.py +0 -0
@@ -0,0 +1,10 @@
1
+ [run]
2
+ branch = True
3
+ omit =
4
+ */flexablelib/_legacy/*
5
+ */setup.py
6
+
7
+ [report]
8
+ precision = 2
9
+ show_missing = True
10
+ skip_covered = True
@@ -2,6 +2,64 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
4
4
 
5
+ ## [3.3.0] - 2026-11-12
6
+
7
+ ### Added
8
+ - Optional packages, released together with the core and installed as
9
+ extras (`pip install flexablelib` alone is unchanged and still has no
10
+ dependencies):
11
+ - `flexablelib[tui]` → `flexablelib-tui`: `App` with keyboard input on
12
+ Linux, macOS and Windows (termios / console API, bracketed paste, mouse
13
+ wheel and clicks), focus over what was drawn in the last frame,
14
+ Tab/Shift-Tab, key bindings, modal and floating layers (`push`/`pop`),
15
+ notifications (`notify`), ticks (`interval`), resize handling and a
16
+ headless mode (`run(keys=..., size=...)`) for tests; `ScrollView`; the
17
+ 3.2.0 widgets, `Screen` and `Live` moved here (still importable from
18
+ `flexablelib`).
19
+ - `flexablelib[components]` → `flexablelib-components`: 83 terminal
20
+ components -- inputs (text, password, number, arithmetic expression,
21
+ money, masks, text area, JSON, barcode scanner, checkbox, switch, radio,
22
+ checkbox group, select, autocomplete, colour, icon, coordinates, file),
23
+ dates (calendar, date, time, date-time, week, month, year, weekday,
24
+ range with presets, timer), display (badge, tag, status, alert, OSC 8
25
+ link, breadcrumbs, empty and error states, spinner, skeleton, code with
26
+ highlighting, Markdown, HTML, detail view, timeline, stepper, comments,
27
+ attachments, stat, braille line chart), navigation (tabs, menus, context
28
+ menu, pagination, sidebar, top bar, toolbar, wizard, accordion,
29
+ carousel, tree, command palette, split, stack, app shell, sort control),
30
+ data (interactive table with sort/filter/selection/paging, filter bar
31
+ with a query language, editable table, catalog grid, form with
32
+ validation, validation summary, login form, file preview) and dialogs
33
+ (modal, confirm, prompt, loading overlay, popover, help line). See
34
+ docs/COMPONENTS.md.
35
+ - `flexablelib[speed]` → `flexablelib-speedups`: C code for interface
36
+ frames (cut/pad lines, column slices, shared-border junctions, frame
37
+ diffs). Up to 17× faster frames than pure Python; identical output.
38
+ See docs/ACCELERATION.md.
39
+ - `flexablelib._frames`: the frame primitives every layout, widget and
40
+ component uses, C or Python (`use()`, `BACKEND`, `FLEXABLELIB_FRAMES`).
41
+ - `GridCell(row=, column=)`: explicit placement; pinned cells go first and
42
+ the rest flow around them.
43
+ - Bordered grids close empty slots (`Grid(fill_gaps=True)`, the default);
44
+ `fill_gaps=False` keeps the 3.2.0 open gaps.
45
+ - `Table.to_cards()` carries merged cells: vertical merges fill every card
46
+ they cover, horizontal merges show once under the joined labels.
47
+ - `Live` writes only the lines that changed; a resize repaints.
48
+ - `Stack(min_width=...)` wraps horizontal children into balanced rows.
49
+ - `examples/admin.py`: a complete interactive back-office application.
50
+ - `tools/bench_frames.py`: frame benchmarks (`--demo admin`, `--pure`).
51
+ - CI: a job without the optional packages, the C modules tested on Linux,
52
+ Windows and macOS, a coverage floor, and wheels for `flexablelib-speedups`.
53
+
54
+ ### Changed
55
+ - README demonstrations are images (code and real output) instead of code
56
+ blocks, which some viewers rendered out of order.
57
+
58
+ ### Compatibility
59
+ - No breaking changes. Without `flexablelib[tui]`, `flexablelib.widgets`,
60
+ `flexablelib.screen` and the widget names load a frozen 3.2.0 copy and
61
+ warn once (`DeprecationWarning`).
62
+
5
63
  ## [3.2.0] - 2026-11-11
6
64
 
7
65
  ### Added
@@ -10,3 +10,4 @@ include flexablelib/py.typed
10
10
  include pytest.ini
11
11
  recursive-include tests *.py
12
12
  recursive-include examples *.py
13
+ include .coveragerc
@@ -0,0 +1,485 @@
1
+ Metadata-Version: 2.4
2
+ Name: flexablelib
3
+ Version: 3.3.0
4
+ Summary: Fast, dependency-free terminal tables for Python: 54 border styles, ANSI colors, cell merges, decimal alignment, width fitting, and CSV/Markdown/HTML/Excel/LaTeX I/O.
5
+ Home-page: https://github.com/Opus-Perpetuus/flexablelib
6
+ Author: Benjamin Ramirez
7
+ Author-email: chilerito12@gmail.com
8
+ License: MIT
9
+ Project-URL: Documentation, https://github.com/Opus-Perpetuus/flexablelib#readme
10
+ Project-URL: Source, https://github.com/Opus-Perpetuus/flexablelib
11
+ Project-URL: Issues, https://github.com/Opus-Perpetuus/flexablelib/issues
12
+ Project-URL: Changelog, https://github.com/Opus-Perpetuus/flexablelib/blob/main/CHANGELOG.md
13
+ Project-URL: Releases, https://github.com/Opus-Perpetuus/flexablelib/releases
14
+ Keywords: table,tables,terminal,console,cli,ascii-table,pretty-print,prettytable,tabulate,tabular-data,ansi,ansi-colors,unicode,box-drawing,markdown,html,csv,excel,latex,formatting
15
+ Classifier: Development Status :: 5 - Production/Stable
16
+ Classifier: Environment :: Console
17
+ Classifier: Intended Audience :: Developers
18
+ Classifier: Intended Audience :: System Administrators
19
+ Classifier: Intended Audience :: Science/Research
20
+ Classifier: License :: OSI Approved :: MIT License
21
+ Classifier: Operating System :: OS Independent
22
+ Classifier: Programming Language :: C
23
+ Classifier: Topic :: Terminals
24
+ Classifier: Topic :: Text Processing
25
+ Classifier: Topic :: Text Processing :: Markup
26
+ Classifier: Topic :: Software Development :: Libraries
27
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
28
+ Classifier: Topic :: Utilities
29
+ Classifier: Typing :: Typed
30
+ Classifier: Programming Language :: Python :: 3
31
+ Classifier: Programming Language :: Python :: 3.8
32
+ Classifier: Programming Language :: Python :: 3.9
33
+ Classifier: Programming Language :: Python :: 3.10
34
+ Classifier: Programming Language :: Python :: 3.11
35
+ Classifier: Programming Language :: Python :: 3.12
36
+ Classifier: Programming Language :: Python :: 3.13
37
+ Classifier: Programming Language :: Python :: 3.14
38
+ Classifier: Programming Language :: Python :: 3 :: Only
39
+ Requires-Python: >=3.8
40
+ Description-Content-Type: text/markdown
41
+ License-File: LICENSE
42
+ Provides-Extra: pandas
43
+ Requires-Dist: pandas>=1.0; extra == "pandas"
44
+ Provides-Extra: excel
45
+ Requires-Dist: openpyxl>=3.0; extra == "excel"
46
+ Provides-Extra: html
47
+ Requires-Dist: lxml>=4.0; extra == "html"
48
+ Provides-Extra: tui
49
+ Requires-Dist: flexablelib-tui==3.3.0; extra == "tui"
50
+ Provides-Extra: components
51
+ Requires-Dist: flexablelib-components==3.3.0; extra == "components"
52
+ Provides-Extra: speed
53
+ Requires-Dist: flexablelib-speedups==3.3.0; extra == "speed"
54
+ Provides-Extra: all
55
+ Requires-Dist: pandas>=1.0; extra == "all"
56
+ Requires-Dist: openpyxl>=3.0; extra == "all"
57
+ Requires-Dist: lxml>=4.0; extra == "all"
58
+ Requires-Dist: flexablelib-tui==3.3.0; extra == "all"
59
+ Requires-Dist: flexablelib-components==3.3.0; extra == "all"
60
+ Requires-Dist: flexablelib-speedups==3.3.0; extra == "all"
61
+ Dynamic: author
62
+ Dynamic: author-email
63
+ Dynamic: classifier
64
+ Dynamic: description
65
+ Dynamic: description-content-type
66
+ Dynamic: home-page
67
+ Dynamic: keywords
68
+ Dynamic: license
69
+ Dynamic: license-file
70
+ Dynamic: project-url
71
+ Dynamic: provides-extra
72
+ Dynamic: requires-python
73
+ Dynamic: summary
74
+
75
+ <p align="center">
76
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/logos/export/logo-1024.png" alt="flexablelib" width="440">
77
+ </p>
78
+
79
+ <p align="center">
80
+ <strong>Fast, dependency-free terminal tables — and optional packages for full terminal apps.</strong><br>
81
+ 54 border styles · ANSI colours · cell merges · decimal alignment · width fitting · CSV / Markdown / HTML / Excel / LaTeX I/O · grids · 80+ terminal components · C-accelerated frames
82
+ </p>
83
+
84
+ <p align="center">
85
+ <a href="https://pypi.org/project/flexablelib/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/flexablelib?style=flat-square&color=4338CA&logo=pypi&logoColor=white"></a>
86
+ <a href="https://pypi.org/project/flexablelib/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/flexablelib?style=flat-square&color=4338CA&logo=python&logoColor=white"></a>
87
+ <a href="https://github.com/Opus-Perpetuus/flexablelib/actions/workflows/tests.yml"><img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/Opus-Perpetuus/flexablelib/tests.yml?branch=main&style=flat-square&label=tests"></a>
88
+ <a href="https://pypistats.org/packages/flexablelib"><img alt="Downloads per month" src="https://img.shields.io/pypi/dm/flexablelib?style=flat-square&color=F59E0B"></a>
89
+ <a href="https://pypi.org/project/flexablelib/"><img alt="Development status" src="https://img.shields.io/pypi/status/flexablelib?style=flat-square&color=F59E0B"></a>
90
+ <a href="https://github.com/Opus-Perpetuus/flexablelib/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/pypi/l/flexablelib?style=flat-square&color=64748B"></a>
91
+ <a href="https://github.com/Opus-Perpetuus/flexablelib/blob/main/flexablelib/py.typed"><img alt="Typed" src="https://img.shields.io/badge/typing-py.typed-64748B?style=flat-square"></a>
92
+ </p>
93
+
94
+ ---
95
+
96
+ **flexablelib** turns rows and columns into readable tables for terminals, logs,
97
+ reports and docs. It has **no runtime dependencies**, ships **prebuilt wheels
98
+ with an optional C speed-up**, and is covered by **3,900+ tests** on Python
99
+ 3.8 – 3.14 (Linux, Windows, macOS).
100
+
101
+ Since 3.3.0 the same library builds **complete interactive terminal
102
+ applications**: keyboard focus, key bindings, dialogs, notifications, 80+
103
+ ready-made components (inputs, dates, tables, forms, menus, charts, dialogs)
104
+ and optional C code that computes each interface frame. All of it is opt-in;
105
+ `pip install flexablelib` stays a single dependency-free package.
106
+
107
+ <p align="center">
108
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/quickstart.png" alt="A rounded flexablelib table built in a few lines, with its output" width="620">
109
+ </p>
110
+
111
+ ## Install
112
+
113
+ `pip install flexablelib` — the core: tables, cards, grids, widgets. No dependencies.
114
+
115
+ | Extra | Brings | For |
116
+ | --- | --- | --- |
117
+ | `flexablelib[tui]` | `flexablelib-tui` | interactive apps: `App`, keyboard input on Linux, macOS and Windows, focus, key bindings, dialogs, notifications, `Live` diff redraw |
118
+ | `flexablelib[components]` | `flexablelib-components` (+ tui) | 80+ terminal components: inputs, dates, tables, forms, navigation, dialogs, charts |
119
+ | `flexablelib[speed]` | `flexablelib-speedups` | C code for interface frames: cutting, padding, borders and frame diffs |
120
+ | `flexablelib[pandas]`, `[excel]`, `[html]` | pandas, openpyxl, lxml | readers and writers |
121
+ | `flexablelib[all]` | everything above | |
122
+
123
+ Quote the extras in shells that expand brackets: `pip install "flexablelib[tui,components,speed]"`.
124
+ Details: [docs/INSTALL.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/INSTALL.md).
125
+
126
+ <p align="center">
127
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/install.png" alt="Checking which C backends are live" width="520">
128
+ </p>
129
+
130
+ ## Terminal applications
131
+
132
+ <p align="center">
133
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/01_demo_140.png" alt="A complete back-office terminal app: sidebar, KPI cards, line chart, activity timeline and orders table">
134
+ </p>
135
+
136
+ [examples/admin.py](https://github.com/Opus-Perpetuus/flexablelib/blob/main/examples/admin.py) is a complete back-office app
137
+ built only with flexablelib: `AppShell` (sidebar, top bar, pages), `Stat`
138
+ cards, a braille `LineChart`, a `Timeline`, a `DataTable` bound to a
139
+ `FilterBar` (`estado:pagado total>5000`), forms with validation, a command
140
+ palette (Ctrl-K), dialogs and notifications. Run it with
141
+ `python examples/admin.py`; `--frame 120x36 --keys "tab,down,enter"` prints a
142
+ single frame instead (that is how these images are made).
143
+
144
+ <p align="center">
145
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/app.png" alt="A table and a form side by side in an App, driven by keys" width="620">
146
+ </p>
147
+
148
+ <table>
149
+ <tr>
150
+ <td width="50%"><b>Keyboard and focus</b> — Tab, arrows, Enter, modal dialogs<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/04_teclado_foco.png" alt="Six frames of keyboard navigation" width="420"></td>
151
+ <td width="50%"><b>Forms</b> — required fields, validators, masks, notifications<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/05_formulario.png" alt="A form with validation errors and a success notification" width="420"></td>
152
+ </tr>
153
+ <tr>
154
+ <td><b>Filter and sort</b> — <code>estado:pagado total&gt;5000</code>, keys 1–9 sort<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/02_demo_pedidos.png" alt="Orders filtered and sorted" width="420"></td>
155
+ <td><b>Narrow terminals</b> — the sidebar hides, cards reflow<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/03_demo_angosto.png" alt="The same app at 80 and 64 columns" width="420"></td>
156
+ </tr>
157
+ <tr>
158
+ <td><b>Command palette and help</b><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/06_comandos_ayuda.png" alt="Command palette and help dialog" width="420"></td>
159
+ <td><b>No colour</b> — zero escape sequences, same layout<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/07_sin_color.png" alt="The app without colour" width="420"></td>
160
+ </tr>
161
+ </table>
162
+
163
+ ### Components
164
+
165
+ `flexablelib[components]` adds 80+ components, each rendered at any width,
166
+ in colour or plain text: the full list, what each does and its keys is in
167
+ [docs/COMPONENTS.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/COMPONENTS.md).
168
+
169
+ <table>
170
+ <tr>
171
+ <td width="50%"><b>Inputs</b> — text, password, numbers, money, masks, expressions, JSON, scanners, choices, colours, files<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/08_entradas.png" alt="Input components" width="420"></td>
172
+ <td width="50%"><b>Dates and times</b> — calendar, date, time, week, month, ranges, timer<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/09_fechas.png" alt="Date components" width="420"></td>
173
+ </tr>
174
+ <tr>
175
+ <td><b>Display</b> — badges, alerts, code, Markdown, HTML, timelines, steps, stats, charts<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/10_visualizacion.png" alt="Display components" width="420"></td>
176
+ <td><b>Navigation</b> — tabs, menus, sidebar, wizard, tree, command palette, app shell<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/11_navegacion.png" alt="Navigation components" width="420"></td>
177
+ </tr>
178
+ <tr>
179
+ <td><b>Data</b> — interactive table, filters, editable table, catalog, forms, login<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/12_datos.png" alt="Data components" width="420"></td>
180
+ <td><b>Dialogs</b> — modal, confirm, prompt, loading, popover<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/13_dialogos.png" alt="Dialog components" width="420"></td>
181
+ </tr>
182
+ </table>
183
+
184
+ ### Speed
185
+
186
+ <p align="center">
187
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v33/15_benchmark_c_vs_python.png" alt="Milliseconds per frame without C, with the core C measurement and with the C frame code" width="760">
188
+ </p>
189
+
190
+ Every frame of an interface is re-laid out and diffed against the previous one;
191
+ only changed lines are written. `flexablelib[speed]` moves the per-line work
192
+ (measuring, cutting, padding, border junctions, the diff) to C: a full
193
+ back-office screen at 160×48 takes **0.47 ms** (2,100 fps) instead of 6.4 ms
194
+ in pure Python. Results are identical with and without C — the test suite
195
+ checks both on random input — and `FLEXABLELIB_FRAMES=python` switches the C
196
+ code off. Method and numbers: [docs/ACCELERATION.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/ACCELERATION.md).
197
+
198
+ ## 30-second quickstart
199
+
200
+ The image at the top is the whole program. Numbers align on the decimal
201
+ point, colours never break alignment, and the same table exports anywhere:
202
+
203
+ <p align="center">
204
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/exports.png" alt="Markdown and CSV exports of a table" width="560">
205
+ </p>
206
+
207
+ ## Feature gallery
208
+
209
+ <table>
210
+ <tr>
211
+ <td width="50%"><b>Styles</b> — 54 presets, from <code>ascii_rows</code> to <code>borderless</code><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/styles.png" alt="Several border styles" width="260"></td>
212
+ <td width="50%"><b>Themes</b> — <code>table.apply_theme("ocean")</code><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/themes.png" alt="Theme presets" width="380"></td>
213
+ </tr>
214
+ <tr>
215
+ <td><b>Text on borders</b> — <code>table.border_text("Production", where="top")</code><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/border_text.png" alt="Labels written into the table frame" width="380"></td>
216
+ <td><b>Cell merges</b> — <code>table.merge_cells(0, 0, last_row=1)</code><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/merges.png" alt="Vertically merged cells" width="320"></td>
217
+ </tr>
218
+ <tr>
219
+ <td><b>Zebra rows, footer, caption</b><br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/zebra_footer.png" alt="Striped rows with a footer and caption" width="380"></td>
220
+ <td><b>Decimal alignment</b> — floats and scientific notation<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/decimals.png" alt="Numbers aligned on the decimal point" width="220"></td>
221
+ </tr>
222
+ </table>
223
+
224
+ More: [all 54 styles](https://github.com/Opus-Perpetuus/flexablelib/blob/main/style_examples.md) ·
225
+ wrapping and ellipsis overflow · per-column / per-cell colour and alignment ·
226
+ vertical alignment · `paginate()` · `stream()` for live rows · `transpose()` ·
227
+ nested tables · `fit_terminal()` · `hide_columns` · `sort_by` · Roman / custom
228
+ index.
229
+
230
+ ## How it compares
231
+
232
+ A factual feature matrix from our
233
+ [survey of 89 table libraries](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/COMPARISON.md). A dash means
234
+ the feature was not found in that library's documentation during the survey,
235
+ not a claim that it is impossible there.
236
+
237
+ | | flexablelib | tabulate | prettytable | rich |
238
+ | --- | :---: | :---: | :---: | :---: |
239
+ | Runtime dependencies | **none** | none | `wcwidth` | `markdown-it-py`, `pygments` |
240
+ | Border style presets | 54 | many `tablefmt` | — (hrules/vrules toggles) | box styles |
241
+ | Decimal-point alignment | ✓ | ✓ | — | — |
242
+ | Row **and** column cell merges | ✓ | — | — | — |
243
+ | ANSI colours (header, rows, cells, borders) | ✓ | — | — | ✓ |
244
+ | Zebra rows / caption / footer | ✓ | — | — | ✓ |
245
+ | Text written on borders | ✓ | — | — | — |
246
+ | Wrap / truncate / ellipsis overflow | ✓ | — | max width | ✓ |
247
+ | Sorting, pagination | ✓ | — | ✓ | — |
248
+ | Exports | CSV, MD, HTML, Excel, RST, AsciiDoc, LaTeX | HTML, LaTeX, MD, RST, org, jira, … | HTML, CSV, JSON, LaTeX | — (console) |
249
+ | Readers | CSV, Markdown, HTML, dicts, pandas, Excel | — | CSV, DB cursor, HTML | — |
250
+ | Nested tables | ✓ | — | — | ✓ (renderables) |
251
+
252
+ rich is a full terminal-rendering toolkit (markup, live displays, progress
253
+ bars) and tabulate covers many more markup dialects; pick flexablelib when you
254
+ want a dependency-free, table-focused library with styling, merges and I/O in
255
+ one place.
256
+
257
+ ## Production notes
258
+
259
+ - **Zero runtime dependencies.** Readers/writers that need a third-party
260
+ package (`pandas`, `openpyxl`, `lxml`) are opt-in extras and imported lazily.
261
+ - **Performance.** Rendering 10,000 rows × 6 columns takes ~157 ms with the C
262
+ extension (~172 ms pure Python), on par with prettytable, ~1.3× faster than
263
+ tabulate and ~18× faster than rich's table. pandas `to_string()` is faster
264
+ still (~85 ms). Full method and numbers:
265
+ [docs/BENCHMARKS.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/BENCHMARKS.md).
266
+ - **Wheels.** Prebuilt for CPython 3.8 – 3.14 on Linux (manylinux, musllinux),
267
+ Windows x64 and macOS arm64, for both `flexablelib` and `flexablelib-speedups`. Anywhere else it builds from source or falls
268
+ back to pure Python — installation never fails for want of a compiler.
269
+ `from flexablelib.fast import implementation; implementation()` tells you
270
+ which backend is live.
271
+ - **Colour safety.** Escape sequences are emitted only to a TTY by default,
272
+ never when `NO_COLOR` is set; `FORCE_COLOR` or `table.use_colors = True`
273
+ overrides. Logs and files stay clean.
274
+ - **Unicode.** Widths are measured in terminal columns, so CJK, emoji and
275
+ coloured text stay aligned.
276
+ - **Windows.** Box-drawing styles need a UTF-8 console (`chcp 65001` or
277
+ `PYTHONUTF8=1`; Windows Terminal is usually UTF-8 already). ASCII styles
278
+ (`ascii_rows`, `ascii_double_underline_rows`, `psql`, `markdown`, …) work on any code page.
279
+ - **Typed.** Ships `py.typed` (PEP 561).
280
+ - **Stability.** flexablelib follows [semantic versioning](https://semver.org):
281
+ within 3.x, public `Table` attributes and methods are not removed or renamed
282
+ without a deprecation period; new features arrive in minor/patch releases
283
+ and every release is listed in the
284
+ [CHANGELOG](https://github.com/Opus-Perpetuus/flexablelib/blob/main/CHANGELOG.md).
285
+ - **Support.** Bugs and requests: [issues](https://github.com/Opus-Perpetuus/flexablelib/issues). Security reports:
286
+ [SECURITY.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/SECURITY.md). Contributions:
287
+ [CONTRIBUTING.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/CONTRIBUTING.md).
288
+
289
+ ### Windows console encoding
290
+
291
+ Box-drawing styles need a UTF-8 console: run `chcp 65001` and set
292
+ `PYTHONUTF8=1` (PowerShell: `$env:PYTHONUTF8=1`). Windows Terminal is usually
293
+ UTF-8 already. The terminal packages enable virtual-terminal output on
294
+ Windows consoles themselves.
295
+
296
+ # Guide
297
+
298
+ ## Usage
299
+
300
+ Creating a table is simple. An empty table has no data, so it only draws its
301
+ frame; a table with columns but no rows — a query that came back empty —
302
+ shows its headers rather than raising:
303
+
304
+ <p align="center">
305
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/empty.png" alt="An empty table and a table with headers only" width="560">
306
+ </p>
307
+
308
+ Data can be added as columns or rows, or alternating each one. Any untitled
309
+ column is named automatically.
310
+
311
+ <p align="center">
312
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/columns.png" alt="Adding columns" width="460">
313
+ </p>
314
+
315
+ <p align="center">
316
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/multiline.png" alt="Rows with line breaks" width="460">
317
+ </p>
318
+
319
+ The table formats new lines and data types automatically, without trying to
320
+ parse strings that could be converted to another type.
321
+
322
+ The `Table` class offers options for showing the index of each row, changing
323
+ the style, hiding the headers, and more. See all styles
324
+ [here](https://github.com/Opus-Perpetuus/flexablelib/blob/main/style_examples.md). The missing value aligns as if it were of
325
+ the same type as the other data in the column, and the row and column counts
326
+ ignore the index column (the internal counts include it):
327
+
328
+ <p align="center">
329
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/index_missing.png" alt="Index column, double_horizontal style and missing values" width="560">
330
+ </p>
331
+
332
+ **Changed in 2.3.0:** an explicit `None` is a missing cell, just like a
333
+ padding gap or `table.missing`. It displays `missing_value` (blank by default),
334
+ not the text `"None"`. Use the string `"None"` if you want that literal text.
335
+ This applies to printing, `compose()`, pagination, streaming, and
336
+ transposition in every style.
337
+
338
+ Missing cells do not turn numeric columns into text: numeric alignment and
339
+ the decimal axis are preserved, and `overflow='wrap'` does not split floats
340
+ because a column contains `None`. Raw `rows` and exports still represent gaps
341
+ as `None`; rendering `Table(rows=table.rows)` reproduces the same cells (copy
342
+ headers and display settings too if you changed them).
343
+
344
+ <p align="center">
345
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/none.png" alt="None displayed as a missing cell" width="520">
346
+ </p>
347
+
348
+ See [missing-cell semantics](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/MISSING_VALUES.md) for migration details.
349
+
350
+ ## Colour
351
+
352
+ Colour the header, the borders, whole columns, whole rows, or individual cells.
353
+ Specs accept names, attributes, 256-colour indexes and hex triples.
354
+ `color_rule` receives the original value, so numeric comparisons work directly.
355
+
356
+ <p align="center">
357
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/colour.png" alt="Header, border, column and rule-based colours" width="500">
358
+ </p>
359
+
360
+ Colour is emitted only to a terminal by default, and never when `NO_COLOR` is
361
+ set. `FORCE_COLOR` or `table.use_colors = True` overrides that. Because
362
+ `compose()` returns a string you may send anywhere, the default errs toward not
363
+ embedding escape sequences in something bound for a file.
364
+
365
+ Widths are measured in terminal columns, not characters, so coloured cells and
366
+ CJK or emoji data stay aligned.
367
+
368
+ ## Reading and writing
369
+
370
+ Readers: `Table.from_csv`, `from_html` (standard library parser),
371
+ `from_dicts`, `from_markdown`, `from_pandas` (`flexablelib[pandas]`) and
372
+ `from_excel` (`flexablelib[excel]`). Writers: `to_csv`, `to_markdown`,
373
+ `to_html` (one self-contained file with inline sorting, filtering and
374
+ pagination that works offline), `to_rst`, `to_asciidoc`, `to_latex`,
375
+ `to_excel` and `to_records`.
376
+
377
+ Since 2.2.0 every export writes the table as `print(table)` shows it: rows in
378
+ `sort_by` order (with `sort_reverse` and callables), `row_filter` applied,
379
+ `hide_columns` left out, and the text formats hold the formatted strings —
380
+ `float_format`, `int_format`, `leading_zeros`, `custom_format`, `strip_cells` —
381
+ without padding or colour. Empty cells are empty strings.
382
+
383
+ <p align="center">
384
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/readwrite.png" alt="Sorted, filtered and formatted Markdown export and records" width="600">
385
+ </p>
386
+
387
+ `to_records()` keeps the stored Python values (numbers stay numbers, gaps are
388
+ `None`) in display order; `to_records(formatted=True)` gives the printed
389
+ strings. `to_excel()` writes numbers as numbers and turns simple format specs
390
+ (`',d'`, `'.2f'`, `'.1%'`, `'{:,.2f}'`…) into the cell's Excel number format.
391
+
392
+ Text formats deliver everything as strings, and a column of strings is
393
+ left-aligned. `table.parse_str_numbers = True` converts numeric-looking text
394
+ so it aligns as numbers; the readers turn it on for you. Values with leading
395
+ zeros are left alone, so `'007'` stays a string.
396
+
397
+ `table.rows` is a copy of the stored data, in insertion order and with `None`
398
+ in empty cells (sorting, filtering and formats do not touch it), so editing it
399
+ does not change the table. Use `add_row` and `set_cell(row, column, value)`
400
+ instead (`column` is a position or a header; `table.missing` empties a cell).
401
+
402
+ ## Merging cells
403
+
404
+ Render a rectangular block as a single cell, across columns, down rows, or
405
+ both. Coordinates are inclusive, zero-based, and ignore the index column.
406
+
407
+ <p align="center">
408
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/merges.png" alt="A vertical merge and a horizontal Total merge" width="560">
409
+ </p>
410
+
411
+ A merge never widens the table — columns are still sized by their unmerged
412
+ content — so text longer than its span is truncated.
413
+
414
+ ## Cards, grids, responsive tables and terminal layouts
415
+
416
+ `Card` draws one record in a frame, in any of the table styles. The title goes
417
+ into the top border when the style draws one; `field_columns=2` (or `'auto'`)
418
+ lays the fields out as tiles and `actions` adds `[ Action ]` chips:
419
+
420
+ <p align="center">
421
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/card.png" alt="Two cards" width="520">
422
+ </p>
423
+
424
+ Cards take `style_name`, `theme` (the table themes), `border_color`,
425
+ `title_color`, `label_color`, `value_colors`, `color` (a background for the
426
+ whole card), `zebra`, `panel` and `shadow`.
427
+
428
+ `table.render(width)` makes a table responsive: the normal table when it fits,
429
+ without its low-priority columns next, squeezed and wrapped after that, and
430
+ one card per row when nothing else fits. `width` defaults to `max_width`, then
431
+ the terminal width; `responsive=True` makes `print(table)` do the same.
432
+
433
+ <p align="center">
434
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/responsive.png" alt="The same table at 64, 46 and 30 columns" width="560">
435
+ </p>
436
+
437
+ `Grid` places cards, tables, text and other grids in columns that reflow with
438
+ the width. Since 3.3.0 a cell can be pinned with `row=` and `column=`; empty
439
+ slots are closed in bordered grids (`fill_gaps=False` keeps them open), and
440
+ `to_cards()` carries merged cells into every card they cover.
441
+
442
+ <p align="center">
443
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/grid_cards.png" alt="A grid of cards and a grid with pinned cells" width="600">
444
+ </p>
445
+
446
+ A grid can size its columns (`12`, `'auto'`, `'2fr'`, `'30%'`, bounds, or one
447
+ layout per width), span rows, share one border with proper junctions and a
448
+ title per cell, and fill an exact height. Widgets — `ProgressBar`,
449
+ `Sparkline`, `BarChart`, `StatusBar`, `KeyHints`, `LogView`, `Text`, `Rule` —
450
+ drop into it, `Screen` pins a header and footer to the terminal's edges and
451
+ `Live` redraws in place:
452
+
453
+ <p align="center">
454
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/terminal_grid.png" alt="A bordered terminal layout with a menu, a progress bar, a sparkline and a log" width="560">
455
+ </p>
456
+
457
+ A whole dashboard with a sidebar, KPI cards, a coloured table with merges,
458
+ bars, sparklines and a log: [examples/dashboard.py](https://github.com/Opus-Perpetuus/flexablelib/blob/main/examples/dashboard.py)
459
+ (`python examples/dashboard.py --live 10`). More in
460
+ [docs/LAYOUT.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/LAYOUT.md).
461
+
462
+ ## Notes
463
+
464
+ - A column named `"i"` does not collide with the index column (`utils.IndexColumnTitle`).
465
+ - Exponential numbers align on the decimal / exponent axis with the rest of the float column.
466
+ - Shrinking a float column drops decimals instead of chopping characters, so decimal alignment survives a terminal fit ([#23](https://github.com/Opus-Perpetuus/flexablelib/issues/23)).
467
+
468
+ Open work and the issue map: [docs/ISSUES.md](https://github.com/Opus-Perpetuus/flexablelib/blob/main/docs/ISSUES.md).
469
+
470
+ ## Project layout
471
+
472
+ - `flexablelib/` — the core package (no runtime dependencies): `table.py` (the Table class), `layout.py` (Card, Grid, GridCell), `_frames.py` (frame primitives, C or Python), `columns.py`, `cells.py`, `table_strings.py`, `style_compositions.py` (the 54 styles, as data), `text_width.py` / `fast.py` (terminal-width measurement, C or Python), readers and writers.
473
+ - `packages/tui/` — `flexablelib-tui`: widgets, Screen, Live, App, keyboard input.
474
+ - `packages/components/` — `flexablelib-components`: the terminal components.
475
+ - `packages/speedups/` — `flexablelib-speedups`: the C frame code.
476
+ - `examples/` — `dashboard.py`, `admin.py`.
477
+ - `tests/` — the pytest suite; `tools/` — benchmarks and generators; `docs/` — guides and images.
478
+ - `ARCHITECTURE.md` — how it all fits together; `style_examples.md` — all 54 styles; `package.json` — the canonical version number.
479
+
480
+ <p align="center">
481
+ <img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/readme/tests.png" alt="Running the test suite" width="560">
482
+ </p>
483
+
484
+ See [**ARCHITECTURE.md**](https://github.com/Opus-Perpetuus/flexablelib/blob/main/ARCHITECTURE.md) for the rendering pipeline, how
485
+ styles are defined, and how to add one.