whatnext 3.2__tar.gz → 3.3__tar.gz

{whatnext-3.2 → whatnext-3.3}/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
 
+## [v3.3] - 2026-04-13
+
+**Added:**
+- `next` reads from stdin when no task text is provided, allowing piping of
+  multiple tasks (one per line) into a file.
+- `next` wraps the text of added tasks, to a default of 80 chars, which can be
+  overriden in the config `wrap_width` setting, or `WHATNEXT_WRAP_WIDTH`. If
+  the file has any existing lines longer than that, the file takes precedence
+  and the text is instead wrapped to match that longer width.
+- `next --config {file}` specifies a non-default location config file,
+  or set `WHATNEXT_CONFIG`.
+- Summary totals line is now shown in yellow as a differentiator.
+
+
 ## [v3.2] - 2026-04-09
 
 **Added:**

{whatnext-3.2 → whatnext-3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: whatnext
-Version: 3.2
+Version: 3.3
 Summary: A lister of tasks found in Markdown files
 Project-URL: Homepage, https://github.com/norm/whatnext
 Project-URL: Repository, https://github.com/norm/whatnext

{whatnext-3.2 → whatnext-3.3}/docs/next.md

@@ -63,3 +63,9 @@ Once the file is chosen, the file is checked for Markdown headings.
 
 If you would prefer the task is always added at the end of the file,
 set `$WHATNEXT_APPEND_ONLY` to a value, or use `next -a`.
+
+
+## The task text
+
+The task text is all remaining arguments as a string. If no arguments remain,
+`next` reads from stdin, with multiple lines making multiple tasks.

{whatnext-3.2 → whatnext-3.3}/tasks/next.md

@@ -3,7 +3,7 @@
 - [X] next should add to tasks.md in cwd before home
 - [ ] next should have -e too, to edit task files
 - [X] show diff when adding task with next
-- [ ] next reads stdin to add multiple tasks at once?
-- [ ] wrap text to a maximum width when adding to the task file;
+- [X] next reads stdin to add multiple tasks at once
+- [X] wrap text to a maximum width when adding to the task file;
       .whatnext config and env var
 - [ ] directive in a file to tell `next` where to put new tasks

{whatnext-3.2 → whatnext-3.3}/tasks/summaries.md

@@ -1,3 +1,4 @@
 Improvements to `--summary` output.
 
 - [X] show total %age progression across project, not just column totals
+- [X] show total %age in a different colour

{whatnext-3.2 → whatnext-3.3}/tests/colour.bats

@@ -30,6 +30,31 @@ EOF
     [ $status -eq 0 ]
 }
 
