flexablelib 3.5.4__tar.gz → 3.6.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 (126) hide show
  1. {flexablelib-3.5.4 → flexablelib-3.6.0}/CHANGELOG.md +69 -0
  2. {flexablelib-3.5.4 → flexablelib-3.6.0}/PKG-INFO +12 -9
  3. {flexablelib-3.5.4 → flexablelib-3.6.0}/README.md +3 -0
  4. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_images.py +21 -3
  5. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/columns.py +38 -0
  6. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/table.py +5 -2
  7. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/writers.py +22 -4
  8. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib.egg-info/PKG-INFO +12 -9
  9. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib.egg-info/SOURCES.txt +2 -0
  10. flexablelib-3.6.0/flexablelib.egg-info/requires.txt +35 -0
  11. {flexablelib-3.5.4 → flexablelib-3.6.0}/package.json +1 -1
  12. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v330_components.py +1 -1
  13. flexablelib-3.6.0/tests/test_v355_fixes.py +173 -0
  14. flexablelib-3.6.0/tests/test_v360_features.py +710 -0
  15. flexablelib-3.5.4/flexablelib.egg-info/requires.txt +0 -35
  16. {flexablelib-3.5.4 → flexablelib-3.6.0}/.coveragerc +0 -0
  17. {flexablelib-3.5.4 → flexablelib-3.6.0}/LICENSE +0 -0
  18. {flexablelib-3.5.4 → flexablelib-3.6.0}/MANIFEST.in +0 -0
  19. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/admin.py +0 -0
  20. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/dashboard.py +0 -0
  21. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/keys.py +0 -0
  22. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/video/demo.py +0 -0
  23. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/video/render.py +0 -0
  24. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/video/scenes.py +0 -0
  25. {flexablelib-3.5.4 → flexablelib-3.6.0}/examples/video/thumbnail.py +0 -0
  26. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/__init__.py +0 -0
  27. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_frames.py +0 -0
  28. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_legacy/__init__.py +0 -0
  29. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_legacy/screen.py +0 -0
  30. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_legacy/widgets.py +0 -0
  31. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_speedups.c +0 -0
  32. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/_width_tables.h +0 -0
  33. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/box_topology.py +0 -0
  34. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/cells.py +0 -0
  35. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/colors.py +0 -0
  36. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/fast.py +0 -0
  37. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/identifiers.py +0 -0
  38. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/layout.py +0 -0
  39. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/merges.py +0 -0
  40. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/options.py +0 -0
  41. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/py.typed +0 -0
  42. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/readers.py +0 -0
  43. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/screen.py +0 -0
  44. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/style_compositions.py +0 -0
  45. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/table_strings.py +0 -0
  46. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/text_width.py +0 -0
  47. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/utils.py +0 -0
  48. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib/widgets.py +0 -0
  49. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib.egg-info/dependency_links.txt +0 -0
  50. {flexablelib-3.5.4 → flexablelib-3.6.0}/flexablelib.egg-info/top_level.txt +0 -0
  51. {flexablelib-3.5.4 → flexablelib-3.6.0}/pytest.ini +0 -0
  52. {flexablelib-3.5.4 → flexablelib-3.6.0}/setup.cfg +0 -0
  53. {flexablelib-3.5.4 → flexablelib-3.6.0}/setup.py +0 -0
  54. {flexablelib-3.5.4 → flexablelib-3.6.0}/style_examples.md +0 -0
  55. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/conftest.py +0 -0
  56. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/helpers.py +0 -0
  57. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_align_indicators.py +0 -0
  58. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_box_topology.py +0 -0
  59. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_cells.py +0 -0
  60. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_columns.py +0 -0
  61. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_excel.py +0 -0
  62. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_features.py +0 -0
  63. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_issues.py +0 -0
  64. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_merge_edge_matrix.py +0 -0
  65. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_merge_fill.py +0 -0
  66. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_merges.py +0 -0
  67. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_public_api_edges.py +0 -0
  68. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_readme_examples.py +0 -0
  69. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_stress_matrix.py +0 -0
  70. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_style_line_widths.py +0 -0
  71. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_styles.py +0 -0
  72. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_text_width.py +0 -0
  73. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_two_pass_measurement.py +0 -0
  74. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_upstream_issues.py +0 -0
  75. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v2021_fixes.py +0 -0
  76. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v210_rows_copy.py +0 -0
  77. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v2110_fixes.py +0 -0
  78. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v211_fixes.py +0 -0
  79. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v213_features.py +0 -0
  80. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v214_features.py +0 -0
  81. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v215_features.py +0 -0
  82. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v216_features.py +0 -0
  83. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v217_features.py +0 -0
  84. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v218_features.py +0 -0
  85. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v219_coverage.py +0 -0
  86. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v219_fixes.py +0 -0
  87. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v220_exports.py +0 -0
  88. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v221_fixes.py +0 -0
  89. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v222_fixes.py +0 -0
  90. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v223_fixes.py +0 -0
  91. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v224_fixes.py +0 -0
  92. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v230_none.py +0 -0
  93. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v231_fixes.py +0 -0
  94. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v232_merge_ansi.py +0 -0
  95. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v300_style_names.py +0 -0
  96. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v310_layout.py +0 -0
  97. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v320_tui.py +0 -0
  98. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v330_frames.py +0 -0
  99. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v330_layout.py +0 -0
  100. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v330_tui.py +0 -0
  101. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v331_formats.py +0 -0
  102. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v331_panel_width.py +0 -0
  103. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v331_readers_bom.py +0 -0
  104. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v331_readers_edges.py +0 -0
  105. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v331_tabs.py +0 -0
  106. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v340_accessibility.py +0 -0
  107. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v340_core.py +0 -0
  108. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v340_input.py +0 -0
  109. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v350_images.py +0 -0
  110. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v350_images_core.py +0 -0
  111. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v352_fixes.py +0 -0
  112. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v353_fixes.py +0 -0
  113. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/test_v354_fixes.py +0 -0
  114. {flexablelib-3.5.4 → flexablelib-3.6.0}/tests/wincon_child.py +0 -0
  115. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/bench_frames.py +0 -0
  116. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/bench_images.py +0 -0
  117. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/benchmark.py +0 -0
  118. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/gen_ascii_table.py +0 -0
  119. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/generate_width_tables.py +0 -0
  120. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/image_demo.py +0 -0
  121. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/pty_check.py +0 -0
  122. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/readme_gallery.py +0 -0
  123. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/stress_matrix.py +0 -0
  124. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/style_examples.py +0 -0
  125. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/text_to_png.py +0 -0
  126. {flexablelib-3.5.4 → flexablelib-3.6.0}/tools/wheel_check.py +0 -0
