Giter VIP home page Giter VIP logo

pact-ruby's Introduction

Pact

Test Backers on Open Collective Sponsors on Open Collective

Define a pact between service consumers and providers, enabling "consumer driven contract" testing.

Pact provides a fluent API for service consumers to define the HTTP requests they will make to a service provider and the HTTP responses they expect back. These expectations are used in the consumer specs to provide a mock service provider. The interactions are recorded, and played back in the service provider specs to ensure the service provider actually does provide the response the consumer expects.

This allows testing of both sides of an integration point using fast unit tests.

This gem is inspired by the concept of "Consumer driven contracts". See this article by Ian Robinson for more information.

What is it good for?

Pact is most valuable for designing and testing integrations where you (or your team/organisation/partner organisation) control the development of both the consumer and the provider, and the requirements of the consumer are going to be used to drive the features of the provider. It is fantastic tool for developing and testing intra-organisation microservices.

What is it not good for?

  • Testing new or existing providers where the functionality is not being driven by the needs of the consumer (eg. public APIs)
  • Testing providers where the consumer and provider teams do not have good communication channels.
  • Performance and load testing.
  • Functional testing of the provider - that is what the provider's own tests should do. Pact is about checking the contents and format of requests and responses.
  • Situations where you cannot load data into the provider without using the API that you're actually testing (eg. public APIs). Why?
  • Testing "pass through" APIs, where the provider merely passes on the request contents to a downstream service without validating them. Why?

Features

  • A service is mocked using an actual process running on a specified port, so javascript clients can be tested as easily as backend clients.
  • "Provider states" (similar to fixtures) allow the same request to be made with a different expected response.
  • Consumers specify only the fields they are interested in, allowing a provider to return more fields without breaking the pact. This allows a provider to have a different pact with a different consumer, and know which fields each cares about in a given response.
  • RSpec and Minitest support for the service consumer codebase.
  • Rake tasks allow pacts to be verified against a service provider codebase.
  • Different versions of a consumer/provider pairs can be easily tested against each other, allowing confidence when deploying new versions of each (see the pact_broker and pact_broker-client gems).
  • Autogenerated API documentation - need we say more?
  • Autogenerated network diagrams with the Pact Broker

How does it work?

  1. In the specs for the provider facing code in the consumer project, expectations are set up on a mock service provider.
  2. When the specs are run, the mock service returns the expected responses. The requests, and their expected responses, are then written to a "pact" file.
  3. The requests in the pact file are later replayed against the provider, and the actual responses are checked to make sure they match the expected responses.

Pact explanation diagram

Why is developing and testing with Pact better than using traditional system integration tests?

  • Faster execution.
  • Reliable responses from mock service reduce likelihood of flakey tests.
  • Causes of failure are easier to identify as only one component is being tested at a time.
  • Design of service provider is improved by considering first how the data is actually going to be used, rather than how it is most easily retrieved and serialised.
  • No separate integration environment required for automated integration tests - pact tests run in standalone CI builds.
  • Integration flows that would traditionally require running multiple services at the same time can be broken down and each integration point tested separately.

Getting help

Installation

Add this line to your application's Gemfile:

gem 'pact'
# gem 'pact-consumer-minitest' for minitest

And then execute:

$ bundle

Or install it yourself as:

$ gem install pact

Usage - an example scenario

We're going to write an integration, with Pact tests, between a consumer, the Zoo App, and its provider, the Animal Service. In the Consumer project, we're going to need a model (the Alligator class) to represent the data returned from the Animal Service, and a client (the AnimalServiceClient) which will be responsible for making the HTTP calls to the Animal Service.

Example

In the Zoo App (consumer) project

1. Start with your model

Imagine a model class that looks something like this. The attributes for an Alligator live on a remote server, and will need to be retrieved by an HTTP call to the Animal Service.

class Alligator
  attr_reader :name

  def initialize name
    @name = name
  end

  def == other
    other.is_a?(Alligator) && other.name == name
  end
end

2. Create a skeleton Animal Service client class

Imagine an Animal Service client class that looks something like this.

require 'httparty'

class AnimalServiceClient
  include HTTParty
  base_uri 'http://animal-service.com'

  def get_alligator
    # Yet to be implemented because we're doing Test First Development...
  end
end

3. Configure the mock Animal Service

The following code will create a mock service on localhost:1234 which will respond to your application's queries over HTTP as if it were the real "Animal Service" app. It also creates a mock provider object which you will use to set up your expectations. The method name to access the mock service provider will be what ever name you give as the service argument - in this case "animal_service"