+@test "force colour output in summary" {
+    cd example
+
+    b=$'\033[34m'
+    r=$'\033[0m'
+    COLUMNS=40 \
+    WHATNEXT_TODAY=2025-01-01 \
+        run --separate-stderr \
+            whatnext \
+                --color \
+                --summary \
+                --open \
+                tasks.md
+
+    expected_output=$(sed -e 's/^        //' <<EOF
+                                   O
+        ${b}█████████████████████████${r}  3  tasks.md
+
+        █ Open
+EOF
+    )
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
 @test "disable colour output" {
     WHATNEXT_TODAY=2025-12-25 \
     WHATNEXT_COLOR=1 \
@@ -58,3 +83,27 @@ EOF
     diff -u <(echo "$expected_output") <(echo "$output")
     [ $status -eq 0 ]
 }
+
+@test "disable colour output in summary" {
+    cd example
+
+    COLUMNS=40 \
+    WHATNEXT_TODAY=2025-01-01 \
+    WHATNEXT_COLOR=1 \
+        run --separate-stderr \
+            whatnext \
+                --no-color \
+                --summary \
+                --open \
+                tasks.md
+
+    expected_output=$(sed -e 's/^        //' <<"        EOF"
+                                   O
+        █████████████████████████  3  tasks.md
+
+        █ Open
+        EOF
+    )
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}

whatnext-3.3/tests/next/wide.md

@@ -0,0 +1,5 @@
+This line of context is deliberately written to be extraordinarily long, much longer than any task line in this file, to prove the script measures task width not arbitrary line width.
+
+- [ ] short task
+- [ ] another short task
+- [ ] This is an existing task that is deliberately written to be wider than eighty characters on a single line

whatnext-3.3/tests/next/wrapped.md

@@ -0,0 +1,4 @@
+# Tasks @after tasks.md
+
+- [ ] the continuation line is deliberately longer than the first line in
+      order to confirm that width detection occurs across the entire task not just the first line

{whatnext-3.2 → whatnext-3.3}/tests/next.bats

@@ -15,32 +15,34 @@ function setup {
 }
 
 @test "shows usage" {
-    expected_output=$(sed -e 's/^        //' <<"        EOF"
-        usage: next [-h] [--version] [-a] ...
+    expected_output=$(sed -e 's/^        //' <<-EOF
+        usage: next [-h] [--version] [-a] [--config CONFIG] ...
 
         Add a task to a Markdown (.md file) task list.
 
         positional arguments:
-          text        task text to add
+          text             task text to add (if omitted, read from stdin)
 
         options:
-          -h, --help  show this help message and exit
-          --version   show program's version number and exit
-          -a          append to end of file, ignoring headings (or set
-                      WHATNEXT_APPEND_ONLY)
+          -h, --help       show this help message and exit
+          --version        show program's version number and exit
+          -a               append to end of file, ignoring headings (or set
+                           WHATNEXT_APPEND_ONLY)
+          --config CONFIG  path to config file (default: WHATNEXT_CONFIG, or
+                           '.whatnext')
 
         The file to add to is chosen indirectly:
 
         - if the first word of text is an absolute filename, use that
         - if the first word matches a file in the current directory, use that
-        - if the first word matches a file in $WHATNEXT_PROJECT_DIR, use that
-        - if the first word matches a file in $HOME, use that
-        - if the first word matches a directory in $WHATNEXT_PROJECT_DIR:
+        - if the first word matches a file in \$WHATNEXT_PROJECT_DIR, use that
+        - if the first word matches a file in \$HOME, use that
+        - if the first word matches a directory in \$WHATNEXT_PROJECT_DIR:
             - if the second word matches a file
-              $WHATNEXT_PROJECT_DIR/[project]/tasks/[word].md then use that
-            - otherwise, use $WHATNEXT_PROJECT_DIR/[project]/tasks.md
+              \$WHATNEXT_PROJECT_DIR/[project]/tasks/[word].md then use that
+            - otherwise, use \$WHATNEXT_PROJECT_DIR/[project]/tasks.md
         - if tasks.md exists in the current directory, use that
-        - otherwise, use $HOME/tasks.md
+        - otherwise, use \$HOME/tasks.md
 
         With the remaining text:
 
@@ -49,7 +51,7 @@ function setup {
               file, the task is added to that section
             - otherwise, the task is added above the first heading
         - otherwise, the task is added to the end of the file
-        EOF
+	EOF
     )
 
     run next --help
@@ -58,28 +60,14 @@ function setup {
     [ $status -eq 0 ]
 }
 
-@test "without args does nothing" {
-    expected_output=$(sed -e 's/^        //' <<"        EOF"
-        # Tasks
-
-        - [ ] existing task
-        EOF
-    )
-
-    run next
-
-    diff -u <(echo "$expected_output") "$HOME/tasks.md"
-    [ $status -eq 0 ]
-}
-
 @test "non-markdown file is treated as part of text" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] something.txt do something
 
         # Tasks
 
         - [ ] existing task
-        EOF
+	EOF
     )
 
     run next something.txt do something
@@ -100,13 +88,13 @@ function setup {
 }
 
 @test "nonexistent file is treated as part of text" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] nonexistent.md do something
 
         # Tasks
 
         - [ ] existing task
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -129,13 +117,13 @@ function assert_task_added {
     local tasks_file="$1"
     local expected_message="$2"
 
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] do something
 
         # Tasks
 
         - [ ] existing task
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -206,13 +194,13 @@ function assert_task_added {
 }
 
 @test "adds to master task list without WHATNEXT_PROJECT_DIR" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] alpha do something
 
         # Tasks
 
         - [ ] existing task
-        EOF
+	EOF
     )
     expected_output=$(sed -e 's/^        //' <<-EOF
         Updated ~/tasks.md:
@@ -249,9 +237,9 @@ function assert_task_added {
 }
 
 @test "creates project tasks file" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] do something
