Enhancements for TableHeadings & CellEdit, Placeholders, autocomplete combo, various fixes and new examples

.git-blame-ignore-revs

@@ -17,4 +17,8 @@ e4787f7ae96e2a6f11838dcd5591b58ab69fc55a
 cb040bf0656ab6b3c019fadc6adf98c7d4ba01ea
 f7addad546672815db9293f772db71c57521f8e8
 fbeec4c4322b7a1f8dc4cd82ac3c10e6c313901a
+# move langformat
+7a3d17b934d739118fb074f0f572d1e30651117d
+# moving widgets under Widgets dummy class
+e94b09e4f103dfade9d6fffc095507b58c836bce
 

README2.md

@@ -0,0 +1,40 @@
+<!-- Begin section: Overview -->
+
+<!-- TODO: create a dark-version of logo -->
+<p align="center">
+  <picture align="center">
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/PySimpleSQL/pysimplesql/assets/57631333/4153cc7b-bfb2-445f-9aa7-cf2b6da0e786">
+    <source media="(prefers-color-scheme: light)" srcset="https://github.com/PySimpleSQL/pysimplesql/assets/57631333/4153cc7b-bfb2-445f-9aa7-cf2b6da0e786">
+    <img alt="pysimplesql logo" src="https://github.com/PySimpleSQL/pysimplesql/assets/57631333/4153cc7b-bfb2-445f-9aa7-cf2b6da0e786">
+  </picture>
+</p>
+
+Write data-driven desktop apps fast! Lightweight Python library supports SQLite, MySQL/MariaDB, PostgreSQL, Flatfile CSV, SQL Server and MS Access. Uses PySimpleGUI layouts.
+
+---
+
+![gif here](https://)
+
+**[Features](#features)** - **[Requirements](#requirements)** - **[Installation](#installation)** - **[Quick usage](#quick-usage)**
+
+## Features
+
+- [**Test**](https://)
+- Design user interfaces with automatic relationship handling
+
+## Requirements
+
+Dependencies here, along with link to sqldriver specific page
+
+## Installation
+
+- **Unix/macOS**: `python3 -m pip install pysimplesql`
+- **Windows**: `py -m pip install pysimplesql`
+
+## Quick usage
+
+```
+Ultra simple example here
+```
+
+See the [Usage](https://pysimplesql.github.io/pysimplesql/) section of the docs for more examples!

examples/SQLite_examples/checkbox_behavior.py

@@ -0,0 +1,80 @@
+# fmt: off
+import logging
+import PySimpleGUI as sg
+
+sg.change_look_and_feel("SystemDefaultForReal")
+sg.set_options(font=("Roboto", 11))  # Set the font and font size for the table
+
+import pysimplesql as ss # noqa: E402
+
+logger = logging.getLogger(__name__)
+logging.basicConfig(level=logging.DEBUG)  # <=== Set the logging level here (NOTSET,DEBUG,INFO,WARNING,ERROR,CRITICAL)
+
+sql = """
+CREATE TABLE checkboxes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    bool_none BOOLEAN,
+    bool_true BOOLEAN Default True,
+    bool_false BOOLEAN Default False,
+    int_none INTEGER,
+    int_true INTEGER Default 1,
+    int_false INTEGER Default 0,
+    text_none TEXT,
+    text_true TEXT Default "True",
+    text_false TEXT Default "False"
+);
+
+INSERT INTO checkboxes (bool_none, bool_true, bool_false, int_none, int_true, int_false, text_none, text_true, text_false)
+VALUES (NULL,True,False,NULL,1,0,NULL,"True","False");
+"""
+
+# -------------------------
+# CREATE PYSIMPLEGUI LAYOUT
+# -------------------------
+# Create a table heading object
+headings = ss.TableHeadings(sort_enable=True, edit_enable=True)
+
+# Add columns to the table heading
+headings.add_column('id', 'id', width=5)
+
+columns = ['bool_none', 'bool_true', 'bool_false', 'int_none', 'int_true', 'int_false', 'text_none', 'text_true', 'text_false']
+
+for col in columns:
+    headings.add_column(col, col, width=8)
+
+fields = []
+for col in columns:
+    fields.append([ss.field(f'checkboxes.{col}', sg.Checkbox, size=(20, 10), label={col})])
+
+layout = [
+    [sg.Text('This test shows pysimplesql checkbox behavior.')],
+    [sg.Text('Each column is labeled as type: bool=BOOLEAN, int=INTEGER, text=TEXT')],
+    [sg.Text("And the DEFAULT set for new records, no default set, True,1,'True', or False,0,'False'")],
+    [ss.selector('checkboxes', sg.Table, num_rows=10, headings=headings, row_height=25)],
+    [ss.actions('checkboxes', edit_protect=False)],
+    fields,
+]
+
+win = sg.Window('Checkbox Test', layout, finalize=True)
+driver = ss.Driver.sqlite(":memory:", sql_commands=sql)
+# Here is the magic!
+frm = ss.Form(
+    driver,
+    bind_window=win,
+    live_update=True # this updates the `Selector`, sg.Table as we type in fields!
+    )
+
+# ---------
+# MAIN LOOP
+# ---------
+while True:
+    event, values = win.read()
+
+    if event == sg.WIN_CLOSED or event == 'Exit':
+        frm.close()  # <= ensures proper closing of the sqlite database and runs a database optimization
+        win.close()
+        break
+    elif ss.process_events(event, values):  # <=== let PySimpleSQL process its own events! Simple!
+        logger.info(f'PySimpleDB event handler handled the event {event}!')
+    else:
+        logger.info(f'This event ({event}) is not yet handled.')