# In /spec/service_providers/pact_helper.rb

require 'pact/consumer/rspec'
# or require 'pact/consumer/minitest' if you are using Minitest

Pact.service_consumer "Zoo App" do
  has_pact_with "Animal Service" do
    mock_service :animal_service do
      port 1234
      host "..." # optional, defaults to "localhost"
    end
  end
end

4. Write a failing spec for the Animal Service client

# In /spec/service_providers/animal_service_client_spec.rb

# When using RSpec, use the metadata `:pact => true` to include all the pact functionality in your spec.
# When using Minitest, include Pact::Consumer::Minitest in your spec.

describe AnimalServiceClient, :pact => true do

  before do
    # Configure your client to point to the stub service on localhost using the port you have specified
    AnimalServiceClient.base_uri 'localhost:1234'
  end

  subject { AnimalServiceClient.new }

  describe "get_alligator" do

    before do
      animal_service.given("an alligator exists").
        upon_receiving("a request for an alligator").
        with(method: :get, path: '/alligator', query: '').
        will_respond_with(
          status: 200,
          headers: {'Content-Type' => 'application/json'},
          body: {name: 'Betty'} )
    end

    it "returns an alligator" do
      expect(subject.get_alligator).to eq(Alligator.new('Betty'))
    end

  end

end

5. Run the specs

Running the AnimalServiceClient spec will generate a pact file in the configured pact dir (spec/pacts by default). Logs will be output to the configured log dir (log by default) that can be useful when diagnosing problems.

Of course, the above specs will fail because the Animal Service client method is not implemented, so next, implement your provider client methods.

6. Implement the Animal Service client consumer methods

class AnimalServiceClient
  include HTTParty
  base_uri 'http://animal-service.com'

  def get_alligator
    name = JSON.parse(self.class.get("/alligator").body)['name']
    Alligator.new(name)
  end
end

7. Run the specs again.

Green! You now have a pact file that can be used to verify your expectations of the Animal Service provider project.

Now, rinse and repeat for other likely status codes that may be returned. For example, consider how you want your client to respond to a:

  • 404 (return null, or raise an error?)
  • 500 (specifying that the response body should contain an error message, and ensuring that your client logs that error message will make your life much easier when things go wrong)
  • 401/403 if there is authorisation.

In the Animal Service (provider) project

1. Create the skeleton API classes

Create your API class using the framework of your choice (the Pact authors have a preference for Webmachine and Roar) - leave the methods unimplemented, we're doing Test First Develoment, remember?

2. Tell your provider that it needs to honour the pact file you made earlier

Require "pact/tasks" in your Rakefile.

# In Rakefile
require 'pact/tasks'

Create a pact_helper.rb in your service provider project. The recommended place is spec/service_consumers/pact_helper.rb.

See Verifying Pacts and the Provider section of the Configuration documentation for more information.

# In spec/service_consumers/pact_helper.rb

require 'pact/provider/rspec'

Pact.service_provider "Animal Service" do

  honours_pact_with 'Zoo App' do

    # This example points to a local file, however, on a real project with a continuous
    # integration box, you would use a [Pact Broker](https://github.com/pact-foundation/pact_broker) or publish your pacts as artifacts,
    # and point the pact_uri to the pact published by the last successful build.

    pact_uri '../zoo-app/spec/pacts/zoo_app-animal_service.json'
  end
end

3. Run your failing specs

$ rake pact:verify

Congratulations! You now have a failing spec to develop against.

At this stage, you'll want to be able to run your specs one at a time while you implement each feature. At the bottom of the failed pact:verify output you will see the commands to rerun each failed interaction individually. A command to run just one interaction will look like this:

$ rake pact:verify PACT_DESCRIPTION="a request for an alligator" PACT_PROVIDER_STATE="an alligator exists"

4. Implement enough to make your first interaction spec pass

Rinse and repeat.

5. Keep going til you're green

Yay! Your Animal Service provider now honours the pact it has with your Zoo App consumer. You can now have confidence that your consumer and provider will play nicely together.

Using provider states

Each interaction in a pact is verified in isolation, with no context maintained from the previous interactions. So how do you test a request that requires data to already exist on the provider? Read about provider states here.

Configuration

See the Configuration section of the documentation for options relating to thing like logging, diff formatting, and documentation generation.

Pact best practices

As in all things, there are good ways to implement Pacts, and there are not so good ways. There are also some Pact GOTCHAS to beware of! Check out the Best practices section of the documentation to make sure you're not Pacting it Wrong.