-        EOF
+	EOF
     )
     expected_output=$(sed -e 's/^        //' <<-EOF
         Created ~/projects/beta/tasks.md:
@@ -267,9 +255,9 @@ function assert_task_added {
 }
 
 @test "does not add to things.md as it is not tried" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] things do something
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -335,13 +323,13 @@ function assert_task_added {
 }
 
 @test "adds to end of file" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
 
 
 
 
         - [ ] do something
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -360,7 +348,7 @@ function assert_task_added {
 }
 
 @test "test within file positioning" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         This is an explanation.
 
         This section currently has no tasks.
@@ -398,7 +386,7 @@ function assert_task_added {
 
         - [ ] second to last task
         - [ ] last task
-        EOF
+	EOF
     )
 
     run next insert.md do something
@@ -422,12 +410,12 @@ function assert_task_added {
 }
 
 @test "WHATNEXT_APPEND_ONLY set" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         # Tasks
 
         - [ ] existing task
         - [ ] do something
-        EOF
+	EOF
     )
     expected_output=$(sed -e 's/^        //' <<-EOF
         Updated ~/tasks.md:
@@ -446,12 +434,12 @@ function assert_task_added {
 }
 
 @test "append flag" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         # Tasks
 
         - [ ] existing task
         - [ ] do something
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -470,13 +458,13 @@ function assert_task_added {
 }
 
 @test "flag-like text is not parsed as arguments" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         - [ ] something -e something
 
         # Tasks
 
         - [ ] existing task
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -496,13 +484,13 @@ function assert_task_added {
 }
 
 @test "appending spaces out tasks" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         # Tasks
 
         This is where things get added.
 
         - [ ] do something
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -522,7 +510,7 @@ function assert_task_added {
 }
 
 @test "append adds to end of file not after last task" {
-    expected_content=$(sed -e 's/^        //' <<"        EOF"
+    expected_content=$(sed -e 's/^        //' <<-EOF
         # Done
 
         - [X] completed task
@@ -530,7 +518,7 @@ function assert_task_added {
         # Next
 
         - [ ] do something
-        EOF
+	EOF
     )
 
     expected_output=$(sed -e 's/^        //' <<-EOF
@@ -576,3 +564,293 @@ function assert_task_added {
     diff -u <(echo "$expected_output") <(echo "$output")
     [ $status -eq 0 ]
 }
+
+@test "continuation line width is detected even when task is deferred" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This new task is longer than eighty characters and exceeds the continuation width to prove
+              where it wraps
+
+        # Tasks @after tasks.md
+
+        - [ ] the continuation line is deliberately longer than the first line in
+              order to confirm that width detection occurs across the entire task not just the first line
+	EOF
+    )
+
+    WHATNEXT_WRAP_WIDTH=20 \
+        run next wrapped.md This new task is longer than eighty characters and exceeds the continuation width to prove where it wraps
+
+    diff -u <(echo "$expected_content") "$HOME/wrapped.md"
+    [ $status -eq 0 ]
+}
+
+@test "existing file with wider lines sets wrap width" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        This line of context is deliberately written to be extraordinarily long, much longer than any task line in this file, to prove the script measures task width not arbitrary line width.
+
+        - [ ] short task
+        - [ ] another short task
+        - [ ] This is an existing task that is deliberately written to be wider than eighty characters on a single line
+        - [ ] Adding another long task that would normally wrap at eighty but should not wrap here because existing
+              tasks are wider
+	EOF
+    )
+
+    run next wide.md Adding another long task that would normally wrap at eighty but should not wrap here because existing tasks are wider
+
+    diff -u <(echo "$expected_content") "$HOME/wide.md"
+    [ $status -eq 0 ]
+}
+
+@test "file width beats narrower env var" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        This line of context is deliberately written to be extraordinarily long, much longer than any task line in this file, to prove the script measures task width not arbitrary line width.
+
+        - [ ] short task
+        - [ ] another short task
+        - [ ] This is an existing task that is deliberately written to be wider than eighty characters on a single line
+        - [ ] This task would wrap at sixty if env var won but it does not because file width is authoritative
+	EOF
+    )
+
+    WHATNEXT_WRAP_WIDTH=60 \
+        run next wide.md This task would wrap at sixty if env var won but it does not because file width is authoritative
+
+    diff -u <(echo "$expected_content") "$HOME/wide.md"
+    [ $status -eq 0 ]
+}
+
+@test "env var sets width when file is narrower" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This is a task that wraps at forty
+              characters
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+
+    WHATNEXT_WRAP_WIDTH=40 \
+        run next This is a task that wraps at forty characters
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    [ $status -eq 0 ]
+}
+
+@test "config sets width when file is narrower" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This is a task that wraps at fifty
+              characters exactly
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+    echo 'wrap_width = 50' > "$HOME/.whatnext"
+
+    run next This is a task that wraps at fifty characters exactly
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    [ $status -eq 0 ]
+}
+
+@test "config file can be specified with --config" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This is a task that wraps at fifty
+              characters exactly
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+    echo 'wrap_width = 50' > "$HOME/custom.toml"
+
+    run next --config custom.toml This is a task that wraps at fifty characters exactly
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    [ $status -eq 0 ]
+}
+
+@test "long task text wraps at 80 chars by default" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This is a very long task description that should wrap because it exceeds
+              the default width of eighty characters
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+
+    run next This is a very long task description that should wrap because it exceeds the default width of eighty characters
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    [ $status -eq 0 ]
+}
+
+@test "stdin adds multiple tasks" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] first task
+        - [ ] second task
+        - [ ] third task
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+    expected_output=$(sed -e 's/^        //' <<-EOF
+        Updated ~/tasks.md:
+        +- [ ] first task
+        +- [ ] second task
+        +- [ ] third task
+        +
+         # Tasks
+         
+	EOF
+    )
+
+    run bash -c 'printf "first task\nsecond task\nthird task\n" | next'
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
+@test "stdin with file specification" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] piped task
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+    expected_output=$(sed -e 's/^        //' <<-EOF
+        Updated ~/alternate.md:
+        +- [ ] piped task
+        +
+         # Tasks
+         
+	EOF
+    )
+
+    run bash -c 'echo "piped task" | next alternate.md'
+
+    diff -u <(echo "$expected_content") "$HOME/alternate.md"
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
+@test "stdin with section specification" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        This is an explanation.
+
+        This section currently has no tasks.
+
+        # First
+
+        - [ ] piped to section
+
+        # Second
+
+        #### Third
+
+        This section contains notes.
+
+        ## Fourth
+
+        A note.
+
+        - [ ] A task.
+
+        Another note.
+
+        # Second
+
+        There is no way to add a task here.
+
+        # Last
+
+        - [ ] second to last task
+	EOF
+    )
+    expected_output=$(sed -e 's/^        //' <<-EOF
+        Updated ~/insert.md (First):
+         
+         # First
+        +
+        +- [ ] piped to section
+         
+         # Second
+	EOF
+    )
+
+    run bash -c 'echo "piped to section" | next insert.md first'
+
+    diff -u <(echo "$expected_content") "$HOME/insert.md"
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
+@test "empty stdin does nothing" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+
+    run bash -c 'echo -n "" | next'
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    diff -u <(echo "") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
+@test "stdin blank lines are ignored" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] actual task
+        - [ ] another task
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+    expected_output=$(sed -e 's/^        //' <<-EOF
+        Updated ~/tasks.md:
+        +- [ ] actual task
+        +- [ ] another task
+        +
+         # Tasks
+         
+	EOF
+    )
+
+    run bash -c 'printf "\nactual task\n\n\nanother task\n\n" | next'
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    diff -u <(echo "$expected_output") <(echo "$output")
+    [ $status -eq 0 ]
+}
+
+@test "stdin tasks are wrapped" {
+    expected_content=$(sed -e 's/^        //' <<-EOF
+        - [ ] This is a very long task that should wrap because it exceeds the default
+              width of eighty characters
+
+        # Tasks
+
+        - [ ] existing task
+	EOF
+    )
+
+    run bash -c 'echo "This is a very long task that should wrap because it exceeds the default width of eighty characters" | next'
+
+    diff -u <(echo "$expected_content") "$HOME/tasks.md"
+    [ $status -eq 0 ]
+}