@@ -2,6 +2,75 @@
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.6.0] - 2026-11-13
6
+
7
+ ### Added
8
+ - **`SignatureInput`**: a signature pad drawn with the mouse (press and
9
+ drag) or the keyboard (arrows move the pen, Space puts it down and lifts
10
+ it, `x` erases, Backspace undoes, `c` clears). `value` is the list of
11
+ strokes; `to_text()`, `to_bitmap(scale)` and `to_png(scale)` export it.
12
+ - **`Stopwatch`**: a stopwatch input for forms -- start / stop (Space or
13
+ Enter), laps (`l`), reset (`r`); `value` is the elapsed
14
+ `datetime.timedelta`, `laps` the split times, `on_lap(split)`.
15
+ - **`VStack`**: children one below the other sharing the stack's height by
16
+ `weights`, within `min_heights` / `max_heights`; when they do not fit it
17
+ scrolls and follows the focus (the child holding the focused component
18
+ comes into view; Tab reaches the ones out of view). Wheel and PgUp/PgDn
19
+ scroll it, with an optional scroll bar.
20
+ - **`CatalogGrid` pictures**: items take an `image` (path, URL, bytes or
21
+ bitmap) and `image_alt`; `image_height`, `image_method` and
22
+ `image_headers` control them. Enter or a click on the current card sets
23
+ `selected` / `value`.
24
+ - **Image downloads with headers**: `Image(headers=)`,
25
+ `ImageViewer(headers=)`, `CatalogGrid(image_headers=)` and
26
+ `_images.load(url, headers=)` send e.g. an `Authorization` bearer token.
27
+ `Authorization`, `Proxy-Authorization` and `Cookie` are not sent on to
28
+ redirects, and no header value appears in errors.
29
+ - **`ValidationSummary` from a list**: messages, `(field, message)` pairs,
30
+ dicts with `field` / `message` or exceptions, besides the
31
+ `{field: message}` dict. With `fields` (a `Form` or inputs) or
32
+ `on_select` it takes the focus and Enter moves the focus to the field.
33
+ `entries` and `messages` list them.
34
+ - **`EditableTable(name=)`** and its `value` (a copy of the rows), so a
35
+ `Form` collects it.
36
+
37
+ ### Changed
38
+ - **`Form.values()` and `Form.fields()` reach nested fields**: inputs inside
39
+ containers (`Stack`, `VStack`, `Tabs` -- hidden tabs too --, `Wizard`
40
+ steps, `Accordion` sections, grids, cards) and named `EditableTable`s,
41
+ not only the top-level ones. Validation and "Enter moves to the next
42
+ field" reach them too.
43
+ - **`ScanInput` keeps the code it read** (`keep_value=True`, the new
44
+ default): `value` and a `Form` still have it after the read, the next
45
+ read replaces it as soon as it starts typing, and Enter on the shown code
46
+ does not read it twice. `keep_value=False` restores the old behaviour of
47
+ clearing the field after every read. `last_code` is the latest code.
48
+ - **Focus without colour**: a focused empty `DataTable`, an `Image` drawn as
49
+ text (alt text, `[alt]`, the warning) and the `ImageViewer` info line now
50
+ show a `▸` marker (`>` without colour or in ASCII mode) and reverse
51
+ video, not only a colour. A focused `CatalogGrid` card always has the
52
+ `▸` marker besides its heavy border.
53
+ - Image download errors give the HTTP status or the reason
54
+ (`no se pudo descargar (HTTP 401)`) instead of the exception text.
55
+
56
+ ## [3.5.5] - 2026-11-13
57
+
58
+ ### Fixed
59
+ - **Line breaks in Markdown, reStructuredText, AsciiDoc and LaTeX exports**:
60
+ every break `compose()` and the readers honour (`\r\n`, a lone `\r`,
61
+ `\u2028`, `\u2029`, vertical tab, form feed, `\x85`, `\x1c`-`\x1e`) now
62
+ becomes a space, as `\n` already did. A cell with a Windows line ending
63
+ split its Markdown row in two, so `from_markdown()` read back extra rows
64
+ and shifted every column after it; the RST grid came out ragged.
65
+ - **Fitting a float column to `max_width`** no longer pads its shorter
66
+ numbers with zeros: `-0.5` printed as `-0.50000000` when another number
67
+ in the column set the decimal budget.
68
+ - **A number written with an exponent** (`6.01e+16`) counts whole towards
69
+ how narrow its column can go. Only its integer digits were counted, so
70
+ the reduction was booked against a column that could not give it back
71
+ and the other columns kept their decimals while the table stayed too
72
+ wide.
73
+
5
74
  ## [3.5.4] - 2026-11-13
