flexablelib 3.6.0__tar.gz → 3.7.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 (127) hide show
  1. {flexablelib-3.6.0 → flexablelib-3.7.0}/CHANGELOG.md +30 -0
  2. {flexablelib-3.6.0 → flexablelib-3.7.0}/PKG-INFO +12 -9
  3. {flexablelib-3.6.0 → flexablelib-3.7.0}/README.md +3 -0
  4. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib.egg-info/PKG-INFO +12 -9
  5. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib.egg-info/SOURCES.txt +1 -0
  6. flexablelib-3.7.0/flexablelib.egg-info/requires.txt +35 -0
  7. {flexablelib-3.6.0 → flexablelib-3.7.0}/package.json +1 -1
  8. flexablelib-3.7.0/tests/test_v370_features.py +296 -0
  9. flexablelib-3.6.0/flexablelib.egg-info/requires.txt +0 -35
  10. {flexablelib-3.6.0 → flexablelib-3.7.0}/.coveragerc +0 -0
  11. {flexablelib-3.6.0 → flexablelib-3.7.0}/LICENSE +0 -0
  12. {flexablelib-3.6.0 → flexablelib-3.7.0}/MANIFEST.in +0 -0
  13. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/admin.py +0 -0
  14. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/dashboard.py +0 -0
  15. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/keys.py +0 -0
  16. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/video/demo.py +0 -0
  17. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/video/render.py +0 -0
  18. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/video/scenes.py +0 -0
  19. {flexablelib-3.6.0 → flexablelib-3.7.0}/examples/video/thumbnail.py +0 -0
  20. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/__init__.py +0 -0
  21. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_frames.py +0 -0
  22. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_images.py +0 -0
  23. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_legacy/__init__.py +0 -0
  24. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_legacy/screen.py +0 -0
  25. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_legacy/widgets.py +0 -0
  26. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_speedups.c +0 -0
  27. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/_width_tables.h +0 -0
  28. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/box_topology.py +0 -0
  29. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/cells.py +0 -0
  30. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/colors.py +0 -0
  31. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/columns.py +0 -0
  32. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/fast.py +0 -0
  33. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/identifiers.py +0 -0
  34. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/layout.py +0 -0
  35. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/merges.py +0 -0
  36. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/options.py +0 -0
  37. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/py.typed +0 -0
  38. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/readers.py +0 -0
  39. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/screen.py +0 -0
  40. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/style_compositions.py +0 -0
  41. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/table.py +0 -0
  42. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/table_strings.py +0 -0
  43. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/text_width.py +0 -0
  44. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/utils.py +0 -0
  45. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/widgets.py +0 -0
  46. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib/writers.py +0 -0
  47. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib.egg-info/dependency_links.txt +0 -0
  48. {flexablelib-3.6.0 → flexablelib-3.7.0}/flexablelib.egg-info/top_level.txt +0 -0
  49. {flexablelib-3.6.0 → flexablelib-3.7.0}/pytest.ini +0 -0
  50. {flexablelib-3.6.0 → flexablelib-3.7.0}/setup.cfg +0 -0
  51. {flexablelib-3.6.0 → flexablelib-3.7.0}/setup.py +0 -0
  52. {flexablelib-3.6.0 → flexablelib-3.7.0}/style_examples.md +0 -0
  53. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/conftest.py +0 -0
  54. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/helpers.py +0 -0
  55. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_align_indicators.py +0 -0
  56. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_box_topology.py +0 -0
  57. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_cells.py +0 -0
  58. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_columns.py +0 -0
  59. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_excel.py +0 -0
  60. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_features.py +0 -0
  61. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_issues.py +0 -0
  62. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_merge_edge_matrix.py +0 -0
  63. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_merge_fill.py +0 -0
  64. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_merges.py +0 -0
  65. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_public_api_edges.py +0 -0
  66. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_readme_examples.py +0 -0
  67. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_stress_matrix.py +0 -0
  68. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_style_line_widths.py +0 -0
  69. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_styles.py +0 -0
  70. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_text_width.py +0 -0
  71. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_two_pass_measurement.py +0 -0
  72. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_upstream_issues.py +0 -0
  73. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v2021_fixes.py +0 -0
  74. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v210_rows_copy.py +0 -0
  75. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v2110_fixes.py +0 -0
  76. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v211_fixes.py +0 -0
  77. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v213_features.py +0 -0
  78. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v214_features.py +0 -0
  79. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v215_features.py +0 -0
  80. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v216_features.py +0 -0
  81. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v217_features.py +0 -0
  82. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v218_features.py +0 -0
  83. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v219_coverage.py +0 -0
  84. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v219_fixes.py +0 -0
  85. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v220_exports.py +0 -0
  86. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v221_fixes.py +0 -0
  87. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v222_fixes.py +0 -0
  88. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v223_fixes.py +0 -0
  89. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v224_fixes.py +0 -0
  90. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v230_none.py +0 -0
  91. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v231_fixes.py +0 -0
  92. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v232_merge_ansi.py +0 -0
  93. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v300_style_names.py +0 -0
  94. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v310_layout.py +0 -0
  95. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v320_tui.py +0 -0
  96. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v330_components.py +0 -0
  97. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v330_frames.py +0 -0
  98. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v330_layout.py +0 -0
  99. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v330_tui.py +0 -0
  100. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v331_formats.py +0 -0
  101. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v331_panel_width.py +0 -0
  102. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v331_readers_bom.py +0 -0
  103. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v331_readers_edges.py +0 -0
  104. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v331_tabs.py +0 -0
  105. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v340_accessibility.py +0 -0
  106. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v340_core.py +0 -0
  107. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v340_input.py +0 -0
  108. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v350_images.py +0 -0
  109. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v350_images_core.py +0 -0
  110. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v352_fixes.py +0 -0
  111. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v353_fixes.py +0 -0
  112. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v354_fixes.py +0 -0
  113. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v355_fixes.py +0 -0
  114. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/test_v360_features.py +0 -0
  115. {flexablelib-3.6.0 → flexablelib-3.7.0}/tests/wincon_child.py +0 -0
  116. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/bench_frames.py +0 -0
  117. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/bench_images.py +0 -0
  118. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/benchmark.py +0 -0
  119. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/gen_ascii_table.py +0 -0
  120. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/generate_width_tables.py +0 -0
  121. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/image_demo.py +0 -0
  122. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/pty_check.py +0 -0
  123. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/readme_gallery.py +0 -0
  124. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/stress_matrix.py +0 -0
  125. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/style_examples.py +0 -0
  126. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/text_to_png.py +0 -0
  127. {flexablelib-3.6.0 → flexablelib-3.7.0}/tools/wheel_check.py +0 -0
