Project

pachinko

0.0
No commit activity in last 3 years
No release in over 3 years
pachinkopmarreck/pachinkoHomepageDocumentationSource CodeBug TrackerWiki
Pachinko is a Ruby monkeypatch manager tool attempting to control the unpredictable and difficult-to-troubleshoot regressions possible when monkeypatches run amok and unchecked in a medium to large Ruby codebase.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
31,770
Stars
11
Forks
0
Watchers
2
 Releases
Current version
0.0.3
Total releases
3
First release
2013-10-03
Latest release
2013-10-03
 Development
Primary Language
Ruby
Licenses
BSD 3-Clause
Average date of last 50 commits
2013-10-09
Reverse Dependencies
0

 Dependencies

Development

active_support
>= 0
mocha
>= 0

Runtime

ansi
>= 0
 Project Readme

pachinko

Pachinko is a Ruby monkeypatch manager tool attempting to control the unpredictable and difficult-to-troubleshoot regressions possible when monkeypatches run amok and unchecked in a medium to large Ruby codebase.

If you have a lot of files in your lib directory which backport features, fix long-fixed bugs or apply other such behavior changes which are never being followed up on later on, via monkeypatching... This gem may be for you!

The idea is, the Pachinko patch itself checks to see whether it even needs to be applied to your app stack to begin with, every time it runs. In order to make that happen you have to come up with a somewhat clever on-the-fly "test for relevancy" but once you succeed in doing that, your patch will auto-expire and/or let you know when it's no longer relevant. Your test for relevancy should ideally check actual behavior and not just the presence/absence of a method or version number. That way it can PROVE it is still relevant (or not).

Pachinko will let you know 3 types of things right in the console when your stack loads:

  1. If the patch did apply successfully (if you don't like noise, you can control this somewhat, see the code)
  2. It will warn you if the patch was run but didn't seem to change any behavior (it reruns the relevancy check after the patch is run to make sure the output changed... if it doesn't, it usually means your relevancy code was invalid)
  3. It will warn you when the patch seems to no longer be relevant (but still applies it)

There are a few examples in the 'examples' directory, including some things like automatically-expiring backported features from versions of Rails ostensibly after the version you are stuck on, bugfixes that are not yet on your Rails version, etc.

Once you write your Pachinko patch, just drop it in your lib or anywhere you automatically require stuff. Or manually require it from your initialization or application code.

I've tried to make this gem agnostic to the type of Ruby project you have, but typically this will end up being most useful on monolithic Rails apps.

If this gem does help you,

  1. Totally awesome, let me know! peter@marreck.com
  2. It's probably a hint that you should consider breaking up your app code somehow, architecturally. ;)

Happy sane monkeypatchery,

-Peter