Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LucHermitte/lh-style
Vim Script library providing stylistic related functions
https://github.com/LucHermitte/lh-style
vim viml-library vimscript-library
Last synced: about 2 months ago
JSON representation
Vim Script library providing stylistic related functions
- Host: GitHub
- URL: https://github.com/LucHermitte/lh-style
- Owner: LucHermitte
- License: other
- Created: 2017-10-17T14:06:58.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-18T08:30:04.000Z (3 months ago)
- Last Synced: 2024-06-18T09:49:36.780Z (3 months ago)
- Topics: vim, viml-library, vimscript-library
- Language: Vim Script
- Size: 226 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: License.md
Awesome Lists containing this project
README
# lh-style [](https://github.com/LucHermitte/lh-style/releases) [](http://travis-ci.org/LucHermitte/lh-style) [](http://lh-style.readthedocs.io/en/latest/?badge=latest) [](https://www.openhub.net/p/21020)
Discl. This page is currently under heavy reorganization!
TODO:
- Complete the documentation
- reorganize the sections to:
-[X] Intro
-[ ] Features
-[ ] Code formatting
-[x] rationale
-[ ] end-user side
-[x] `.editorconfig`
-[x] `.clang-format` (to be implemented)
-[x] `:UseStyle`
-[x] `:AddStyle`
-[ ] extending the style families
-[x] Naming policies
-[ ] API
-[ ] Contributing
-[X] Installation
## Introduction
lh-style is a vim script library that defines vim functions and commands that permit to specify stylistic preferences
like naming conventions, bracket formatting, etc.
In itself the only feature end-users can directly exploit is name converting based on the style name (`snake_case`,
`UpperCamelCase`...) like Abolish plugin does, or on a given identifier kind (function, type, class, attribute...).
Check `:NameConvert` and `ConvertNames` -- sorry I wasn't inspired.
The main, and unique, feature is this plugin is to offer core functionalities, related to code-style, other plugins can
exploit. Typical client plugins would be code generating plugins: wizards/snippet/abbreviation plugins, and refactoring
plugins.
The style can be tuned through options. The options are meant to be tuned by end-users, and indirectly used by plugin
maintainers. See [API section](doc/API.md) to see how you could exploit these options from your plugins.
Snippets from [lh-cpp](http://github.com/LucHermitte/lh-cpp) and
[mu-template](http://github.com/LucHermitte/mu-template), and refactorings from
[lh-refactor](http://github.com/LucHermitte/lh-refactor) exploit the options offered by lh-style for specifying code
style.
> Note: The library has been extracted from [lh-dev](http://github.com/LucHermitte/lh-dev) v2.x.x. in order to remove dependencies to [lh-tags](http://github.com/LucHermitte/lh-tags) and other plugins from template/snippet expander plugins like [mu-template](http://github.com/LucHermitte/mu-template). Yet, I've decided to reset the version counter to 1.0.0.
---
## Features
lh-style permits to adjust the style of the code you generate along two axis:
- you can define a [naming policy](doc/naming.rst)
- you can define a [formatting style](doc/code-formatting.rst) regarding the placement of brackets, spaces, newlines, and
so on.
---
## Contributing
Contributions are welcomed. I've yet to write a proper CONTRIBUTING.md guide regarding copyright, licence and so on.
---
## Installation
* Requirements:
* Vim 7.+,
* [lh-vim-lib](http://github.com/LucHermitte/lh-vim-lib) (v5.3.1),
* [editorconfig-vim](https://github.com/editorconfig/editorconfig-vim) (optional).
* Install with [vim-addon-manager](https://github.com/MarcWeber/vim-addon-manager) any plugin that requires lh-style should be enough.
* With [vim-addon-manager](https://github.com/MarcWeber/vim-addon-manager), install lh-style (this is the preferred method because of the [dependencies](http://github.com/LucHermitte/lh-style/blob/master/addon-info.txt)).
```vim
ActivateAddons lh-style
" will also install editorconfig-vim
```
* [vim-flavor](http://github.com/kana/vim-flavor) (which also supports
dependencies)
```
flavor 'LucHermitte/lh-style'
" will also install editorconfig-vim
```
* Vundle/NeoBundle:
```vim
Bundle 'LucHermitte/lh-vim-lib'
Bundle 'LucHermitte/lh-style'
" Optional
Bundle 'editorconfig/editorconfig-vim'
```
* Clone from the git repositories
```
git clone [email protected]:LucHermitte/lh-vim-lib.git
git clone [email protected]:LucHermitte/lh-style.git
" Optional
git clone [email protected]:editorconfig/editorconfig-vim'
```