flexablelib 2.0.0__tar.gz

flexablelib-2.0.0/CHANGELOG.md

@@ -0,0 +1,176 @@
+# Changelog
+
+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.
+
+## [2.0.0](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.4.1...v2.0.0) (2026-10-28)
+
+
+### ⚠ BREAKING CHANGES
+
+* package renamed from `prettyTables` to `flexablelib` (`from flexablelib import Table`)
+
+
+### Features
+
+* Flexible Table Library identity: PyPI name `flexablelib`, C extension `flexablelib._speedups`
+
+
+### Bug Fixes
+
+* colour merge tests pin `use_colors=True` so CI without a TTY still asserts ANSI codes
+
+## [1.4.1](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.4.0...v1.4.1) (2026-08-03)
+
+
+### Bug Fixes
+
+* `column_max_width` now wraps or trims cell content to the cap (was only
+  changing the measured width number, so long cells still overflowed)
+
+## [1.4.0](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.3.0...v1.4.0) (2026-08-03)
+
+
+### Features
+
+* cell formatters: `float_format`, `int_format`, `custom_format`, and `leading_zeros`
+* per-column `column_min_width` / `column_max_width`
+* `header_align` independent of body alignment
+* `add_divider()` / `clear_dividers()` for horizontal rules between rows
+* table `title` drawn above the frame
+* `sort_by` / `sort_reverse` and `row_filter` at render time (storage unchanged)
+* Jupyter `_repr_html_()` via a bare HTML table
+* `shape` property `(rows, columns)`
+* `table_align` and `expand_to_window` wired into render
+
+
+### Bug Fixes
+
+* float columns keep decimal alignment when the table is shrunk ([#23](https://github.com/Opus-Perpetuus/prettyTables/issues/23))
+* alignment options are actually applied; `bool_align` no longer wrote the float slot ([#4](https://github.com/Opus-Perpetuus/prettyTables/issues/4))
+* empty rows and columns share one emptiness criterion ([#9](https://github.com/Opus-Perpetuus/prettyTables/issues/9))
+* column named `"i"` no longer collides with the index column
+* exponential numbers align with the float column
+* tabs, emoji VS16, empty header-only tables, markdown alignment colons, and other upstream regressions
+* wide-character wrap at width 1 no longer invents a blank line
+* header-only tables survive a narrow `max_width` without `IndexError`
+
+
+### Documentation
+
+* `docs/ISSUES.md` maps every tracker issue to its fix and tests
+* README Known Issues and ARCHITECTURE Known gaps brought in line with current behaviour
+
+## [1.3.0](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.2.0...v1.3.0) (2026-08-03)
+
+
+### Features
+
+* merge cells across columns, down rows, or both, via `merge_cells()` ([39f6e56](https://github.com/Opus-Perpetuus/prettyTables/commit/39f6e56))
+
+
+### Performance Improvements
+
+* skip the redundant second measuring pass when the table already fits, and cut per-cell helper overhead; 2000x4 renders in 16.9ms against 30.6ms, making this the fastest of flexablelib, prettytable, tabulate and pandas .to_string() on the same data ([88b01f0](https://github.com/Opus-Perpetuus/prettyTables/commit/88b01f0))
+
+
+### Bug Fixes
+
+* the index column no longer continues counting across renders; it is reset explicitly rather than by a side effect of deep-copying the table ([88b01f0](https://github.com/Opus-Perpetuus/prettyTables/commit/88b01f0))
+* `is_some_instance` returned None instead of False when nothing matched ([88b01f0](https://github.com/Opus-Perpetuus/prettyTables/commit/88b01f0))
+
+## [1.2.0](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.5...v1.2.0) (2026-08-03)
+
+
+### Features
+
+* ANSI colour for headers, borders, columns, rows and individual cells, with NO_COLOR and TTY detection ([f7ea1c9](https://github.com/Opus-Perpetuus/prettyTables/commit/f7ea1c9))
+* read from CSV, HTML, dicts, pandas and Excel; write CSV, Markdown, self-contained paginated HTML and Excel ([c54fa06](https://github.com/Opus-Perpetuus/prettyTables/commit/c54fa06))
+* parse numeric strings via `parse_str_numbers`, absorbing celulartable's type parsing ([ce5362b](https://github.com/Opus-Perpetuus/prettyTables/commit/ce5362b))
+* `max_width` and `too_narrow_message` for tables that cannot fit ([f8309b8](https://github.com/Opus-Perpetuus/prettyTables/commit/f8309b8))
+* `Table.missing` sentinel for building tables with gaps ([c54fa06](https://github.com/Opus-Perpetuus/prettyTables/commit/c54fa06))
+
+
+### Bug Fixes
+
+* measure and pad cells by visible width, fixing alignment for CJK, Hangul and emoji ([7a350d2](https://github.com/Opus-Perpetuus/prettyTables/commit/7a350d2))
+* exclude hidden rows from column width measurement ([#22](https://github.com/Opus-Perpetuus/prettyTables/issues/22)) ([e480f4e](https://github.com/Opus-Perpetuus/prettyTables/commit/e480f4e))
+* shrink the widest column first instead of every column in proportion ([#16](https://github.com/Opus-Perpetuus/prettyTables/issues/16)) ([842f64e](https://github.com/Opus-Perpetuus/prettyTables/commit/842f64e))
+* never hand a column a width budget of zero, which raised from textwrap ([#14](https://github.com/Opus-Perpetuus/prettyTables/issues/14)) ([842f64e](https://github.com/Opus-Perpetuus/prettyTables/commit/842f64e))
+* with auto_wrap off, the trimmed table now fits the terminal (Known Issue #2) ([842f64e](https://github.com/Opus-Perpetuus/prettyTables/commit/842f64e))
+
+
+### Performance Improvements
+
+* C extension for text measurement, 17-34x on the hot path, with a pure-Python fallback ([23981d4](https://github.com/Opus-Perpetuus/prettyTables/commit/23981d4))
+
+### [1.1.5](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.4...v1.1.5) (2022-07-11)
+
+
+### Bug Fixes
+
+* Wasn't possible to add empty rows. ([7a94a3f](https://github.com/Opus-Perpetuus/prettyTables/commit/7a94a3f94438ebdab16d21dd80d4c1bc66be872e))
+
+### [1.1.4](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.3...v1.1.4) (2022-07-11)
+
+
+### Bug Fixes
+
+* Accidental import. ([47e798a](https://github.com/Opus-Perpetuus/prettyTables/commit/47e798a9019b918b47ace50d5fe5683864e5e886))
+* Auto trimming fixed. ([92e3a66](https://github.com/Opus-Perpetuus/prettyTables/commit/92e3a668fb931da0225b375d03c72f2ce9e357d0))
+* Auto-wrapping fixed. ([4b8d631](https://github.com/Opus-Perpetuus/prettyTables/commit/4b8d631dc9f7dbe65053e25b854dc61c7d6fbb64))
+* Autwrapping with index shown fixed. ([cbcb70c](https://github.com/Opus-Perpetuus/prettyTables/commit/cbcb70c8a08c5572553a3b46cad822cc316d5025))
+* Columns not showing wen passing less headers in class args. ([1559fe4](https://github.com/Opus-Perpetuus/prettyTables/commit/1559fe41f347130e44f07c67cdd464ca23f0cf68))
+* Passing extra headers causes an IndexError. ([e5a3e42](https://github.com/Opus-Perpetuus/prettyTables/commit/e5a3e427cf226d6eb4e58fb658d5068be1700edd))
+* Using rows and headers arguments gives error. ([0479cd5](https://github.com/Opus-Perpetuus/prettyTables/commit/0479cd569396db5a08c9b51be7816b53e0e0f8f9))
+
+### [1.1.3](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.2...v1.1.3) (2022-05-07)
+
+
+### Bug Fixes
+
+* more accidental imports ([25e4c88](https://github.com/Opus-Perpetuus/prettyTables/commit/25e4c88e0feab8f154547ae159d0d7d8fff0750b))
+
+### [1.1.2](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.1...v1.1.2) (2022-05-07)
+
+
+### Bug Fixes
+
+* accidental import. ([736ab4d](https://github.com/Opus-Perpetuus/prettyTables/commit/736ab4dc281cb766f9726512e3505a5bb17fc0cc))
+
+### [1.1.1](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.1.0...v1.1.1) (2022-05-07)
+
+
+### Bug Fixes
+
+* adding column of different size causing misplaced missing values. ([66abc50](https://github.com/Opus-Perpetuus/prettyTables/commit/66abc5082488c734ffd9329be09f9dc6ea86683b))
+* unintended info printing on console. ([560af0a](https://github.com/Opus-Perpetuus/prettyTables/commit/560af0aa8016ab71ad11f9f7ce29375543c192a9))
+
+## [1.1.0](https://github.com/Opus-Perpetuus/prettyTables/compare/v1.0.0...v1.1.0) (2022-05-07)
+
+
+### Features
+
+* added auto-wrapping for string columns. ([0cacdef](https://github.com/Opus-Perpetuus/prettyTables/commit/0cacdef34c738d0d611440ab393f474f37858ae3))
+* added float parsing and alignment ([1a65acd](https://github.com/Opus-Perpetuus/prettyTables/commit/1a65acd7a3fc7deb7331de4bed20a9d276d1a87d))
+* added show_index option ([8b8d328](https://github.com/Opus-Perpetuus/prettyTables/commit/8b8d328af591a7d0edd288d80af029837f300f81))
+* auto-wrap depends on the auto_wrap option. ([a1e09e5](https://github.com/Opus-Perpetuus/prettyTables/commit/a1e09e50ec913343b5b48b679cf08128ba74a383))
+* column data trimming added. ([f53503b](https://github.com/Opus-Perpetuus/prettyTables/commit/f53503bc0b1bf3bd342286ba5cb16354ab8ee4ab))
+* show_empty_columns, show_empty_rows options ([a7e4288](https://github.com/Opus-Perpetuus/prettyTables/commit/a7e428845254d68368e9bce6a7fbb4a59fe4046f))
+
+
+### Bug Fixes
+
+* add_column omitting columns_with_i ([4cc900d](https://github.com/Opus-Perpetuus/prettyTables/commit/4cc900d25c494fbc2dcf4b58a7c7794c42d22b81))
+* auto-wrapping doesn't wrap columns "equally". ([9ba68ab](https://github.com/Opus-Perpetuus/prettyTables/commit/9ba68aba7c8c7494c33682368921802bc5167436))
+* empty column and row hiding working bad ([76979e9](https://github.com/Opus-Perpetuus/prettyTables/commit/76979e9b803491e6335cdcca8f7417f99abf8542))
+* float columns weren't considering header size ([f8ffce3](https://github.com/Opus-Perpetuus/prettyTables/commit/f8ffce38a2b97d409ca7ba37677280d8ff329c68))
+* header wrapping wasn't working ([09b5136](https://github.com/Opus-Perpetuus/prettyTables/commit/09b513653f89dc61331301c2be5b1506366d0fdc))
+* hiding empty r/c when showing i behaving bad ([823776a](https://github.com/Opus-Perpetuus/prettyTables/commit/823776ae5b1ca9b9210a8cd8337847a79fd5625f))
+* index displays incorrectly when hiding empty rows ([6054dda](https://github.com/Opus-Perpetuus/prettyTables/commit/6054ddae743df58907802c1467f8993d937c7df7))
+* large missing val. in float col. causes bad alignment ([565d58c](https://github.com/Opus-Perpetuus/prettyTables/commit/565d58c9db550d63d634c1f49c972a7c8beb7b8f))
+* missing value was a normal value and was affecting alignment ([a01d4fa](https://github.com/Opus-Perpetuus/prettyTables/commit/a01d4fa1b7dcc03f3ba78f31b9984ba7a7f4d334))
+* read_json not closing json ([6702f53](https://github.com/Opus-Perpetuus/prettyTables/commit/6702f5330f11d1f2a70b811e68f9a26447a065f6))
+* table with index wasn't auto-wrapping ([23457a5](https://github.com/Opus-Perpetuus/prettyTables/commit/23457a542733a40931f875db76f2a62939ffa93e))
+* when displaying index and adding rows table data messes up. ([3c0a724](https://github.com/Opus-Perpetuus/prettyTables/commit/3c0a7245dd09597ac46028bf31a03d37014c0ccc))
+* when showing i table data displays incomplete. ([b33ed42](https://github.com/Opus-Perpetuus/prettyTables/commit/b33ed42d064b1875e70357dedc1b2005ba396379))
+* wrapping wasn't working ([cf63647](https://github.com/Opus-Perpetuus/prettyTables/commit/cf63647a741dec0867cb702d75d16c3b0301d3e1))

flexablelib-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2022 Benjamin Ramirez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

flexablelib-2.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include package.json
+include flexablelib/_speedups.c
+include flexablelib/_width_tables.h
+recursive-include tools *.py

flexablelib-2.0.0/PKG-INFO

@@ -0,0 +1,372 @@
+Metadata-Version: 2.4
+Name: flexablelib
+Version: 2.0.0
+Summary: Flexible Table Library — console tables
+Home-page: https://github.com/Opus-Perpetuus/prettyTables
+Download-URL: 
+Author: Benjamin Ramirez
+Author-email: chilerito12@gmail.com
+License: MIT
+Keywords: console,graphics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.0; extra == "pandas"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.0; extra == "excel"
+Provides-Extra: html
+Requires-Dist: lxml>=4.0; extra == "html"
+Provides-Extra: all
+Requires-Dist: pandas>=1.0; extra == "all"
+Requires-Dist: openpyxl>=3.0; extra == "all"
+Requires-Dist: lxml>=4.0; extra == "all"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+<p align="center">
+  <img src="logos/export/logo.svg" alt="flexablelib" width="440">
+</p>
+
+<p align="center">
+  <em>Flexible Table Library — format tabular data with pretty styles.</em>
+</p>
+
+<p align="center">
+  <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>
+  <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>
+  <a href="https://pypi.org/project/flexablelib/"><img alt="Downloads per month" src="https://img.shields.io/pypi/dm/flexablelib?style=flat-square&color=F59E0B"></a>
+  <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>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/flexablelib?style=flat-square&color=64748B"></a>
+</p>
+
+---
+
+# **flexablelib**
+
+Flexible Table Library
+
+This is a python package that aims to provide a simple and pretty way of printing tables to the console making use of a class.
+
+The idea started as an attempt to reproduce the behavior of the [PM2](https://pm2.keymetrics.io) package when it displays tables to show data. Later, heavy inspiration came
+of two other python packages:
+
+- [Jazzband's](https://github.com/jazzband) [prettytable](https://github.com/jazzband/prettytable) (The names are similar by accident). Uses a class too.
+- [Astanin's](https://github.com/astanin) [tabulate](https://github.com/astanin/python-tabulate). A very simple to use and efficient package.
+
+A big part of the behavior of this package was replicated from these.
+
+# Installation
+``pip install flexablelib`` on Windows.
+
+``pip3 install flexablelib`` on Linux
+
+# Usage
+Creating a table is simple.
+### Code Example
+```
+from flexablelib import Table
+
+new_table = Table()
+print(new_table)
+```
+### Output
+```
+++
+++
+++
+```
+This is an empty table. It has no data so it only displays this strange thing.
+
+A table that has columns but no rows — a query that came back empty — shows
+its headers rather than raising:
+
+```
+┌──────┬───────┐
+│ name │ value │
+╞══════╪═══════╡
+└──────┴───────┘
+```
+
+It's possible to add data as columns or rows, or even alternating each one. Any untitled column will be named automatically.
+
+### Code Example
+```
+new_table.add_column('Name', ['Jade', 'John', 'Jane'])
+new_table.add_column('Age', [20, 30, 40])
+new_table.add_column('Results', [9.651, 3, 245.7])
+print(new_table)
+```
+
+### Output
+```
++----------------------+
+| Name   Age   Results |
++======+=====+=========+
+| Jade |  20 |   9.651 |
+| John |  30 |   3     |
+| Jane |  40 | 245.7   |
++------+-----+---------+
+```
+
+### Code Example
+```
+new_table = Table()
+new_table.add_column('Name', ['Jade', 'John', 'Jane'])
+new_table.add_column('Age', [20, 30, 40])
+new_table.add_column('Test\nResults', [9.651, 3, 245.7])
+new_table.add_row(['Piotr\nBaltimore', 27, 3.5])
+new_table.add_row(['Sam', 21, 0.6519])
+print(new_table)
+```
+
+### Output
+```
++----------------------------+
+| Name        Age       Test |
+|                    Results |
++===========+=====+==========+
+| Jade      |  20 |   9.651  |
+| John      |  30 |   3      |
+| Jane      |  40 | 245.7    |
+| Piotr     |  27 |   3.5    |
+| Baltimore |     |          |
+| Sam       |  21 |   0.6519 |
++-----------+-----+----------+
+```
+As it is visible, the table will format automatically new lines and data types, for now without trying to parse strings that could be converted to another type.
+
+The ``Table`` class offers a variety of options that allow things like showing the index of each row, changing the style of the table, hiding the headers, etc.
+
+See style examples [here](/style_examples.md).
+
+### Code Example
+```
+new_table = Table()
+new_table.add_column('Name', ['Jade', 'John'])
+new_table.add_column('Age', [20, 30])
+new_table.add_column('Test\nResults', [9.651, 3, 245.7])
+new_table.add_row(['Piotr\nBaltimore', 27, 3.5])
+new_table.add_row(['Sam', 21])
+new_table.show_index = True
+new_table.style_name = 'pretty_columns'
+new_table.missing_value = '?'
+print(new_table)
+```
+
+### Output
+```
+╒═══╤═══════════╤═════╤═════════╕
+│ i │ Name      │ Age │    Test │
+│   │           │     │ Results │
+╞═══╪═══════════╪═════╪═════════╡
+│ 0 │ Jade      │  20 │   9.651 │
+│ 1 │ John      │  30 │   3     │
+│ 2 │ ?         │   ? │ 245.7   │
+│ 3 │ Piotr     │  27 │   3.5   │
+│   │ Baltimore │     │         │
+│ 4 │ Sam       │  21 │       ? │
+╘═══╧═══════════╧═════╧═════════╛
+```
+The missing value aligns as if it was of the same type of the other data in the column.
+
+This shows how to get the row and column count. If the index is shown, this count remains unaffected by that column, although, you can get the internal count.
+
+### Code Example
+```
+new_table.show_index = False
+new_table.show_headers = False
+print(new_table)
+print('row:', new_table.row_count)
+print('columns:', new_table.column_count)
+new_table.show_index = True
+print(new_table)
+print('internal_row_count:', new_table.internal_row_count)
+print('internal_column_count:', new_table.internal_column_count)
+```
+
+### Output
+```
+╒═══════════╤════╤═════════╕
+│ Jade      │ 20 │   9.651 │
+│ John      │ 30 │   3     │
+│ ?         │  ? │ 245.7   │
+│ Piotr     │ 27 │   3.5   │
+│ Baltimore │    │         │
+│ Sam       │ 21 │       ? │
+╘═══════════╧════╧═════════╛
+row: 5
+columns: 3
+╒═══╤═══════════╤════╤═════════╕
+│ 0 │ Jade      │ 20 │   9.651 │
+│ 1 │ John      │ 30 │   3     │
+│ 2 │ ?         │  ? │ 245.7   │
+│ 3 │ Piotr     │ 27 │   3.5   │
+│   │ Baltimore │    │         │
+│ 4 │ Sam       │ 21 │       ? │
+╘═══╧═══════════╧════╧═════════╛
+internal_row_count: 5
+internal_column_count: 4
+```
+
+# Colour
+
+Colour the header, the borders, whole columns, whole rows, or individual cells.
+Specs accept names, attributes, 256-colour indexes and hex triples.
+
+```python
+table.header_color = 'bold cyan'
+table.border_color = 'grey'
+table.column_colors = {'Service': 'bright_white'}
+table.color_rule = lambda value, row, column: (
+    'red' if column == 'Delta' and value < 0 else None
+)
+```
+
+`color_rule` receives the original value, so numeric comparisons work directly.
+
+Colour is emitted only to a terminal by default, and never when `NO_COLOR` is
+set. `FORCE_COLOR` or `table.use_colors = True` overrides that. Because
+`compose()` returns a string you may send anywhere, the default errs toward not
+embedding escape sequences in something bound for a file.
+
+Widths are measured in terminal columns, not characters, so coloured cells and
+CJK or emoji data stay aligned.
+
+# Reading and writing
+
+```python
+Table.from_csv('sales.csv')          # numeric columns parsed and aligned
+Table.from_html(markup)              # standard library parser, no dependency
+Table.from_dicts(records)
+Table.from_pandas(dataframe)         # pip install flexablelib[pandas]
+Table.from_excel('report.xlsx')      # pip install flexablelib[excel]
+
+table.to_csv('out.csv')
+table.to_markdown()
+table.to_html('report.html', paginate=25)
+table.to_excel('report.xlsx')
+```
+
+`to_html` writes one self-contained file — the stylesheet and the sorting,
+filtering and pagination script are inline — so it works offline and from a
+`file://` URL.
+
+Text formats deliver everything as strings, and a column of strings is
+left-aligned. `parse_str_numbers` converts numeric-looking text so it aligns as
+numbers; the readers turn it on for you:
+
+```python
+table.parse_str_numbers = True
+```
+
+Values with leading zeros are left alone, so `'007'` stays a string.
+
+# Merging cells
+
+Render a rectangular block as a single cell, across columns, down rows, or
+both. Coordinates are inclusive, zero-based, and ignore the index column.
+
+```python
+table.merge_cells(0, 0, last_column=2, value='Quarter summary')
+table.merge_cells(1, 0, last_row=3)                # keeps the top-left content
+table.merge_cells(0, 0, 2, 2, value='Total', align='r')
+```
+
+A merge never widens the table -- columns are still sized by their unmerged
+content -- so text longer than its span is truncated.
+
+# Performance
+
+An optional C extension accelerates text measurement, and the render pipeline
+avoids the second measuring pass when the table already fits. On identical
+data:
+
+| Library | 100x4 | 2000x4 | 10000x6 |
+| --- | ---: | ---: | ---: |
+| **flexablelib** | **1.0 ms** | **16.9 ms** | **147 ms** |
+| prettytable | 1.4 ms | 23.2 ms | 174 ms |
+| tabulate | 1.7 ms | 27.5 ms | 193 ms |
+| pandas `.to_string()` | 1.7 ms | 22.9 ms | 228 ms |
+
+Reproduce with `python3 tools/benchmark.py`. This measures one job: turning
+data already in memory into formatted text. pandas is an analysis engine and
+`to_string` is a convenience within it, so this says nothing about groupby or
+joins.
+
+The extension is built automatically where a compiler is available and falls
+back to pure Python where it is not, so installation never fails for want of a
+toolchain.
+
+```python
+from flexablelib.fast import implementation
+print(implementation())   # 'C extension' or 'pure Python'
+```
+
+# Known Issues
+
+None of the three historical known issues remain:
+
+- A column named ``"i"`` no longer collides with the index column
+  (`utils.IndexColumnTitle`).
+- Exponential numbers align on the decimal / exponent axis with the rest of
+  the float column.
+- Shrinking a float column drops decimals instead of chopping characters, so
+  decimal alignment survives a terminal fit ([#23](https://github.com/Opus-Perpetuus/prettyTables/issues/23)).
+
+Open work and the full issue map live in [docs/ISSUES.md](docs/ISSUES.md).
+
+# Project Layout
+
+```
+prettyTables/                 # GitHub repository (name unchanged)
+├── flexablelib/            the Python package (no runtime dependencies)
+│   ├── __init__.py          public API: Table, TableComposition, SeparatorLine
+│   ├── table.py             the Table class — state and render orchestration
+│   ├── columns.py           type inference, alignment, column widths
+│   ├── style_compositions.py   the 42 border styles, as data
+│   ├── table_strings.py     separator lines and data rows
+│   ├── cells.py             cell padding, justification, wrapping
+│   ├── options.py           constants and defaults
+│   └── utils.py             type predicates and small helpers
+├── tests/                   pytest suite — see ARCHITECTURE.md#testing
+├── docs/                    issue history and design notes
+├── logos/                   brand assets — see logos/README.md
+├── ARCHITECTURE.md          how it all fits together
+├── style_examples.md        all 42 styles rendered
+├── package.json             canonical version number; drives the release
+└── setup.py                 reads the version from package.json
+```
+
+Run the tests from the repository root:
+
+```
+pip install -r requirements-dev.txt
+python -m pytest
+```
+
+See [**ARCHITECTURE.md**](ARCHITECTURE.md) for the rendering pipeline, how styles are defined,
+and how to add one.