Merge branch 'dev'

Author: thiswillbeyourgithub

README.md

@@ -78,9 +78,11 @@ Alternatively, you can install from source:
 The library supports configuration via environment variables:
 
 - `CALDAV_TASKS_API_URL`: CalDAV server URL
-- `CALDAV_TASKS_API_USERNAME`: CalDAV username  
+- `CALDAV_TASKS_API_USERNAME`: CalDAV username
 - `CALDAV_TASKS_API_PASSWORD`: CalDAV password
 - `CALDAV_TASKS_API_DEFAULT_LIST_UID`: Default task list UID for operations
+- `CALDAV_TASKS_API_DEFAULT_PRIORITY`: Default priority to use when creating tasks
+- `CALDAV_TASKS_API_LOG_LEVEL`: Default log level, by default `WARNING`
 
 ## Usage
 
@@ -101,6 +103,9 @@ python -m caldav_tasks_api list-lists
 # List latest tasks from a specific list
 python -m caldav_tasks_api list-latest-tasks --list-uid <list-uid>
 
+# Dump all the tasks of a list as VTODO format
+python -m caldav_tasks_api dump-all-tasks --list-uid <list-uid>
+
 # Add a new task
 python -m caldav_tasks_api add-task --list-uid <list-uid> --summary "My new task"
 

bumpver.toml

@@ -1,6 +1,6 @@
 
 [bumpver]
-current_version = "1.2.4"
+current_version = "1.3.0"
 version_pattern = "MAJOR.MINOR.PATCH"
 commit_message = "bump version {old_version} -> {new_version}"
 tag_message = "{new_version}"

caldav_tasks_api/__main__.py

@@ -544,5 +544,107 @@ def list_lists(url, username, password, nextcloud_mode, debug):
         raise click.Abort()
 
 
+@cli.command(name="dump-all-tasks")
+@click.option("--url", help="CalDAV server URL (or set CALDAV_URL env var)")
+@click.option("--username", help="CalDAV username (or set CALDAV_USERNAME env var)")
+@click.option("--password", help="CalDAV password (or set CALDAV_PASSWORD env var)")
+@click.option(
+    "--nextcloud-mode/--no-nextcloud-mode",
+    default=True,
+    help="Adjust URL for Nextcloud specific path [default: enabled]",
+)
+@click.option(
+    "--debug/--no-debug",
+    default=False,
+    help="Enable debug mode with interactive console [default: disabled]",
+)
+@click.option(
+    "--list-uid",
+    default=None,
+    envvar="CALDAV_TASKS_API_DEFAULT_LIST_UID",
+    help="UID of the task list to dump all tasks from. Defaults to CALDAV_TASKS_API_DEFAULT_LIST_UID env var if set.",
+)
+def dump_all_tasks(url, username, password, nextcloud_mode, debug, list_uid):
+    """Dump all tasks from a specified list in VTODO format."""
+    logger.debug(
+        f"CLI dump-all-tasks initiated with url: {'***' if url else 'from env'}, "
+        f"user: {username or 'from env'}, nc_mode: {nextcloud_mode}, "
+        f"debug: {debug}, list_uid: {list_uid}"
+    )
+
+    if not list_uid:
+        click.echo(
+            "Error: Task list UID must be provided via --list-uid argument or CALDAV_TASKS_API_DEFAULT_LIST_UID environment variable.",
+            err=True,
+        )
+        raise click.Abort()
+
+    try:
+        # This command is inherently read-only.
+        # Filter to only the specified list to optimize loading
+        api = get_api(
+            url,
+            username,
+            password,
+            nextcloud_mode,
+            debug,
+            target_lists=[list_uid],
+            read_only=True,
+        )
+
+        logger.info("Loading remote tasks...")
+        api.load_remote_data()
+
+        # Find the specified task list
+        target_task_list = None
+        for task_list in api.task_lists:
+            if task_list.uid == list_uid:
+                target_task_list = task_list
+                break
+
+        if not target_task_list:
+            click.echo(f"Error: Task list with UID '{list_uid}' not found.", err=True)
+            raise click.Abort()
+
+        click.echo(
+            f"# Dumping all tasks from list: '{target_task_list.name}' (UID: {list_uid})"
+        )
+        click.echo(f"# Total tasks: {len(target_task_list.tasks)}")
+        click.echo("")
+
+        if not target_task_list.tasks:
+            click.echo("# No tasks found in this list.")
+            return
+
+        # Print each task's VTODO format
+        for i, task in enumerate(target_task_list.tasks, 1):
+            click.echo(f"# Task {i}/{len(target_task_list.tasks)}: {task.text}")
+            click.echo(f"# UID: {task.uid}")
+            click.echo("")
+            vtodo_string = task.to_ical()
+            click.echo(vtodo_string)
+            click.echo("")  # Extra blank line between tasks
+
+        if debug:
+            click.echo(
+                "Debug mode: Starting interactive console. API and task list available as 'api', 'target_task_list'."
+            )
+            _globals = globals().copy()
+            _locals = locals().copy()
+            _globals.update(_locals)
+            code.interact(local=_globals)
+
+    except click.UsageError as ue:
+        click.echo(f"Configuration error: {ue}", err=True)
+        raise click.Abort()
+    except ConnectionError as ce:
+        click.echo(f"Connection failed: {ce}", err=True)
+        raise click.Abort()
+    except Exception as e:
+        logger.exception(f"An unexpected error occurred: {e}")
+        click.echo(f"Error: {e}", err=True)
+        raise click.Abort()
+
+
 if __name__ == "__main__":
     cli()