Current Pact specification version

Currently, Ruby Pact supports writing Pacts in v2, and verifying Pacts in v3 format, HOWEVER it only supports the rules that were defined in v2 (like and term). If you are interested in helping add support for the v3 rules, please talk to @Beth in the #pact-ruby channel on our Slack.

Docs

Related libraries

Pact Provider Proxy - Verify a pact against a running server, allowing you to use pacts with a provider of any language.

Pact Broker - A pact repository. Provides endpoints to access published pacts, meaning you don't need to use messy CI URLs in your codebase. Enables cross testing of prod/head versions of your consumer and provider, allowing you to determine whether the head version of one is compatible with the production version of the other. Helps you to answer that ever so important question, "can I deploy without breaking all the things?"

Pact Broker Client - Contains rake tasks for publishing pacts to the pact_broker.

Shokkenki - Another Consumer Driven Contract gem written by one of Pact's original authors, Brent Snook. Shokkenki allows matchers to be composed using jsonpath expressions and allows auto-generation of mock response values based on regular expressions.

A list of Pact implementations in other languages - JVM, .Net, Javascript and Swift

Links

Simplifying microservices testing with pacts - Ron Holshausen (one of the original pact authors)

Pact specification

Integrated tests are a scam - J.B. Rainsberger

Consumer Driven Contracts - Ian Robinson

Integration Contract Tests - Martin Fowler

Roadmap

See ROADMAP.md.

Contributing

See CONTRIBUTING.md.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

pact-ruby's People

Contributors

abhitrivedi avatar akhil-gautam avatar allavena avatar asaaki avatar benjaminpjacobs avatar bethesque avatar bookofgreg avatar danielheath avatar elgalu avatar ertrzyiks avatar f1337 avatar iamvery avatar jfraser avatar lifeifei avatar maxforasteiro avatar mefellows avatar olleolleolle avatar rafaelgonzalez avatar rashiagarwal avatar readmecritic avatar rhunter avatar sergei-matheson avatar snyk-bot avatar stanhu avatar stuliston avatar taiki45 avatar tancnle avatar thatguysimon avatar vixplows avatar you54f avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

pact-ruby's Issues

Change the request and response validation to use paths mapped to matchers

The current validation of the requests and response bodies is by comparison of the whole expected body. It does allow more to be in the actual body, but it is awkward when the bodies get large.

One idea id to allow paths to be mapped to a matcher. This would work in a XPath or JSON Path style. That way you can have a number of paths to execute the matcher against.

Pact::Terms are visible in the generated docs

"startDate": {
        "json_class": "Pact::Term",
        "data": {
          "generate": "2013-10-01T10:00:00.000Z",
          "matcher": {"json_class":"Regexp","o":0,"s":"\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z"}
        }
      }

It should show the example value.

Support other body types than JSON

Currently Pact assumes everything is JSON.

We need to add a may to transform different mime types into something that can be compared. Initially only JSON and XML need be supported until someone finds a need for another format

Separate pact-server & pact

This would reduce the code size, making it much easier to identify e.g. concurrency bugs in the pact server implementation.

CSV differ

Hi Beth,

I've created a CSV differ for pact.
It doesn't have tests yet and uses cucumber tables for diffing (which seems a little awkward), but it works in manual tests on an adapted example.
Maybe you can have a look if this goes in the right direction.
I don't know how much time I can spend on this, but hopefully get to write some basic tests at least.

Best
Martin

Require a way to validate a pact against a running server

Not all apps are Rack apps. Sometimes we have integration points with servers outside our control.

We should allow the Pact verification to hit a running server instead of starting up a Rack app.

Two ideas:
Maybe the Pact.service_provider configuration could have a URL configuration instead of an app?

Pact.service_provider "Horrific Monolith" do
    base_url "http://blah"

   honours_pact_with ...
end

Or maybe just a rake task, seeing as you probably won't have an actual ruby project to run it in.

Pact::RunningAppVerificationTask.new do | task |
  task.pact_uri = "./spec/pacts/my-consumer_horrific_monolith.json"
  task.app_base_url = "http://blah"
end

Add warning when no expectations are made of the response body for a post/put/patch

Each interaction is tested in isolation, meaning you can't do a PUT/POST/PATCH, and then follow it with a GET to ensure that the values you sent were actually read successfully by the provider. If you send a lastname instead of a surname field, a provider will most likely ignore the misnamed field, and return a 200, failing to alert you to the fact that your lastname has gone to the big /dev/null in the sky.

