Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


The programmable mock proxy

Subscribe to updates I use moxy

Statistics on moxy

Number of watchers on Github 121
Number of open issues 0
Main language Ruby
Average time to merge a PR about 4 hours
Open pull requests 0+
Closed pull requests 0+
Last commit about 5 years ago
Repo Created over 8 years ago
Repo Last Updated over 2 years ago
Size 298 KB
Homepage http://jondot.git...
Organization / Authorjondot
Page Updated
Do you use moxy? Leave a review!
View moxy activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating moxy for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Moxy (or moxy) is a programmable mock proxy. It is an HTTP proxy exposing web hooks that you can use in order to tell it what to do, and when to do it.

For example, you might want to set up that a request to http://google.com will return the text boo hoo. Thats easy:

$ curl -d "mock_text=stub_request(:get, 'http://google.com').to_return(:body=>'boo hoo')" http://localhost:9292/__setup__ 

However, moxy was not made just for one-offs. It was made in order to allow you to use such things in automated integration tests.

Here is an example in Ruby:

it "should handle google crashes" do
    # setup responses at moxie.
                :mock_text=>'stub_request(:get, "http://google.com?q=moxie").to_return(:status=>401)'

    r = Google.get("http://google.com?q=moxie")

    r.code.must_equal 401

See more languages and use cases in /examples.

But these kind of things can already be done using rack-test, and other abstraction/mocking frameworks in other languages. Moxy can be an extremely fitting answer to your problems when:

  • The juice is not worth the squeeze. You need to integration test but you don't want/need to invest effort in convoluted HTTP abstracting test code and helpers. Just set up a real response and go.

  • The language / platform is not worth the squeeze. Some platforms and languages just aren't as great as Ruby. In .NET, for example, some parts of the framework don't allow for (real) testing. Using moxy clears this up pretty easily!.

  • You need a proxy which is programmable. Reply with pre-programmed responses, send back files, or just pre-program to return all sorts of errors that blow in your face.

Getting Started

Run gem install moxy

As a system executable

$ moxy  # no arguments, default to localhost, 9292
$ moxy integration-notifier.dev.com 3000 

As a Web app

$ git clone https://github.com/jondot/moxy
$ cd moxy; rackup

A web app is great for a dedicated integration server. Moxy will run on any rack handler.

Using Moxy

  1. Set http://moxy-host:port as a system proxy, or a proxy in your HTTP library in your code.
  2. Issue any number of POSTs to your http://moxy-host:port/__setup__ endpoint with a POST variable named mock_text.

Below are some examples of mock_text (in each, second line describes result).

stub_request :get, "http://google.com"
(Returns an empty content with 200 HTTP status code)

stub_request(:get, "http://google.com").to_return(:body => "boo hoo!")
(Returns boo hoo! as content)

stub_request(:get, "http://google.com").to_return(:body => "boo hoo!", :code => 500)
(Returns boo hoo! as content)

Since currently moxy uses WebMock under the hood (that may change), this will be WebMock's syntax, and you can go learn about it for more examples.

Moxy Console

If you access http://moxy-host:port/__setup__ in your browser, you'll be presented with the moxy console:


Fork, implement, add tests, pull request, get my everlasting thanks and a respectable place here :).

Contributions (Thanks!)

  • github.com/omcnet


Copyright (c) 2011 Dotan Nahum @jondot. See MIT-LICENSE for further details.

moxy questions on Stackoverflow (View All Questions)
  • Building an RCP application with Maven Tycho: EclipseLink Moxy not working
  • Web Service Client using Eclipselink MOXy
  • What is the relationship between Jersey, JAXB, JAX-RS, Moxy, Jackson, EclipseLink Moxy, json and xml?
  • MOXy/JAXB read all attributes into a single map?
  • MOXy exceptions in JavaEE Jersey 2.0 project
  • MOXy: Variable interpolation of XML element values
  • How to generate JAXB external metadata with MOXy compiler
  • Eclipse MOXy XML with attributes from POJO
  • How to generate Java from an XSD using MOXy under Maven-3?
  • JSON unmarshalling using JAX-RS and MOXy
  • Object Mapping for XML - MOXy
  • MOXy - Automatically unmarshal correct class from a list of classes
  • MOXy unmarshalled bean from @PUT is null, depending on JSON property order
  • can XJC ant task using MOXy JAXB Implementation
  • MOXy unmarshaling with base interface - "Missing class indicator field from database row"
  • MOXy DynamicEntity with JSON?
  • JAX-RS: NoSuchMethodFound Exception Jersey-media-moxy JSON
  • Unmarshalling Fails For a Collection of IDREFs When Using Moxy
  • MOXy order of fields in the target Java object matters when unmarshalling
  • EclipseLink MOXy JSON Provider giving ClassCastException
  • Jersey (MOXy) truncating JSON dates
  • Moxy returning null values when used with Jaxb2Marshaller in spring batch
  • How to make EclipseLink MOXy ignore AspectJ fields?
  • Jaxb cycle (infinite loop) marshalling error - MOXy and Spring OXM
  • EclipseLink MOXY JSON Serialization of Polymorphic Collections
  • How to unmarshall JSON array using EclipseLink MOXy JAXB provider
  • Jersey - Moxy returning appended json in class property
  • EclipseLink JAXB (MOXy) unmarshalling map with Serializable value fails to convert
  • Jersey Making Moxy work with Jackson
  • What are the possible types of value an @Xmlpath annotation can have in MOXy
moxy list of languages used
Other projects in Ruby