6
75
 
7
76
  ### Fixed
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: flexablelib
3
- Version: 3.5.4
3
+ Version: 3.6.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.5.4; extra == "tui"
49
+ Requires-Dist: flexablelib-tui==3.6.0; extra == "tui"
50
50
  Provides-Extra: components
51
- Requires-Dist: flexablelib-components==3.5.4; extra == "components"
51
+ Requires-Dist: flexablelib-components==3.6.0; extra == "components"
52
52
  Provides-Extra: speed
53
- Requires-Dist: flexablelib-speedups==3.5.4; extra == "speed"
53
+ Requires-Dist: flexablelib-speedups==3.6.0; extra == "speed"
54
54
  Provides-Extra: images
55
55
  Requires-Dist: Pillow>=8; extra == "images"
56
- Requires-Dist: flexablelib-tui==3.5.4; extra == "images"
57
- Requires-Dist: flexablelib-components==3.5.4; extra == "images"
56
+ Requires-Dist: flexablelib-tui==3.6.0; extra == "images"
57
+ Requires-Dist: flexablelib-components==3.6.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.5.4; extra == "all"
66
- Requires-Dist: flexablelib-components==3.5.4; extra == "all"
67
- Requires-Dist: flexablelib-speedups==3.5.4; 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"
68
68
  Dynamic: author
69
69
  Dynamic: author-email
70
70
  Dynamic: classifier
@@ -186,6 +186,9 @@ in colour or plain text: the full list, what each does and its keys is in
186
186
  <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>
187
187
  <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>
