.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "examples/plot_tabular_parsing.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_examples_plot_tabular_parsing.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_examples_plot_tabular_parsing.py:


Tabular Parsing
================

This example demonstrates the ``TabularParser`` class for schema-driven
tabular data parsing, supporting both fixed-width and delimiter-separated
layouts.

.. GENERATED FROM PYTHON SOURCE LINES 11-15

Fixed-Width Parsing
--------------------
Define a column schema using ``ColumnDef`` named tuples, then parse
fixed-width text lines into a dict-of-lists.

.. GENERATED FROM PYTHON SOURCE LINES 15-44

.. code-block:: Python


    from cfinterface.components import FloatField, IntegerField, LiteralField
    from cfinterface.components.tabular import ColumnDef, TabularParser

    fixed_columns = [
        ColumnDef(name="City", field=LiteralField(size=12, starting_position=0)),
        ColumnDef(
            name="Population",
            field=IntegerField(size=10, starting_position=12),
        ),
        ColumnDef(
            name="Area",
            field=FloatField(size=8, starting_position=22, decimal_digits=1),
        ),
    ]

    parser = TabularParser(fixed_columns)

    lines = [
        "Springfield  1200000    115.4\n",
        "Shelbyville   800000     98.2\n",
        "Capital City  500000     72.0\n",
    ]

    data = parser.parse_lines(lines)
    print("=== Fixed-Width Parsing ===")
    for i, city in enumerate(data["City"]):
        print(f"  {city}: pop={data['Population'][i]}, area={data['Area'][i]}")





.. rst-class:: sphx-glr-script-out

 .. code-block:: none

    === Fixed-Width Parsing ===
      Springfield: pop=1200000, area=115.4
      Shelbyville: pop=800000, area=98.2
      Capital City: pop=500000, area=72.0




.. GENERATED FROM PYTHON SOURCE LINES 45-49

Round-Trip with format_rows
----------------------------
``format_rows()`` converts the parsed dict-of-lists back into
fixed-width text lines.

.. GENERATED FROM PYTHON SOURCE LINES 49-55

.. code-block:: Python


    roundtrip_lines = parser.format_rows(data)
    print("\n=== Round-Trip Output ===")
    for line in roundtrip_lines:
        print(f"  |{line.rstrip()}|")





.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    === Round-Trip Output ===
      |Springfield    1200000   115.4|
      |Shelbyville     800000    98.2|
      |Capital City    500000    72.0|




.. GENERATED FROM PYTHON SOURCE LINES 56-61

Delimiter-Separated Parsing
----------------------------
For CSV-style data, pass a ``delimiter`` to the parser.
When using a delimiter, ``starting_position`` is ignored and only
``size`` (max token width) applies.

.. GENERATED FROM PYTHON SOURCE LINES 61-86

.. code-block:: Python


    delimited_columns = [
        ColumnDef(name="Name", field=LiteralField(size=20, starting_position=0)),
        ColumnDef(
            name="Score",
            field=FloatField(size=10, starting_position=0, decimal_digits=2),
        ),
        ColumnDef(name="Grade", field=LiteralField(size=2, starting_position=0)),
    ]

    csv_parser = TabularParser(delimited_columns, delimiter=",")

    csv_lines = [
        "Alice,95.50,A\n",
        "Bob,87.25,B\n",
        "Charlie,72.00,C\n",
    ]

    csv_data = csv_parser.parse_lines(csv_lines)
    print("\n=== Delimiter-Separated Parsing ===")
    for i, name in enumerate(csv_data["Name"]):
        print(
            f"  {name}: score={csv_data['Score'][i]}, grade={csv_data['Grade'][i]}"
        )





.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    === Delimiter-Separated Parsing ===
      Alice: score=95.5, grade=A
      Bob: score=87.25, grade=B
      Charlie: score=72.0, grade=C




.. GENERATED FROM PYTHON SOURCE LINES 87-89

Formatting delimited data back
--------------------------------

.. GENERATED FROM PYTHON SOURCE LINES 89-94

.. code-block:: Python


    csv_roundtrip = csv_parser.format_rows(csv_data)
    print("\n=== Delimited Round-Trip ===")
    for line in csv_roundtrip:
        print(f"  {line.rstrip()}")




.. rst-class:: sphx-glr-script-out

 .. code-block:: none


    === Delimited Round-Trip ===
      Alice,95.50,A
      Bob,87.25,B
      Charlie,72.00,C





.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 0.010 seconds)


.. _sphx_glr_download_examples_plot_tabular_parsing.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: plot_tabular_parsing.ipynb <plot_tabular_parsing.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: plot_tabular_parsing.py <plot_tabular_parsing.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: plot_tabular_parsing.zip <plot_tabular_parsing.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_