@@ -2,6 +2,36 @@
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.7.0] - 2026-11-13
6
+
7
+ ### Added
8
+ - **`ScrollView` follows the focus** (`follow_focus=True`, the default):
9
+ when a component inside it takes the focus, its rows are scrolled into
10
+ view; scrolling by hand afterwards is left alone. `focus_rows(width)`
11
+ gives the rows of the focused component.
12
+ - **`Menu` and `Sidebar` keep to their height**: with more items than fit,
13
+ a window around the current item with `▲ n más` / `▼ n más` lines (click
14
+ them to page); PgUp/PgDn move a page and the wheel scrolls. The sidebar
15
+ title stays on top.
16
+ - **Responsive `Form` grid**: `min_column_width` drops to fewer columns when
17
+ they would be narrower; `FormCell(field, span=, min_width=)` and
18
+ `Form.set_layout()` give a field several columns, more when it would be
19
+ narrower than its minimum; `grid_columns(width)`.
20
+ - **`DataTable(fill=True)`** takes its whole slot with the status line at
21
+ the bottom; `visible_rows` is how many rows the last frame showed.
22
+ - **`GridView`**: a `flexablelib.Grid` as a component with an accessible
23
+ name (`title` / `a11y_label`) and role, and `audit()` for itself and
24
+ every component inside.
25
+ - **`StatusLine`**: a one-line status bar with role `status`, a symbol per
26
+ kind besides the colour, and screen-reader announcements on change.
27
+
28
+ ### Changed
29
+ - **`VStack` without `weights`** gives weight 1 to children that fill their
30
+ slot (`expand`: `DataTable(fill=True)`, `ScrollView`, `Sidebar`, `Tabs`),
31
+ so they share the rows left over; before, every child kept its own
32
+ height.
33
+ - `Menu` with `max_visible` (or a height) now shows the `▲` / `▼` lines.
34
+
5
35
  ## [3.6.0] - 2026-11-13
