https://github.com/dafalcon/pgreset

Automatically kill postgres connections during db:reset
https://github.com/dafalcon/pgreset

gem postgresql rails rails-db ruby ruby-on-rails

Last synced: 20 days ago
JSON representation

Automatically kill postgres connections during db:reset

• Host: GitHub
• URL: https://github.com/dafalcon/pgreset
• Owner: dafalcon
• License: mit
• Created: 2016-09-28T04:14:26.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2023-10-12T20:47:40.000Z (about 1 year ago)
• Last Synced: 2024-12-15T05:35:42.564Z (24 days ago)
• Topics: gem, postgresql, rails, rails-db, ruby, ruby-on-rails
• Language: Ruby
• Size: 19.5 KB
• Stars: 40
• Watchers: 3
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# pgreset

The pgreset gem makes it possible to run rails db:reset against a postgres database with active connections.  It should eliminate "database in use" errors from rails.

Credit for the [original solution](https://github.com/basecamp/pow/issues/212) goes to [Manuel Meurer](https://github.com/manuelmeurer).

Special thanks to [Emil Kampp](https://github.com/ekampp), [Michael Yin](https://github.com/layerssss), and [Kate Donaldson](https://github.com/katelovescode) for adding Rails 6.1 support.

## Installation and Usage

Add this line to your application's Gemfile:

```ruby

gem 'pgreset'

```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install pgreset

    

Now you can run rails db:reset as normal, and rails will kill active connections to the database being reset:

    $ rails db:reset

    

## Development

After checking out the repo, run `bin/setup` to install dependencies. 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`.

## Testing

There's a script called pgreset-test.sh that can test a local copy of pgreset against various versions of ruby and rails.  The script assumes postgres is listening on a socket at /tmp/.s.PGSQL.5432 and accepts connections for a user with no password, and that rvm is installed.  You should at least test against these versions, since there were breaking changes to pgreset in them (replace PG_USER with your postgres username):

    cd /path/to/your/pgreset/clone

    ./pgreset-test.sh 3.0.4 6.0.4 PG_USER

    ./pgreset-test.sh 3.1.2 7.0.8 PG_USER

    ./pgreset-test.sh 3.1.2 7.1.1 PG_USER

## Releasing

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/dafalcon/pgreset.

## License

The gem is available as open source under the terms of the [MIT

License](https://opensource.org/licenses/MIT).