The code should warn you when a POST/PUT/PATCH request is defined, with a non-empty body, that does not make any expectations about the response.

Running pact with existing contact

Ok following my twitter conversation that is probably better place to have proper discussion.
The scenario I have is the following

  1. I generate contracts based on my consumer/service_providers/service_spec.rb
  2. I would like to be able to use generated contracts to run set of tests(JS) using pact as replacement for real service. I figured out how to make pact run but it does not load any interactions.
    I have already generated the contract why can't we just add an option --contract so that server loads interactions from contract. They are generated from expected interactions so there should be a way to get expected interaction back from them.

Example of how TW does something similar -> https://github.com/thoughtworks/pacto#pacto-server-non-ruby-usage
As extra benefit that way pact can be used with any language at least to perform stubbing

Authentication tokens/step in pact.

So at the moment we are having to modify the pact.json files before running pact. This is for inserting authentication tokens with expiry in about 2 hours into the pacts.

pacts = File.join(File.dirname(File.expand_path(__FILE__)), '../src/test/resources/pacts/*.json')
Dir.glob(pacts).each do |f|
  text = File.read(f)
  output_of_gsub = text.gsub(/\"Authorization\"\s*:\s*\".+\"/) { "\"Authorization\": \"ioof-token #{token}\"" }
  File.open(f, "w") { |file| file.puts output_of_gsub }
end

It would be good to be able to nicely insert/modify headers of the request before they are sent without modifying the pact files.

Cheers,

Allow rspec methods to be used within provider state blocks

I'd like to be able to use the new RSpec syntax while setting up provider states.

For example:

provider_state "some state exists" do
  set_up do
    allow(Foo).to receive(:bar).and_return('baz')
  end
end

The current workaround for this is simply to use the older deprecated RSpec syntax.

provider_state "some state exists" do
  set_up do
    Foo.stub(:bar).and_return('baz')
  end
end

Pact::Term displays incorrectly in pact:verify output in 1.1.0.rc1

It should show the regular expression, not the json.

     Failure/Error: expect(response_body).to match_term expected_response_body
       {
         "_links": {
           "expected": {
             "self": {
               "href": {
                 "json_class": "Pact::Term",
                 "data": {
                   "generate": "http://localhost:1234/pacticipants/Condor/versions/1.3.0/tags/prod",
                   "matcher": {
                     "json_class": "Regexp",
                     "o": 0,
                     "s": "http://.*/pacticipants/Condor/versions/1.3.0/tags/prod"
                   }
                 }
               }
             }
           },
           "actual": "<key not found>"
         }
       }

Absolute URLs in responses

Hey folks,

We've got a server here which is generating a HAL response with absolute URLs. We're hitting a bit of a chicken and the egg problem, and I'm wondering if anyone has any suggestions (or if we're just doing something stupid).

  • When running the specs with the mock server, the server is running on localhost:1234. The server uses req.host to generate absolute urls, which results in a HAL response containing http://localhost:1234/v1/blah. These urls are recorded in the pact.
  • When verifying the pact, the requests are made with a Host header of example.org which obviously causes the server to respond with http://example.org/v1/blah, violating the pact.

I've tried not using req.host to generate the URL and instead making it a config setting for the app; however, the problem still exists that the mock server needs to listen on localhost:1234.

Ultimately, there always seems to be a mismatch between the hostname of the mock server, and the server the verification is being run against.

Any suggestions? Am I missing something obvious here?

For HAL responses, should pact mock service url "localhost:1234" be displayed in generated documentation?