6
36
 
7
37
  ### Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: flexablelib
3
- Version: 3.6.0
3
+ Version: 3.7.0
4
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
5
  Home-page: https://github.com/Opus-Perpetuus/flexablelib
6
6
  Author: Benjamin Ramirez
@@ -46,15 +46,15 @@ Requires-Dist: openpyxl>=3.0; extra == "excel"
46
46
  Provides-Extra: html
47
47
  Requires-Dist: lxml>=4.0; extra == "html"
48
48
  Provides-Extra: tui
49
- Requires-Dist: flexablelib-tui==3.6.0; extra == "tui"
49
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "tui"
50
50
  Provides-Extra: components
51
- Requires-Dist: flexablelib-components==3.6.0; extra == "components"
51
+ Requires-Dist: flexablelib-components==3.7.0; extra == "components"
52
52
  Provides-Extra: speed
53
- Requires-Dist: flexablelib-speedups==3.6.0; extra == "speed"
53
+ Requires-Dist: flexablelib-speedups==3.7.0; extra == "speed"
54
54
  Provides-Extra: images
55
55
  Requires-Dist: Pillow>=8; extra == "images"
56
- Requires-Dist: flexablelib-tui==3.6.0; extra == "images"
57
- Requires-Dist: flexablelib-components==3.6.0; extra == "images"
56
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "images"
57
+ Requires-Dist: flexablelib-components==3.7.0; extra == "images"
58
58
  Provides-Extra: svg
59
59
  Requires-Dist: cairosvg>=2.5; extra == "svg"
60
60
  Provides-Extra: all
@@ -62,9 +62,9 @@ Requires-Dist: pandas>=1.0; extra == "all"
62
62
  Requires-Dist: openpyxl>=3.0; extra == "all"
63
63
  Requires-Dist: lxml>=4.0; extra == "all"
64
64
  Requires-Dist: Pillow>=8; extra == "all"
65
- Requires-Dist: flexablelib-tui==3.6.0; extra == "all"
66
- Requires-Dist: flexablelib-components==3.6.0; extra == "all"
67
- Requires-Dist: flexablelib-speedups==3.6.0; extra == "all"
65
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "all"
66
+ Requires-Dist: flexablelib-components==3.7.0; extra == "all"
67
+ Requires-Dist: flexablelib-speedups==3.7.0; extra == "all"
68
68
  Dynamic: author
69
69
  Dynamic: author-email
70
70
  Dynamic: classifier
@@ -189,6 +189,9 @@ in colour or plain text: the full list, what each does and its keys is in
189
189
  <tr>
190
190
  <td colspan="2"><b>New in 3.6.0</b> — signature pad, stopwatch, a vertical stack that shares its height and follows the focus, focus shown without colour, forms that collect nested fields and editable tables, scanners that keep the code read, catalog cards with pictures, pictures downloaded with an <code>Authorization</code> header, a validation summary from a list of errors<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/01_novedades.png" alt="3.6.0 components: SignatureInput, Stopwatch, VStack, focus markers, ScanInput, CatalogGrid with images, ValidationSummary" width="520"></td>
191
191
  </tr>
192
+ <tr>
193
+ <td colspan="2"><b>New in 3.7.0</b> — scroll views that follow the focus, menus and sidebars that keep to their height, responsive form columns with spans, tables that fill their slot, an accessible grid with its own audit, a status line for screen readers<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/02_novedades_370.png" alt="3.7.0 components: ScrollView following the focus, Menu and Sidebar windows, Form grid, DataTable fill, GridView, StatusLine" width="520"></td>
194
+ </tr>
192
195
  </table>
193
196
 
194
197
  ### Keyboard, mouse and accessibility
@@ -108,6 +108,9 @@ in colour or plain text: the full list, what each does and its keys is in
108
108
  <tr>
109
109
  <td colspan="2"><b>New in 3.6.0</b> — signature pad, stopwatch, a vertical stack that shares its height and follows the focus, focus shown without colour, forms that collect nested fields and editable tables, scanners that keep the code read, catalog cards with pictures, pictures downloaded with an <code>Authorization</code> header, a validation summary from a list of errors<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/01_novedades.png" alt="3.6.0 components: SignatureInput, Stopwatch, VStack, focus markers, ScanInput, CatalogGrid with images, ValidationSummary" width="520"></td>
