This is a package for Sublime Text 3 that provides a number of useful commands for interacting with Trello (using the Trello API).
This package allows you to navigate the data Trello provides using the Trello API. It's heavily inspired in the File Navigator package.
For more info on how to customize the plugin check the settings.
If you run the Trello: Navigate
command, you'll see your boards, and from there you can go into the Trello element structure (Board -> List -> Card -> Actions)
.
In the default settings you can find { "keep_navigate_open_after_action": true }
If you want you can set it to false on your user settings so the panel will close after each action.
It tries to create a Card on the last active List. The active List refers to the last List viewed using the Trello: Navigate
command.
If you didn't use Navigate
yet the package will display a panel explaining the situation.
Running Trello: Notifications
you'll get two options, Unread
and Read all
.
When you run Trello: Unread Notifications
, you'll see the amount of unread notifications the current user has, and a little description of what happened, for example:
Total unread: 1
1) Nofitication type: commentCard
Card: Some Card
Board: Some Board
This could be improved a lot, but I think it's understandable (with a little bit of brain parsing) and I prefer adding some other stuff before making it prettier (pull requests are welcome!).
This command will attempt to read all your current unread notifications. This may result in an error because more privileges are needed. The package will explain how to fix this (if you so desire) in a panel.
By default most requests will be cached, to improve performance. When you do an action that requires the element to be realoaded, for example creating a new card in a list, the package will try to delete only that cache, maintaining the rest.
But if you make changes in the web version or by some chance elements remain cached, changes will not be reflected.
To avoid this you have two options, run the Trello: Delete cache
command, which will clean the cache and will request everything again or you can switch the use_cache
(which is true by default) option to false
on your user settings, like this:
{ "use_cache": false }
which is not really recommended because the package will request everything on every request, but it's an option just in case.
By default the package uses a Trello app generated only to be used here. If the token
isn't present the package will pop up a message telling you how to get it.
Basically because of the way Trello authentication works, you'll need to copy a url in your browser and pase the result in the token
property of the user settings, for example:
Url:
https://trello.com/1/connect?key={KEY}&name=sublime_app&response_type=token&scope=read,write
Options:
{
"key" : "",
"secret": "",
"token" : "{token_goes_here}"
}
If you don't want to use the default app, you can change it by adding your own key and secret to the user settings (check the default settings to see how). You can get them from here.
Also, if you want to enable only some access to your account, you can modify the scope of the url before pasting it in the browser, for example from &scope=read,write
to &scope=read
{
// Key and secret to identify the app. If not present the default is used
"key" : "",
"secret": "",
// Access token to interact with the API (required)
"token" : "",
// Cache unchanged responses for better performance
"use_cache": true,
// After creating elements or performing an action on them the panel reopens (until exit is selected)
"keep_navigate_open_after_action": true,
// Use a new tab when showing the results. If it's false it'll use a panel (like the ST console)
"results_in_new_tab": true,
// Syntax to use when showing the text from a trello element
"syntax_file": "Packages/Markdown/Markdown.tmLanguage",
// Set the delemiter used to create more than one card at once in 'Create card with description'.
// By default, if you place "<end>" after the card description placeholder you can create another card (as many as you want)
"card_delimiter": "<end>"
}
Windows and Linux:
- Navigate:
ctrl+alt+t
- Unread notifications:
ctrl+alt+n
OSX
- Navigate:
super+alt+t
- Unread notifications:
super+alt+n
Delete cache
and Notifications
don't have a shortcut, but you can set it in Preferences -> Key Bindings - User
by adding:
{
"keys": ["alt+d"], "command": "trello_delete_cache",
"keys": ["alt+n"], "command": "trello_notifications"
}
Preferences -> Package Settings -> Trello -> Settings - User
If you have PackageControl installed, you can use that to install the package.
Just type cmd-shift-p
/ctrl-shift-p
to bring up the command pallate and pick Package Control: Install Package
from the dropdown.
Then type Trello
and choose this package from the dropdown. That's it!
You can clone the repo in your /Packages
(Preferences -> Browse Packages...) folder and start using/hacking it.
cd ~/path/to/Packages
git clone git://github.com/NicoSantangelo/sublime-text-trello.git Trello
Curl is required for Linux users (it should be on:
/usr/local/sbin
, /sbin
, /usr/sbin
, /usr/local/bin
, /usr/bin
, or /bin
).
- Checklists
- Port to ST2?
- The rest of the Trello API?
LabelsDon't cache requestsGo back optionCard descriptionCreate Card from ListCreate List from BoardCreate BoardPrint the comment somewhere when it's selected from the list of Card comments(ouput panel)
-
Pull requests are more than welcome, you can run the tests using the AAAPT Package or in the terminal (for example:
cd path/to/Trello && python3 -m tests.test_output
). -
Another way would be adding an issue with your feature request.
- The Trollop Python Library
- The Sublime Github package for the awesome workaround for httplib
Copyright © 2013+ Nicolás Santángelo.
See LICENSE for details.