Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mattbrictson/tomo-plugin
A GitHub template for creating tomo plugins
https://github.com/mattbrictson/tomo-plugin
template tomo
Last synced: 3 months ago
JSON representation
A GitHub template for creating tomo plugins
- Host: GitHub
- URL: https://github.com/mattbrictson/tomo-plugin
- Owner: mattbrictson
- License: mit
- Created: 2019-08-11T21:05:17.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-07T21:07:55.000Z (4 months ago)
- Last Synced: 2024-09-07T22:22:24.054Z (4 months ago)
- Topics: template, tomo
- Language: Ruby
- Homepage: https://tomo-deploy.com/tutorials/publishing-a-plugin/
- Size: 243 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# tomo plugin template
This is a GitHub template for creating [tomo](https://github.com/mattbrictson/tomo) plugins, which are packaged as Ruby gems.
Read the tomo tutorial [Publishing a Plugin](https://tomo.mattbrictson.com/tutorials/publishing-a-plugin/) to get started. Then press [**Use this template**](https://github.com/mattbrictson/tomo-plugin/generate) to generate a project from this template. In the generated project, run this script to rename the gem to meet your needs:
```
ruby rename_template.rb
```Note that to get the full benefits of the script, you will need the [gh](https://github.com/cli/cli) command installed.
This template is based on `bundle gem` with some notable improvements:
- GitHub Actions configuration
- Minitest, with minitest-rg for nicely formatted test output
- Rubocop with a good set of configuration
- [release-drafter](https://github.com/apps/release-drafter) GitHub Action for automating release notes
- A `rake bump` task to keep your Ruby and Bundler dependencies up to date
- A nice README with badges ready to go (see below)---
# tomo-plugin-example
[![Gem Version](https://img.shields.io/gem/v/replace_with_gem_name)](https://rubygems.org/gems/replace_with_gem_name)
[![Gem Downloads](https://img.shields.io/gem/dt/replace_with_gem_name)](https://www.ruby-toolbox.com/projects/replace_with_gem_name)
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/mattbrictson/tomo-plugin/ci.yml)](https://github.com/mattbrictson/tomo-plugin/actions/workflows/ci.yml)
[![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/mattbrictson/tomo-plugin)](https://codeclimate.com/github/mattbrictson/tomo-plugin)This is a [tomo](https://github.com/mattbrictson/tomo) plugin that ... TODO: Description of this plugin goes here.
---
- [Installation](#installation)
- [Settings](#settings)
- [Tasks](#tasks)
- [Support](#support)
- [License](#license)
- [Code of conduct](#code-of-conduct)
- [Contribution guide](#contribution-guide)## Installation
Run:
```
gem install tomo-plugin-example
```Or add it to your Gemfile:
```ruby
gem "tomo-plugin-example"
```Then add the following to `.tomo/config.rb`:
```ruby
plugin "example"
```## Settings
TODO: document plugin settings
| Name | Purpose | Default |
| --------------------- | ------- | ------- |
| `plugin_name_setting` | TODO | `nil` |## Tasks
TODO: document plugin tasks
### example:task_name
TODO
## Support
If you want to report a bug, or have ideas, feedback or questions about the gem, [let me know via GitHub issues](https://github.com/mattbrictson/tomo-plugin/issues/new) and I will do my best to provide a helpful answer. Happy hacking!
## License
The gem is available as open source under the terms of the [MIT License](LICENSE.txt).
## Code of conduct
Everyone interacting in this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
## Contribution guide
Pull requests are welcome!