110
110
  </tr>
111
+ <tr>
112
+ <td colspan="2"><b>New in 3.7.0</b> — scroll views that follow the focus, menus and sidebars that keep to their height, responsive form columns with spans, tables that fill their slot, an accessible grid with its own audit, a status line for screen readers<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/02_novedades_370.png" alt="3.7.0 components: ScrollView following the focus, Menu and Sidebar windows, Form grid, DataTable fill, GridView, StatusLine" width="520"></td>
113
+ </tr>
111
114
  </table>
112
115
 
113
116
  ### Keyboard, mouse and accessibility
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: flexablelib
3
- Version: 3.6.0
3
+ Version: 3.7.0
4
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
5
  Home-page: https://github.com/Opus-Perpetuus/flexablelib
6
6
  Author: Benjamin Ramirez
@@ -46,15 +46,15 @@ Requires-Dist: openpyxl>=3.0; extra == "excel"
46
46
  Provides-Extra: html
47
47
  Requires-Dist: lxml>=4.0; extra == "html"
48
48
  Provides-Extra: tui
49
- Requires-Dist: flexablelib-tui==3.6.0; extra == "tui"
49
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "tui"
50
50
  Provides-Extra: components
51
- Requires-Dist: flexablelib-components==3.6.0; extra == "components"
51
+ Requires-Dist: flexablelib-components==3.7.0; extra == "components"
52
52
  Provides-Extra: speed
53
- Requires-Dist: flexablelib-speedups==3.6.0; extra == "speed"
53
+ Requires-Dist: flexablelib-speedups==3.7.0; extra == "speed"
54
54
  Provides-Extra: images
55
55
  Requires-Dist: Pillow>=8; extra == "images"
56
- Requires-Dist: flexablelib-tui==3.6.0; extra == "images"
57
- Requires-Dist: flexablelib-components==3.6.0; extra == "images"
56
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "images"
57
+ Requires-Dist: flexablelib-components==3.7.0; extra == "images"
58
58
  Provides-Extra: svg
59
59
  Requires-Dist: cairosvg>=2.5; extra == "svg"
60
60
  Provides-Extra: all
@@ -62,9 +62,9 @@ Requires-Dist: pandas>=1.0; extra == "all"
62
62
  Requires-Dist: openpyxl>=3.0; extra == "all"
63
63
  Requires-Dist: lxml>=4.0; extra == "all"
64
64
  Requires-Dist: Pillow>=8; extra == "all"
65
- Requires-Dist: flexablelib-tui==3.6.0; extra == "all"
66
- Requires-Dist: flexablelib-components==3.6.0; extra == "all"
67
- Requires-Dist: flexablelib-speedups==3.6.0; extra == "all"
65
+ Requires-Dist: flexablelib-tui==3.7.0; extra == "all"
66
+ Requires-Dist: flexablelib-components==3.7.0; extra == "all"
67
+ Requires-Dist: flexablelib-speedups==3.7.0; extra == "all"
68
68
  Dynamic: author
69
69
  Dynamic: author-email
70
70
  Dynamic: classifier
@@ -189,6 +189,9 @@ in colour or plain text: the full list, what each does and its keys is in
189
189
  <tr>
190
190
  <td colspan="2"><b>New in 3.6.0</b> — signature pad, stopwatch, a vertical stack that shares its height and follows the focus, focus shown without colour, forms that collect nested fields and editable tables, scanners that keep the code read, catalog cards with pictures, pictures downloaded with an <code>Authorization</code> header, a validation summary from a list of errors<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/01_novedades.png" alt="3.6.0 components: SignatureInput, Stopwatch, VStack, focus markers, ScanInput, CatalogGrid with images, ValidationSummary" width="520"></td>
191
191
  </tr>
192
+ <tr>
193
+ <td colspan="2"><b>New in 3.7.0</b> — scroll views that follow the focus, menus and sidebars that keep to their height, responsive form columns with spans, tables that fill their slot, an accessible grid with its own audit, a status line for screen readers<br><img src="https://raw.githubusercontent.com/Opus-Perpetuus/flexablelib/main/docs/img/v36/02_novedades_370.png" alt="3.7.0 components: ScrollView following the focus, Menu and Sidebar windows, Form grid, DataTable fill, GridView, StatusLine" width="520"></td>
194
+ </tr>
192
195
  </table>
