microsoft-todo-cli 1.0.0__py3-none-any.whl

microsoft_todo_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,296 @@
+Metadata-Version: 2.4
+Name: microsoft-todo-cli
+Version: 1.0.0
+Summary: Fast, minimal command-line client for Microsoft To-Do
+Home-page: https://github.com/underwear/microsoft-todo-cli
+Author: underwear
+Author-email: 
+License: MIT
+Keywords: microsoft todo cli task management
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Requires-Dist: requests>=2.28.1
+Requires-Dist: requests_oauthlib
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# microsoft-todo-cli
+
+Fast, minimal command-line client for Microsoft To-Do
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```
+$ todo tasks
+[0]  Buy groceries
+[1]  Call mom                     ! (due: tomorrow)
+[2]  Review PR #42
+     [x] Check tests
+     [ ] Add documentation
+
+$ todo new "Deploy v2.0" -d friday -r 9am -I
+Created task 'Deploy v2.0' in 'Tasks'
+
+$ todo complete 0
+Completed task 'Buy groceries' in 'Tasks'
+```
+
+## Install
+
+**Requirements:** Python 3.10+
+
+```bash
+pip install microsoft-todo-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/underwear/microsoft-todo-cli.git
+cd microsoft-todo-cli
+pip install -e .
+```
+
+Then configure Microsoft API access: **[Setup Guide](docs/setup-api.md)** (5 min)
+
+## Quick Start
+
+```bash
+todo lists                        # Show all lists
+todo tasks                        # Show tasks from default list
+todo tasks Work                   # Show tasks from "Work" list
+todo new "Buy milk"               # Create task
+todo complete "Buy milk"          # Mark done (or: todo c "Buy milk")
+todo rm "Old task"                # Delete
+```
+
+**Default list**: The first list returned by Microsoft To-Do API (usually "Tasks"). Specify a list explicitly with `-l ListName` or as a positional argument.
+
+**Short aliases**: `t` (tasks), `n` (new), `c` (complete), `d` (rm) — see [Aliases](#aliases).
+
+## Usage
+
+### Tasks
+
+```bash
+# View
+todo tasks                        # Default list
+todo tasks Work                   # Specific list
+todo tasks --due-today            # Due today
+todo tasks --overdue              # Past due
+todo tasks --important            # High priority
+todo tasks --completed            # Done tasks
+todo tasks --all                  # Everything
+
+# Create
+todo new "Task name"              # Basic
+todo new "Task" -l Work           # In specific list
+todo new "Task" -d tomorrow       # With due date
+todo new "Task" -r 2h             # With reminder (in 2 hours)
+todo new "Task" -d mon -r 9am     # Due Monday, remind at 9am
+todo new "Task" -I                # Important
+todo new "Task" -R daily          # Recurring
+todo new "Task" -R weekly:mon,fri # Recurring on specific days
+todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+
+# View single task
+todo show "Task"                  # Show task details
+todo show 0                       # Show by index
+
+# Manage
+todo complete "Task"              # Mark complete
+todo complete 0 1 2               # Complete by index (batch)
+todo uncomplete "Task"            # Reopen task
+todo update "Task" --title "New"  # Rename
+todo update "Task" -d friday -I   # Change due date, make important
+todo rm "Task"                    # Delete (asks confirmation)
+todo rm "Task" -y                 # Delete (no confirmation)
+```
+
+### Subtasks (Steps)
+
+```bash
+todo new-step "Task" "Step text"      # Add step
+todo list-steps "Task"                # List steps
+todo complete-step "Task" "Step"      # Check off
+todo uncomplete-step "Task" "Step"    # Uncheck
+todo rm-step "Task" 0                 # Remove by index
+```
+
+### Lists
+
+```bash
+todo lists                        # Show all lists
+todo new-list "Project X"         # Create list
+todo rename-list "Old" "New"      # Rename list
+todo rm-list "Project X"          # Delete list (asks confirmation)
+todo rm-list "Project X" -y       # Delete list (no confirmation)
+```
+
+### Date & Time Formats
+
+| Type | Examples |
+|------|----------|
+| Relative | `1h`, `30m`, `2d`, `1h30m` |
+| Time | `9:30`, `9am`, `17:00`, `5:30pm` |
+| Days | `tomorrow`, `monday`, `fri` |
+| Date | `2026-12-31`, `31.12.2026`, `12/31/2026` |
+| Keywords | `morning` (7:00), `evening` (18:00) |
+
+### Recurrence Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `daily` | Every day |
+| `weekly` | Every week |
+| `monthly` | Every month |
+| `yearly` | Every year |
+| `weekdays` | Monday to Friday |
+| `weekly:mon,wed,fri` | Specific days |
+| `every 2 days` | Custom interval |
+| `every 3 weeks` | Custom interval |
+
+## Scripting & Automation
+
+### JSON Output
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+todo tasks --json
+todo lists --json
+todo show "Task" --json
+```
+
+**Example: `todo tasks --json`**
+```json
+{
+  "list": "Tasks",
+  "tasks": [
+    {
+      "id": "AAMkADU3...",
+      "title": "Buy groceries",
+      "status": "notStarted",
+      "importance": "normal",
+      "due_date": null,
+      "reminder": null,
+      "recurrence": null,
+      "steps": []
+    },
+    {
+      "id": "AAMkADU4...",
+      "title": "Call mom",
+      "status": "notStarted",
+      "importance": "high",
+      "due_date": "2026-02-06",
+      "reminder": "2026-02-06T09:00:00",
+      "recurrence": null,
+      "steps": [
+        {"id": "step1", "name": "Check tests", "completed": true},
+        {"id": "step2", "name": "Add documentation", "completed": false}
+      ]
+    }
+  ]
+}
+```
+
+**Write commands return action confirmation:**
+```bash
+todo new "Task" --json            # {"action": "created", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo complete "Task" --json       # {"action": "completed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo rm "Task" -y --json          # {"action": "removed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+```
+
+### Task Identification
+
+Tasks can be identified by **name**, **index**, or **ID**. Priority for reliable automation:
+
+| Method | Stability | Use case |
+|--------|-----------|----------|
+| `--id "AAMk..."` | Stable | Scripts, automation, agents |
+| Index (`0`, `1`) | Unstable | Interactive use only |
+| Name (`"Task"`) | Unstable | Interactive use, unique names |
+
+```bash
+# Get task ID from JSON output
+todo tasks --json | jq -r '.tasks[0].id'
+
+# Show IDs inline (human-readable + IDs)
+todo tasks --show-id
+
+# Use ID in commands (requires -l for list context)
+todo complete --id "AAMkADU3..." -l Tasks
+todo update --id "AAMkADU3..." --title "New title"
+todo rm --id "AAMkADU3..." -l Tasks -y
+```
+
+**Example: Create and complete a task by ID**
+```bash
+ID=$(todo new "Deploy v2.0" -l Work --json | jq -r '.id')
+# ... later ...
+todo complete --id "$ID" -l Work
+```
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error (invalid arguments, task not found, API error) |
+
+With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
+
+### Tips for Scripts and Agents
+
+- **Prefer `--id` over names/indexes**: Names can have duplicates (first match wins). Indexes change as tasks are added/completed/reordered.
+- **Always use `-l ListName`** with `--id` to specify list context.
+- **Capture IDs on creation**: Store the ID from `todo new --json` for later operations.
+- **Use `--json` for parsing**: Human-readable output format may change between versions.
+- **Use `-y` flag** with `rm` commands to skip confirmation prompts.
+
+## Aliases
+
+| Alias | Command | Alias | Command |
+|-------|---------|-------|---------|
+| `t` | `tasks` | `d` | `rm` |
+| `n` | `new` | `newl` | `new-list` |
+| `c` | `complete` | `reopen` | `uncomplete` |
+
+```bash
+todo t                  # = todo tasks
+todo n "Task" -d fri    # = todo new "Task" -d fri
+todo c 0 1 2            # = todo complete 0 1 2
+todo d "Old" -y         # = todo rm "Old" -y
+```
+
+## Credits
+
+Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.
+
+## License
+
+MIT

microsoft_todo_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+microsoft_todo_cli-1.0.0.dist-info/licenses/LICENSE,sha256=1xYliB2ZJeYUr4HpX68WiziquLEEHtHs4diJdPCi7ec,1064
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/run_tests.py,sha256=gi0SgUUTBgav9WjSOmGYBH2pVIfxXokk3NXmrPfgxhQ,1651
+tests/test_checklist_cli.py,sha256=-JhpcXokmYdMKQXhn3FeIDg2xKzD7irfnfzSWjeKvpo,4497
+tests/test_checklist_item_model.py,sha256=t3t5eTDw471dU1ruFHGF6vXdYuD_rHJ8ni8inuhQdKM,3752
+tests/test_checklist_wrapper.py,sha256=fs68UBUaVRu7RXnlgdC84qSKpzT8nHz5d5srK__xBck,2080
+tests/test_cli_commands.py,sha256=9qNShLumjdFOQXkEvikRSC5FezRf4EpK19ozSd7EjIw,17595
+tests/test_cli_output.py,sha256=a55uOtFe3GupKczWv_sPvzz9FbEsbNAtFiHiGklSLc0,6234
+tests/test_cli_url_integration.py,sha256=2zHTLa63olTUFisYn_p0Buu6eMlal7p7xyuXiq0rC-A,4546
+tests/test_datetime_parser.py,sha256=eVurIgTf-P0g4wv09i4fJ3lrAqjB0K6i89UNMWi_9aA,9195
+tests/test_filters.py,sha256=-uFVfyhIucQSLSiLhNvaUJNrW5Zuf92Sl0T6WltlJTs,4171
+tests/test_json_output.py,sha256=ZkZW6N3CuLBz0_j1fRk2nMJ_DN5b3QNdnFuUEgN3jQI,7411
+tests/test_lst_output.py,sha256=EksORiPZIfWS8u7lHm99tBNXAHtfavE8XJzgAp-uuwo,4533
+tests/test_models.py,sha256=uMhHJqWBVqiAFb8xL017z0vhyfrG7TH8C4ZUsgVcovI,8095
+tests/test_odata_escape.py,sha256=P6nECMeUn7UEKyZXkRqFjx3_EwoF4Q84b56aJ01lLPg,7976
+tests/test_recurrence.py,sha256=-pVYKrL5RvtsL3YhTJOfB92MTgKwDFz-0_1JImmlCYU,6386
+tests/test_update_command.py,sha256=Hq--wFbfcUtZ7s83Q8tQVZTFokraWxjqqKRFUG5307E,7740
+tests/test_utils.py,sha256=mXgtng8oB8f1NkUb8qITAM8rnJOHiBYa4zm3eYln6Q4,5003
+tests/test_wrapper.py,sha256=wlO3U4_L-LbMWyMPHPd6dMWOliHt_h7ZCoqF7dvSCvc,6546
+todocli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+todocli/cli.py,sha256=k4zLprrIJUjuD4kBrQhNE6Rns8s2lnQiY6d6wvkoRzU,45458
+todocli/graphapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+todocli/graphapi/oauth.py,sha256=AA4X3ZhmCLTEH3ZrbsihemcO7UUfFCzRUxko9tZOIo0,3993
+todocli/graphapi/wrapper.py,sha256=kWiaLrQwDBa6mBG_4qkJKuzzCxI0MGOk9UJurWf83vg,21155
+todocli/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+todocli/models/checklistitem.py,sha256=KO1CZD8YvL7MqByOW4CQIGuDLyUM4DGCObs0ATpHXYo,1968
+todocli/models/todolist.py,sha256=StdyeA0rY-PDIst2-82FvgSgy_IxvzoqpOVUVJO6rmc,914
+todocli/models/todotask.py,sha256=zRK90WUEftaZfAMmA-ODVR5oE2UCQMevHs21PfAmsjQ,3328
+todocli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+todocli/utils/datetime_util.py,sha256=fcx1ZK-59Sn270avEenvFOiTOvSgTJPVGD8qe6LxxIg,10283
+todocli/utils/recurrence_util.py,sha256=a-Vcbr3YNPioOtHEMwQMViKGqq5qxwkzdX3gAdhI_Zw,3233
+todocli/utils/update_checker.py,sha256=X--k4dkSq3bhNvoLdPwDBjdu2atGJjCze7349zbAnDo,2049
+microsoft_todo_cli-1.0.0.dist-info/METADATA,sha256=kTbLk9-qCmXU_DQR1XZDOiHjQYTOGevU38bibpuOlbU,8807
+microsoft_todo_cli-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+microsoft_todo_cli-1.0.0.dist-info/entry_points.txt,sha256=PqRWcETcJ1IRkrRYErjmilmH6y205R8VPX8QmgWWWGg,42
+microsoft_todo_cli-1.0.0.dist-info/top_level.txt,sha256=EIZMq91YloWqg-5RgfD9gxCiO-nGcrkciT9GnLyMDnc,14
+microsoft_todo_cli-1.0.0.dist-info/RECORD,,

microsoft_todo_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microsoft_todo_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+todo = todocli.cli:main

microsoft_todo_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2019 kiblee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

microsoft_todo_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+tests
+todocli

tests/run_tests.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+"""
+Test runner for todocli.
+Runs all unit tests that don't require API credentials.
+"""
+
+import sys
+import unittest
+
+# Discover and run all test files matching pattern
+if __name__ == "__main__":
+    loader = unittest.TestLoader()
+    start_dir = "tests"
+    pattern = "test_*.py"
+
+    # Exclude integration tests that require API credentials
+    suite = unittest.TestSuite()
+
+    # Add each unit test explicitly (excludes test_cli_url_integration.py)
+    suite.addTests(loader.loadTestsFromName("tests.test_datetime_parser"))
+    suite.addTests(loader.loadTestsFromName("tests.test_cli_commands"))
+    suite.addTests(loader.loadTestsFromName("tests.test_models"))
+    suite.addTests(loader.loadTestsFromName("tests.test_wrapper"))
+    suite.addTests(loader.loadTestsFromName("tests.test_checklist_item_model"))
+    suite.addTests(loader.loadTestsFromName("tests.test_checklist_wrapper"))
+    suite.addTests(loader.loadTestsFromName("tests.test_checklist_cli"))
+    suite.addTests(loader.loadTestsFromName("tests.test_odata_escape"))
+    suite.addTests(loader.loadTestsFromName("tests.test_update_command"))
+    suite.addTests(loader.loadTestsFromName("tests.test_lst_output"))
+    suite.addTests(loader.loadTestsFromName("tests.test_cli_output"))
+    suite.addTests(loader.loadTestsFromName("tests.test_json_output"))
+    suite.addTests(loader.loadTestsFromName("tests.test_filters"))
+    suite.addTests(loader.loadTestsFromName("tests.test_recurrence"))
+
+    runner = unittest.TextTestRunner(verbosity=2)
+    result = runner.run(suite)
+
+    # Exit with non-zero status if tests failed
+    sys.exit(not result.wasSuccessful())

tests/test_checklist_cli.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+"""Unit tests for checklist CLI commands (argument parsing)"""
+
+import unittest
+from todocli.cli import setup_parser
+
+
+class TestChecklistCLIArgParsing(unittest.TestCase):
+    """Test that CLI parsers correctly parse checklist command arguments"""
+
+    def setUp(self):
+        self.parser = setup_parser()
+
+    # new-step
+
+    def test_new_step_basic(self):
+        """Test new-step command with list/task format"""
+        args = self.parser.parse_args(
+            ["new-step", "Shopping/Buy groceries", "Buy eggs"]
+        )
+        self.assertEqual(args.task_name, "Shopping/Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+
+    def test_new_step_default_list(self):
+        """Test new-step command without list prefix"""
+        args = self.parser.parse_args(["new-step", "Buy groceries", "Buy eggs"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+
+    def test_new_step_with_list_flag(self):
+        """Test new-step with --list flag"""
+        args = self.parser.parse_args(
+            ["new-step", "Buy groceries", "Buy eggs", "-l", "Shopping"]
+        )
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+        self.assertEqual(args.list, "Shopping")
+
+    # list-steps
+
+    def test_list_steps_basic(self):
+        """Test list-steps command with list/task format"""
+        args = self.parser.parse_args(["list-steps", "Shopping/Buy groceries"])
+        self.assertEqual(args.task_name, "Shopping/Buy groceries")
+
+    def test_list_steps_default_list(self):
+        """Test list-steps without list prefix"""
+        args = self.parser.parse_args(["list-steps", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    def test_list_steps_with_list_flag(self):
+        """Test list-steps with --list flag"""
+        args = self.parser.parse_args(["list-steps", "Buy groceries", "-l", "Shopping"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.list, "Shopping")
+
+    # complete-step
+
+    def test_complete_step_basic(self):
+        """Test complete-step command"""
+        args = self.parser.parse_args(
+            ["complete-step", "Shopping/Buy groceries", "Buy eggs"]
+        )
+        self.assertEqual(args.task_name, "Shopping/Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+
+    def test_complete_step_by_index(self):
+        """Test complete-step with numeric step index"""
+        args = self.parser.parse_args(["complete-step", "Shopping/Buy groceries", "0"])
+        self.assertEqual(args.step_name, "0")
+
+    def test_complete_step_with_list_flag(self):
+        """Test complete-step with --list flag"""
+        args = self.parser.parse_args(
+            ["complete-step", "Buy groceries", "Buy eggs", "-l", "Shopping"]
+        )
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+        self.assertEqual(args.list, "Shopping")
+
+    # rm-step
+
+    def test_rm_step_basic(self):
+        """Test rm-step command"""
+        args = self.parser.parse_args(["rm-step", "Shopping/Buy groceries", "Buy eggs"])
+        self.assertEqual(args.task_name, "Shopping/Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+
+    def test_rm_step_by_index(self):
+        """Test rm-step with numeric step index"""
+        args = self.parser.parse_args(["rm-step", "Shopping/Buy groceries", "2"])
+        self.assertEqual(args.step_name, "2")
+
+    def test_rm_step_with_list_flag(self):
+        """Test rm-step with --list flag"""
+        args = self.parser.parse_args(
+            ["rm-step", "Buy groceries", "Buy eggs", "-l", "Shopping"]
+        )
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.step_name, "Buy eggs")
+        self.assertEqual(args.list, "Shopping")
+
+    # lst --no-steps flag
+
+    def test_lst_no_steps_flag(self):
+        """Test lst command with --no-steps flag"""
+        args = self.parser.parse_args(["lst", "Shopping", "--no-steps"])
+        self.assertEqual(args.list_name, "Shopping")
+        self.assertTrue(args.no_steps)
+
+    def test_lst_default_shows_steps(self):
+        """Test lst command defaults to showing steps (no_steps=False)"""
+        args = self.parser.parse_args(["lst", "Shopping"])
+        self.assertFalse(args.no_steps)
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/test_checklist_item_model.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Unit tests for ChecklistItem model"""
+
+import unittest
+from todocli.models.checklistitem import ChecklistItem
+
+
+class TestChecklistItemModel(unittest.TestCase):
+    """Test ChecklistItem model initialization and properties"""
+
+    def test_basic_item_creation(self):
+        """Test creating a ChecklistItem from API response"""
+        api_response = {
+            "id": "step123",
+            "displayName": "Buy eggs",
+            "isChecked": False,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertEqual(item.id, "step123")
+        self.assertEqual(item.display_name, "Buy eggs")
+        self.assertFalse(item.is_checked)
+        self.assertIsNotNone(item.created_datetime)
+        self.assertIsNone(item.checked_datetime)
+
+    def test_checked_item(self):
+        """Test creating a checked ChecklistItem"""
+        api_response = {
+            "id": "step456",
+            "displayName": "Buy milk",
+            "isChecked": True,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "checkedDateTime": "2024-01-25T11:00:00.0000000Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertTrue(item.is_checked)
+        self.assertIsNotNone(item.checked_datetime)
+
+    def test_unchecked_item_no_checked_datetime(self):
+        """Test that unchecked item has no checked_datetime"""
+        api_response = {
+            "id": "step789",
+            "displayName": "Buy bread",
+            "isChecked": False,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertFalse(item.is_checked)
+        self.assertIsNone(item.checked_datetime)
+
+    def test_checked_datetime_null_value(self):
+        """Test that null checkedDateTime is handled as None"""
+        api_response = {
+            "id": "step101",
+            "displayName": "Clean kitchen",
+            "isChecked": False,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "checkedDateTime": None,
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertFalse(item.is_checked)
+        self.assertIsNone(item.checked_datetime)
+
+    def test_display_name_preserved(self):
+        """Test that display name with special characters is preserved"""
+        api_response = {
+            "id": "step201",
+            "displayName": "Check A/B testing results (urgent!)",
+            "isChecked": False,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertEqual(item.display_name, "Check A/B testing results (urgent!)")
+
+    def test_datetime_without_fractional_seconds(self):
+        """Test parsing datetime without fractional seconds (checklistItems API format)"""
+        api_response = {
+            "id": "step301",
+            "displayName": "Step",
+            "isChecked": True,
+            "createdDateTime": "2026-02-04T19:08:45Z",
+            "checkedDateTime": "2026-02-04T19:10:00Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertIsNotNone(item.created_datetime)
+        self.assertIsNotNone(item.checked_datetime)
+
+    def test_datetime_with_fractional_seconds(self):
+        """Test parsing datetime with fractional seconds (standard Graph API format)"""
+        api_response = {
+            "id": "step401",
+            "displayName": "Step",
+            "isChecked": False,
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+        }
+        item = ChecklistItem(api_response)
+
+        self.assertIsNotNone(item.created_datetime)
+
+
+if __name__ == "__main__":
+    unittest.main()