188
188
  </tr>
189
+ <tr>
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
+ </tr>
189
192
  </table>
190
193
 
191
194
  ### Keyboard, mouse and accessibility
@@ -105,6 +105,9 @@ in colour or plain text: the full list, what each does and its keys is in
105
105
  <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>
106
106
  <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>
107
107
  </tr>
108
+ <tr>
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
+ </tr>
108
111
  </table>
109
112
 
110
113
  ### Keyboard, mouse and accessibility
@@ -733,8 +733,17 @@ def render_pdf(data, dpi=96):
733
733
  raise ImageError('PDF necesita PyMuPDF o pdftoppm (poppler)')
734
734
 
735
735
 
736
- def read_source(source, timeout=5.0, max_bytes=64 * 1024 * 1024):
737
- """``(bytes, name)`` for a path, URL, bytes or file object."""
736
+ _PRIVATE_HEADERS = ('authorization', 'proxy-authorization', 'cookie')
737
+
738
+
739
+ def read_source(source, timeout=5.0, max_bytes=64 * 1024 * 1024,
740
+ headers=None):
741
+ """``(bytes, name)`` for a path, URL, bytes or file object.
742
+
743
+ ``headers`` (a dict) go with an ``http(s)://`` request, e.g.
744
+ ``{'Authorization': 'Bearer <token>'}`` for images behind a session.
745
+ ``Authorization``, ``Proxy-Authorization`` and ``Cookie`` are never
746
+ sent on to a redirect, and no header value appears in errors."""
738
747
  if isinstance(source, (bytes, bytearray, memoryview)):
739
748
  return bytes(source), None
740
749
  if hasattr(source, 'read'):
@@ -744,10 +753,19 @@ def read_source(source, timeout=5.0, max_bytes=64 * 1024 * 1024):
744
753
  from urllib.request import Request, urlopen
745
754
  try:
746
755
  req = Request(path, headers={'User-Agent': 'flexablelib'})
756
+ for name, value in (headers or {}).items():
757
+ if str(name).lower() in _PRIVATE_HEADERS:
758
+ req.add_unredirected_header(str(name).capitalize(),
759
+ str(value))
760
+ else:
761
+ req.add_header(str(name), str(value))
747
762
  with urlopen(req, timeout=timeout) as resp:
748
763
  data = resp.read(max_bytes + 1)
749
764
  except Exception as error:
750
- raise ImageError('no se pudo descargar ({0})'.format(error))
765
+ code = getattr(error, 'code', None)
766
+ reason = 'HTTP {0}'.format(code) if isinstance(code, int) else \
767
+ (getattr(error, 'reason', None) or error)
768
+ raise ImageError('no se pudo descargar ({0})'.format(reason))
751
769
  if len(data) > max_bytes:
752
770
  raise ImageError('imagen demasiado grande')
753
771
  return data, path
@@ -497,6 +497,36 @@ def _float_extents(cells: Union[list, tuple],
497
497
  )
498
498
 
499
499
 
500
+ def _float_shrink_floor(cells: Union[list, tuple],
501
+ skip_rows: frozenset = frozenset()) -> int:
502
+ """
503
+ Narrowest a float column can be drawn without changing a number.
504
+
505
+ The integer digits always stay, and so does all of a number written
506
+ with an exponent: :func:`_round_float_cell` never rounds one, so its
507
+ point and everything after it keep their width too. Counting only the
508
+ integer digits booked reductions the column could not give back, and
509
+ the table came out wider than ``max_width``.
510
+
511
+ Example::
512
+
513
+ _float_shrink_floor([9.651, 6.5e+16]) -> 7 # '6' + '.5e+16'
514
+ """
515
+ extents = _float_extents(cells, skip_rows)
516
+ floor = extents.left
517
+ for row_i, cell in enumerate(cells):
518
+ if row_i in skip_rows:
519
+ continue
520
+ parts = cell if is_some_instance(cell, tuple, list) else (cell,)
521
+ for part in parts:
522
+ text = str(part)
523
+ if EXP_FILTER(text) is None or FLT_FILTER(text) is None:
524
+ continue
525
+ _, point, right = text.partition(FLOAT_SEPARATOR)
526
+ floor = max(floor, extents.left + len(point) + visible_width(right))
527
+ return floor
528
+
529
+
500
530
  def _round_float_cell(cell: Any, decimals: int) -> Any:
