ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Trello

Sublime Text 3 package to interact with the Trello API

Details

Installs

  • Total 1K
  • Win 586
  • Mac 542
  • Linux 333
Jan 7 Jan 6 Jan 5 Jan 4 Jan 3 Jan 2 Jan 1 Dec 31 Dec 30 Dec 29 Dec 28 Dec 27 Dec 26 Dec 25 Dec 24 Dec 23 Dec 22 Dec 21 Dec 20 Dec 19 Dec 18 Dec 17 Dec 16 Dec 15 Dec 14 Dec 13 Dec 12 Dec 11 Dec 10 Dec 9 Dec 8 Dec 7 Dec 6 Dec 5 Dec 4 Dec 3 Dec 2 Dec 1 Nov 30 Nov 29 Nov 28 Nov 27 Nov 26 Nov 25 Nov 24
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Mac 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
01234Jan 7Jan 4Jan 1Dec 29Dec 26Dec 23Dec 20Dec 17Dec 14Dec 11Dec 8Dec 5Dec 2Nov 29Nov 26Jan 7 Linux: 1 Mac: 0 Windows: 0Jan 6 Linux: 0 Mac: 0 Windows: 0Jan 5 Linux: 0 Mac: 0 Windows: 0Jan 4 Linux: 0 Mac: 0 Windows: 0Jan 3 Linux: 0 Mac: 0 Windows: 0Jan 2 Linux: 0 Mac: 0 Windows: 0Jan 1 Linux: 0 Mac: 0 Windows: 0Dec 31 Linux: 0 Mac: 0 Windows: 0Dec 30 Linux: 0 Mac: 0 Windows: 0Dec 29 Linux: 0 Mac: 0 Windows: 0Dec 28 Linux: 0 Mac: 0 Windows: 0Dec 27 Linux: 0 Mac: 0 Windows: 0Dec 26 Linux: 0 Mac: 0 Windows: 0Dec 25 Linux: 0 Mac: 0 Windows: 0Dec 24 Linux: 0 Mac: 1 Windows: 0Dec 23 Linux: 0 Mac: 0 Windows: 0Dec 22 Linux: 0 Mac: 0 Windows: 0Dec 21 Linux: 0 Mac: 0 Windows: 0Dec 20 Linux: 0 Mac: 0 Windows: 0Dec 19 Linux: 0 Mac: 0 Windows: 0Dec 18 Linux: 0 Mac: 0 Windows: 0Dec 17 Linux: 0 Mac: 0 Windows: 0Dec 16 Linux: 0 Mac: 0 Windows: 0Dec 15 Linux: 0 Mac: 0 Windows: 0Dec 14 Linux: 0 Mac: 0 Windows: 0Dec 13 Linux: 0 Mac: 0 Windows: 0Dec 12 Linux: 0 Mac: 0 Windows: 0Dec 11 Linux: 0 Mac: 0 Windows: 0Dec 10 Linux: 0 Mac: 0 Windows: 0Dec 9 Linux: 0 Mac: 0 Windows: 0Dec 8 Linux: 0 Mac: 0 Windows: 0Dec 7 Linux: 0 Mac: 0 Windows: 0Dec 6 Linux: 0 Mac: 0 Windows: 0Dec 5 Linux: 0 Mac: 0 Windows: 0Dec 4 Linux: 0 Mac: 0 Windows: 0Dec 3 Linux: 0 Mac: 0 Windows: 0Dec 2 Linux: 0 Mac: 0 Windows: 0Dec 1 Linux: 0 Mac: 0 Windows: 0Nov 30 Linux: 0 Mac: 0 Windows: 0Nov 29 Linux: 0 Mac: 0 Windows: 0Nov 28 Linux: 0 Mac: 0 Windows: 0Nov 27 Linux: 0 Mac: 0 Windows: 0Nov 26 Linux: 0 Mac: 0 Windows: 0Nov 25 Linux: 0 Mac: 0 Windows: 0Nov 24 Linux: 0 Mac: 0 Windows: 0Jan 7 Linux: 1 Mac: 0 Windows: 0Jan 6 Linux: 0 Mac: 0 Windows: 0Jan 5 Linux: 0 Mac: 0 Windows: 0Jan 4 Linux: 0 Mac: 0 Windows: 0Jan 3 Linux: 0 Mac: 0 Windows: 0Jan 2 Linux: 0 Mac: 0 Windows: 0Jan 1 Linux: 0 Mac: 0 Windows: 0Dec 31 Linux: 0 Mac: 0 Windows: 0Dec 30 Linux: 0 Mac: 0 Windows: 0Dec 29 Linux: 0 Mac: 0 Windows: 0Dec 28 Linux: 0 Mac: 0 Windows: 0Dec 27 Linux: 0 Mac: 0 Windows: 0Dec 26 Linux: 0 Mac: 0 Windows: 0Dec 25 Linux: 0 Mac: 0 Windows: 0Dec 24 Linux: 0 Mac: 1 Windows: 0Dec 23 Linux: 0 Mac: 0 Windows: 0Dec 22 Linux: 0 Mac: 0 Windows: 0Dec 21 Linux: 0 Mac: 0 Windows: 0Dec 20 Linux: 0 Mac: 0 Windows: 0Dec 19 Linux: 0 Mac: 0 Windows: 0Dec 18 Linux: 0 Mac: 0 Windows: 0Dec 17 Linux: 0 Mac: 0 Windows: 0Dec 16 Linux: 0 Mac: 0 Windows: 0Dec 15 Linux: 0 Mac: 0 Windows: 0Dec 14 Linux: 0 Mac: 0 Windows: 0Dec 13 Linux: 0 Mac: 0 Windows: 0Dec 12 Linux: 0 Mac: 0 Windows: 0Dec 11 Linux: 0 Mac: 0 Windows: 0Dec 10 Linux: 0 Mac: 0 Windows: 0Dec 9 Linux: 0 Mac: 0 Windows: 0Dec 8 Linux: 0 Mac: 0 Windows: 0Dec 7 Linux: 0 Mac: 0 Windows: 0Dec 6 Linux: 0 Mac: 0 Windows: 0Dec 5 Linux: 0 Mac: 0 Windows: 0Dec 4 Linux: 0 Mac: 0 Windows: 0Dec 3 Linux: 0 Mac: 0 Windows: 0Dec 2 Linux: 0 Mac: 0 Windows: 0Dec 1 Linux: 0 Mac: 0 Windows: 0Nov 30 Linux: 0 Mac: 0 Windows: 0Nov 29 Linux: 0 Mac: 0 Windows: 0Nov 28 Linux: 0 Mac: 0 Windows: 0Nov 27 Linux: 0 Mac: 0 Windows: 0Nov 26 Linux: 0 Mac: 0 Windows: 0Nov 25 Linux: 0 Mac: 0 Windows: 0Nov 24 Linux: 0 Mac: 0 Windows: 0Jan 7 Linux: 1 Mac: 0 Windows: 0Jan 6 Linux: 0 Mac: 0 Windows: 0Jan 5 Linux: 0 Mac: 0 Windows: 0Jan 4 Linux: 0 Mac: 0 Windows: 0Jan 3 Linux: 0 Mac: 0 Windows: 0Jan 2 Linux: 0 Mac: 0 Windows: 0Jan 1 Linux: 0 Mac: 0 Windows: 0Dec 31 Linux: 0 Mac: 0 Windows: 0Dec 30 Linux: 0 Mac: 0 Windows: 0Dec 29 Linux: 0 Mac: 0 Windows: 0Dec 28 Linux: 0 Mac: 0 Windows: 0Dec 27 Linux: 0 Mac: 0 Windows: 0Dec 26 Linux: 0 Mac: 0 Windows: 0Dec 25 Linux: 0 Mac: 0 Windows: 0Dec 24 Linux: 0 Mac: 1 Windows: 0Dec 23 Linux: 0 Mac: 0 Windows: 0Dec 22 Linux: 0 Mac: 0 Windows: 0Dec 21 Linux: 0 Mac: 0 Windows: 0Dec 20 Linux: 0 Mac: 0 Windows: 0Dec 19 Linux: 0 Mac: 0 Windows: 0Dec 18 Linux: 0 Mac: 0 Windows: 0Dec 17 Linux: 0 Mac: 0 Windows: 0Dec 16 Linux: 0 Mac: 0 Windows: 0Dec 15 Linux: 0 Mac: 0 Windows: 0Dec 14 Linux: 0 Mac: 0 Windows: 0Dec 13 Linux: 0 Mac: 0 Windows: 0Dec 12 Linux: 0 Mac: 0 Windows: 0Dec 11 Linux: 0 Mac: 0 Windows: 0Dec 10 Linux: 0 Mac: 0 Windows: 0Dec 9 Linux: 0 Mac: 0 Windows: 0Dec 8 Linux: 0 Mac: 0 Windows: 0Dec 7 Linux: 0 Mac: 0 Windows: 0Dec 6 Linux: 0 Mac: 0 Windows: 0Dec 5 Linux: 0 Mac: 0 Windows: 0Dec 4 Linux: 0 Mac: 0 Windows: 0Dec 3 Linux: 0 Mac: 0 Windows: 0Dec 2 Linux: 0 Mac: 0 Windows: 0Dec 1 Linux: 0 Mac: 0 Windows: 0Nov 30 Linux: 0 Mac: 0 Windows: 0Nov 29 Linux: 0 Mac: 0 Windows: 0Nov 28 Linux: 0 Mac: 0 Windows: 0Nov 27 Linux: 0 Mac: 0 Windows: 0Nov 26 Linux: 0 Mac: 0 Windows: 0Nov 25 Linux: 0 Mac: 0 Windows: 0Nov 24 Linux: 0 Mac: 0 Windows: 0

Readme

Source
raw.​githubusercontent.​com

Sublime Trello

This is a package for Sublime Text 3 that provides a number of useful commands for interacting with Trello (using the Trello API).

Usage

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.

Navigate

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.

Card creation

'Quick create card' and 'Create card with description'

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.

Notifications

Running Trello: Notifications you'll get two options, Unread and Read all.

Unread notifications

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!).

Read all notifications

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.

Cache

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.

Generating Your Keys

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

All settings

{
    // 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>"
}

Shortcut Keys

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"
}

Settings location

Preferences -> Package Settings -> Trello -> Settings - User

Installation

PackageControl

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!

Manual

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

Known issues

Curl is required for Linux users (it should be on: /usr/local/sbin, /sbin, /usr/sbin, /usr/local/bin, /usr/bin, or /bin).

Roadmap

  • Checklists
  • Port to ST2?
  • The rest of the Trello API?
  • Labels
  • Don't cache requests
  • Go back option
  • Card description
  • Create Card from List
  • Create List from Board
  • Create Board
  • Print the comment somewhere when it's selected from the list of Card comments (ouput panel)

Any idea?

  • 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.

Thanks to

Copyright

Copyright © 2013+ Nicolás Santángelo.

See LICENSE for details.