https://github.com/bergercookie/fish_plugin_cookiecutter
A cookiecutter template for creating fish plugins
https://github.com/bergercookie/fish_plugin_cookiecutter
fish fish-plugin plugin
Last synced: 9 months ago
JSON representation
A cookiecutter template for creating fish plugins
- Host: GitHub
- URL: https://github.com/bergercookie/fish_plugin_cookiecutter
- Owner: bergercookie
- License: mit
- Created: 2022-08-28T13:31:23.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-08-28T16:31:48.000Z (almost 4 years ago)
- Last Synced: 2025-02-12T23:45:59.983Z (over 1 year ago)
- Topics: fish, fish-plugin, plugin
- Language: Shell
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Fish Plugin Cookiecutter ๐ช
This is a template repository for spawning new ๐
[fish-shell](https://fishshell.com/) plugins off it, using the
[cookiecutter tool](https://www.cookiecutter.io/)
## How to use
Download this repository, install cookiecutter, and call cookiecutter, with this
cloned repo as the argument:
```sh
pip install coookiecutter
git clone https://github.com/bergercookie/fish_plugin_cookiecutter
cookiecutter fish_plugin_cookiecutter
```
Here's a potential interaction with this tool:
```text
cookiecutter .
plugin_name [some_plugin]: awesome_plugin
plugin_slug [awesome_plugin]:
plugin_short_description [Some short description]: My awesome plugin
repo_name [awesome_plugin]:
Select work_over_ssh_or_https:
1 - ssh
2 - https
Choose from 1, 2 [1]: 1
github_username [bergercookie]:
full_name [Nikos Koukis]:
create_author_file [y]:
Initializing the newly created repo
PWD=/home/berger/sync/bulk/src/fish_plugin_cookiecutter/awesome_plugin
Initialised empty Git repository in /home/berger/sync/bulk/src/fish_plugin_cookiecutter/awesome_plugin/.git/
Setting remote origin -> ssh://git@github.com:bergercookie/awesome_plugin
**************************************************
Setup completed ๐, created new fish plugin at /home/berger/sync/bulk/src/fish_plugin_cookiecutter/awesome_plugin
Next steps๐พ
- Fill in thhe README
- Push to Github
- Announce this plugin.
**************************************************
```
## Features
When spawning new fish plugins off this repository, you'll get these for free:
- A proper plugin structure so that your new plugin plays well from the get-go
with plugin managers like [fisher](https://github.com/jorgebucaran/fisher)
- Github CI recipes with automatic spell-checking in your README and more nice
to haves
- Automatically add `.gitignore` file, and initialize the git repository