501
531
  """
502
532
  Re-render one numeric cell with ``decimals`` digits after the point.
@@ -511,6 +541,7 @@ def _round_float_cell(cell: Any, decimals: int) -> Any:
511
541
  _round_float_cell(9.651, 2) -> '9.65'
512
542
  _round_float_cell(245.7, 0) -> '246'
513
543
  _round_float_cell(3, 2) -> 3
544
+ _round_float_cell(0.5, 4) -> 0.5
514
545
  _round_float_cell('n/a', 2) -> 'n/a'
515
546
  """
516
547
  text = str(cell)
@@ -520,6 +551,13 @@ def _round_float_cell(cell: Any, decimals: int) -> Any:
520
551
  # claim entirely.
521
552
  return cell
522
553
 
554
+ _, point, written = text.partition(FLOAT_SEPARATOR)
555
+ if point and len(written) <= max(decimals, 0):
556
+ # Already short enough. Formatting it anyway pads it with zeros:
557
+ # -0.5 came out as -0.50000000 when another cell set the budget,
558
+ # widening the column this is trying to narrow.
559
+ return cell
560
+
523
561
  if decimals <= 0:
524
562
  # No point either: a column with nothing after the point should not
525
563
  # keep paying a character for one.
@@ -23,6 +23,7 @@ from .columns import (
23
23
  _align_columns,
24
24
  _align_headers,
25
25
  _float_extents,
26
+ _float_shrink_floor,
26
27
  _is_numeric_cell,
27
28
  _round_float_cell,
28
29
  TYPE_NAMES,
@@ -3347,8 +3348,10 @@ class Table(object):
3347
3348
  if type_name != TYPE_NAMES.float_ or column is None:
3348
3349
  floor = MIN_COLUMN_SIZE
3349
3350
  else:
3350
- extents = _float_extents(column['data'], skip_rows)
3351
- floor = max(MIN_COLUMN_SIZE, extents.left)
3351
+ floor = max(
3352
+ MIN_COLUMN_SIZE,
3353
+ _float_shrink_floor(column['data'], skip_rows),
3354
+ )
3352
3355
  lo = self.__bound_for_column(
3353
3356
  self.__column_min_width, header, user_i
3354
3357
  )
@@ -59,6 +59,24 @@ def _plain(value: Any) -> str:
59
59
  return strip_ansi(str(value)) if value is not None else ''
60
60
 
61
61
 
62
+ # Every character str.splitlines() breaks on. compose() starts a new line at
63
+ # each of them, and so does a Markdown or AsciiDoc reader, so a single-line
64
+ # format has to flatten all of them, not just '\n'.
65
+ _LINE_BREAKS = re.compile('\r\n|[\n\r\x0b\x0c\x1c\x1d\x1e\x85\u2028\u2029]')
66
+
67
+
68
+ def _one_line(text: str) -> str:
69
+ r"""
70
+ ``text`` with every line break turned into a space.
71
+
72
+ Only replacing ``'\n'`` left the ``'\r'`` of Windows line endings, and
73
+ a lone ``'\r'``, ``'\u2028'`` or form feed, in the output: a cell
74
+ holding ``'a\r\nb'`` split its Markdown row in two, so reading the
75
+ table back shifted every row after it.
76
+ """
77
+ return _LINE_BREAKS.sub(' ', text)
78
+
79
+
62
80
  def _view(table, include_index: bool):
63
81
  """
64
82
  The rows, columns and cell texts ``compose()`` would show.
@@ -327,7 +345,7 @@ def to_markdown(table, include_index: bool = False,
327
345
  return ''
328
346
 
329
347
  def cell(value):
330
- return _plain(value).replace('|', '\\|').replace('\n', ' ')
348
+ return _one_line(_plain(value)).replace('|', '\\|')
331
349
 
332
350
  header_texts = [cell(header) for header in headers]
333
351
  row_texts = [[cell(value) for value in row] for row in view.text]
@@ -919,7 +937,7 @@ def to_rst(table, include_index: bool = False) -> str:
919
937
  return ''
920
938
 
921
939
  def cell(value):
922
- return _plain(value).replace('\n', ' ')
940
+ return _one_line(_plain(value))
923
941
 
924
942
  header_texts = [cell(h) for h in headers]
925
943
  row_texts = [[cell(v) for v in row] for row in view.text]
@@ -962,7 +980,7 @@ def to_asciidoc(table, include_index: bool = False) -> str:
962
980
  return ''
963
981
 
964
982
  def cell(value):
965
- return _plain(value).replace('|', '\\|').replace('\n', ' ')
983
+ return _one_line(_plain(value)).replace('|', '\\|')
966
984
 
967
985
  lines = ['|===', '| ' + ' | '.join(cell(h) for h in headers)]
968
986
  for row in view.text:
@@ -985,7 +1003,7 @@ def to_latex(table, include_index: bool = False) -> str:
985
1003
  return ''
986
1004
 
987
1005
  def escape_tex(value):
988
- text = _plain(value).replace('\n', ' ')
1006
+ text = _one_line(_plain(value))
989
1007
  out = []
990
1008
  for ch in text:
991
1009
  if ch == '\\':
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: flexablelib
3
- Version: 3.5.4
3
+ Version: 3.6.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.5.4; extra == "tui"
49
+ Requires-Dist: flexablelib-tui==3.6.0; extra == "tui"
50
50
  Provides-Extra: components
51
- Requires-Dist: flexablelib-components==3.5.4; extra == "components"
51
+ Requires-Dist: flexablelib-components==3.6.0; extra == "components"
52
52
  Provides-Extra: speed
53
- Requires-Dist: flexablelib-speedups==3.5.4; extra == "speed"
53
+ Requires-Dist: flexablelib-speedups==3.6.0; extra == "speed"
54
54
  Provides-Extra: images
55
55
  Requires-Dist: Pillow>=8; extra == "images"
56
- Requires-Dist: flexablelib-tui==3.5.4; extra == "images"
57
- Requires-Dist: flexablelib-components==3.5.4; extra == "images"
56
+ Requires-Dist: flexablelib-tui==3.6.0; extra == "images"
57
+ Requires-Dist: flexablelib-components==3.6.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.5.4; extra == "all"
66
- Requires-Dist: flexablelib-components==3.5.4; extra == "all"
67
- Requires-Dist: flexablelib-speedups==3.5.4; 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"
68
68
  Dynamic: author
69
69
  Dynamic: author-email
70
70
  Dynamic: classifier
@@ -186,6 +186,9 @@ in colour or plain text: the full list, what each does and its keys is in
186
186
  <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>
187
187
  <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>
188
188
  </tr>
189
+ <tr>
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
+ </tr>
189
192
  </table>
190
193
 
191
194
  ### Keyboard, mouse and accessibility
@@ -107,6 +107,8 @@ tests/test_v350_images_core.py
107
107
  tests/test_v352_fixes.py
108
108
  tests/test_v353_fixes.py
109
109
  tests/test_v354_fixes.py
110
+ tests/test_v355_fixes.py
111
+ tests/test_v360_features.py
110
112
  tests/wincon_child.py
111
113
  tools/bench_frames.py
112
114
  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.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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flexablelib",
3
- "version": "3.5.4",
3
+ "version": "3.6.0",
4
4
  "private": true,
5
5
  "description": "Flexible console and HTML tables for Python: styles, merges, colors, widths, decimal alignment.",
6
6
  "repository": {
@@ -367,7 +367,7 @@ class TestOtherTextInputs:
367
367
  for c in 'P123#':
368
368
  press(s, c)
369
369
  press(s, 'enter')
370
- assert codes == ['123'] and s.text == ''
370
+ assert codes == ['123'] and s.text == '123' # 3.6.0: kept
371
371
  for c in '123':
372
372
  press(s, c)
373
373
  press(s, 'enter') # duplicate within the window: dropped
@@ -0,0 +1,173 @@
1
+ """3.5.5: single-line exports (Markdown, reStructuredText, AsciiDoc, LaTeX)
2
+ flatten every line break, not only '\\n'; a float column narrowed to fit
3
+ max_width never pads short numbers with zeros, and a number written with
4
+ an exponent counts whole towards how narrow its column can go."""
5
+
6
+ import io
7
+ import random
8
+
9
+ import pytest
10
+
11
+ from flexablelib import Table
12
+ from flexablelib.text_width import visible_width
13
+
14
+ BREAKS = ['\r\n', '\r', '\n', '\x0b', '\x0c', '\x1c', '\x1d', '\x1e',
15
+ '\x85', '\u2028', '\u2029']
16
+
17
+
18
+ def table(rows, headers):
19
+ return Table.from_records(rows, headers=headers, parse_numbers=False)
20
+
21
+
22
+ class TestLineBreaksInExports:
23
+ @pytest.mark.parametrize('brk', BREAKS)
24
+ def test_markdown_row_stays_one_line(self, brk):
25
+ t = table([['a' + brk + 'b', 'z']], ['h' + brk + '1', 'k'])
26
+ md = t.to_markdown()
27
+ assert len(md.splitlines()) == 3
28
+ assert md.splitlines()[2].count('|') == 3
29
+
30
+ @pytest.mark.parametrize('brk', BREAKS)
31
+ def test_markdown_round_trip_keeps_rows_and_columns(self, brk):
32
+ t = table([['a' + brk + 'b', 'z'], ['c', 'd']], ['h', 'k'])
33
+ back = Table.from_markdown(t.to_markdown(), parse_numbers=False)
34
+ assert back.to_records() == [
35
+ {'h': 'a b', 'k': 'z'}, {'h': 'c', 'k': 'd'},
36
+ ]
37
+
38
+ def test_windows_line_ending_is_one_space(self):
39
+ t = table([['first\r\nsecond']], ['h'])
40
+ assert 'first second' in t.to_markdown()
41
+ assert '\r' not in t.to_markdown()
42
+
43
+ @pytest.mark.parametrize('brk', BREAKS)
44
+ def test_rst_grid_lines_all_same_width(self, brk):
45
+ t = table([['a' + brk + 'b', 'z']], ['h', 'k'])
46
+ lines = t.to_rst().splitlines()
47
+ assert len(lines) == 5
48
+ assert len({visible_width(line) for line in lines}) == 1
49
+
50
+ @pytest.mark.parametrize('brk', BREAKS)
51
+ def test_asciidoc_one_source_line_per_row(self, brk):
52
+ t = table([['a' + brk + 'b', 'z']], ['h', 'k'])
53
+ assert t.to_asciidoc().splitlines() == [
54
+ '|===', '| h | k', '| a b | z', '|===',
55
+ ]
56
+
57
+ @pytest.mark.parametrize('brk', BREAKS)
58
+ def test_latex_row_on_one_line(self, brk):
59
+ t = table([['a' + brk + 'b', 'z']], ['h', 'k'])
60
+ assert 'a b & z \\\\' in t.to_latex().splitlines()
61
+
62
+ def test_pipes_still_escaped(self):
63
+ t = table([['x|y\r\nw']], ['h'])
64
+ assert '| x\\|y w |' in t.to_markdown()
65
+ assert '| x\\|y w' in t.to_asciidoc()
66
+
67
+ def test_csv_keeps_line_breaks_quoted(self):
68
+ t = table([['a\r\nb', 'c\rd']], ['h', 'k'])
69
+ back = Table.from_csv(io.StringIO(t.to_csv()), parse_numbers=False)
70
+ assert back.to_records() == [{'h': 'a\r\nb', 'k': 'c\rd'}]
71
+
72
+ def test_random_markdown_round_trip(self):
73
+ rng = random.Random(355)
74
+ alphabet = ['a', 'Z', ' ', '9', '.', '中', 'é', '|', '\\'] + BREAKS
75
+ for _ in range(300):
76
+ ncols = rng.randint(1, 4)
77
+ headers = ['h%d' % i for i in range(ncols)]
78
+ rows = [[''.join(rng.choice(alphabet)
79
+ for _ in range(rng.randint(0, 6)))
80
+ for _ in range(ncols)]
81
+ for _ in range(rng.randint(1, 4))]
82
+ md = table(rows, headers).to_markdown()
83
+ assert len(md.splitlines()) == 2 + len(rows), md
84
+ back = Table.from_markdown(md, parse_numbers=False)
85
+ assert len(back.to_records()) == len(rows), md
86
+
87
+
88
+ class TestFloatColumnNarrowing:
89
+ def fitted(self, rows, headers, max_width):
90
+ t = table(rows, headers)
91
+ t.max_width = max_width
92
+ return t.compose()
93
+
94
+ def test_short_number_not_padded_with_zeros(self):
95
+ out = self.fitted([[6.013009189981389e+16, 1.123456789],
96
+ [-0.5, 2.5]], ['R', 'S'], 30)
97
+ assert '-0.5 ' in out
98
+ assert '0.50' not in out
99
+
100
+ def test_other_column_gives_up_decimals_instead(self):
101
+ # R cannot narrow (the exponent keeps all its digits), so S takes
102
+ # the whole reduction, down to the three-character column floor.
103
+ out = self.fitted([[6.013009189981389e+16, 1.123456789],
104
+ [-0.5, 2.5]], ['R', 'S'], 32)
105
+ assert '6.013009189981389e+16' in out
106
+ assert '| 1.1 |' in out
107
+ assert max(visible_width(line) for line in out.splitlines()) <= 32
108
+
109
+ def test_negative_zero_keeps_its_text(self):
110
+ rows = [[None, -1339, -6612, -1046],
111
+ [-4.06238450900009e+16, 168, -6.013009189981389e+16, None],
112
+ [-3.613745969155277e+16, -0.0, -0.0, -2846763.25]]
113
+ out = self.fitted(rows, ['P', 'abcdefghijkl', 'R', 'S'], 80)
114
+ assert '-0.000' not in out
115
+
116
+ def test_lines_stay_aligned(self):
117
+ out = self.fitted([[1.5e+16, 1.123456789, 'x' * 30],
118
+ [-0.25, 2.5, 'y']], ['A', 'B', 'C'], 40)
119
+ assert len({visible_width(line) for line in out.splitlines()}) == 1
120
+
121
+ def test_rounding_still_happens_when_needed(self):
122
+ out = self.fitted([[1.123456789, 'x' * 70], [22.5, 'y']],
123
+ ['F', 'T'], 30)
124
+ assert '1.123456789' not in out
125
+ assert '22.5' in out or '23' in out or '22' in out
126
+
127
+ def test_stream_matches_compose_after_fit(self):
128
+ rows = [[6.013009189981389e+16, 1.123456789], [-0.5, 2.5]]
129
+ t = table(rows, ['R', 'S'])
130
+ t.max_width = 30
131
+ assert '\n'.join(t.stream([])) == t.compose()
132
+
133
+ def test_hidden_exponent_row_does_not_hold_the_column_wide(self):
134
+ rows = [[6.013009189981389e+16, 1.5, 'x' * 40], [2.25, 2.5, 'y']]
135
+ t = table(rows, ['R', 'S', 'T'])
136
+ t.row_filter = lambda row: row[0] != 6.013009189981389e+16
137
+ t.max_width = 20
138
+ out = t.compose()
139
+ assert 'e+16' not in out
140
+ assert max(visible_width(line) for line in out.splitlines()) <= 20
141
+
142
+
143
+ class TestExportAlignmentSources:
144
+ """Where Markdown and LaTeX take each column's alignment from."""
145
+
146
+ def base(self):
147
+ return Table.from_records([['a', 1], ['b', 2]], headers=['x', 'y'])
148
+
149
+ def test_one_code_for_every_column(self):
150
+ t = self.base()
151
+ t.col_alignment = 'c'
152
+ assert t.to_markdown().splitlines()[1] == '| :-: | :-: |'
153
+ assert t.to_latex().splitlines()[0] == r'\begin{tabular}{cc}'
154
+
155
+ def test_short_list_leaves_the_rest_to_the_data(self):
156
+ t = self.base()
157
+ t.col_alignment = ['c']
158
+ assert t.to_markdown().splitlines()[1] == '| :-: | --: |'
159
+ assert t.to_latex().splitlines()[0] == r'\begin{tabular}{cr}'
160
+
161
+ def test_mapping_by_header(self):
162
+ t = self.base()
163
+ t.col_alignment = {'y': 'l'}
164
+ assert t.to_markdown().splitlines()[1] == '| :-- | :-- |'
165
+ assert t.to_latex().splitlines()[0] == r'\begin{tabular}{ll}'
166
+
167
+ def test_merged_html_cell_takes_the_column_colour(self):
168
+ t = self.base()
169
+ t.column_colors = {'x': 'red'}
170
+ t.merge_cells(0, 0, 1, 0)
171
+ html = t._repr_html_()
172
+ assert 'rowspan="2"' in html
173
+ assert 'color:#' in html.split('rowspan="2"')[1].split('>')[0]