steve/pcli
1
0
Fork 0
Code Issues Pull Requests Actions Projects Releases 4 Wiki Activity

removed test no longer required

Browse Source
This commit is contained in:
Steve Cliff
2026-03-02 12:13:14 +00:00
parent 7452734e38
commit e352fd530f
1 changed files with 0 additions and 95 deletions
Download Patch File Download Diff File Expand all files Collapse all files
test-list-commands.md
-95
View File
@@ -1,95 +0,0 @@
# Testing List Commands
This document demonstrates how to use the new list management commands.
## Prerequisites
1. Set up your Planka API credentials:
```bash
export PLANKA_URL="https://your-planka-instance.com"
export PLANKA_API_KEY="your-api-key"
```
2. Have a project and board available. You can create them with:
```bash
./pcli project create --name "Test Project"
./pcli board create --project <project-id> --name "Test Board"
```
## List Management Commands
### 1. Create a new list (column)
```bash
# Create an "To Do" list
./pcli list create --board <board-id> --name "To Do" --type "active"
# Create a "Done" list with specific position
./pcli list create --board <board-id> --name "Done" --type "closed" --position 131072
```
### 2. Get list details
```bash
./pcli list get <list-id>
```
### 3. Update a list
```bash
# Change the name
./pcli list update <list-id> --name "In Progress"
# Change the color
./pcli list update <list-id> --color "berry-red"
# Move list to a different position
./pcli list update <list-id> --position 98304
# Move list to a different board
./pcli list update <list-id> --board <other-board-id>
```
### 4. Delete a list
```bash
./pcli list delete <list-id>
```
## Output Formats
All commands support both JSON and table output formats:
```bash
# JSON output (default)
./pcli list get <list-id>
# Table output
./pcli list get <list-id> --format table
```
## Example Workflow
```bash
# 1. List existing boards to get the board ID
./pcli board list --format table
# 2. Create multiple lists for a Kanban board
./pcli list create --board <board-id> --name "Backlog" --type "active" --position 0
./pcli list create --board <board-id> --name "To Do" --type "active" --position 65536
./pcli list create --board <board-id> --name "In Progress" --type "active" --position 131072
./pcli list create --board <board-id> --name "Done" --type "closed" --position 196608
# 3. View the board with its lists
./pcli board get <board-id> --format table
# 4. Update a list color
./pcli list update <list-id> --color "lagoon-blue"
# 5. Clean up (optional)
./pcli list delete <list-id>
```
## Notes
- List types can be "active" or "closed"
- Active lists are for ongoing work
- Closed lists are for completed/archived items
- Position determines the order of lists on the board (lower numbers appear first)
- Colors must be one of the supported Planka list colors
- Deleting a list moves its cards to a trash list (doesn't permanently delete cards)