composeui 0.1.0__tar.gz → 0.2.0__tar.gz

{composeui-0.1.0 → composeui-0.2.0}/AGENTS.md

@@ -165,7 +165,8 @@ document owns what, and the checks.
 - **Change the docs in the commit that changes the behavior.** A change that users see gets
   a line under "Unreleased" in `CHANGELOG.md`. A new view gets a section
   in its page of `docs/user-guide/` and a class docstring, which the widget catalog shows. In
-  `ROADMAP.md`, add it to "Already there" and remove its entry. A new example gets its
+  `ROADMAP.md`, remove its entry, and add it to "Where ComposeUI stands" when it is a new
+  capability. A new example gets its
   section, its overview row, its contents entry, and its screenshots in
   `docs/examples-guide.md`. When a name is renamed or changes, search `README.md`, `docs/`
   and the docstrings for it, and fix every place.
@@ -204,3 +205,27 @@ document owns what, and the checks.
   "Generated with ..." lines, no emoji signatures, in commits, pull requests or code.
   This overrides any default an agent or tool would otherwise add.
 - Keep commits focused: one feature or fix per commit.
+
+## Pull requests
+
+- Push a branch or open a pull request only when the user asks.
+- One feature or fix per pull request, on a branch from an up-to-date `origin/main`.
+- A pull request is complete when it opens: its tests, its docs, and its `CHANGELOG.md`
+  line are in the commit that changes the behavior (see "Documentation"). Ask for the
+  permission that they need before you open it, not after.
+- Before you push, run `make check test`. Also run `make typecheck` after a change to
+  `tests/`: Pyright, Pyrefly and ty check the tests in CI, and `make check` runs none of
+  them. Run `make docs` after a change to `docs/` or a docstring, and `make browser-test`
+  after a change to the page's scripts or a web renderer. Run them again after a rebase.
+- When fixes or features depend on each other, open one pull request at a time. Push the
+  next once the previous one merges, rebased on `origin/main` and checked again.
+- The title is the commit's subject. The body says what was wrong or missing, what
+  changes, and which tests cover it, without AI attribution (see "Commits").
+- Write the body for a reviewer who did not see the conversation, not as a reply to the
+  user: no "I", "you", "as asked" or "as discussed", no thanks or apologies. Describe the
+  code and its behavior, in the style of the documentation (see the `documentation-style`
+  skill).
+- Stage the files of the change by name: never `git add -A`, which takes unrelated files,
+  such as screenshots left in the repository's root.
+- When a check fails for an unrelated reason, such as a flaky browser test, show that
+  `main` fails the same way before you say so.

composeui-0.2.0/CHANGELOG.md

@@ -0,0 +1,128 @@
+# Changelog
+
+The notable changes of each release of ComposeUI. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the versions follow
+[Semantic Versioning](https://semver.org/). Before 1.0, a minor version can break the API.
+
+## [Unreleased]
+
+## [0.2.0] - 2026-10-30
+
+### Added
+
+- `MainView.loaded`, a signal emitted once the views and the model's data are in place: as
+  the app starts, with the study of `-f` or a new one, and after New and Open. An app gives
+  again there what a study doesn't hold, such as the source of a large table, which a load
+  left as it was.
+- `composeui.core.dashboard`, for shorter dashboard code: `DashboardView`, a wide main view
+  without the File menu, and `bar_chart`, a bar chart as a view field's default.
+- `Task.show_state`, which shows a task's loading, progress, or error in a label, and other
+  views only once the task has a result.
+- `CheckBoxMixin.shows`, which shows other views only while the box is checked.
+- `CellWidget.file_path`, a file path in each cell of a table's column: typed, or picked
+  with a "…" button. Qt and Textual open their file dialogs, and the web uploads the file.
+- `ContentDialogView`, a dialog holding any view with OK and Cancel, such as a table to pick
+  a file from. The app enables OK with `is_accept_enabled`, and a subclass can keep the
+  dialog open on OK by overriding `accept`.
+- `FilePathInputMixin.server_roots`, the folders of the server whose files the web's "…"
+  button lists, instead of uploading a copy. The field holds the path of the file on the
+  server. A typed path outside the roots gives `path` `None` on the web. Qt and Textual open
+  their dialogs in the first root.
+- `SavePathInputView`, `RowSavePathInputView` and `LabelRowSavePathInputView`, the path of a
+  file to save, typed or picked in a save dialog, the first extension added to a name that
+  has none. The user agrees to replace a file that exists (`confirms_overwrite`). On the
+  web, the path is typed, or picked in the server's folders with `server_roots`.
+- `FolderPathInputView`, `RowFolderPathInputView` and `LabelRowFolderPathInputView`, a
+  folder's path, typed or picked in a folder dialog. On the web, the path is typed, or picked
+  among the server's folders with `server_roots`.
+- `CellWidget.file_path(..., server_roots=...)`, a table's file path cells picked among the
+  server's files, as a field's. On the web, a path typed outside the roots is refused: the
+  cell keeps its text, and the status bar says why (`TableView.file_texts`).
+- `TableView.row_activated`, which emits a row's index when the user opens it with a double
+  click or Enter, as a large table's `row_activated` emits its id. A double click that edits
+  a cell, or clicks its button or link, doesn't open the row.
+- `ConsoleView`, plain text that the app adds to as it comes, such as a process's output:
+  `append` adds text, "\r" starts a line again, and the view keeps the last `max_lines`
+  lines. It scrolls to its end unless the user scrolled up. On the web, a change sends only
+  the new lines.
+- `current_backend()` and `renders(view_type)` in `composeui.core.application`: the views
+  that the app builds know its backend, and whether it shows a kind of view, such as a
+  `MapView`, which Textual doesn't show.
+- `Task.disables` and `Task.cancel_with`: the views disabled while a task runs, and the
+  buttons or actions that cancel its run, enabled only until it is asked to stop. They
+  follow every start and outcome. `Task.is_canceled` tells a run asked to stop.
+- A console saves its text to a file: a "Save output…" button on Qt, the key `s` on
+  Textual, and a download link on the web. `ConsoleView.export_text(path)` writes it, and
+  `export_filename` names the file at first.
+- A console copies its whole text to the clipboard: a "Copy all" button on Qt and the web,
+  and the key `c` on Textual.
+- A console searches its text: a search field on Qt and the web, `/` on Textual. Its
+  matches are highlighted, and a count says which one is current. New lines keep the
+  current match. `find_in_lines` finds them as the search does.
+- A console removes the escape sequences of a terminal, such as ANSI color codes, from its
+  text. With `ConsoleView.ansi_colors`, it shows their colors and styles on every backend
+  (`TextStyle`, `line_styles`). Before, their characters showed in the text.
+- A large table (`SourceTableView`) opens a row on the web too: a double click or Enter
+  emits its id with `row_activated`, as on Qt and Textual.
+
+### Changed
+
+- `Task.cancel` emits `changed` when it cancels a run, so a `changed` callback can show that
+  the run is stopping. Called in a job's function, it raises `CalledInJobError`, as
+  `Task.start` does: call it on the main thread.
+
+### Fixed
+
+- With reload on, an app that runs the changed code, then exits at once, is no longer started
+  again now and then. When the app acknowledged the change and exited between two of the
+  supervisor's looks, the supervisor took the exit for a request to run the code anew.
+- On Textual, a file or folder picker loading a folder no longer fails now and then with a
+  `KeyError` on a style of its list. textual-fspicker read the styles from its loading
+  thread while Textual applied them again; they are read on the app's thread.
+- A large table of a `DataFrameSource` whose `id_column` is also one of its columns shows its
+  rows. Its cells failed to read on Polars.
+- A choice whose value is `None`, such as `{"All regions": None, "North": "north"}`, shows
+  as selected when `value` is `None`, and its study saves it as that choice. A combobox
+  showed nothing selected instead, on each backend.
+- A job started before the main view shows, such as by `setup_model`, gives its result once
+  the view shows. A job over before then gave it to no backend: a quick load stayed on its
+  "Loading..." text.
+- A chart shows the hovered values of a series of whole numbers, such as counts, as
+  integers: `45280`, not `4.528e+04`, and `12`, not `12.00`. Qt and the web showed 4
+  significant digits for every series. A series with other values still shows 4.
+- A form row in another view than a `FormView`, such as a `LabelRowSliderView` in a
+  sidebar, shows its label, its field, and its message, as a form shows them. No backend
+  showed it, and nothing said why.
+- A `FormView` shows its other views, such as a table or a row of buttons, in their place
+  between its rows, also in a form dialog. Every backend left them out, and nothing said
+  why.
+- With reload on, an app that runs the changed code, then exits by itself soon after, such
+  as one closing its window, isn't started again in a new process. The supervisor took its
+  exit for a request to run the code anew.
+- On the web, a click right after typing in a field sees the value typed, and Save or
+  Save As saves it. The field posts its value as the click takes the focus, and the server
+  could handle the click first.
+
+## [0.1.0] - 2026-10-27
+
+The first release on PyPI.
+
+### Added
+
+- Views as typed `attrs` classes, signals, models, and a `run` function that starts the app
+  on the backend that the command line chooses.
+- Three backends: Qt (the `pyside6` extra), Textual (the `tui` extra), and the web
+  (the `web` extra, the default).
+- Layouts, a status bar, menus, toolbars, inputs, forms and their checks, pages, tabs,
+  resizable panes, a sidebar, dialogs, tables, large tables, trees, Markdown, charts, and
+  street maps (Qt and the web).
+- The state of the views saved to a study file and loaded from it. The file holds the
+  version of its format and the app's `state_version`, and `migrate_state` upgrades an
+  older one.
+- Threads, SQLite models, CSV imports, translations, and tests of an app that need no backend.
+- A skill for coding agents that write a ComposeUI app.
+- `composeui.__version__`, the version of the installed package.
+
+[Unreleased]: https://github.com/ehmoussi/composeui/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/ehmoussi/composeui/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/ehmoussi/composeui/releases/tag/v0.1.0

{composeui-0.1.0 → composeui-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: composeui
-Version: 0.1.0
+Version: 0.2.0
 Summary: A framework-agnostic MVVM layer for Python UIs: one app for Qt, Textual and the web
 Author-email: El Hadi Moussi <50993404+ehmoussi@users.noreply.github.com>
 License-Expression: MIT