When using a Pact::Term.new(generate: "http://localhost:1234/some-path", matcher: %r{http://.*/some-path})
Or should it be replaced with example.org? Or the regexp?

{
  "status": 200,
  "headers": {
    "Content-Type": "application/hal+json"
  },
  "body": {
    "_links": {
      "some-resource": {
        "href": "http://localhost:1234/some-resource"
      }
    }
  }
}

or

{
  "status": 200,
  "headers": {
    "Content-Type": "application/hal+json"
  },
  "body": {
    "_links": {
      "some-resource": {
        "href": "http://example.org/some-resource"
      }
    }
  }
}

or

{
  "status": 200,
  "headers": {
    "Content-Type": "application/hal+json"
  },
  "body": {
    "_links": {
      "some-resource": {
        "href": "http:\/\/.*/some-resource"
      }
    }
  }
}

Thoughts:
Regular expressions can be hard to read, example data is more meaningful, especially for something like a timestamp.

Display request diffs in after hook for consumer

Current message

An error occurred in an after hook
  RuntimeError: Actual interactions do not match expected interactions for mock XXX.

Incorrect requests:
    POST /xxx (request body did not match)

See log/xxx_mock_service.log for details.

Showing diffs here would be easier than traipsing through logs.

Create pact init

Submit PRs to: https://github.com/bethesque/pact-init-consumer

pact-init-consumer --consumer "My Consumer" --provider "My Provider" should create
spec/service_providers/pact_helper.rb

require 'pact/consumer/rspec'

Pact.service_consumer 'My Consumer' do
  has_pact_with 'My Provider' do
    mock_service :my_provider do
      port 1234
    end
  end
end

--consumer and --provider should be optional, and if no values are given use "My Consumer" and "My Provider".

Submit PRs to: https://github.com/bethesque/pact-init-provider
pact-init-provider --provider "My Provider" --consumer "My Consumer" should create
spec/service_consumers/pact_helper.rb

require 'pact/provider/rspec'
require "service_consumers/provider_states_for_my_consumer"

Pact.service_provider 'My Provider' do
  honours_pact_with 'My Consumer' do
    pact_uri ''
  end
end

spec/service_consumers/provider_states_for_my_consumer.rb

Pact.provider_states_for 'My Consumer' do
  provider_state 'there is a thing' do
    set_up do
      # Set up the provider state here (eg. insert record into a database)
    end
  end
end

Headers are modified when they shouldn't be

When using custom headers (Blah-Blah-Blah) all dashes are re-written as underscores (Blah_Blah_Blah).

Consumer tests correctly validate against dashes in the request, but when they're replayed back against the provider the headers get changed. Either the consumer tests should rewrite the headers to use underscores or the provider side shouldn't change the request. As it stands currently tests on one side will pass and the other will fail even though the specification is correct.

Set order of interactions in pact file

When rspec runs with random order, the interactions are added to the pact file in the random order, and hence, the pact file changes significantly each time, and it is hard to see what the actual genuine changes are. Allow the order of the interactions to be written consistently.

Message for duplicate interaction should specify that the headers/body/path are differerent

RuntimeError:
       Interaction with same description (a request retrieve a committed revenue sync) and provider state (a committed-revenue-sync exists with ID 123) already exists

Duplicate description/provider state is allowed so long as the entire interaction itself is identical.

Suggested new message:

An interaction with same description (a request retrieve a committed revenue sync) and provider state (a committed-revenue-sync exists with ID 123) has already been used, however, its has different request and/or response details. Please use a new description or provider state.

Duplicate detection failing with SomethingLike

I mentioned on the mailing list that setting up an identical second interaction was being rejected when it contained a Pact::SomethingLike, but not when it contained a Pact::Term.

This is the track the issue.

I have not yet reproduced it on a small example, however, I have just noticed that in the json pact file, the Pact::SomethingLike is serialised to "amount": "#Pact::SomethingLike:0x00000002b10d58"
whereas the Pact::Term is correctly serialised to
"myobject": {
"json_class": "Pact::Term",
"data": {
"generate": "123",
"matcher": {
"json_class": "Regexp",
"o": 0,
"s": "\d+"
}
}
},

In my existing case, this is in the response body, a few level down in a hash, along the lines of:
body: {
data: {
embeded_data: {
name: Pact::Term(...)
}
}
info: {
amount: Pact::SomethingLike("20.00")
}
}

Maybe something is going wrong with a serialisation of Pact::SomethingLike when it's embedded a few level down in a hash.

Support hashes for query param matching

I currently have a requirement to match a request with three query string parameters and at the moment the only way I can do this is to match the whole query string with the parameters in the "correct order" as per what is actually sent:

  describe "fetching updated agencies" do
    before do
      cp_services
        .given("an updated agency")
        .upon_receiving("a request for updated agencies")
        .with( method: :get, path: '/services/agencies', query: "updated_from=#{updated_from}&per_page=#{per_page}&api_key=#{api_key}" )

What I'd like to do is something like this:

  describe "fetching updated agencies" do
    before do
      cp_services
        .given("an updated agency")
        .upon_receiving("a request for updated agencies")
        .with( method: :get, path: '/services/agencies', query: { updated_from: updated_from, per_page: per_page, api_key: api_key } )

We can already do this sort of thing with HTTP headers so it would only make sense to make them work the same way

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.