commit 50248aee06b7359e6fc86ba1ed766fe4a082a690 Author: Buddy Sandidge Date: Wed Feb 19 22:01:03 2014 -0800 Squashed 'vim/bundle/editorconfig/' content from commit 3bb9f129c git-subtree-dir: vim/bundle/editorconfig git-subtree-split: 3bb9f129ca364e484654e37ecb7bdcde58100b22 diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..7a47279 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,23 @@ +root = true + +[*] +end_of_line = LF +charset = utf-8 + +[*.vim] +indent_style = space +indent_size = 4 +insert_final_newline = true +trim_trailing_whitespace = true +max_line_length = 80 + +[*.rb] +indent_style = space +indent_size = 2 +insert_final_newline = true +trim_trailing_whitespace = true +max_line_length = 120 + +[*.yml] +indent_style = space +indent_size = 2 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6e92f57 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +tags diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..c09317f --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "tests/spec/plugin_tests"] + path = tests/spec/plugin_tests + url = git://github.com/editorconfig/editorconfig-plugin-tests.git diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..58fab1b --- /dev/null +++ b/.travis.yml @@ -0,0 +1,20 @@ +language: ruby + +rvm: + - 1.9.3 + +gemfile: tests/Gemfile + +before_install: sudo apt-get install vim-gtk + +before_script: + - "export DISPLAY=:99.0" + - "sh -e /etc/init.d/xvfb start" + +script: + bundle exec rspec tests/spec/editorconfig_spec.rb + +notifications: + email: + on_success: change + on_failure: always diff --git a/CONTRIBUTORS b/CONTRIBUTORS new file mode 100644 index 0000000..cfd1c9d --- /dev/null +++ b/CONTRIBUTORS @@ -0,0 +1,5 @@ +Contributors to the EditorConfig Vim Plugin: + +Hong Xu +Trey Hunner +Kent Frazier diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..8a201f7 --- /dev/null +++ b/LICENSE @@ -0,0 +1,26 @@ +Unless otherwise stated, all files are distributed under the Simplified BSD +license included below. + +Copyright (c) 2011-2012 EditorConfig Team +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..00b9c03 --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +# EditorConfig Vim Plugin + +[![Build Status](https://travis-ci.org/editorconfig/editorconfig-vim.png?branch=master)](https://travis-ci.org/editorconfig/editorconfig-vim) + +This is an [EditorConfig][] plugin for Vim. This plugin could be found on both +[GitHub][] and [Vim online][]. + +## Installation + +There are two ways for installation: + +- If your Vim is compiled with `+python` feature (this is usually true on most + Linux distributions), the most simple way to install this plugin is to + download the archive and extract it into your Vim runtime directory (`~/.vim` + on UNIX/Linux and `$VIM_INSTALLATION_FOLDER\vimfiles` on windows). + +- If your Vim is not compiled with `+python` feature, please first download the + [EditorConfig core][] and follow the instructions in the README and INSTALL + files to install it. This plugin would NOT work if neither `+python` nor + EditorConfig core is available. + + +## Supported properties + +The EditorConfig Vim plugin supports the following EditorConfig [properties][]: + +* indent_style +* indent_size +* tab_width +* end_of_line +* charset +* trim_trailing_whitespace +* max_line_width +* root (only used by EditorConfig core) + +## Bugs and Feature Requests + +Feel free to submit bugs, feature requests, and other issues to the main +[EditorConfig issue tracker][]. + +[EditorConfig]: http://editorconfig.org +[EditorConfig core]: https://github.com/editorconfig/editorconfig-core +[GitHub]: https://github.com/editorconfig/editorconfig-vim +[properties]: http://github.com/editorconfig/editorconfig/wiki/EditorConfig-Properties +[Vim online]: http://www.vim.org/scripts/script.php?script_id=3934 +[EditorConfig issue tracker]: https://github.com/editorconfig/editorconfig/issues diff --git a/autoload/editorconfig.vim b/autoload/editorconfig.vim new file mode 100644 index 0000000..44463c6 --- /dev/null +++ b/autoload/editorconfig.vim @@ -0,0 +1,59 @@ +" Copyright (c) 2011-2012 EditorConfig Team +" All rights reserved. +" +" Redistribution and use in source and binary forms, with or without +" modification, are permitted provided that the following conditions are met: +" +" 1. Redistributions of source code must retain the above copyright notice, +" this list of conditions and the following disclaimer. +" 2. Redistributions in binary form must reproduce the above copyright notice, +" this list of conditions and the following disclaimer in the documentation +" and/or other materials provided with the distribution. +" +" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +" ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE +" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +" POSSIBILITY OF SUCH DAMAGE. +" + +if v:version < 700 + finish +endif + +let s:saved_cpo = &cpo +set cpo&vim + +" {{{1 variables +let s:hook_list = [] + +function editorconfig#AddNewHook(func) " {{{1 + " Add a new hook + + call add(s:hook_list, a:func) +endfunction + +function editorconfig#ApplyHooks(config) " {{{1 + " apply hooks + + for Hook in s:hook_list + let l:hook_ret = Hook(a:config) + + if type(l:hook_ret) != type(0) && l:hook_ret != 0 + " TODO print some debug info here + endif + endfor +endfunction + +" }}} + +let &cpo = s:saved_cpo +unlet! s:saved_cpo + +" vim: fdm=marker fdc=3 diff --git a/doc/editorconfig.txt b/doc/editorconfig.txt new file mode 100644 index 0000000..8cd45f4 --- /dev/null +++ b/doc/editorconfig.txt @@ -0,0 +1,173 @@ +*editorconfig.txt* + +File: editorconfig.txt +Version: 0.3.2 +Maintainer: EditorConfig Team +Description: EditorConfig vim plugin + +License: + Copyright (c) 2011-2013 EditorConfig Team + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + + +CONTENTS~ + *editorconfig-contents* +---------------------------------------------------------------------------- +1. Overview |editorconfig-overview| +2. Installation |editorconfig-installation| +3. Commands |editorconfig-commands| +4. Settings |editorconfig-settings| +5. Advanced |editorconfig-advanced| + + +OVERVIEW~ + *editorconfig-overview* +---------------------------------------------------------------------------- +This is the EditorConfig plugin for vim. + + +INSTALLATION~ + *editorconfig-installation* +---------------------------------------------------------------------------- +Download the [EditorConfig core][] and follow the instructions in the README +and INSTALL files to install it. + +Once EditorConfig core is installed, copy the `plugin/editorconfig.vim` file +to your `~/.vim/plugin` directory and `doc/editorconfig.txt` to your +`~/.vim/doc` directory to install the EditorConfig plugin. + +COMMANDS~ + *editorconfig-commands* +---------------------------------------------------------------------------- + + *:EditorConfigReload* +Command: + :EditorConfigReload + +Reload the EditorConfig conf files. When `.editorconfig` files are modified, +this command could prevent you to reload the current edited file to load the +new configuration. + +SETTINGS~ + *editorconfig-settings* +---------------------------------------------------------------------------- + *g:EditorConfig_core_mode* +Specify the mode of EditorConfig core. Generally it is OK to leave this option +empty. There are 3 modes currently: "external_command", "python_builtin", +"python_external". + + python_builtin: Use the vim built-in python to run the python version + EditorConfig Core. + python_external: Use an external python interpreter to run the python + version EditorConfig Core. + external_command: Run external EditorConfig Core. + +If "g:EditorConfig_core_mode" is not specified, this plugin will automatically +choose a mode that could work for you. The checking sequence is: +python_builtin, external_command, python_external. + + *g:EditorConfig_exec_path* +The file path to the EditorConfig core executable. You could set this value in +your |vimrc| like this: +> + let g:EditorConfig_exec_path = 'Path to your EditorConfig Core executable' +< +The default value is empty. + +This plugin will search through the following executables in order: + +On UNIX: + the value of g:EditorConfig_exec_path + editorconfig + /usr/local/bin/editorconfig + /usr/bin/editorconfig + /opt/bin/editorconfig + /opt/editorconfig/bin/editorconfig + editorconfig.py + /usr/local/bin/editorconfig.py + /usr/bin/editorconfig.py + /opt/bin/editorconfig.py + /opt/editorconfig/bin/editorconfig.py + +On Windows: + the value of g:EditorConfig_exec_path + editorconfig + C:\editorconfig\bin\editorconfig + D:\editorconfig\bin\editorconfig + E:\editorconfig\bin\editorconfig + F:\editorconfig\bin\editorconfig + C:\Program Files\editorconfig\bin\editorconfig + D:\Program Files\editorconfig\bin\editorconfig + E:\Program Files\editorconfig\bin\editorconfig + F:\Program Files\editorconfig\bin\editorconfig + editorconfig.py + + *g:EditorConfig_python_files_dir* +If the EditorConfig core mode is python_builtin or python_external (see +|g:EditorConfig_core_mode|), this variable is the directory where the plugin +looks for the python scripts. This could either be an abosolute path, or a +path relative to any of the directories in 'runtimepath'. The default value is +"plugin/editorconfig-core-py", which means all "plugin/editorconfig-core-py" +directory in 'runtimepath' will be searched. + + *g:EditorConfig_verbose* +Set this to 1 if you want debug info printed: +> + let g:EditorConfig_verbose = 1 +< + +ADVANCED~ + *editorconfig-advanced* +---------------------------------------------------------------------------- + *editorconfig-hook* + *EditorConfig#AddNewHook()* +While this plugin offers several builtin supported properties (as mentioned +here: https://github.com/editorconfig/editorconfig-vim#supported-properties), +we are also able to add our own hooks to support additional EditorConfig +properties, including those not in the EditorConfig standard. For example, we +are working on an Objective-C project, and all our "*.m" files should be +Objective-C source files. However, vim sometimes detect "*.m" files as MATLAB +source files, which causes incorrect syntax highlighting, code indentation, +etc. To solve the case, we could write the following code into the |vimrc| +file: +> + function! FiletypeHook(config) + if has_key(a:config, 'vim_filetype') + let &filetype = a:config['vim_filetype'] + endif + + return 0 " Return 0 to show no error happened + endfunction + + call editorconfig#AddNewHook(function('FiletypeHook')) +< +And add the following code to your .editorconfig file: +> + [*.m] + vim_filetype = objc +< +Then try to open an Objective-C file, you will find the |filetype| is set to +"objc". + +vim:ft=help:tw=78 diff --git a/mkzip.sh b/mkzip.sh new file mode 100755 index 0000000..5c02cca --- /dev/null +++ b/mkzip.sh @@ -0,0 +1,3 @@ +#!/bin/sh + +zip -r editorconfig-vim-$*.zip plugin/editorconfig.vim plugin/editorconfig-core-py/* doc/editorconfig.txt autoload/*.vim diff --git a/plugin/editorconfig-core-py/.editorconfig b/plugin/editorconfig-core-py/.editorconfig new file mode 100644 index 0000000..794bb51 --- /dev/null +++ b/plugin/editorconfig-core-py/.editorconfig @@ -0,0 +1,12 @@ +root = true + +[*.{py,rst,txt}] +indent_style = space +trim_trailing_whitespace = true +indent_size = 4 +end_of_line = LF + +[*.yml] +indent_style = space +indent_size = 2 +end_of_line = LF diff --git a/plugin/editorconfig-core-py/.gitignore b/plugin/editorconfig-core-py/.gitignore new file mode 100644 index 0000000..3b75fd6 --- /dev/null +++ b/plugin/editorconfig-core-py/.gitignore @@ -0,0 +1,11 @@ +*.py[co] +*\$py.class +*.egg-info +dist +build +/Testing +/Makefile +/tests/Makefile +*.cmake +CMakeFiles +CMakeCache.txt diff --git a/plugin/editorconfig-core-py/.travis.yml b/plugin/editorconfig-core-py/.travis.yml new file mode 100644 index 0000000..263824d --- /dev/null +++ b/plugin/editorconfig-core-py/.travis.yml @@ -0,0 +1,51 @@ +language: python + +# We support from Python 2.4 to 2.7. However, 2.4 is not supported by travis, +# so it is not listed here +python: + - "2.5" + - "2.6" + - "2.7" + - "3.2" + - "3.3" + +# For testing with JYTHON=true, we will use Jython 2.2 instead of the python +# version provided by Travis CI +env: + - JYTHON=true + - JYTHON=false + +matrix: + exclude: + - python: "2.5" + env: JYTHON=true + - python: "2.6" + env: JYTHON=true + - python: "3.2" + env: JYTHON=true + - python: "3.3" + env: JYTHON=true + +# we need cmake, and jython if JYTHON=true +install: + - sudo apt-get install cmake ant + - export JYTHON_URL='http://downloads.sourceforge.net/project/jython/jython/2.2.1/jython_installer-2.2.1.jar?r=http%3A%2F%2Fsourceforge.net%2Fprojects%2Fjython%2Ffiles%2Fjython%2F2.2.1%2F&ts=1338180153&use_mirror=iweb' + - if [ "$JYTHON" == "true" ]; then wget $JYTHON_URL -O jython_installer.jar; java -jar jython_installer.jar -s -d $HOME/jython; export PATH=$HOME/jython:$PATH;jython --version; fi + +# Before run the test case, we need to make jython run some code +before_script: + - if [ "$JYTHON" == "true" ]; then jython -c "print ''"; fi + +# test script +script: + - if [ "$JYTHON" == "true" ]; then cmake -DPYTHON_EXECUTABLE="$(which jython)" . ; else cmake . ; fi + - ctest -V --output-on-failure . + - cd java-binding + - ant -v + - ant -v doc + +# Notify the mailing list +notifications: + email: + on_success: change + on_failure: always diff --git a/plugin/editorconfig-core-py/CMakeLists.txt b/plugin/editorconfig-core-py/CMakeLists.txt new file mode 100644 index 0000000..890662a --- /dev/null +++ b/plugin/editorconfig-core-py/CMakeLists.txt @@ -0,0 +1,21 @@ +# This file is used for testing only + +# To perform the test, run `cmake .` at the root of the project tree followed +# by ctest . + +cmake_minimum_required(VERSION 2.6) + +# Do not check any compiler +project(editorconfig-core-py NONE) + +find_package(PythonInterp) + +if(NOT PYTHONINTERP_FOUND) + message(FETAL_ERROR + "Python interpreter is not found. If you have python installed, please run: + cmake -DPYTHON_EXECUTABLE=/path/to/python .") +endif() + +enable_testing() +set(EDITORCONFIG_CMD ${PYTHON_EXECUTABLE} ${PROJECT_SOURCE_DIR}/main.py) +add_subdirectory(tests) diff --git a/plugin/editorconfig-core-py/LICENSE.txt b/plugin/editorconfig-core-py/LICENSE.txt new file mode 100644 index 0000000..e1f2cbd --- /dev/null +++ b/plugin/editorconfig-core-py/LICENSE.txt @@ -0,0 +1,192 @@ +PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 +-------------------------------------------- + +1. This LICENSE AGREEMENT is between the Python Software Foundation +("PSF"), and the Individual or Organization ("Licensee") accessing and +otherwise using this software ("Python") in source or binary form and +its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, PSF hereby +grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, +analyze, test, perform and/or display publicly, prepare derivative works, +distribute, and otherwise use Python alone or in any derivative version, +provided, however, that PSF's License Agreement and PSF's notice of copyright, +i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 +Python Software Foundation; All Rights Reserved" are retained in Python alone or +in any derivative version prepared by Licensee. + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python. + +4. PSF is making Python available to Licensee on an "AS IS" +basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. Nothing in this License Agreement shall be deemed to create any +relationship of agency, partnership, or joint venture between PSF and +Licensee. This License Agreement does not grant permission to use PSF +trademarks or trade name in a trademark sense to endorse or promote +products or services of Licensee, or any third party. + +8. By copying, installing or otherwise using Python, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 +------------------------------------------- + +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 + +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an +office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the +Individual or Organization ("Licensee") accessing and otherwise using +this software in source or binary form and its associated +documentation ("the Software"). + +2. Subject to the terms and conditions of this BeOpen Python License +Agreement, BeOpen hereby grants Licensee a non-exclusive, +royalty-free, world-wide license to reproduce, analyze, test, perform +and/or display publicly, prepare derivative works, distribute, and +otherwise use the Software alone or in any derivative version, +provided, however, that the BeOpen Python License is retained in the +Software, alone or in any derivative version prepared by Licensee. + +3. BeOpen is making the Software available to Licensee on an "AS IS" +basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE +SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS +AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY +DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +5. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +6. This License Agreement shall be governed by and interpreted in all +respects by the law of the State of California, excluding conflict of +law provisions. Nothing in this License Agreement shall be deemed to +create any relationship of agency, partnership, or joint venture +between BeOpen and Licensee. This License Agreement does not grant +permission to use BeOpen trademarks or trade names in a trademark +sense to endorse or promote products or services of Licensee, or any +third party. As an exception, the "BeOpen Python" logos available at +http://www.pythonlabs.com/logos.html may be used according to the +permissions granted on that web page. + +7. By copying, installing or otherwise using the software, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 +--------------------------------------- + +1. This LICENSE AGREEMENT is between the Corporation for National +Research Initiatives, having an office at 1895 Preston White Drive, +Reston, VA 20191 ("CNRI"), and the Individual or Organization +("Licensee") accessing and otherwise using Python 1.6.1 software in +source or binary form and its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, CNRI +hereby grants Licensee a nonexclusive, royalty-free, world-wide +license to reproduce, analyze, test, perform and/or display publicly, +prepare derivative works, distribute, and otherwise use Python 1.6.1 +alone or in any derivative version, provided, however, that CNRI's +License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) +1995-2001 Corporation for National Research Initiatives; All Rights +Reserved" are retained in Python 1.6.1 alone or in any derivative +version prepared by Licensee. Alternately, in lieu of CNRI's License +Agreement, Licensee may substitute the following text (omitting the +quotes): "Python 1.6.1 is made available subject to the terms and +conditions in CNRI's License Agreement. This Agreement together with +Python 1.6.1 may be located on the Internet using the following +unique, persistent identifier (known as a handle): 1895.22/1013. This +Agreement may also be obtained from a proxy server on the Internet +using the following URL: http://hdl.handle.net/1895.22/1013". + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python 1.6.1 or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python 1.6.1. + +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" +basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. This License Agreement shall be governed by the federal +intellectual property law of the United States, including without +limitation the federal copyright law, and, to the extent such +U.S. federal law does not apply, by the law of the Commonwealth of +Virginia, excluding Virginia's conflict of law provisions. +Notwithstanding the foregoing, with regard to derivative works based +on Python 1.6.1 that incorporate non-separable material that was +previously distributed under the GNU General Public License (GPL), the +law of the Commonwealth of Virginia shall govern this License +Agreement only as to issues arising under or with respect to +Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this +License Agreement shall be deemed to create any relationship of +agency, partnership, or joint venture between CNRI and Licensee. This +License Agreement does not grant permission to use CNRI trademarks or +trade name in a trademark sense to endorse or promote products or +services of Licensee, or any third party. + +8. By clicking on the "ACCEPT" button where indicated, or by copying, +installing or otherwise using Python 1.6.1, Licensee agrees to be +bound by the terms and conditions of this License Agreement. + + ACCEPT + + +CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 +-------------------------------------------------- + +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, +The Netherlands. All rights reserved. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the name of Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior +permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. diff --git a/plugin/editorconfig-core-py/MANIFEST.in b/plugin/editorconfig-core-py/MANIFEST.in new file mode 100644 index 0000000..88629c9 --- /dev/null +++ b/plugin/editorconfig-core-py/MANIFEST.in @@ -0,0 +1 @@ +include README.rst LICENSE.txt diff --git a/plugin/editorconfig-core-py/README.rst b/plugin/editorconfig-core-py/README.rst new file mode 100644 index 0000000..f3cccf5 --- /dev/null +++ b/plugin/editorconfig-core-py/README.rst @@ -0,0 +1,82 @@ +======================== +EditorConfig Python Core +======================== + +.. image:: https://secure.travis-ci.org/editorconfig/editorconfig-core-py.png?branch=master + :target: http://travis-ci.org/editorconfig/editorconfig-core-py + +EditorConfig Python Core provides the same functionality as the +`EditorConfig C Core `_. +EditorConfig Python core can be used as a command line program or as an +importable library. + +EditorConfig Project +==================== + +EditorConfig makes it easy to maintain the correct coding style when switching +between different text editors and between different projects. The +EditorConfig project maintains a file format and plugins for various text +editors which allow this file format to be read and used by those editors. For +information on the file format and supported text editors, see the +`EditorConfig website `_. + +Installation +============ + +With setuptools:: + + sudo python setup.py install + +Getting Help +============ +For help with the EditorConfig core code, please write to our `mailing list +`_. Bugs and feature requests +should be submitted to our `issue tracker +`_. + +If you are writing a plugin a language that can import Python libraries, you +may want to import and use the EditorConfig Python Core directly. + +Using as a Library +================== + +Basic example use of EditorConfig Python Core as a library: + +.. code-block:: python + + from editorconfig import get_properties, EditorConfigError + + filename = "/home/zoidberg/humans/anatomy.md" + + try: + options = get_properties(filename) + except EditorConfigError: + print "Error occurred while getting EditorConfig properties" + else: + for key, value in options.items(): + print "%s=%s" % (key, value) + +For details, please take a look at the `online documentation +`_. + +Running Test Cases +================== + +`Cmake `_ has to be installed first. Run the test cases +using the following commands:: + + cmake . + ctest . + +Use ``-DPYTHON_EXECUTABLE`` to run the tests using an alternative versions of +Python (Python 3, Jython, etc.):: + + cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 . + ctest . + +License +======= + +Unless otherwise stated, all files are distributed under the PSF license. The +odict library (editorconfig/odict.py) is distributed under the New BSD license. +See LICENSE.txt file for details on PSF license. diff --git a/plugin/editorconfig-core-py/docs/Makefile b/plugin/editorconfig-core-py/docs/Makefile new file mode 100644 index 0000000..752e467 --- /dev/null +++ b/plugin/editorconfig-core-py/docs/Makefile @@ -0,0 +1,130 @@ +# Makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +PAPER = +BUILDDIR = _build + +# Internal variables. +PAPEROPT_a4 = -D latex_paper_size=a4 +PAPEROPT_letter = -D latex_paper_size=letter +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . + +.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest + +help: + @echo "Please use \`make ' where is one of" + @echo " html to make standalone HTML files" + @echo " dirhtml to make HTML files named index.html in directories" + @echo " singlehtml to make a single large HTML file" + @echo " pickle to make pickle files" + @echo " json to make JSON files" + @echo " htmlhelp to make HTML files and a HTML help project" + @echo " qthelp to make HTML files and a qthelp project" + @echo " devhelp to make HTML files and a Devhelp project" + @echo " epub to make an epub" + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" + @echo " latexpdf to make LaTeX files and run them through pdflatex" + @echo " text to make text files" + @echo " man to make manual pages" + @echo " changes to make an overview of all changed/added/deprecated items" + @echo " linkcheck to check all external links for integrity" + @echo " doctest to run all doctests embedded in the documentation (if enabled)" + +clean: + -rm -rf $(BUILDDIR)/* + +html: + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." + +dirhtml: + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." + +singlehtml: + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml + @echo + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." + +pickle: + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle + @echo + @echo "Build finished; now you can process the pickle files." + +json: + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json + @echo + @echo "Build finished; now you can process the JSON files." + +htmlhelp: + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp + @echo + @echo "Build finished; now you can run HTML Help Workshop with the" \ + ".hhp project file in $(BUILDDIR)/htmlhelp." + +qthelp: + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp + @echo + @echo "Build finished; now you can run "qcollectiongenerator" with the" \ + ".qhcp project file in $(BUILDDIR)/qthelp, like this:" + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/EditorConfigPythonCore.qhcp" + @echo "To view the help file:" + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/EditorConfigPythonCore.qhc" + +devhelp: + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp + @echo + @echo "Build finished." + @echo "To view the help file:" + @echo "# mkdir -p $$HOME/.local/share/devhelp/EditorConfigPythonCore" + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/EditorConfigPythonCore" + @echo "# devhelp" + +epub: + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub + @echo + @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + +latex: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." + @echo "Run \`make' in that directory to run these through (pdf)latex" \ + "(use \`make latexpdf' here to do that automatically)." + +latexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through pdflatex..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +text: + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text + @echo + @echo "Build finished. The text files are in $(BUILDDIR)/text." + +man: + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man + @echo + @echo "Build finished. The manual pages are in $(BUILDDIR)/man." + +changes: + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes + @echo + @echo "The overview file is in $(BUILDDIR)/changes." + +linkcheck: + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck + @echo + @echo "Link check complete; look for any errors in the above output " \ + "or in $(BUILDDIR)/linkcheck/output.txt." + +doctest: + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest + @echo "Testing of doctests in the sources finished, look at the " \ + "results in $(BUILDDIR)/doctest/output.txt." diff --git a/plugin/editorconfig-core-py/docs/command_line_usage.rst b/plugin/editorconfig-core-py/docs/command_line_usage.rst new file mode 100644 index 0000000..7b5b496 --- /dev/null +++ b/plugin/editorconfig-core-py/docs/command_line_usage.rst @@ -0,0 +1,18 @@ +================== +Command Line Usage +================== + +The EditorConfig Python Core can be used from the command line in the same way +as the EditorConfig C Core. + +Discovering EditorConfig properties +----------------------------------- + +Installing EditorConfig Python Core should add an ``editorconfig.py`` command +to your path. This command can be used to locate and parse EditorConfig files +for a given full filepath. For example:: + + editorconfig.py /home/zoidberg/humans/anatomy.md + +When used to retrieve EditorConfig file properties, ``editorconfig.py`` will +return discovered properties in *key=value* pairs, one on each line. diff --git a/plugin/editorconfig-core-py/docs/conf.py b/plugin/editorconfig-core-py/docs/conf.py new file mode 100644 index 0000000..bd060da --- /dev/null +++ b/plugin/editorconfig-core-py/docs/conf.py @@ -0,0 +1,219 @@ +# -*- coding: utf-8 -*- +# +# EditorConfig Python Core documentation build configuration file, created by +# sphinx-quickstart on Sat May 5 09:51:42 2012. +# +# This file is execfile()d with the current directory set to its containing dir. +# +# Note that not all possible configuration values are present in this +# autogenerated file. +# +# All configuration values have a default; values that are commented out +# serve to show the default. + +import sys, os + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +sys.path.insert(0, os.path.abspath('..')) + +import editorconfig +from editorconfig import __version__ + +# -- General configuration ----------------------------------------------------- + +# If your documentation needs a minimal Sphinx version, state it here. +#needs_sphinx = '1.0' + +# Add any Sphinx extension module names here, as strings. They can be extensions +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. +extensions = ['sphinx.ext.autodoc'] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# The suffix of source filenames. +source_suffix = '.rst' + +# The encoding of source files. +#source_encoding = 'utf-8-sig' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = u'EditorConfig Python Core' +copyright = u'2012, EditorConfig Team' + +# The version info for the project you're documenting, acts as replacement for +# |version| and |release|, also used in various other places throughout the +# built documents. +# +# The short X.Y version. +version = __version__ +# The full version, including alpha/beta/rc tags. +release = __version__ + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +#language = None + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +#today = '' +# Else, today_fmt is used as the format for a strftime call. +#today_fmt = '%B %d, %Y' + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +exclude_patterns = ['_build'] + +# The reST default role (used for this markup: `text`) to use for all documents. +#default_role = None + +# If true, '()' will be appended to :func: etc. cross-reference text. +#add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +#add_module_names = True + +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +#show_authors = False + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'sphinx' + +# A list of ignored prefixes for module index sorting. +#modindex_common_prefix = [] + + +# -- Options for HTML output --------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +html_theme = 'agogo' + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +#html_theme_options = {} + +# Add any paths that contain custom themes here, relative to this directory. +#html_theme_path = [] + +# The name for this set of Sphinx documents. If None, it defaults to +# " v documentation". +#html_title = None + +# A shorter title for the navigation bar. Default is the same as html_title. +#html_short_title = None + +# The name of an image file (relative to this directory) to place at the top +# of the sidebar. +#html_logo = None + +# The name of an image file (within the static path) to use as favicon of the +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 +# pixels large. +#html_favicon = None + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, +# using the given strftime format. +#html_last_updated_fmt = '%b %d, %Y' + +# If true, SmartyPants will be used to convert quotes and dashes to +# typographically correct entities. +#html_use_smartypants = True + +# Custom sidebar templates, maps document names to template names. +#html_sidebars = {} + +# Additional templates that should be rendered to pages, maps page names to +# template names. +#html_additional_pages = {} + +# If false, no module index is generated. +#html_domain_indices = True + +# If false, no index is generated. +#html_use_index = True + +# If true, the index is split into individual pages for each letter. +#html_split_index = False + +# If true, links to the reST sources are added to the pages. +#html_show_sourcelink = True + +# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. +#html_show_sphinx = True + +# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. +#html_show_copyright = True + +# If true, an OpenSearch description file will be output, and all pages will +# contain a tag referring to it. The value of this option must be the +# base URL from which the finished HTML is served. +#html_use_opensearch = '' + +# This is the file name suffix for HTML files (e.g. ".xhtml"). +#html_file_suffix = None + +# Output file base name for HTML help builder. +htmlhelp_basename = 'EditorConfigPythonCoredoc' + + +# -- Options for LaTeX output -------------------------------------------------- + +# The paper size ('letter' or 'a4'). +#latex_paper_size = 'letter' + +# The font size ('10pt', '11pt' or '12pt'). +#latex_font_size = '10pt' + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, author, documentclass [howto/manual]). +latex_documents = [ + ('index', 'EditorConfigPythonCore.tex', u'EditorConfig Python Core Documentation', + u'EditorConfig Team', 'manual'), +] + +# The name of an image file (relative to this directory) to place at the top of +# the title page. +#latex_logo = None + +# For "manual" documents, if this is true, then toplevel headings are parts, +# not chapters. +#latex_use_parts = False + +# If true, show page references after internal links. +#latex_show_pagerefs = False + +# If true, show URL addresses after external links. +#latex_show_urls = False + +# Additional stuff for the LaTeX preamble. +#latex_preamble = '' + +# Documents to append as an appendix to all manuals. +#latex_appendices = [] + +# If false, no module index is generated. +#latex_domain_indices = True + + +# -- Options for manual page output -------------------------------------------- + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + ('index', 'editorconfigpythoncore', u'EditorConfig Python Core Documentation', + [u'EditorConfig Team'], 1) +] diff --git a/plugin/editorconfig-core-py/docs/index.rst b/plugin/editorconfig-core-py/docs/index.rst new file mode 100644 index 0000000..637fe36 --- /dev/null +++ b/plugin/editorconfig-core-py/docs/index.rst @@ -0,0 +1,23 @@ +================================================================== +EditorConfig Python Core -- Process EditorConfig Files With Python +================================================================== + +EditorConfig is a file format for defining file-specific coding styles and a +set of plugins that allow text editors and IDEs to read this file format. For +more information on the EditorConfig project visit the +`EditorConfig Homepage`_. + +The EditorConfig Python Core is a Python package for locating and parsing +EditorConfig files. This package can be used as an import by other Python code +or as a stand-alone command line program. + +.. _`EditorConfig Homepage`: http://editorconfig.org + +Contents: + +.. toctree:: + :maxdepth: 1 + + usage + command_line_usage + plugins diff --git a/plugin/editorconfig-core-py/docs/make.bat b/plugin/editorconfig-core-py/docs/make.bat new file mode 100644 index 0000000..e674afb --- /dev/null +++ b/plugin/editorconfig-core-py/docs/make.bat @@ -0,0 +1,170 @@ +@ECHO OFF + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set BUILDDIR=_build +set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% . +if NOT "%PAPER%" == "" ( + set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% +) + +if "%1" == "" goto help + +if "%1" == "help" ( + :help + echo.Please use `make ^` where ^ is one of + echo. html to make standalone HTML files + echo. dirhtml to make HTML files named index.html in directories + echo. singlehtml to make a single large HTML file + echo. pickle to make pickle files + echo. json to make JSON files + echo. htmlhelp to make HTML files and a HTML help project + echo. qthelp to make HTML files and a qthelp project + echo. devhelp to make HTML files and a Devhelp project + echo. epub to make an epub + echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter + echo. text to make text files + echo. man to make manual pages + echo. changes to make an overview over all changed/added/deprecated items + echo. linkcheck to check all external links for integrity + echo. doctest to run all doctests embedded in the documentation if enabled + goto end +) + +if "%1" == "clean" ( + for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i + del /q /s %BUILDDIR%\* + goto end +) + +if "%1" == "html" ( + %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/html. + goto end +) + +if "%1" == "dirhtml" ( + %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml. + goto end +) + +if "%1" == "singlehtml" ( + %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml. + goto end +) + +if "%1" == "pickle" ( + %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can process the pickle files. + goto end +) + +if "%1" == "json" ( + %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can process the JSON files. + goto end +) + +if "%1" == "htmlhelp" ( + %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can run HTML Help Workshop with the ^ +.hhp project file in %BUILDDIR%/htmlhelp. + goto end +) + +if "%1" == "qthelp" ( + %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; now you can run "qcollectiongenerator" with the ^ +.qhcp project file in %BUILDDIR%/qthelp, like this: + echo.^> qcollectiongenerator %BUILDDIR%\qthelp\EditorConfigPythonCore.qhcp + echo.To view the help file: + echo.^> assistant -collectionFile %BUILDDIR%\qthelp\EditorConfigPythonCore.ghc + goto end +) + +if "%1" == "devhelp" ( + %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. + goto end +) + +if "%1" == "epub" ( + %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The epub file is in %BUILDDIR%/epub. + goto end +) + +if "%1" == "latex" ( + %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex + if errorlevel 1 exit /b 1 + echo. + echo.Build finished; the LaTeX files are in %BUILDDIR%/latex. + goto end +) + +if "%1" == "text" ( + %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The text files are in %BUILDDIR%/text. + goto end +) + +if "%1" == "man" ( + %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man + if errorlevel 1 exit /b 1 + echo. + echo.Build finished. The manual pages are in %BUILDDIR%/man. + goto end +) + +if "%1" == "changes" ( + %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes + if errorlevel 1 exit /b 1 + echo. + echo.The overview file is in %BUILDDIR%/changes. + goto end +) + +if "%1" == "linkcheck" ( + %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck + if errorlevel 1 exit /b 1 + echo. + echo.Link check complete; look for any errors in the above output ^ +or in %BUILDDIR%/linkcheck/output.txt. + goto end +) + +if "%1" == "doctest" ( + %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest + if errorlevel 1 exit /b 1 + echo. + echo.Testing of doctests in the sources finished, look at the ^ +results in %BUILDDIR%/doctest/output.txt. + goto end +) + +:end diff --git a/plugin/editorconfig-core-py/docs/plugins.rst b/plugin/editorconfig-core-py/docs/plugins.rst new file mode 100644 index 0000000..e22922a --- /dev/null +++ b/plugin/editorconfig-core-py/docs/plugins.rst @@ -0,0 +1,72 @@ +=============== +Writing Plugins +=============== + +The EditorConfig Python Core can be easily used by text editor plugins written in Python or plugins that can call an external Python interpreter. The EditorConfig Python Core supports Python versions 2.2 to 2.7. Check out the `Vim`_ and `Gedit`_ plugins for example usages of the EditorConfig Python Core. + +.. _`Vim`: https://github.com/editorconfig/editorconfig-vim +.. _`Gedit`: https://github.com/editorconfig/editorconfig-gedit + + +Use as a library +---------------- + +For instructions on using the EditorConfig Python Core as a Python library see :doc:`usage`. + + +Using with an external Python interpreter +----------------------------------------- + +The EditorConfig Python Core can be used with an external Python interpreter by executing the ``main.py`` file. The ``main.py`` file can be executed like so:: + + python editorconfig-core-py/main.py /home/zoidberg/humans/anatomy.md + +For more information on command line usage of the EditorConfig Python Core see :doc:`command_line_usage`. + + +Bundling EditorConfig Python Core with Plugin +--------------------------------------------- + +A text editor or IDE plugin will either need to bundle the EditorConfig Python +Core with the plugin installation package or the will need to assist the user +in installing the EditorConfig Python Core. Below are instructions for +bundling the EditorConfig Python Core with plugins. + +Bundling as a Submodule in Git +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Git submodules allow one repository to be included inside another. A submodule +stores a remote repositry and commit to use for fetching the embedded +repository. Submodules take up very little space in the repository since they +do not actually include the code of the embedded repository directly. + +To add EditorConfig Python Core as a submodule in the ``editorconfig-core-py`` +directory of your repository:: + + git submodule add git://github.com/editorconfig/editorconfig-core-py.git editorconfig-core-py + +Then every time the code is checked out the submodule directory should be +initialized and updated:: + + git submodule update --init + +Bundling as a Subtree in Git +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Git subtrees are convenient because, unlike submodules, they do not require any +extra work to be performed when cloning the git repository. Git subtrees +include one git codebase as a subdirectory of another. + +Example of using a subtree for the ``editorconfig`` directory from the +EditorConfig Python Core repository:: + + git remote add -f editorconfig-core-py git://github.com/editorconfig/editorconfig-core-py.git + git merge -s ours --no-commit editorconfig-core-py/master + git read-tree --prefix=editorconfig -u editorconfig-core-py/master:editorconfig + git commit + +For more information on subtrees consult the `subtree merge guide`_ on Github +and `Chapter 6.7`_ in the book Pro Git. + +.. _`subtree merge guide`: http://help.github.com/subtree-merge/ +.. _`Chapter 6.7`: http://git-scm.com/book/ch6-7.html diff --git a/plugin/editorconfig-core-py/docs/usage.rst b/plugin/editorconfig-core-py/docs/usage.rst new file mode 100644 index 0000000..993ffdf --- /dev/null +++ b/plugin/editorconfig-core-py/docs/usage.rst @@ -0,0 +1,84 @@ +===== +Usage +===== + +Installation +------------ + +First you will need to install the EditorConfig Python Core package. + +To install from PyPI using pip:: + + pip install editorconfig + +Discovering EditorConfig properties +----------------------------------- + +The ``get_properties`` function can be used to discover EditorConfig properties +for a given file. Example: + +.. code-block:: python + + import logging + from editorconfig import get_properties, EditorConfigError + + filename = "/home/zoidberg/humans/anatomy.md" + + try: + options = get_properties(filename) + except EditorConfigError: + logging.warning("Error getting EditorConfig properties", exc_info=True) + else: + for key, value in options.items(): + print "%s=%s" % (key, value) + + +The ``get_properties`` method returns a dictionary representing EditorConfig +properties found for the given file. If an error occurs while parsing a file +an exception will be raised. All raised exceptions will inherit from the +``EditorConfigError`` class. + +Handling Exceptions +------------------- + +All exceptions raised by EditorConfig will subclass ``EditorConfigError``. To +handle certain exceptions specially, catch them first. More exception classes +may be added in the future so it is advisable to always handle general +``EditorConfigError`` exceptions in case a future version raises an exception +that your code does not handle specifically. + +Exceptions module reference +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Exceptions can be found in the ``editorconfig.exceptions`` module. These are +the current exception types: + +.. autoexception:: editorconfig.exceptions.EditorConfigError +.. autoexception:: editorconfig.exceptions.ParsingError +.. autoexception:: editorconfig.exceptions.PathError +.. autoexception:: editorconfig.exceptions.VersionError + +Exception handling example +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +An example of custom exception handling: + +.. code-block:: python + + import logging + from editorconfig import get_properties + from editorconfig import exceptions + + filename = "/home/zoidberg/myfile.txt" + + try: + options = get_properties(filename) + except exceptions.ParsingError: + logging.warning("Error parsing an .editorconfig file", exc_info=True) + except exceptions.PathError: + logging.error("Invalid filename specified", exc_info=True) + except exceptions.EditorConfigError: + logging.error("An unknown EditorConfig error occurred", exc_info=True) + + for key, value in options.iteritems(): + print "%s=%s" % (key, value) diff --git a/plugin/editorconfig-core-py/editorconfig/__init__.py b/plugin/editorconfig-core-py/editorconfig/__init__.py new file mode 100644 index 0000000..2dd8408 --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/__init__.py @@ -0,0 +1,19 @@ +"""EditorConfig Python Core""" + +from editorconfig.versiontools import join_version + +VERSION = (0, 11, 3, "final") + +__all__ = ['get_properties', 'EditorConfigError', 'exceptions'] + +__version__ = join_version(VERSION) + + +def get_properties(filename): + """Locate and parse EditorConfig files for the given filename""" + handler = EditorConfigHandler(filename) + return handler.get_configurations() + + +from editorconfig.handler import EditorConfigHandler +from editorconfig.exceptions import * diff --git a/plugin/editorconfig-core-py/editorconfig/compat.py b/plugin/editorconfig-core-py/editorconfig/compat.py new file mode 100644 index 0000000..ebd0405 --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/compat.py @@ -0,0 +1,18 @@ +"""EditorConfig Python2/Python3/Jython compatibility utilities""" +import sys +import types + +__all__ = ['slice', 'u'] + + +if sys.version_info[0] == 2: + slice = types.SliceType +else: + slice = slice + + +if sys.version_info[0] == 2: + import codecs + u = lambda s: codecs.unicode_escape_decode(s)[0] +else: + u = lambda s: s diff --git a/plugin/editorconfig-core-py/editorconfig/exceptions.py b/plugin/editorconfig-core-py/editorconfig/exceptions.py new file mode 100644 index 0000000..545732b --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/exceptions.py @@ -0,0 +1,27 @@ +"""EditorConfig exception classes + +Licensed under PSF License (see LICENSE.txt file). + +""" + + +class EditorConfigError(Exception): + """Parent class of all exceptions raised by EditorConfig""" + + +try: + from ConfigParser import ParsingError as _ParsingError +except: + from configparser import ParsingError as _ParsingError + + +class ParsingError(_ParsingError, EditorConfigError): + """Error raised if an EditorConfig file could not be parsed""" + + +class PathError(ValueError, EditorConfigError): + """Error raised if invalid filepath is specified""" + + +class VersionError(ValueError, EditorConfigError): + """Error raised if invalid version number is specified""" diff --git a/plugin/editorconfig-core-py/editorconfig/fnmatch.py b/plugin/editorconfig-core-py/editorconfig/fnmatch.py new file mode 100644 index 0000000..a1d5f10 --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/fnmatch.py @@ -0,0 +1,126 @@ +"""Filename matching with shell patterns. + +fnmatch(FILENAME, PATTERN) matches according to the local convention. +fnmatchcase(FILENAME, PATTERN) always takes case in account. + +The functions operate by translating the pattern into a regular +expression. They cache the compiled regular expressions for speed. + +The function translate(PATTERN) returns a regular expression +corresponding to PATTERN. (It does not compile it.) + +Based on code from fnmatch.py file distributed with Python 2.6. + +Licensed under PSF License (see LICENSE.txt file). + +Changes to original fnmatch module: +- translate function supports ``*`` and ``**`` similarly to fnmatch C library +""" + +import os +import re + +__all__ = ["fnmatch", "fnmatchcase", "translate"] + +_cache = {} + + +def fnmatch(name, pat): + """Test whether FILENAME matches PATTERN. + + Patterns are Unix shell style: + + - ``*`` matches everything except path separator + - ``**`` matches everything + - ``?`` matches any single character + - ``[seq]`` matches any character in seq + - ``[!seq]`` matches any char not in seq + - ``{s1,s2,s3}`` matches any of the strings given (separated by commas) + + An initial period in FILENAME is not special. + Both FILENAME and PATTERN are first case-normalized + if the operating system requires it. + If you don't want this, use fnmatchcase(FILENAME, PATTERN). + """ + + name = os.path.normcase(name).replace(os.sep, "/") + return fnmatchcase(name, pat) + + +def fnmatchcase(name, pat): + """Test whether FILENAME matches PATTERN, including case. + + This is a version of fnmatch() which doesn't case-normalize + its arguments. + """ + + if not pat in _cache: + res = translate(pat) + _cache[pat] = re.compile(res) + return _cache[pat].match(name) is not None + + +def translate(pat): + """Translate a shell PATTERN to a regular expression. + + There is no way to quote meta-characters. + """ + + i, n = 0, len(pat) + res = '' + escaped = False + while i < n: + c = pat[i] + i = i + 1 + if c == '*': + j = i + if j < n and pat[j] == '*': + res = res + '.*' + else: + res = res + '[^/]*' + elif c == '?': + res = res + '.' + elif c == '[': + j = i + if j < n and pat[j] == '!': + j = j + 1 + if j < n and pat[j] == ']': + j = j + 1 + while j < n and (pat[j] != ']' or escaped): + escaped = pat[j] == '\\' and not escaped + j = j + 1 + if j >= n: + res = res + '\\[' + else: + stuff = pat[i:j] + i = j + 1 + if stuff[0] == '!': + stuff = '^' + stuff[1:] + elif stuff[0] == '^': + stuff = '\\' + stuff + res = '%s[%s]' % (res, stuff) + elif c == '{': + j = i + groups = [] + while j < n and pat[j] != '}': + k = j + while k < n and (pat[k] not in (',', '}') or escaped): + escaped = pat[k] == '\\' and not escaped + k = k + 1 + group = pat[j:k] + for char in (',', '}', '\\'): + group = group.replace('\\' + char, char) + groups.append(group) + j = k + if j < n and pat[j] == ',': + j = j + 1 + if j < n and pat[j] == '}': + groups.append('') + if j >= n or len(groups) < 2: + res = res + '\\{' + else: + res = '%s(%s)' % (res, '|'.join(map(re.escape, groups))) + i = j + 1 + else: + res = res + re.escape(c) + return res + '\Z(?ms)' diff --git a/plugin/editorconfig-core-py/editorconfig/handler.py b/plugin/editorconfig-core-py/editorconfig/handler.py new file mode 100644 index 0000000..72d99bd --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/handler.py @@ -0,0 +1,126 @@ +"""EditorConfig file handler + +Provides ``EditorConfigHandler`` class for locating and parsing +EditorConfig files relevant to a given filepath. + +Licensed under PSF License (see LICENSE.txt file). + +""" + +import os + +from editorconfig import VERSION +from editorconfig.ini import EditorConfigParser +from editorconfig.exceptions import PathError, VersionError + + +__all__ = ['EditorConfigHandler'] + + +def get_filenames(path, filename): + """Yield full filepath for filename in each directory in and above path""" + path_list = [] + while True: + path_list.append(os.path.join(path, filename)) + newpath = os.path.dirname(path) + if path == newpath: + break + path = newpath + return path_list + + +class EditorConfigHandler(object): + + """ + Allows locating and parsing of EditorConfig files for given filename + + In addition to the constructor a single public method is provided, + ``get_configurations`` which returns the EditorConfig options for + the ``filepath`` specified to the constructor. + + """ + + def __init__(self, filepath, conf_filename='.editorconfig', + version=VERSION): + """Create EditorConfigHandler for matching given filepath""" + self.filepath = filepath + self.conf_filename = conf_filename + self.version = version + self.options = None + + def get_configurations(self): + + """ + Find EditorConfig files and return all options matching filepath + + Special exceptions that may be raised by this function include: + + - ``VersionError``: self.version is invalid EditorConfig version + - ``PathError``: self.filepath is not a valid absolute filepath + - ``ParsingError``: improperly formatted EditorConfig file found + + """ + + self.check_assertions() + path, filename = os.path.split(self.filepath) + conf_files = get_filenames(path, self.conf_filename) + + # Attempt to find and parse every EditorConfig file in filetree + for filename in conf_files: + parser = EditorConfigParser(self.filepath) + parser.read(filename) + + # Merge new EditorConfig file's options into current options + old_options = self.options + self.options = parser.options + if old_options: + self.options.update(old_options) + + # Stop parsing if parsed file has a ``root = true`` option + if parser.root_file: + break + + self.preprocess_values() + return self.options + + def check_assertions(self): + + """Raise error if filepath or version have invalid values""" + + # Raise ``PathError`` if filepath isn't an absolute path + if not os.path.isabs(self.filepath): + raise PathError("Input file must be a full path name.") + + # Raise ``VersionError`` if version specified is greater than current + if self.version is not None and self.version[:3] > VERSION[:3]: + raise VersionError( + "Required version is greater than the current version.") + + def preprocess_values(self): + + """Preprocess option values for consumption by plugins""" + + opts = self.options + + # Lowercase option value for certain options + for name in ["end_of_line", "indent_style", "indent_size", + "insert_final_newline", "trim_trailing_whitespace", "charset"]: + if name in opts: + opts[name] = opts[name].lower() + + # Set indent_size to "tab" if indent_size is unspecified and + # indent_style is set to "tab". + if (opts.get("indent_style") == "tab" and + not "indent_size" in opts and self.version >= (0, 10, 0)): + opts["indent_size"] = "tab" + + # Set tab_width to indent_size if indent_size is specified and + # tab_width is unspecified + if ("indent_size" in opts and "tab_width" not in opts and + opts["indent_size"] != "tab"): + opts["tab_width"] = opts["indent_size"] + + # Set indent_size to tab_width if indent_size is "tab" + if ("indent_size" in opts and "tab_width" in opts and + opts["indent_size"] == "tab"): + opts["indent_size"] = opts["tab_width"] diff --git a/plugin/editorconfig-core-py/editorconfig/ini.py b/plugin/editorconfig-core-py/editorconfig/ini.py new file mode 100644 index 0000000..3f58fed --- /dev/null +++ b/plugin/editorconfig-core-py/editorconfig/ini.py @@ -0,0 +1,150 @@ +"""EditorConfig file parser + +Based on code from ConfigParser.py file distributed with Python 2.6. + +Licensed under PSF License (see LICENSE.txt file). + +Changes to original ConfigParser: + +- Special characters can be used in section names +- Octothorpe can be used for comments (not just at beginning of line) +- Only track INI options in sections that match target filename +- Stop parsing files with when ``root = true`` is found + +""" + +import re +from codecs import open +import posixpath +from os import sep +from os.path import normcase, dirname + +from editorconfig.exceptions import ParsingError +from editorconfig.fnmatch import fnmatch +from editorconfig.odict import OrderedDict +from editorconfig.compat import u + + +__all__ = ["ParsingError", "EditorConfigParser"] + + +class EditorConfigParser(object): + + """Parser for EditorConfig-style configuration files + + Based on RawConfigParser from ConfigParser.py in Python 2.6. + """ + + # Regular expressions for parsing section headers and options. + # Allow ``]`` and escaped ``;`` and ``#`` characters in section headers + SECTCRE = re.compile( + r'\s*\[' # [ + r'(?P
([^#;]|\\#|\\;)+)' # very permissive! + r'\]' # ] + ) + # Regular expression for parsing option name/values. + # Allow any amount of whitespaces, followed by separator + # (either ``:`` or ``=``), followed by any amount of whitespace and then + # any characters to eol + OPTCRE = re.compile( + r'\s*(?P