https://github.com/artemave/fixturex
Rails fixtures explorer
https://github.com/artemave/fixturex
fixtures rails ruby
Last synced: 10 months ago
JSON representation
Rails fixtures explorer
- Host: GitHub
- URL: https://github.com/artemave/fixturex
- Owner: artemave
- License: mit
- Created: 2021-01-31T16:47:03.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-08-13T16:09:04.000Z (11 months ago)
- Last Synced: 2025-08-28T13:41:36.723Z (10 months ago)
- Topics: fixtures, rails, ruby
- Language: Ruby
- Homepage:
- Size: 102 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Fixturex [](https://github.com/artemave/fixturex/actions/workflows/ruby.yml) [](https://badge.fury.io/rb/fixturex)
Rails fixtures explorer.
## Description
Rails fixtures are hard work. There are different sides to that, but one particular thing is that it's not obvious what other fixtures reference the one you're looking at and what fixtures reference those ones referencing the one you're looking at. And so on.
This little gem to the rescue. It's a command line tool that shows reference tree for a given fixture. It plugs in to vim's quickfix and it shouldn't be too much work to hook it up with vscode, if anyone is up for it.
Demo
https://user-images.githubusercontent.com/23721/135531049-527640b0-f2f9-436b-923d-c5fc4d9f3fe8.mp4
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'fixturex'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install fixturex
## Usage
$ bundle exec fixturex test/fixtures/things.yml thing1
### Vim
Here is one way to plug it into vim. Define a new command - let's call it `Fixturex` - in your ([project](https://andrew.stwrt.ca/posts/project-specific-vimrc/)) vimrc:
```vim
command! -nargs=0 Fixturex :cexpr system('bundle exec fixturex '. expand('%') .' '.shellescape(expand(''))) | copen
```
From then on, if the cursor is on the fixture name in a fixture file, running `:Fixturex` will populate the quickfix window with the reference tree.
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/featurist/fixturex.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).