193
196
 
194
197
  ### Keyboard, mouse and accessibility
@@ -109,6 +109,7 @@ tests/test_v353_fixes.py
109
109
  tests/test_v354_fixes.py
110
110
  tests/test_v355_fixes.py
111
111
  tests/test_v360_features.py
112
+ tests/test_v370_features.py
112
113
  tests/wincon_child.py
113
114
  tools/bench_frames.py
114
115
  tools/bench_images.py
@@ -0,0 +1,35 @@
1
+
2
+ [all]
3
+ pandas>=1.0
4
+ openpyxl>=3.0
5
+ lxml>=4.0
6
+ Pillow>=8
7
+ flexablelib-tui==3.7.0
8
+ flexablelib-components==3.7.0
9
+ flexablelib-speedups==3.7.0
10
+
11
+ [components]
12
+ flexablelib-components==3.7.0
13
+
14
+ [excel]
15
+ openpyxl>=3.0
16
+
17
+ [html]
18
+ lxml>=4.0
19
+
20
+ [images]
21
+ Pillow>=8
22
+ flexablelib-tui==3.7.0
23
+ flexablelib-components==3.7.0
24
+
25
+ [pandas]
26
+ pandas>=1.0
27
+
28
+ [speed]
29
+ flexablelib-speedups==3.7.0
30
+
31
+ [svg]
32
+ cairosvg>=2.5
33
+
34
+ [tui]
35
+ flexablelib-tui==3.7.0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flexablelib",
3
- "version": "3.6.0",
3
+ "version": "3.7.0",
4
4
  "private": true,
5
5
  "description": "Flexible console and HTML tables for Python: styles, merges, colors, widths, decimal alignment.",
