trello-to-deck/README.md

73 lines
2 KiB
Markdown

# Trello to Deck
Migrate your Trello Board to Nextcloud Deck.
## Getting Started
- Install `trello-to-deck`:
e.g.
```bash
cargo install trello-to-deck
```
- Create a starter configuration file
```bash
trello-to-deck init
```
This will create a `trello-to-deck.toml` file in the current directory.
Edit this file to add your Trello and Nextcloud credentials.
### Trello Credentials
To autheniticate to Trello and be able to download the attachements for each card, you need to register a Power Up as a Developer.
This is free and easy, following these instructions;
- Login to <https://trello.com/>
- Visit: <https://trello.com/power-ups/admin>
- Click *New* to create a new Power-Up/Integration
- Complete the *New Power-Up or Integration* form:
- Power-Up or Integrtation Name: *Trello to Deck*
- Workspace: select the workspace you went to export your boards from
- IFrame: (ignore)
- Email: your email
- Support: your email
- Author: your name
- Click *Create*
- API Key: click *Generate a new API key* (twice)
- Copy your *API key* into your `trello-to-deck.toml` file
- To the right of the API Key, click on the *Token* link at the end of the paragraph.
- On the 'Would you like to give the following application access to your account?' page, scroll down and click *Allow*
- Copy the token into you `trello-to-deck.toml` file
### Nextcloud Credentials
TODO
### Verify configuration
Run the `check` command to validate your configuration:
```bash
trello-to-deck check
```
## Development
As part of building the import server, I'm including the following commands the exercise each operation invovled.
- [ ] trello member get (was boards list)
- [ ] trello board get (was list/stack list)
- [ ] trello stack get (was card list)
- [ ] trello card get
- [ ] trello attachment get
- [ ] nextcloud deck get (was board list)
- [ ] nextcloud board get (was stack list)
- [ ] nextcloud stack get (was card list)
- [x] nextcloud card create
- [x] nextcloud card add-label
- [ ] nextcloud card add-attachment