Monkey patch

From Wikipedia, the free encyclopedia
  (Redirected from Monkey patching)
Jump to navigation Jump to search

A monkey patch is a way for a program to extend or modify supporting system software locally (affecting only the running instance of the program).


The term monkey patch seems to have come from an earlier term, guerrilla patch, which referred to changing code sneakily – and possibly incompatibly with other such patches – at runtime.[1] The word guerrilla, homophonous with gorilla (or nearly so), became monkey, possibly to make the patch sound less intimidating.[1] An alternative etymology is that it refers to “monkeying about” with the code (messing with it).


The definition of the term varies depending upon the community using it. In Ruby,[2] Python,[3] and many other dynamic programming languages, the term monkey patch only refers to dynamic modifications of a class or module at runtime, motivated by the intent to patch existing third-party code as a workaround to a bug or feature which does not act as desired. Other forms of modifying classes at runtime have different names, based on their different intents. For example, in Zope and Plone, security patches are often delivered using dynamic class modification, but they are called hot fixes.[citation needed]


Monkey patching is used to:

  • Replace methods / classes / attributes / functions at runtime, e.g. to stub out a function during testing;
  • Modify/extend behaviour of a third-party product without maintaining a private copy of the source code;
  • Apply the result of a patch at runtime to the state in memory, instead of the source code on disk;
  • Distribute security or behavioural fixes that live alongside the original source code (an example of this would be distributing the fix as a plugin for the Ruby on Rails platform);
  • Explore different automated fixes to provide self-healing.[4]


Carelessly written or poorly documented monkey patches can lead to problems:

  • They can lead to upgrade problems when the patch makes assumptions about the patched object that are no longer true; a new release may very well break the patch. For this reason monkey patches are often made conditional, and only applied if appropriate.[5]
  • If two modules attempt to monkey patch the same method, one of them (whichever one runs last) "wins" and the other patch has no effect, unless monkey patches are written with a pattern like alias_method_chain.[6]
  • They create a discrepancy between the original source code on disk and the observed behaviour that can be very confusing to anyone unaware of the patches' existence.


The following Python example monkey-patches the value of Pi from the standard Python math library to make it compliant with the laws of the American State of Indiana.

>>> import math
>>> math.pi
>>> math.pi = 3.2   # monkey-patch the value of Pi in the math module
>>> math.pi
================================ RESTART ================================
>>> import math
>>> math.pi

See also[edit]


  1. ^ a b Limi, Alexander; Shane Hathaway (2005-12-23). "Monkey patch". Plone Foundation. Archived from the original on 2008-06-04. Retrieved 2008-07-03.CS1 maint: BOT: original-url status unknown (link)
  2. ^ "Refining Ruby". 2013-02-27.
  3. ^ Biswal, Bimal. "Monkey Patching in Python". Software Technology Tips. Mindfire Solutions. Retrieved 9 December 2013.
  4. ^ Durieux, Thomas; Hamadi, Youssef; Monperrus, Martin (2020). "Fully Automated HTML and JavaScript Rewriting for Constructing a Self‐healing Web Proxy". Software Testing, Verification and Reliability. 30 (2). arXiv:1803.08725. doi:10.1002/stvr.1731. ISSN 0960-0833.
  5. ^ "Maintainable JavaScript: Don't modify objects you don't own". 2010-03-02.
  6. ^ "New in Rails: Module#alias_method_chain". 2006-04-26.