{"id":15646158,"url":"https://github.com/nicosantangelo/sublime-text-trello","last_synced_at":"2025-04-30T11:56:58.004Z","repository":{"id":13263857,"uuid":"15949110","full_name":"nicosantangelo/sublime-text-trello","owner":"nicosantangelo","description":"Sublime Text 3 package to interact with the Trello API","archived":false,"fork":false,"pushed_at":"2021-11-05T04:44:52.000Z","size":485,"stargazers_count":49,"open_issues_count":4,"forks_count":7,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-30T15:51:16.750Z","etag":null,"topics":["python","sublime","trello-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"google/ExoPlayer","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicosantangelo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-15T21:32:18.000Z","updated_at":"2024-05-25T23:27:34.000Z","dependencies_parsed_at":"2022-09-23T11:31:52.153Z","dependency_job_id":null,"html_url":"https://github.com/nicosantangelo/sublime-text-trello","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicosantangelo%2Fsublime-text-trello","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicosantangelo%2Fsublime-text-trello/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicosantangelo%2Fsublime-text-trello/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicosantangelo%2Fsublime-text-trello/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicosantangelo","download_url":"https://codeload.github.com/nicosantangelo/sublime-text-trello/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251694811,"owners_count":21628912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","sublime","trello-api"],"created_at":"2024-10-03T12:11:38.615Z","updated_at":"2025-04-30T11:56:57.955Z","avatar_url":"https://github.com/nicosantangelo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sublime Trello\n\nThis is a package for [Sublime Text 3](http://www.sublimetext.com/3) that provides a number of useful commands for interacting with Trello (using the [Trello API](https://trello.com/docs/index.html)).\n\n## Usage\n\nThis package allows you to navigate the data Trello provides using the Trello API. It's heavily inspired in the [File Navigator](https://github.com/Chris---/SublimeText-File-Navigator) package.\n\nFor more info on how to customize the plugin check the [settings][4].\n\n\n### Navigate\n\nIf you [run][1] the `Trello: Navigate` command, you'll see your boards, and from there you can go into the Trello element structure `(Board -\u003e List -\u003e Card -\u003e Actions)`.\n\nIn the [default settings][4] you can find `{ \"keep_navigate_open_after_action\": true }`\nIf you want you can set it to false on your [user settings][3] so the panel will close after each action.\n\n### Card creation\n\n#### 'Quick create card' and 'Create card with description'\n\nIt tries to create a Card on the last **active** List. The **active** List refers to the last List viewed using the `Trello: Navigate` command.\n\nIf you didn't use `Navigate` yet the package will display a panel explaining the situation.\n\n### Notifications\n\nRunning `Trello: Notifications` you'll get two options, `Unread` and `Read all`.\n\n#### Unread notifications\n\nWhen you [run][1] `Trello: Unread Notifications`, you'll see the amount of unread notifications the current user has, and a *little* description of what happened, for example:\n\n````\nTotal unread: 1\n\n1) Nofitication type: commentCard\nCard: Some Card\nBoard: Some Board\n````\n\nThis 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!).\n\n#### Read all notifications\n\nThis 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.\n\n\n### Cache\n\nBy 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.\n\nBut if you make changes in the web version or by some chance elements remain cached, changes will not be reflected.\n\nTo avoid this you have two options, [run][1] 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][3], like this:\n\n````json\n{ \"use_cache\": false }\n````\n\nwhich is not really recommended because the package will request everything on *every* request, but it's an option just in case.\n\n## Generating Your Keys\nBy 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.\n\nBasically 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][3], for example:\n\nUrl:\n\n````\nhttps://trello.com/1/connect?key={KEY}\u0026name=sublime_app\u0026response_type=token\u0026scope=read,write\n````\n\nOptions:\n\n````json\n{\n    \"key\"   : \"\",\n    \"secret\": \"\",\n    \"token\" : \"{token_goes_here}\"\n}\n````\n\nIf you don't want to use the default app, you can change it by adding your own key and secret to the [user settings][3] (check the [default settings][4] to see how). You can get them from [here](https://trello.com/1/appKey/generate).\n\nAlso, 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 `\u0026scope=read,write` to `\u0026scope=read` \n\n## All settings\n\n````javascript\n{\n    // Key and secret to identify the app. If not present the default is used\n    \"key\"   : \"\",\n    \"secret\": \"\",\n\n    // Access token to interact with the API (required)\n    \"token\" : \"\",\n\n    // Cache unchanged responses for better performance\n    \"use_cache\": true,\n\n    // After creating elements or performing an action on them the panel reopens (until exit is selected)\n    \"keep_navigate_open_after_action\": true,\n\n    // Use a new tab when showing the results. If it's false it'll use a panel (like the ST console)\n    \"results_in_new_tab\": true,\n\n    // Syntax to use when showing the text from a trello element\n    \"syntax_file\": \"Packages/Markdown/Markdown.tmLanguage\",\n\n    // Set the delemiter used to create more than one card at once in 'Create card with description'.\n    // By default, if you place \"\u003cend\u003e\" after the card description placeholder you can create another card (as many as you want)\n    \"card_delimiter\": \"\u003cend\u003e\"\n}\n````\n\n## Shortcut Keys\n\n**Windows and Linux:**\n\n * Navigate: `ctrl+alt+t`\n * Unread notifications: `ctrl+alt+n`\n\n**OSX**\n\n * Navigate: `super+alt+t`\n * Unread notifications: `super+alt+n`\n\n\n`Delete cache` and `Notifications` don't have a shortcut, but you can set it in `Preferences -\u003e Key Bindings - User` by adding:\n\n````json\n{\n    \"keys\": [\"alt+d\"], \"command\": \"trello_delete_cache\", \n    \"keys\": [\"alt+n\"], \"command\": \"trello_notifications\"\n}\n````\n\n## Settings location\nPreferences -\u003e Package Settings -\u003e Trello -\u003e Settings - User\n\n## Installation\n\n### PackageControl\nIf you have [PackageControl](http://wbond.net/sublime_packages/package_control) installed, you can use that to install the package.\n\nJust type `cmd-shift-p`/`ctrl-shift-p` to bring up the command pallate and pick `Package Control: Install Package` from the dropdown.\n\nThen type `Trello` and choose this package from the dropdown. That's it!\n\n### Manual\n\nYou can clone the repo in your `/Packages` (*Preferences -\u003e Browse Packages...*) folder and start using/hacking it.\n    \n    cd ~/path/to/Packages\n    git clone git://github.com/NicoSantangelo/sublime-text-trello.git Trello\n\n## Known issues\n\n[Curl](http://curl.haxx.se/) is required for Linux users (it should be on:\n`/usr/local/sbin`, `/sbin`,  `/usr/sbin`, `/usr/local/bin`, `/usr/bin`, or `/bin`).\n\n\n## Roadmap\n\n* Checklists\n* Port to ST2?\n* The rest of the [Trello API](https://trello.com/docs/index.html)?\n* ~~Labels~~\n* ~~Don't cache requests~~\n* ~~Go back option~~\n* ~~Card description~~\n* ~~Create Card from List~~\n* ~~Create List from Board~~\n* ~~Create Board~~\n* ~~Print the comment somewhere when it's selected from the list of Card comments~~ (ouput panel)\n\n## Any idea?\n\n* Pull requests are more than welcome, you can run the tests using the [AAAPT Package](https://github.com/guillermooo/AAAPT) or in the terminal (for example: `cd path/to/Trello \u0026\u0026 python3 -m tests.test_output`).\n\n* Another way would be adding an [issue](https://github.com/NicoSantangelo/sublime-text-trello/issues) with your feature request.\n\n## Thanks to\n* The [Trollop](https://bitbucket.org/btubbs/trollop) Python Library\n* The [Sublime Github](https://github.com/bgreenlee/sublime-github) package for the awesome workaround for httplib\n\n## Copyright\n\nCopyright \u0026copy; 2013+ Nicolás Santángelo. \n\nSee LICENSE for details.\n\n  [1]: https://github.com/NicoSantangelo/sublime-text-trello#shortcut-keys\n  [2]: https://github.com/NicoSantangelo/sublime-text-trello#roadmap\n  [3]: https://github.com/NicoSantangelo/sublime-text-trello#settings-location\n  [4]: https://github.com/NicoSantangelo/sublime-text-trello#all-settings\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicosantangelo%2Fsublime-text-trello","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicosantangelo%2Fsublime-text-trello","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicosantangelo%2Fsublime-text-trello/lists"}