6
6
  "repository": {
@@ -0,0 +1,296 @@
1
+ """3.7.0: a ScrollView that follows the focus, menus and sidebars that keep
2
+ to their height, responsive form columns with spans and minimum widths,
3
+ tables that fill their slot, a grid component with an accessible name and
4
+ its own audit, and a status line with the status role."""
5
+
6
+ import pytest
7
+
8
+ C = pytest.importorskip('flexablelib_components')
9
+
10
+ from flexablelib import Card # noqa: E402
11
+ from flexablelib.layout import GridCell # noqa: E402
12
+ from flexablelib_tui import (App, Key, ScrollView, # noqa: E402
13
+ accessibility as a11y)
14
+ from flexablelib_tui.keys import MouseEvent # noqa: E402
15
+ from flexablelib.text_width import strip_ansi # noqa: E402
16
+
17
+
18
+ def key(name):
19
+ if len(name) == 1:
20
+ return Key(name, name)
21
+ return Key(name)
22
+
23
+
24
+ @pytest.fixture(autouse=True)
25
+ def plain_a11y():
26
+ with a11y.configure(screen_reader=False, ascii=False, reduced_motion=False,
27
+ focus_marker=False):
28
+ yield
29
+
30
+
31
+ def lines(comp, width=30, height=None):
32
+ return [l.rstrip() for l in
33
+ strip_ansi(comp.render(width=width, height=height)).split('\n')]
34
+
35
+
36
+ # 9. ScrollView follows the focus
37
+
38
+ class TestScrollViewFocus:
39
+ def test_follows_tab(self):
40
+ fields = [C.TextInput('Campo {0}'.format(i)) for i in range(10)]
41
+ view = ScrollView(C.Stack(fields), height=6)
42
+ app = App(body=view)
43
+ app.run(keys=[], size=(40, 6))
44
+ while app.focused is not fields[7]:
45
+ app.dispatch(key('tab'))
46
+ frame = strip_ansi(app.render(40, 6))
47
+ assert 'Campo 7' in frame
48
+ assert view.offset > 0
49
+ assert view.focus_rows(39) is not None
50
+ view.scroll_to(0) # by hand: left alone
51
+ app.render(40, 6)
52
+ assert view.offset == 0
53
+ app.dispatch(key('tab')) # focus moves again: follows
54
+ app.render(40, 6)
55
+ assert 'Campo 8' in strip_ansi(app.render(40, 6))
56
+ while app.focused is not fields[1]:
57
+ app.dispatch(key('tab'))
58
+ app.render(40, 6)
59
+ assert view.offset <= 4
60
+
61
+ def test_off_and_edges(self):
62
+ fields = [C.TextInput('Campo {0}'.format(i)) for i in range(10)]
63
+ view = ScrollView(C.Stack(fields), height=6, follow_focus=False)
64
+ app = App(body=view)
65
+ app.run(keys=[], size=(40, 6))
66
+ for _ in range(8):
67
+ app.dispatch(key('tab'))
68
+ app.render(40, 6)
69
+ assert view.offset == 0
70
+ assert ScrollView('texto').focus_rows(10) is None
71
+ lone = ScrollView(C.TextInput('x'))
72
+ assert lone.focus_rows(10) is None # no app
73
+ big = C.TextArea('Notas', '\n'.join('l%d' % i for i in range(20)),
74
+ rows=15)
75
+ tall = ScrollView(C.Stack([C.TextInput('a'), big]), height=5)
76
+ app2 = App(body=tall)
77
+ app2.run(keys=[], size=(30, 5))
78
+ app2.focus(big)
79
+ app2.render(30, 5)
80
+ assert tall.offset == tall.focus_rows(29)[0]
81
+
82
+
83
+ # 10. Menu and Sidebar keep to the height
84
+
85
+ class TestMenuHeight:
86
+ def test_menu_window(self):
87
+ picked = []
88
+ m = C.Menu(['Opción {0}'.format(i) for i in range(20)],
89
+ on_select=lambda i, it: picked.append(i), use_colors=False)
90
+ out = lines(m, 20, 6)
91
+ assert len(out) == 6 and out[-1] == ' v 15 más'
92
+ m.focused = True
93
+ for _ in range(10):
94
+ m.handle_key(key('down'))
95
+ out = lines(m, 20, 6)
96
+ assert out[0].startswith(' ^') and out[-1].startswith(' v')
97
+ assert any('Opción 10' in l for l in out)
98
+ assert m.handle_key(key('pagedown')) and m.index == 14
99
+ assert m.handle_key(key('scrollup')) and m.index == 11
100
+ m.handle_key(key('end'))
101
+ out = lines(m, 20, 6)
102
+ assert 'Opción 19' in out[-1] and out[0].startswith(' ^')
103
+ m.render(width=20, height=6)
104
+ m.on_mouse(MouseEvent(0, 2, 0, True)) # click the ▲ line: page up
105
+ assert m.index < 19
106
+ m.render(width=20, height=6)
107
+ m.on_mouse(MouseEvent(0, 2, 2, True)) # an item: selects it
108
+ assert picked
109
+ for _ in range(30):
110
+ m.handle_key(key('pagedown'))
111
+ assert m.index == 19
112
+ for _ in range(30):
113
+ m.handle_key(key('pageup'))
114
+ assert m.index == 0
115
+ m.render(width=20, height=6)
116
+ m.on_mouse(MouseEvent(0, 2, 5, True)) # the ▼ line: page down
117
+ assert m.index > 0
118
+ assert len(lines(m, 20, 2)) == 2 # too short for arrows
119
+ assert C.Menu([]).handle_key(key('pagedown')) is False
120
+
121
+ def test_coloured_arrows_and_max_visible(self):
122
+ m = C.Menu(['x%d' % i for i in range(9)], max_visible=4,
123
+ use_colors=True)
124
+ assert '▼ 6 más' in strip_ansi(m.render(width=20))
125
+
126
+ def test_sidebar_window(self):
127
+ sections = {'Ventas': ['V%d' % i for i in range(10)],
128
+ 'Compras': ['C%d' % i for i in range(10)]}
129
+ sb = C.Sidebar(sections, title='Menú', use_colors=False)
130
+ out = lines(sb, 20, 8)
131
+ assert len(out) == 8 and out[0] == ' Menú' and \
132
+ out[-1].startswith(' v')
133
+ sb.focused = True
134
+ for _ in range(15):
135
+ sb.handle_key(key('down'))
136
+ out = lines(sb, 20, 8)
137
+ assert out[0] == ' Menú' and out[2].startswith(' ^')
138
+ assert any('C' in l and '>' in l for l in out)
139
+ sb.render(width=20, height=8)
140
+ sb.on_mouse(MouseEvent(0, 3, 4, True))
141
+ assert sb.active == sb.index
142
+ app = App(body=C.AppShell(sidebar=sb, content='hola'))
143
+ app.run(keys=[], size=(40, 8))
144
+ assert len(app.last_frame.split('\n')) == 8
145
+ full = C.Sidebar({'A': ['a', 'b']}, use_colors=False)
146
+ out = lines(full, 20, 10)
147
+ assert out[:3] == [' A', '*a', ' b'] and not any(
148
+ l.startswith((' ^', ' v')) for l in out)
149
+
150
+
151
+ # 11. Form: responsive columns, spans, minimum widths
152
+
153
+ class TestFormGrid:
154
+ def make(self, **kw):
155
+ a = C.TextInput('Nombre')
156
+ b = C.TextInput('Apellido')
157
+ c = C.TextInput('Dirección')
158
+ d = C.TextInput('CP')
159
+ form = C.Form([a, b, C.FormCell(c, span=2), 'Más',
160
+ C.FormCell(d, min_width=30)], columns=2,
161
+ use_colors=False, cancel_label=None, **kw)
162
+ return form, (a, b, c, d)
163
+
164
+ def test_spans_and_min_width(self):
165
+ form, (a, b, c, d) = self.make()
166
+ out = lines(form, 60)
167
+ assert 'Nombre' in out[0] and 'Apellido' in out[0]
168
+ addr = [l for l in out if 'Dirección' in l][0]
169
+ assert 'CP' not in addr
170
+ cp = [l for l in out if l.startswith('CP')]
171
+ assert cp # 29 < 30: takes the whole row
172
+ assert form.fields() == [a, b, c, d]
173
+ assert form.grid_columns(60) == 2
174
+
175
+ def test_responsive_columns(self):
176
+ form, _ = self.make(min_column_width=30)
177
+ assert form.grid_columns(70) == 2 and form.grid_columns(50) == 1
178
+ out = lines(form, 50)
179
+ nombre = [l for l in out if 'Nombre' in l][0]
180
+ assert 'Apellido' not in nombre
181
+ wide = lines(form, 80)
182
+ assert any('Nombre' in l and 'Apellido' in l for l in wide)
183
+
184
+ def test_tuple_rows_and_set_layout(self):
185
+ a, b, c = C.TextInput('A'), C.TextInput('B'), C.TextInput('C')
186
+ form = C.Form([(a, b), c], columns=3, use_colors=False)
187
+ form.set_layout(c, span=3)
188
+ out = lines(form, 60)
189
+ assert any(l.startswith('A') and 'B' in l for l in out)
190
+ assert form._draw_grid(60)
191
+ assert C.FormCell(a, span=0).span == 1
192
+
193
+
194
+ # 12. DataTable fits the height
195
+
196
+ class TestTableHeight:
197
+ def test_fill_in_a_vstack(self):
198
+ t = C.DataTable(['n'], [[i] for i in range(50)], fill=True,
199
+ use_colors=False)
200
+ st = C.VStack([C.TextInput('Buscar'), t], height=12)
201
+ assert st.weights == [0, 1]
202
+ app = App(body=st)
203
+ app.run(keys=[], size=(30, 12))
204
+ app.focus(t)
205
+ for _ in range(20):
206
+ app.dispatch(key('down'))
207
+ frame = [l.rstrip() for l in strip_ansi(app.render(30, 12))
208
+ .split('\n')]
209
+ assert len(frame) == 12 and frame[-1] == '21/50'
210
+ assert t.visible_rows == 12 - 2 - 2 - 1
211
+ assert any(l.strip() == '> 20' or l.startswith('> 20') or
212
+ '20' in l for l in frame)
213
+
214
+ def test_fill_pads_short_tables(self):
215
+ t = C.DataTable(['n'], [[1], [2]], fill=True, use_colors=False)
216
+ out = lines(t, 20, 8)
217
+ assert len(out) == 8 and out[-1] == '1/2' and t.expand
218
+ assert C.DataTable(['n'], []).visible_rows == 10
219
+
220
+
221
+ # 13. GridView
222
+
223
+ class TestGridView:
224
+ def test_name_role_and_audit(self):
225
+ ok = C.Button('Guardar', lambda: None)
226
+ field = C.TextInput('Nombre')
227
+ g = C.GridView([Card('A', 'a'), (field, 1), GridCell(ok)],
228
+ title='Tablero', columns=3, use_colors=False)
229
+ info = g.a11y()
230
+ assert info['role'] == 'group' and info['label'] == 'Tablero'
231
+ assert info['value'] == '3 elementos'
232
+ assert g.children()[1:] == [field, ok]
233
+ out = lines(g, 60)
234
+ assert out[0] == 'Tablero' and 'Nombre' in ' '.join(out)
235
+ assert g.audit(width=30) == []
236
+ assert g.natural_width() > 0
237
+ assert len(lines(g, 60, 3)) == 3
238
+ app = App(body=g)
239
+ app.run(keys=['tab'], size=(60, 6))
240
+ assert app.focused in (field, ok)
241
+
242
+ def test_audit_reports(self):
243
+ class Plain(C.Box.__mro__[1]):
244
+ focusable = True
245
+ role = 'button'
246
+
247
+ def draw(self, width, height):
248
+ return [self.paint('x', 'cyan' if self.focused else 'blue')]
249
+ g = C.GridView([Plain(), C.Stack([C.Image(b'', alt=None)])],
250
+ role='grid')
251
+ checks = sorted(i.check for i in g.audit())
252
+ assert checks.count('label') >= 3 # grid, button, image
253
+ assert 'focus' in checks and g.a11y()['role'] == 'grid'
254
+ named = C.GridView(['x'], a11y_label='Resumen')
255
+ assert named.a11y_name() == 'Resumen' and named.children() == []
256
+
257
+
258
+ # 14. StatusLine
259
+
260
+ class TestStatusLine:
261
+ def test_render_and_role(self):
262
+ clock = ['12:00']
263
+ sl = C.StatusLine('Listo', center='3 elementos',
264
+ right=lambda: clock[0], kind='success',
265
+ use_colors=False)
266
+ out = strip_ansi(sl.render(width=40))
267
+ assert out.startswith(' ✔ Listo') and out.endswith('12:00 ')
268
+ assert '3 elementos' in out
269
+ info = sl.a11y()
270
+ assert info['role'] == 'status' and info['label'] == 'Estado'
271
+ assert info['value'] == 'Éxito: Listo · 3 elementos · 12:00'
272
+ clock[0] = '12:01'
273
+ assert '12:01' in sl.render(width=40)
274
+ coloured = C.StatusLine('x', use_colors=True)
275
+ assert '\x1b[' in coloured.render(width=20)
276
+ assert coloured.natural_width() >= 3
277
+ assert C.StatusLine(a11y_label='Barra').a11y_name() == 'Barra'
278
+ assert C.StatusLine(kind='error').a11y_value() == 'Error'
279
+ assert C.StatusLine(left=None).parts() == ('', '', '')
280
+
281
+ def test_announces_changes(self):
282
+ said = []
283
+ sl = C.StatusLine('Listo')
284
+ app = App(body=sl)
285
+ app.announce = lambda text, priority='polite': said.append(
286
+ (text, priority))
287
+ app.run(keys=[], size=(30, 2))
288
+ sl.message('Guardado', 'success')
289
+ sl.set(kind='error', left='Sin conexión')
290
+ sl.set(center='') # nothing new: silent
291
+ assert said == [('Éxito: Guardado', 'polite'),
292
+ ('Error: Sin conexión', 'assertive')]
293
+ quiet = C.StatusLine('x', announce=False)
294
+ quiet.app = app
295
+ quiet.set(left='y', right='z', kind=None)
296
+ assert len(said) == 2 and quiet.parts() == ('y', '', 'z')
@@ -1,35 +0,0 @@
1
-
2
- [all]
3
- pandas>=1.0
4
- openpyxl>=3.0
5
- lxml>=4.0
6
- Pillow>=8
7
- flexablelib-tui==3.6.0
8
- flexablelib-components==3.6.0
9
- flexablelib-speedups==3.6.0
10
-
11
- [components]
12
- flexablelib-components==3.6.0
13
-
14
- [excel]
15
- openpyxl>=3.0
16
-
17
- [html]
18
- lxml>=4.0
19
-
20
- [images]
21
- Pillow>=8
22
- flexablelib-tui==3.6.0
23
- flexablelib-components==3.6.0
24
-
25
- [pandas]
26
- pandas>=1.0
27
-
28
- [speed]
29
- flexablelib-speedups==3.6.0
30
-
31
- [svg]
32
- cairosvg>=2.5
33
-
34
- [tui]
35
- flexablelib-tui==3.6.0
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes