devboard 0.1.0__tar.gz → 0.2.0__tar.gz

devboard-0.2.0/AI_POLICY.md

@@ -0,0 +1,15 @@
+# AI Contribution Policy
+
+We accept AI-*assisted* contributions, both for code and documentation, with the following expectations:
+
+- AI-assisted contributions must disclaim their use of AI.
+- Contributors must fully understand the proposed changes and be able to explain why they are the correct approach.
+- Issues must be created before creating pull requests (unless there is already a relevant issue).
+- Issue and pull request templates must be followed.
+- Comments (including bodies) in issues and pull requests must be written by humans. If you use LLMs to translate from one language to another, please include your original comment and the translated one.
+- Git commits must be authored by humans, not AI/bot accounts or identities.
+- Git commit messages must be written by humans, in English. If you cannot write English, please state so in the pull request body and we will write the commit messages ourselves.
+
+Failure to comply with any of these requirements will result in issues or pull requests being closed immediately without comment. Repeated violations of this policy will result in a ban of the offending accounts/identities from contributing to this project and any related project from the same author/organization.
+
+We do not accept AI-generated content in community spaces we maintain or moderate, such as GitHub discussions or Matrix rooms.

{devboard-0.1.0 → devboard-0.2.0}/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [0.2.0](https://github.com/pawamoy/devboard/releases/tag/0.2.0) - 2026-09-10
+
+<small>[Compare with 0.1.0](https://github.com/pawamoy/devboard/compare/0.1.0...0.2.0)</small>
+
+The project is update to support latest version of Textual.
+
+### Bug Fixes
+
+- Prevent event propagation from modal ([e61eadd](https://github.com/pawamoy/devboard/commit/e61eaddaca58f91c02150c2f11465fcb82d576d1) by Timothée Mazzucotelli).
+- Fix script entrypoint ([acb054d](https://github.com/pawamoy/devboard/commit/acb054d11395861c34a60e2a60711379a3b48019) by Timothée Mazzucotelli).
+
+### Performance Improvements
+
+- Start faster (cache), scan faster ([9a740e5](https://github.com/pawamoy/devboard/commit/9a740e55aff8add3016b438d1b0912376a5552aa) by Timothée Mazzucotelli).
+
 ## [0.1.0](https://github.com/pawamoy/devboard/releases/tag/0.1.0) - 2025-11-08
 
 <small>[Compare with first commit](https://github.com/pawamoy/devboard/compare/286120e957168a9162d5a8dc19c7dd72fb0a6d65...0.1.0)</small>

{devboard-0.1.0 → devboard-0.2.0}/CONTRIBUTING.md

@@ -1,28 +1,19 @@
 # Contributing
 
-Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
+Contributions are welcome, and they are greatly appreciated. Every little bit helps, and credit will always be given.
 
-## Environment setup
+**Please always create an issue before working on a new feature or a bug fix, so that we can discuss the implementation and make sure that your work will be merged.**
 
-Nothing easier!
+## Environment setup
 
-Fork and clone the repository, then:
+Install [uv](https://github.com/astral-sh/uv) and [direnv](https://direnv.net/), fork and clone the repository, then:
 
 ```bash
 cd devboard
+direnv allow
 make setup
 ```
 
-> NOTE: If it fails for some reason, you'll need to install [uv](https://github.com/astral-sh/uv) manually.
->
-> You can install it with:
->
-> ```bash
-> curl -LsSf https://astral.sh/uv/install.sh | sh
-> ```
->
-> Now you can try running `make setup` again, or simply `uv sync`.
-
 You now have the dependencies installed.
 
 You can run the application with `make run devboard [ARGS...]`.
@@ -31,8 +22,7 @@ Run `make help` to see all the available actions!
 
 ## Tasks
 
-The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed,
-while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
+The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed, while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
 
 If you work in VSCode, we provide [an action to configure VSCode](https://pawamoy.github.io/copier-uv/work/#vscode-setup) for the project.
 

{devboard-0.1.0 → devboard-0.2.0}/LICENSE

@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) 2023, Timothée Mazzucotelli
+Copyright (c) 2023, Timothée Mazzucotelli and contributors
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devboard
-Version: 0.1.0
+Version: 0.2.0
 Summary: A development dashboard for your projects.
 Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
 License-Expression: ISC
@@ -37,7 +37,7 @@ Description-Content-Type: text/markdown
 # Devboard
 
 [![ci](https://github.com/pawamoy/devboard/workflows/ci/badge.svg)](https://github.com/pawamoy/devboard/actions?query=workflow%3Aci)
-[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/devboard/)
+[![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://pawamoy.github.io/devboard/)
 [![pypi version](https://img.shields.io/pypi/v/devboard.svg)](https://pypi.org/project/devboard/)
 [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#devboard:gitter.im)
 
@@ -59,4 +59,3 @@ uv tool install devboard
 
 <!-- sponsors-start -->
 <!-- sponsors-end -->
-

{devboard-0.1.0 → devboard-0.2.0}/README.md

@@ -1,7 +1,7 @@
 # Devboard
 
 [![ci](https://github.com/pawamoy/devboard/workflows/ci/badge.svg)](https://github.com/pawamoy/devboard/actions?query=workflow%3Aci)
-[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/devboard/)
+[![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://pawamoy.github.io/devboard/)
 [![pypi version](https://img.shields.io/pypi/v/devboard.svg)](https://pypi.org/project/devboard/)
 [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#devboard:gitter.im)
 
@@ -23,4 +23,3 @@ uv tool install devboard
 
 <!-- sponsors-start -->
 <!-- sponsors-end -->
-

{devboard-0.1.0 → devboard-0.2.0}/config/git-changelog.toml

@@ -4,6 +4,6 @@ in-place = true
 output = "CHANGELOG.md"
 parse-refs = false
 parse-trailers = true
-sections = ["build", "deps", "feat", "fix", "refactor"]
+sections = ["build", "deps", "feat", "fix", "perf", "refactor"]
 template = "keepachangelog"
 versioning = "pep440"

{devboard-0.1.0 → devboard-0.2.0}/config/ruff.toml

@@ -1,34 +1,14 @@
-target-version = "py39"
+target-version = "py310"
 line-length = 120
+output-format = "concise"
 
 [lint]
 exclude = [
     "tests/fixtures/*.py",
 ]
-select = [
-    "A", "ANN", "ARG",
-    "B", "BLE",
-    "C", "C4",
-    "COM",
-    "D", "DTZ",
-    "E", "ERA", "EXE",
-    "F", "FBT",
-    "G",
-    "I", "ICN", "INP", "ISC",
-    "N",
-    "PGH", "PIE", "PL", "PLC", "PLE", "PLR", "PLW", "PT", "PYI",
-    "Q",
-    "RUF", "RSE", "RET",
-    "S", "SIM", "SLF",
-    "T", "T10", "T20", "TCH", "TID", "TRY",
-    "UP",
-    "W",
-    "YTT",
-]
+select = ["ALL"]
 ignore = [
     "A001",  # Variable is shadowing a Python builtin
-    "ANN101",  # Missing type annotation for self
-    "ANN102",  # Missing type annotation for cls
     "ANN204",  # Missing return type annotation for special method __str__
     "ANN401",  # Dynamically typed expressions (typing.Any) are disallowed
     "ARG005",  # Unused lambda argument
@@ -36,13 +16,18 @@ ignore = [
     "D105",  # Missing docstring in magic method
     "D417",  # Missing argument description in the docstring
     "E501",  # Line too long
+    "EM101",  # String literal when raising exception
+    "EM102",  # f-string when raising exception
     "ERA001",  # Commented out code
+    "FIX",  # TODO, FIXME, etc.
     "G004",  # Logging statement uses f-string
     "PLR0911",  # Too many return statements
     "PLR0912",  # Too many branches
     "PLR0913",  # Too many arguments to function call
     "PLR0915",  # Too many statements
     "SLF001", # Private member accessed
+    "TD002",  # Missing author in TODO
+    "TD003",  # Missing issue link for TODO
     "TRY003",  # Avoid specifying long messages outside the exception class
 ]
 

devboard-0.2.0/config/ty.toml

@@ -0,0 +1,6 @@
+[src]
+exclude = ["tests/fixtures"]
+
+[terminal]
+error-on-warning = true
+output-format = "concise"

{devboard-0.1.0 → devboard-0.2.0}/config/vscode/launch.json

@@ -23,11 +23,10 @@
             "name": "docs",
             "type": "debugpy",
             "request": "launch",
-            "module": "mkdocs",
+            "module": "zensical",
             "justMyCode": false,
             "args": [
                 "serve",
-                "-v"
             ]
         },
         {

{devboard-0.1.0 → devboard-0.2.0}/config/vscode/settings.json

@@ -4,9 +4,6 @@
         "**/.venvs*/**": true,
         "**/venv*/**": true
     },
-    "mypy-type-checker.args": [
-        "--config-file=config/mypy.ini"
-    ],
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
     "python.testing.pytestArgs": [
@@ -19,6 +16,7 @@
     "ruff.lint.args": [
         "--config=config/ruff.toml"
     ],
+    "ty.configurationFile": "config/ty.toml",
     "yaml.schemas": {
         "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
     },

devboard-0.2.0/config/zed/debug.json

@@ -0,0 +1,44 @@
+// Project-local debug tasks
+//
+// For more documentation on how to configure debug tasks,
+// see: https://zed.dev/docs/debugger
+[
+  {
+    "label": "python (current file)",
+    "adapter": "Debugpy",
+    "request": "launch",
+    "program": "$ZED_FILE",
+    "justMyCode": false
+  },
+  {
+    "label": "run",
+    "adapter": "Debugpy",
+    "request": "launch",
+    "module": "devboard",
+    "justMyCode": false
+  },
+  {
+    "label": "docs",
+    "adapter": "Debugpy",
+    "request": "launch",
+    "module": "zensical",
+    "args": [
+      "serve"
+    ],
+    "justMyCode": false
+  },
+  {
+    "label": "test",
+    "adapter": "Debugpy",
+    "request": "launch",
+    "module": "pytest",
+    "args": [
+      "-c=config/pytest.ini",
+      "-vvv",
+      "--no-cov",
+      "--dist=no",
+      "tests"
+    ],
+    "justMyCode": false
+  }
+]

devboard-0.2.0/config/zed/settings.json

@@ -0,0 +1,43 @@
+// Zed settings
+//
+// For information on how to configure Zed, see the Zed
+// documentation: https://zed.dev/docs/configuring-zed
+//
+// To see all of Zed's default settings without changing your
+// custom settings, run `zed: open default settings` from the
+// command palette (cmd-shift-p / ctrl-shift-p)
+{
+  "languages": {
+    "YAML": {
+      "auto_indent_on_paste": false,
+      "auto_indent": "preserve_indent",
+      "format_on_save": "off"
+    },
+    "Python": {
+      "language_servers": ["ty", "ruff"],
+      "code_actions_on_format": {
+        "source.organizeImports.ruff": true
+      },
+      "formatter": {
+        "language_server": {
+          "name": "ruff"
+        }
+      }
+    }
+  },
+  "lsp": {
+    "ty": {
+      "settings": {
+        "configurationFile": "config/ty.toml"
+      }
+    },
+    "ruff": {
+      "initialization_options": {
+        "settings": {
+          "configurationPreference": "filesystemFirst",
+          "configuration": "config/ruff.toml"
+        }
+      }
+    }
+  }
+}

devboard-0.2.0/config/zed/tasks.json

@@ -0,0 +1,72 @@
+[
+  {
+    "label": "changelog",
+    "command": "scripts/make",
+    "args": ["changelog"]
+  },
+  {
+    "label": "check",
+    "command": "scripts/make",
+    "args": ["check"]
+  },
+  {
+    "label": "check-quality",
+    "command": "scripts/make",
+    "args": ["check-quality"]
+  },
+  {
+    "label": "check-types",
+    "command": "scripts/make",
+    "args": ["check-types"]
+  },
+  {
+    "label": "check-docs",
+    "command": "scripts/make",
+    "args": ["check-docs"]
+  },
+  {
+    "label": "check-api",
+    "command": "scripts/make",
+    "args": ["check-api"]
+  },
+  {
+    "label": "clean",
+    "command": "scripts/make",
+    "args": ["clean"]
+  },
+  {
+    "label": "docs",
+    "command": "scripts/make",
+    "args": ["docs"]
+  },
+  {
+    "label": "docs-deploy",
+    "command": "scripts/make",
+    "args": ["docs-deploy"]
+  },
+  {
+    "label": "format",
+    "command": "scripts/make",
+    "args": ["format"]
+  },
+  {
+    "label": "release",
+    "command": "scripts/make",
+    "args": ["release"]
+  },
+  {
+    "label": "setup",
+    "command": "scripts/make",
+    "args": ["setup"]
+  },
+  {
+    "label": "test",
+    "command": "scripts/make",
+    "args": ["test", "coverage"]
+  },
+  {
+    "label": "vscode",
+    "command": "scripts/make",
+    "args": ["vscode"]
+  }
+]

{devboard-0.1.0 → devboard-0.2.0}/docs/.overrides/main.html

@@ -1,7 +1,11 @@
 {% extends "base.html" %}
 
 {% block announce %}
-  
+  <strong>Fund this project</strong> through
+  <a href="https://github.com/sponsors/pawamoy"><strong>sponsorship</strong></a>
+  <span class="twemoji heart pulse">
+    {% include ".icons/octicons/heart-fill-16.svg" %}
+  </span> &mdash;
   Follow
   <strong>@pawamoy</strong> on
   <a rel="me" href="https://fosstodon.org/@pawamoy">

{devboard-0.1.0 → devboard-0.2.0}/docs/.overrides/partials/comments.html

@@ -1,5 +1,5 @@
 <!-- Giscus -->
-<!-- https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/#giscus-integration -->
+<!-- https://zensical.org/docs/setup/comment-system/#giscus-integration -->
 <div id="feedback" style="display: none;">
     <h2 id="__comments">Feedback</h2>
     <script src="https://giscus.app/client.js"

devboard-0.2.0/docs/css/apidocs.css

@@ -0,0 +1,21 @@
+/* Mark external links as such. */
+a.external::after,
+a.autorefs-external::after {
+  /* https://primer.style/octicons/arrow-up-right-24 */
+  mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  content: ' ';
+
+  display: inline-block;
+  vertical-align: middle;
+  position: relative;
+
+  height: 1em;
+  width: 1em;
+  background-color: currentColor;
+}
+
+a.external:hover::after,
+a.autorefs-external:hover::after {
+  background-color: var(--md-accent-fg-color);
+}

{devboard-0.1.0 → devboard-0.2.0}/docs/tutorial.md

@@ -67,6 +67,16 @@ and change the board value to "tutorial":
 board = "tutorial"
 ```
 
+The configuration file supports one more setting: `workers`,
+the number of projects Devboard scans concurrently (4 by default).
+Raise it if your repositories live on a fast SSD,
+lower it if they live on a spinning disk and cold starts feel slow:
+
+```toml
+board = "tutorial"
+workers = 4
+```
+
 Now open the `tutorial.py` file in your favorite editor,
 and you'll be ready to start building.
 
@@ -150,7 +160,7 @@ Of course, it doesn't know what to do with these projects.
 We will tell it how to scan a project to add rows to our table
 by implementing the `populate_rows` method.
 
-```python hl_lines="7 15-17"
+```python hl_lines="7 15-18"
 from pathlib import Path
 from devboard import Column, Project
 
@@ -167,7 +177,8 @@ class ToCommit(Column):
 
     @staticmethod
     def populate_rows(project):
-        return [(project, project.status_line)] if project.is_dirty else []
+        status_line = project.status_line
+        return [(project, status_line)] if status_line else []
 
 
 columns = [
@@ -180,8 +191,8 @@ We declare the table headers with the `HEADERS` class variable.
 Then we build and return rows in the `populate_rows` method.
 The number of element in each row must be equal to the number of headers.
 Fortunately, the status line functionality is built into [`devboard.Project`][],
-so we can use it directly. We don't bother computing a status line
-if the project is not "dirty", i.e. has no current modifications.
+so we can use it directly. An empty status line means the project is clean
+(no current modifications), in which case we don't add any row.
 
 You may have noticed that the method is a `staticmethod`.
 This is required by Devboard for technical reasons that are beyond this tutorial's scope.
@@ -199,7 +210,7 @@ and the output of `git diff` when hitting ++d++.
 We do that by declaring the `BINDINGS` class variable,
 and by implementing the `apply` method:
 
-```python hl_lines="2 8-12 24-29"
+```python hl_lines="2 8-12 26-32"
 from pathlib import Path
 from devboard import Column, Project, Row
 
@@ -221,14 +232,16 @@ class ToCommit(Column):
 
     @staticmethod
     def populate_rows(project):
-        return [(project, project.status_line)] if project.is_dirty else []
+        status_line = project.status_line
+        return [(project, status_line)] if status_line else []
 
     def apply(self, action, row):
         if action == "status":
             self.modal(text=row.project.repo.git(c="color.status=always").status())
-        if action == "diff":
+        elif action == "diff":
             self.modal(text=row.project.repo.git(c="color.ui=always").diff())
-        raise ValueError(f"Unknown action '{action}'")```
+        else:
+            raise ValueError(f"Unknown action '{action}'")
 
 
 columns = [