{"id":13897561,"url":"https://github.com/kana/vim-flavor","last_synced_at":"2025-04-05T21:09:46.897Z","repository":{"id":427656,"uuid":"3684940","full_name":"kana/vim-flavor","owner":"kana","description":"Taste the difference.","archived":false,"fork":false,"pushed_at":"2023-11-20T07:17:54.000Z","size":544,"stargazers_count":112,"open_issues_count":8,"forks_count":11,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-24T13:16:14.529Z","etag":null,"topics":["vim","vim-plugin-manager"],"latest_commit_sha":null,"homepage":"https://www.relishapp.com/kana/vim-flavor","language":"Ruby","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/kana.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-03-11T05:49:15.000Z","updated_at":"2024-06-09T00:34:42.146Z","dependencies_parsed_at":"2024-06-09T00:34:41.851Z","dependency_job_id":"cae26655-fc34-4ade-8473-70995f00cc11","html_url":"https://github.com/kana/vim-flavor","commit_stats":{"total_commits":758,"total_committers":7,"mean_commits":"108.28571428571429","dds":0.0158311345646438,"last_synced_commit":"4f459eafcb200772d6deef538d8b64ec5329d299"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kana%2Fvim-flavor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kana%2Fvim-flavor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kana%2Fvim-flavor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kana%2Fvim-flavor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kana","download_url":"https://codeload.github.com/kana/vim-flavor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399884,"owners_count":20932880,"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":["vim","vim-plugin-manager"],"created_at":"2024-08-06T18:03:41.612Z","updated_at":"2025-04-05T21:09:46.879Z","avatar_url":"https://github.com/kana.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# vim-flavor, a tool to manage your favorite Vim plugins\n\n[![CI](https://github.com/kana/vim-flavor/actions/workflows/ci.yml/badge.svg)](https://github.com/kana/vim-flavor/actions/workflows/ci.yml)\n[![Maintainability](https://api.codeclimate.com/v1/badges/97414d95fb6d19c7fb72/maintainability)](https://codeclimate.com/github/kana/vim-flavor/maintainability)\n\n\n\n\n# Getting started\n\n## Create `Flavorfile`\n\nThis file contains a set of declarations about what Vim plugins you want to\ninstall.  For example:\n\n```ruby\n# Install a Vim plugin from `https://github.com/kana/vim-textobj-indent`.\n#\n# Note that kana/vim-textobj-indent requires kana/vim-textobj-user.\n# Such dependencies are automatically installed if the former plugin\n# declares its dependencies with Flavorfile.\nflavor 'kana/vim-textobj-indent'\n\n# Install a Vim plugin from `https://github.com/vim-scripts/fakeclip`.\nflavor 'fakeclip'\n\n# Install a Vim plugin from the specified URI.\nflavor 'https://github.com/kana/vim-altr.git'\n\n# You can also specify which version of Vim plugin should be installed.\n# For example:\nflavor 'kana/vim-smartword', '~\u003e 0.1'    # 0.1 or later, but older than 0.2\nflavor 'kana/vim-smartchr',  '~\u003e 0.2.4'  # 0.2.4 or later, but older than 0.3.0\nflavor 'kana/vim-smarttill', '\u003e= 0.3.6'  # 0.3.6 or later\n\n# vim-flavor, by design, requires Vim plugins to follow semantic versioning\n# and to create version tags (like `v1.2.3`) in their repositories.\n#\n# For repositories without versioning, branches can be specified.\nflavor 'chriskempson/base16-vim', branch: 'master'\n```\n\n## Install Vim plugins (for the first time)\n\nRun the following command:\n\n```bash\nvim-flavor install\n```\n\nThis command does the following stuffs:\n\n1. Fetches Vim plugins declared in the `Flavorfile`.\n2. Creates `Flavorfile.lock` file.  It contains information about what\n   versions of plugins to be installed.\n3. Copies the fetched plugins into `~/.vim/pack/flavors/start`, then updates\n   help tags for each plugin.\n\nIt's recommended to commit `Flavorfile` and `Flavorfile.lock` after\ninstallation.\n\n```bash\ngit add Flavorfile Flavorfile.lock\ngit commit -m 'Use vim-flavor to manage my favorite Vim plugins'\n```\n\n## Install Vim plugins (from another machine)\n\nSuppose that you work with several PCs and/or servers, and you want to use the\nsame configuration, including Vim plugins, on all of them.\n\nFirstly, let's synchronize your configuration files:\n\n```bash\ncd ~/your/dotfiles/repository\ngit pull\n```\n\nNow you have the same `Flavorfile` and `Flavorfile.lock` created by the\nprevious step.\n\nThen run the following command:\n\n```bash\nvim-flavor install\n```\n\nThis time `vim-flavor` installs the same versions of Vim plugins as recorded\nin `Flavorfile.lock`, even if newer versions are available.\n\n## Update Vim plugins\n\nTo update Vim plugins, run the following command:\n\n```bash\nvim-flavor update\n```\n\nThis is similar to `vim-flavor install`, but vim-flavor tries checking and\ninstalling newer versions of Vim plugins.\n\nThis command usually updates `Flavorfile.lock`.  So that you have to commit it\nagain.\n\n```bash\ngit add Flavorfile.lock\ngit commit -m 'Update Vim plugins'\n```\n\n\n\n\n# References\n\nSee [`features/`](./features) directory for the details.\nThe same [documents](https://www.relishapp.com/kana/vim-flavor) are available\nalso on relish.\n\n\n\n\n# Changelog\n\nSee [CHANGELOG.md](./CHANGELOG.md).\n\n\n\n\n# License\n\nvim-flavor is released under the terms of MIT license.\nSee the [LICENSE](./LICENSE) file for the details.\n\n\n\n\n# Development\n\n## Set up\n\n1. Install [rbenv](https://github.com/rbenv/rbenv).\n2. Run the following commands in your clone of vim-flavor repository:\n\n   ```bash\n   git submodule update --init\n   rbenv install\n   bundle install\n   ```\n\n## Run tests\n\n```bash\nrake test\n```\n\n\n\n\n# Author\n\n* [kana](https://github.com/kana)\n\n\n\n\n\u003c!-- vim: set expandtab shiftwidth=4 softtabstop=4 textwidth=78 : --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkana%2Fvim-flavor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkana%2Fvim-flavor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkana%2Fvim-flavor/lists"}