mirror of
https://github.com/SpaceVim/SpaceVim.git
synced 2025-02-03 12:50:03 +08:00
57 lines
1.5 KiB
VimL
57 lines
1.5 KiB
VimL
" ============================================================================
|
|
" File: api.vim
|
|
" Description: SpaceVim api core file
|
|
" Author: Shidong Wang <wsdjeg@outlook.com>
|
|
" Website: https://spacevim.org
|
|
" License: GPLv3
|
|
" ============================================================================
|
|
|
|
""
|
|
" @section API, api
|
|
" SpaceVim contains a variety of public apis. To using the api, you need to
|
|
" make sure SpaceVim has been added to your &rtp. after that, you can use
|
|
" |SpaceVim#api#import| to import the API you need.
|
|
"
|
|
" @subsection usage
|
|
"
|
|
" This is just an example, and it works well in old version vim.
|
|
" >
|
|
" let s:json = SpaceVim#api#import('data#json')
|
|
" let rst = s:json.json_encode(onject)
|
|
" let rst = s:json.json_decode(string)
|
|
" <
|
|
"
|
|
" here is list of resources where SpaceVim comes from:
|
|
"
|
|
" - vital: https://github.com/vim-jp/vital.vim
|
|
|
|
let s:apis = {}
|
|
|
|
|
|
""
|
|
"@public
|
|
"Import API base the given {name}, and return the API object. for all
|
|
"available APIs please check |spacevim-api|
|
|
function! SpaceVim#api#import(name) abort
|
|
if has_key(s:apis, a:name)
|
|
return deepcopy(s:apis[a:name])
|
|
endif
|
|
let p = {}
|
|
try
|
|
let p = SpaceVim#api#{a:name}#get()
|
|
let s:apis[a:name] = p
|
|
catch /^Vim\%((\a\+)\)\=:E117/
|
|
endtry
|
|
return p
|
|
endfunction
|
|
|
|
function! SpaceVim#api#register(name, api) abort
|
|
if !empty(SpaceVim#api#import(a:name))
|
|
echoerr '[SpaceVim api] Api : ' . a:name . ' already existed!'
|
|
else
|
|
let s:apis[a:name] = deepcopy(a:api)
|
|
endif
|
|
endfunction
|
|
|
|
" vim:set fdm=marker sw=2 nowrap:
|