devboard 0.1.0__tar.gz → 0.3.0__tar.gz

devboard-0.3.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.3.0/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+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.3.0](https://github.com/pawamoy/devboard/releases/tag/0.3.0) - 2026-09-23
+
+<small>[Compare with 0.2.0](https://github.com/pawamoy/devboard/compare/0.2.0...0.3.0)</small>
+
+### Features
+
+- Render Rich content in modals ([fb2393e](https://github.com/pawamoy/devboard/commit/fb2393e75edc21b71e4684b82394f4516785499c) by Timothée Mazzucotelli).
+- Let columns report status bar progress ([08a6943](https://github.com/pawamoy/devboard/commit/08a6943c6ab66bde2699c116e22a1ab025c11f7a) by Timothée Mazzucotelli).
+- Add maximize/unmaximize keybinding to all columns ([8fd99d4](https://github.com/pawamoy/devboard/commit/8fd99d48d715189c5679cb97edb07806964738d5) by Timothée Mazzucotelli). [Issue-2](https://github.com/pawamoy/devboard/issues/2)
+- Allow collapsing/expanding column with keybinding ([51160e1](https://github.com/pawamoy/devboard/commit/51160e152a9bcbcc3a77ede5ee2878252b7a6946) by Timothée Mazzucotelli).
+- Add progress bar (scanning/fetching) ([34290ea](https://github.com/pawamoy/devboard/commit/34290ea4b1bfb04ac9560b47d5fbd0244034e5a6) by Timothée Mazzucotelli).
+
+### Bug Fixes
+
+- Update cache after each (batch) row operation ([25b1370](https://github.com/pawamoy/devboard/commit/25b13703240c94107146d1de2fcff7a20f16d6c3) by Timothée Mazzucotelli).
+- Emptied columns are collapsed ([6e49906](https://github.com/pawamoy/devboard/commit/6e49906ba1dcdb3cedc04d92909c838c4b9e1627) by Timothée Mazzucotelli).
+- Always encode in UTF8 ([fe0f17f](https://github.com/pawamoy/devboard/commit/fe0f17f8016b55c8edff96dbcba2d12975987511) by Timothée Mazzucotelli).
+- Support restoring cache with moved columns ([a014e82](https://github.com/pawamoy/devboard/commit/a014e82f49b4d3f3d47a0f5bf4d5edda1eacb5b0) by Timothée Mazzucotelli).
+- Identify projects by their paths, to avoid redundant work ([2708a80](https://github.com/pawamoy/devboard/commit/2708a80282ef5a37b9a1b62efa081542bd1ef39f) by Timothée Mazzucotelli).
+- Save to cache after each reload ([091a229](https://github.com/pawamoy/devboard/commit/091a2296ac968ba92ef562b50eb4b67db4165114) by Timothée Mazzucotelli).
+
+### Code Refactoring
+
+- Let each board declare its own bindings ([cf7a6a9](https://github.com/pawamoy/devboard/commit/cf7a6a928a6fb50bc50d4caa5d010117305e8eae) by Timothée Mazzucotelli).
+- Declare keybindings with Textual actions ([5b1ec54](https://github.com/pawamoy/devboard/commit/5b1ec548daf2fc3c5db6171f35a1c680fa91b429) by Timothée Mazzucotelli).
+- Generalize refresh/force-refresh ([342ef55](https://github.com/pawamoy/devboard/commit/342ef552ccbf3e151750ef44800fe68d0f6f8e20) by Timothée Mazzucotelli).
+- Make columns generic ([6532042](https://github.com/pawamoy/devboard/commit/6532042da615c7f9c54ffa1cd9f713db552c77c3) by Timothée Mazzucotelli).
+- Restructure app to separate concerns ([c11b897](https://github.com/pawamoy/devboard/commit/c11b897a3a5e45aad0e78b9c7a6749e0bbed7e91) by Timothée Mazzucotelli).
+
+## [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>
+
+### Features
+
+- Release Insiders project to the public ([ce7aad4](https://github.com/pawamoy/devboard/commit/ce7aad4c6c2da3924aebcf143f3a0d1068573297) by Timothée Mazzucotelli).
+
+### Code Refactoring
+
+- Update imports ([976e578](https://github.com/pawamoy/devboard/commit/976e57897d92431c60f510efbe6d8be5516747cd) by Timothée Mazzucotelli).
+- Move submodules under internal folder ([9ec90e1](https://github.com/pawamoy/devboard/commit/9ec90e11392d86022213e7dc4cfcfd520fa7783c) by Timothée Mazzucotelli).

{devboard-0.1.0 → devboard-0.3.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.
 
@@ -48,6 +38,7 @@ As usual:
 1. run `make format` to auto-format the code
 1. run `make check` to check everything (fix any warning)
 1. run `make test` to run the tests (fix any issue)
+1. if you changed the terminal layout, run `.venv/bin/pytest tests/test_snapshots.py -c config/pytest.ini --snapshot-update` and review the updated SVG files
 1. if you updated the documentation or the project dependencies:
     1. run `make docs`
     1. go to http://localhost:8000 and check that everything looks good

{devboard-0.1.0 → devboard-0.3.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.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: devboard
-Version: 0.1.0
-Summary: A development dashboard for your projects.
+Version: 0.3.0
+Summary: A development dashboard for projects, issues, pull requests, and other work.
 Author-Email: =?utf-8?q?Timoth=C3=A9e_Mazzucotelli?= <dev@pawamoy.fr>
 License-Expression: ISC
 License-File: LICENSE
@@ -28,7 +28,7 @@ Project-URL: Discussions, https://github.com/pawamoy/devboard/discussions
 Project-URL: Gitter, https://gitter.im/devboard/community
 Project-URL: Funding, https://github.com/sponsors/pawamoy
 Requires-Python: >=3.10
-Requires-Dist: textual>=0.40
+Requires-Dist: textual>=8.2
 Requires-Dist: gitpython>=3.1
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: tomli>=2.0; python_version < "3.11"
@@ -37,11 +37,11 @@ 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)
 
-A development dashboard for your projects.
+A development dashboard for projects, issues, pull requests, and other work.
 
 ## Installation
 
@@ -59,4 +59,3 @@ uv tool install devboard
 
 <!-- sponsors-start -->
 <!-- sponsors-end -->
-

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

@@ -1,11 +1,11 @@
 # 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)
 
-A development dashboard for your projects.
+A development dashboard for projects, issues, pull requests, and other work.
 
 ## Installation
 
@@ -23,4 +23,3 @@ uv tool install devboard
 
 <!-- sponsors-start -->
 <!-- sponsors-end -->
-

{devboard-0.1.0 → devboard-0.3.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.3.0}/config/pytest.ini

@@ -12,5 +12,7 @@ filterwarnings =
   error
   default::EncodingWarning
   error::EncodingWarning:devboard
+  # pytest-textual-snapshot 1.1 uses datetime.utcnow while building a failure report.
+  ignore:datetime.datetime.utcnow\(\) is deprecated.*:DeprecationWarning:pytest_textual_snapshot
   # TODO: remove once pytest-xdist 4 is released
   ignore:.*rsyncdir:DeprecationWarning:xdist

{devboard-0.1.0 → devboard-0.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.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.3.0}/docs/examples/columns/commit.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import os
 from pathlib import Path
 
+from devboard import Board
 from devboard._internal.default_board import ToCommit
 from devboard._internal.projects import Project as BaseProject
 
@@ -11,15 +12,15 @@ BASE_DIR = Path(os.environ["PROJECTS_DIR"])
 
 class Project(BaseProject):
     @classmethod
-    def list_projects(cls):
+    def list_items(cls):
         for filedir in BASE_DIR.iterdir():
             if filedir.is_dir() and filedir.joinpath(".git").is_dir():
                 yield cls(filedir)
 
 
 class ToCommit(ToCommit):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
-columns = [ToCommit]
+board = Board([ToCommit])

{devboard-0.1.0 → devboard-0.3.0}/docs/examples/columns/commit_pull.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import os
 from pathlib import Path
 
+from devboard import Board
 from devboard._internal.default_board import ToCommit, ToPull
 from devboard._internal.projects import Project as BaseProject
 
@@ -11,20 +12,20 @@ BASE_DIR = Path(os.environ["PROJECTS_DIR"])
 
 class Project(BaseProject):
     @classmethod
-    def list_projects(cls):
+    def list_items(cls):
         for filedir in BASE_DIR.iterdir():
             if filedir.is_dir() and filedir.joinpath(".git").is_dir():
                 yield cls(filedir)
 
 
 class ToCommit(ToCommit):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
 class ToPull(ToPull):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
-columns = [ToCommit, ToPull]
+board = Board([ToCommit, ToPull])

{devboard-0.1.0 → devboard-0.3.0}/docs/examples/columns/commit_pull_push.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import os
 from pathlib import Path
 
+from devboard import Board
 from devboard._internal.default_board import ToCommit, ToPull, ToPush
 from devboard._internal.projects import Project as BaseProject
 
@@ -11,25 +12,25 @@ BASE_DIR = Path(os.environ["PROJECTS_DIR"])
 
 class Project(BaseProject):
     @classmethod
-    def list_projects(cls):
+    def list_items(cls):
         for filedir in BASE_DIR.iterdir():
             if filedir.is_dir() and filedir.joinpath(".git").is_dir():
                 yield cls(filedir)
 
 
 class ToCommit(ToCommit):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
 class ToPull(ToPull):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
 class ToPush(ToPush):
-    def list_projects(self):
-        yield from Project.list_projects()
+    def list_items(self):
+        yield from Project.list_items()
 
 
-columns = [ToCommit, ToPull, ToPush]
+board = Board([ToCommit, ToPull, ToPush])