{"id":15021360,"url":"https://github.com/nicodebo/vim-pck","last_synced_at":"2025-10-28T11:31:58.461Z","repository":{"id":52704459,"uuid":"83982711","full_name":"nicodebo/vim-pck","owner":"nicodebo","description":"vim package manager","archived":false,"fork":false,"pushed_at":"2021-04-20T17:36:47.000Z","size":210,"stargazers_count":12,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-09-29T01:43:02.835Z","etag":null,"topics":["command-line","neovim","package-manager","python","vim"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicodebo.png","metadata":{"files":{"readme":"README.rst","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":"2017-03-05T15:58:23.000Z","updated_at":"2023-03-25T05:00:34.000Z","dependencies_parsed_at":"2022-08-22T09:20:38.344Z","dependency_job_id":null,"html_url":"https://github.com/nicodebo/vim-pck","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicodebo%2Fvim-pck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicodebo%2Fvim-pck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicodebo%2Fvim-pck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicodebo%2Fvim-pck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicodebo","download_url":"https://codeload.github.com/nicodebo/vim-pck/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859638,"owners_count":16556035,"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":["command-line","neovim","package-manager","python","vim"],"created_at":"2024-09-24T19:56:29.827Z","updated_at":"2025-10-28T11:31:58.130Z","avatar_url":"https://github.com/nicodebo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Vim Pck\n=======\n\n|Build Status| |Coverage Status| |Pypi|\n\nA command-line tool to manage my vim plugins using the built-in package\nfeature of vim8. (see :help packages)\n\n|install| |list| |upgrade|\n\n\nTable of contents:\n * `Dependencies`_;\n * `Installation`_;\n * `How to use`_;\n * `Related projects`_;\n * `Note`_;\n * `License`_.\n\nDependencies\n------------\n\n-  git\n-  python 3.6\n\nInstallation\n------------\n\nI like to install python command line programs in their own virtual\nenvironment to not clutter the system wide package directory. ``pipsi``\nmake it very conveniant to do so by automatically creating the venv and\nsymlinking scripts to ``~/.local/bin``. If you don't use ``pipsi``,\nyou're missing out. Here are `installation\ninstructions \u003chttps://github.com/mitsuhiko/pipsi#readme\u003e`_.\n\nSimply run:\n\n.. code:: shell\n\n    $ pipsi install vim-pck\n\nAlternatively, with pip:\n\n.. code:: shell\n\n    $ pip install vim-pck\n\nHow to use\n----------\n\nConfiguration file\n~~~~~~~~~~~~~~~~~~\n\nThe main configuration file where the vim packages are specified. It's\ndefault location follow the `XDG specification \u003chttps://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\u003e`_\nthat is ``$XDG_HOME_CONFIG/vimpck/config`` or\n``~/.config/vimpck/config`` if ``XDG_HOME_CONFIG`` is not set.\n\n.. code:: dosini\n\n    [SETTING]\n        # The built in package directory. See :help packages\n        pack_path=~/.vim/pack\n        # pack_path= ~/.local/share/nvim/site/pack for neovim\n\n    [REPOSITORY]\n        [[https://github.com/tpope/vim-commentary]]\n            package = common\n            type = start\n            freeze = True # Don't update vim-commentary when launching vimpck upgrade\n\n        [[https://github.com/tpope/vim-dispatch]]\n        # default location pack_path/vimpck/start/vim-dispatch\n\n        [[https://github.com/mustache/vim-mustache-handlebars]]\n            package = filetype\n            type = start\n\n        [[https://github.com/altercation/vim-colors-solarized]]\n            package = colors\n            type = start\n\nThen run ``vimpck install`` to clone each remote repository in the\ncorrect package location. For exemple, ``vim-commentary`` --\u003e\n``~/.vim/pack/common/start/vim-commentary``\n\nFor neovim the package path should be set to\n``~/.local/share/nvim/site/pack``\n\n+--------------+-------------------+\n| Option       | default value     |\n+==============+===================+\n| pack\\_path   | ``~/.vim/pack``   |\n+--------------+-------------------+\n| package      | ``vimpck``        |\n+--------------+-------------------+\n| type         | ``start``         |\n+--------------+-------------------+\n| freeze       | ``False``         |\n+--------------+-------------------+\n\nUsage\n~~~~~\n\nTo use it (see ``vimpck --help``):\n\n-  ``$ vimpck install`` : install plugins from the configuration file\n-  ``$ vimpck ls`` : list all plugins\n-  ``$ vimpck ls --start`` : list plugins that are automatically loaded\n-  ``$ vimpck ls --opt`` : list plugins that have to be loaded manually\n-  ``$ vimpck upgrade`` : update all plugins that are not freezed\n-  ``$ vimpck upgrade \u003cplug\u003e...`` : only update ``\u003cplug\u003e`` plugin. The\n   plugin have to be specified using the following pattern\n   ``package/type/plugin``. You can easily complete the ``\u003cplug\u003e`` with\n   the zsh completion script.\n-  ``vimpck rm \u003cplug\u003e...`` : remove one or more ``\u003cplug\u003e``. Support zsh\n   completion.\n-  ``vimpck rm -r \u003cplug\u003e...`` : remove one or more ``\u003cplug\u003e`` and also\n   remove the corresponding section from the configuration file.\n-  ``vimpck clean`` : remove unused plugins\n\nEnvironment variable\n~~~~~~~~~~~~~~~~~~~~\n\n-  ``VIMPCKRC``: override default configuration location (xdg standard)\n\nExample : ``export VIMPCKRC=/path/to/conf/name``\n\nCompletion\n~~~~~~~~~~\n\nA zsh completion function is provided in the ``completion`` folder of\nthis repository.\n\nTo use it copy ``_vimpck`` somewhere in the ``$fpath`` environment\nvariable of zsh and make sure the completion module of zsh is loaded by\nputting these following lines in your ``.zshrc``:\n\n.. code:: bash\n\n    autoload -U compinit\n    compinit\n\nRelated projects\n----------------\n\n-  `minpac \u003chttps://github.com/k-takata/minpac\u003e`_: vim plugin\n-  `infect \u003chttps://github.com/csexton/infect\u003e`_: command-line tool\n   build in ruby.\n-  `pack \u003chttps://github.com/maralla/pack\u003e`_: command-line tool build\n   in rust.\n-  `vim8-pack \u003chttps://github.com/mkarpoff/vim8-pack\u003e`_: command-line\n   tool in bash.\n\nNote\n----\n\n-  Project generated with\n   `cookiecutter-python-cli \u003chttps://github.com/nvie/cookiecutter-python-cli\u003e`_\n\nLicense\n-------\n\nMIT license, see the LICENSE file. You can use vim-pck in open source\nprojects and commercial products.\n\n.. _Dependencies: #dependencies\n.. _Installation: #installation\n.. _How to use: #how-to-use\n.. _Related projects: #related-projects\n.. _Note: #note\n.. _License: #license\n\n.. |Build Status| image:: https://travis-ci.org/nicodebo/vim-pck.svg?branch=master\n   :target: https://travis-ci.org/nicodebo/vim-pck\n.. |Coverage Status| image:: https://coveralls.io/repos/github/nicodebo/vim-pck/badge.svg?branch=master\n   :target: https://coveralls.io/github/nicodebo/vim-pck?branch=master\n.. |install| image:: screenshot/install.jpg\n.. |list| image:: screenshot/ls.jpg\n.. |upgrade| image:: screenshot/upgrade.jpg\n.. |Pypi| image:: https://img.shields.io/pypi/v/vim-pck.svg?style=flat\n   :target: https://pypi.python.org/pypi/vim-pck\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicodebo%2Fvim-pck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicodebo%2Fvim-pck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicodebo%2Fvim-pck/lists"}