caldav_tasks_api/caldav_tasks_api.py

@@ -17,7 +17,7 @@
 
 class TasksAPI:
 
-    VERSION: str = "1.2.4"
+    VERSION: str = "1.3.0"
 
     def __init__(
         self,

caldav_tasks_api/utils/logging_config.py

@@ -12,7 +12,7 @@ def setup_logging():
 
     # Console logger
     # Determine console log level from environment variable, default to INFO
-    console_log_level = os.environ.get("CALDAV_TASKS_API_LOG_LEVEL", "INFO").upper()
+    console_log_level = os.environ.get("CALDAV_TASKS_API_LOG_LEVEL", "WARNING").upper()
     try:
         logger.add(
             sys.stderr,
@@ -23,14 +23,14 @@ def setup_logging():
     except ValueError:  # Handle invalid log level from env var
         logger.add(
             sys.stderr,
-            level="INFO",  # Default to INFO if env var is invalid
+            level="WARNING",  # Default to INFO if env var is invalid
             format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>",
             colorize=True,
         )
         logger.warning(
             f"Invalid CALDAV_TASKS_API_LOG_LEVEL '{console_log_level}'. Defaulting to INFO for console."
         )
-        console_log_level = "INFO"  # Update for the info message below
+        console_log_level = "WARNING"  # Update for the info message below
 
     # File logger
     # Using appname and appauthor (you might want to centralize these, e.g., from setup.py or a config)

docs/source/conf.py

@@ -25,7 +25,7 @@
 project = "Caldav-Tasks-API"
 copyright = "2025, thiswillbeyourgithub"
 author = "thiswillbeyourgithub"
-release = "1.2.4"
+release = "1.3.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

docs/source/the_tests.md

@@ -20,6 +20,7 @@ Test Coverage Summary
 | TasksAPI | Create and rename/update task                       | `test_create_and_rename_task`                    |   ✅   |
 | TasksAPI | `TaskData.to_dict()` conversion                     | `test_task_to_dict`                              |   ✅   |
 | CLI      | `show-summary --json` command runs successfully     | `test_cli_show_summary_json_runs_successfully`   |   ✅   |
+| CLI      | `dump-all-tasks` command runs successfully          | `test_cli_dump_all_tasks_runs_successfully`      |   ✅   |
 | TasksAPI | Add task attempt fails (read-only mode)             | `test_add_task_in_read_only_mode`                |   ✅   |
 | TasksAPI | Delete task attempt fails (read-only mode)          | `test_delete_task_in_read_only_mode`             |   ✅   |
 | TasksAPI | Update task attempt fails (read-only mode)          | `test_update_task_in_read_only_mode`             |   ✅   |

docs/source/the_usage.md

@@ -76,7 +76,7 @@ caldav-tasks-api list-lists > all_lists.json
 - `--username TEXT`: CalDAV username (or set `CALDAV_TASKS_API_USERNAME` env var)
 - `--password TEXT`: CalDAV password (or set `CALDAV_TASKS_API_PASSWORD` env var)
 - `--nextcloud-mode` / `--no-nextcloud-mode`: Adjust URL for Nextcloud (default: True)
-- `--debug` / `--no-debug`: Enable interactive debugging console (default: False)
+- `--debug` / `--no-debug`: Enable interactive debugging console (default: False). Also changes the log level, which by default is `WARNING` (or set `CALDAV_TASKS_API_LOG_LEVEL`)
 
 ### Specific command options: