plone.recipe.sublimetext is the buildout recipe for ST3 lover who wants python IDE like features while developing python Buildout based project. This tool will help them to create per project basis sublimetext settings with appropriate paths location assignment. Currently plone.recipe.sublimetext comes with supporting settings for Anaconda (the all-in-one package), Jedi, Sublimelinter, Sublimelinter-Flake8, Sublimelinter-Pylint.
A general question may arise that why we will use this tool, whether we can create ST3 project settings easily (we have better knowledge over ST3 configuration)?
Well i completely agree with you, but if you want to get benefited from Anaconda or Jedi's python autocompletion feature (basically I am lover of autocompletion), you have to add all eggs links for Anaconda or Jedi's paths settings and it is hard to manage eggs links manually if the size of project is big (think about any Plone powered project), beside Sublimelinter-Pylint also need list of paths to be added to sys.path to find modules.
Install plone.recipe.sublimetext is simple enough, just need to create a section for sublimetext to your buildout. Before using plone.recipe.sublimetext make sure Jedi, Sublimelinter, Sublimelinter-Flake8 and/or Sublimelinter-Pylint plugins are already installed at your ST3. You could follow full [instruction here] if not your ST3 setup yet. Flake8 linter need flake8 executable available globally (unless you are going to use local flake8), also it is recommended you install some awsome flake8 plugins (flake8-isort, flake8-coding, pep8-naming, flake8-blind-except, flake8-quotes and more could find in pypi)
Example Buildout:
[buildout] parts += sublimetext [sublimetext] recipe = plone.recipe.sublimetext eggs = ${buildout:eggs} jedi-enabled = True sublimelinter-enabled = True sublimelinter-pylint-enabled = True
- eggs
Required: Yes
Default: None
Your project's list of eggs, those are going to be added in path location for Jedi and/or Sublimelinter-Pylint or Anaconda.
- overwrite
Required: No
Default: False
This option indicates whether existing settings should be cleaned first or just updating changes. This situation may happen, you did create settings file manually with other configuration (those are not managed by
plone.recipe.sublimetext) and you want keep those settings intact.- python-executable
Required: No
Default:
plone.recipe.sublimetextwill find current python executable path.The python executable path for current project, if you are using virtual environment then should be that python path. FYI: ${home} and ${project} variable should work.
- project-name
Required: No
Default: if you have a existing ST3 project file(settings file) in project/buildout's root directory,
plone.recipe.sublimetextwill choose it asproject-name, other than project/buildout directory name will become asproject-nameDon't add suffix
.sublime-project, when you provide the project name.- jedi-enabled
Required: No
Default: False
This option is related to enable/disable Sublime Jedi
- jedi-use-omelette
Required: No
Default: False
Use the omelette as basis for jedi autocompletion and go-to-definition. See collective.recipe.omelette
- omelette-location
Required: No
Default: ${buildout:directory}/parts/omelette - the default omelette location.
For use with jedi-use-omelette, but unless the omelette is installed at a custom location, the default should be fine.
- sublimelinter-enabled
Required: No
Default: False
Whether Sublimelinter's features you want to use or not.
- sublimelinter-pylint-enabled
Required: No
Default: False
If you want to use Sublimelinter-Pylint or not;
sublimelinter-enabledoption will be respected, means if parent option is set as disabled but you enable this option will not work.- sublimelinter-pylint-executable
Required: No
Default: ''
You could provide buildout specific pylint executable. It is very flexible way to avoid using global pylint. Example of relative path usecase: i.) ${buildout:directory}/bin/pylint ii.) $project_path/bin/pylint iii.) ./bin/pylint iv.) ~/path/bin/pylint
- sublimelinter-pylint-args
Required: No
Default: ''
@see bellow at
sublimelinter-flake8-argssection for full detail.- sublimelinter-flake8-enabled
Required: No
Default: False
Whether you want to use Sublimelinter-Flake8 or not. Like
sublimelinter-pylint-enabledparent option will be respected.- sublimelinter-flake8-executable
Required: No
Default: ''
Project specific Flake8 executable path, this will give you lots flexibility over using global Flake8 executable, because each project might have separate Python version. You could use buildout or user's relative directory path and it is very convenient for collboration works where all members' absolute path of flake8 excecutable may not be the same! Example of relative path usecase: i.) ${buildout:directory}/bin/flake8 ii.) $project_path/bin/flake8 iii.) ./bin/flake8 iv.) ~/path/bin/flake8
- sublimelinter-flake8-args
Required: No
Default: ''
It is possible to provide arguments (options) for
flake8executable project specific. You have to follow a simple format to provide multiple arguments aka flake8 options thanks to buildout for making our life easy. Format{option name}={option value(optional if the arg boolen type)}max-line-length=90, it is remarkable that--prefix is not required, you can provide multiple arguments separated byspaceand/ornewline- sublimelinter-flake8-args = max-line-length=90 --show-source
- sublimelinter-flake8-args = max-line-length=90 --show-source
- output-file=path_to_file
- anaconda-enabled
Required: No
Default: False
This option is related to whether you want to enable Anaconda the all-in-one python IDE package!
- anaconda-linting-enabled
Required: No
Default: True
If want to other library for liniting (i.e sublimelinter), keep it disabled, other than should be enabled. Like other parent options, it will respect parent (
anaconda-enabled) option.- anaconda-completion-enabled
Required: No
Default: True
Anaconda is using Jedi engine for autocompletion, but if you want to use Sublime-Jedi other than provided by Anaconda, make it disabled.
- anaconda-pylint-enabled
Required: No
Default: False
By default Anaconda liniting doing validation using PyFlakes, PEP8, PEP257. But you can use Pylint instead of PyFlakes by enabling this option.
- anaconda-validate-imports
Required: No
Default: True
It is always good that you want to see any invalid imports (for example:
from fake.foo import bar), but if you don't want this just disabled this option.- anaconda-pep8-ignores
Required: No
Default: ''
If you want ignore some pep8 checklist (i.e N802 is for pep8 naming). Each ignore should be separated by
spaceand/ornewline.- anaconda-pep257-enabled
Required: No
Default: False
Indicates whether you want to active
pep257checklist by anaconda.- anaconda-pep257-ignores
Required: No
Default: ''
If you want ignore some pep8 checklist (i.e N802 is for pep8 naming). Each ignore should be separated by
spaceand/ornewline.- ignore-develop
Required: No
Default: False
If you don't want development eggs, should go for autocompletion.
- ignores
Required: No
Default: ""
If you want specific eggs should not go for autocompletion.
- packages
Required: No
Default: ""
Location of some python scripts or non standard modules (don't have setup file), you want to be in system path.
Code repository:
https://github.com/collective/plone.recipe.sublimetext
Continuous Integration:
https://travis-ci.org/collective/plone.recipe.sublimetext
Issue Tracker:
https://github.com/collective/plone.recipe.sublimetext/issues
Sublimelinter-Flake8 might stop working if flake8-plone-api is installed as until 1.2 version, flake8-plone-api don't support SublimeText (linting), see pull request here . That means upcoming version will support hopefully. It could happen, either you are using global or virtualenv flake8. You can see error in ST3 console:
flake8_plone_api-1.2-py2.7.egg/flake8_plone_api.py", line 16, in run with open(self.filename) as f: IOError: [Errno 2] No such file or directory: 'stdin'