patron 0.3.2

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2008 The Hive http://www.thehive.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.txt

@@ -0,0 +1,56 @@
+= Ruby HTTP Client
+
+== SYNOPSIS
+
+Patron is a Ruby HTTP client library based on libcurl. It does not try to expose
+the full "power" (read complexity) of libcurl but instead tries to provide a
+sane API while taking advantage of libcurl under the hood.
+
+
+== USAGE
+
+Usage is very simple. First, you instantiate a Session object. You can set a few
+default options on the Session instance that will be used by all subsequent
+requests:
+
+    sess = Patron::Session.new
+    sess.timeout = 10
+    sess.base_url = "http://myserver.com:9900"
+    sess.headers['User-Agent'] = 'myapp/1.0'
+
+The Session is used to make HTTP requests.
+
+    resp = sess.get("/foo/bar")
+
+Requests return a Response object:
+
+    if resp.status < 400
+      puts resp.body
+    end
+
+The GET, HEAD, PUT, POST and DELETE operations are all supported.
+
+    sess.put("/foo/baz", "some data")
+    sess.delete("/foo/baz")
+
+You can ship custom headers with a single request:
+
+    sess.post("/foo/stuff", "some data", {"Content-Type" => "text/plain"})
+
+That is pretty much all there is to it.
+
+
+== REQUIREMENTS
+
+You need a recent version of libcurl in order to install this gem. On MacOS X
+the provided libcurl is sufficient. You will have to install the libcurl
+development packages on Debian or Ubuntu. Other Linux systems are probably
+similar. Windows users are on your own. Good luck with that.
+
+
+== INSTALL
+
+  sudo gem install patron
+
+
+Copyright (c) 2008 The Hive

data/Rakefile

@@ -0,0 +1,150 @@
+## -------------------------------------------------------------------
+##
+## Copyright (c) 2008 The Hive http://www.thehive.com/
+##
+## Permission is hereby granted, free of charge, to any person obtaining a copy
+## of this software and associated documentation files (the "Software"), to deal
+## in the Software without restriction, including without limitation the rights
+## to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+## copies of the Software, and to permit persons to whom the Software is
+## furnished to do so, subject to the following conditions:
+##
+## The above copyright notice and this permission notice shall be included in
+## all copies or substantial portions of the Software.
+##
+## THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+## IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+## FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+## AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+## LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+## OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+## THE SOFTWARE.
+##
+## -------------------------------------------------------------------
+require 'yaml'
+require 'rake/clean'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+require 'jeweler'
+
+require 'rbconfig'
+include Config
+
+EXT_DIR     = 'ext/patron'
+SESSION_SO  = "#{EXT_DIR}/session_ext.#{CONFIG['DLEXT']}"
+SESSION_SRC = "#{EXT_DIR}/session_ext.c"
+
+CLEAN.include FileList["#{EXT_DIR}/*"].exclude(/^.*\.(rb|c)$/)
+CLOBBER.include %w( doc coverage pkg )
+
+module Git
+  class Lib
+    def tag(tag)
+      # Force an annotated tag
+      command('tag', [tag, '-a', '-m', tag])
+    end
+  end
+end
+
+Jeweler::Tasks.new do |s|
+  s.name              = 'patron'
+  s.platform          = Gem::Platform::RUBY
+  s.author            = 'Phillip Toland'
+  s.email             = 'phil.toland@gmail.com'
+  s.homepage          = 'http://github.com/toland/Patron'
+  s.rubyforge_project = 'patron'
+  s.summary           = 'Patron HTTP client'
+  s.description       = 'Ruby HTTP client library based on libcurl'
+
+  s.extensions    << 'ext/patron/extconf.rb'
+  s.require_paths << 'ext'
+
+  s.files = FileList['README.txt',
+                     'LICENSE',
+                     'Rakefile',
+                     'lib/**/*',
+                     'spec/*',
+                     'ext/patron/*.{rb,c}']
+
+  # rdoc
+  s.has_rdoc         = true
+  s.extra_rdoc_files = ['README.txt']
+  s.rdoc_options     = ['--quiet',
+                        '--title', "Patron documentation",
+                        '--opname', 'index.html',
+                        '--line-numbers',
+                        '--main', 'README.txt',
+                        '--inline-source']
+end
+
+file SESSION_SO => SESSION_SRC do
+  cd EXT_DIR do
+    ruby 'extconf.rb'
+    sh 'make'
+  end
+end
+
+desc "Compile extension"
+task :compile => SESSION_SO
+
+desc "Start an IRB shell"
+task :shell => :compile do
+  sh 'irb -I./lib -I./ext -r patron'
+end
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title = "Patron documentation"
+  rdoc.main = 'README.txt'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.txt')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Run specs"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+task :spec => [:compile]
+
+desc "Run specs with RCov"
+Spec::Rake::SpecTask.new('spec:rcov') do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+  t.rcov_opts << '--sort coverage'
+  t.rcov_opts << '--comments'
+  t.rcov_opts << '--exclude spec'
+  t.rcov_opts << '--exclude lib/magneto.rb'
+  t.rcov_opts << '--exclude /Library/Ruby/Gems'
+end
+
+# Rubyforge tasks
+begin
+  require 'rake/contrib/sshpublisher'
+  namespace :rubyforge do
+
+    desc "Release gem and RDoc documentation to RubyForge"
+    task :release => ["rubyforge:release:gem", "rubyforge:release:docs"]
+
+    namespace :release do
+      desc "Publish RDoc to RubyForge."
+      task :docs => [:rdoc] do
+        config = YAML.load(
+            File.read(File.expand_path('~/.rubyforge/user-config.yml'))
+        )
+
+        host = "#{config['username']}@rubyforge.org"
+        remote_dir = "/var/www/gforge-projects/patron/"
+        local_dir = 'rdoc'
+
+        Rake::SshDirPublisher.new(host, remote_dir, local_dir).upload
+      end
+    end
+  end
+rescue LoadError
+  puts "Rake SshDirPublisher is unavailable or your rubyforge environment is not configured."
+end
+
+task :default => :spec

data/ext/patron/extconf.rb

@@ -0,0 +1,43 @@
+## -------------------------------------------------------------------
+##
+## Copyright (c) 2008 The Hive http://www.thehive.com/
+##
+## Permission is hereby granted, free of charge, to any person obtaining a copy
+## of this software and associated documentation files (the "Software"), to deal
+## in the Software without restriction, including without limitation the rights
+## to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+## copies of the Software, and to permit persons to whom the Software is
+## furnished to do so, subject to the following conditions:
+##
+## The above copyright notice and this permission notice shall be included in
+## all copies or substantial portions of the Software.
+##
+## THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+## IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+## FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+## AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+## LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+## OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+## THE SOFTWARE.
+##
+## -------------------------------------------------------------------
+require 'mkmf'
+require 'rbconfig'
+
+if find_executable('curl-config')
+  $CFLAGS << " #{`curl-config --cflags`.strip}"
+  $LIBS << " #{`curl-config --libs`.strip}"
+elsif !have_library('curl') or !have_header('curl/curl.h')
+  fail <<-EOM
+  Can't find libcurl or curl/curl.h
+
+  Try passing --with-curl-dir or --with-curl-lib and --with-curl-include
+  options to extconf.
+  EOM
+end
+
+if CONFIG['CC'] =~ /gcc/
+  $CFLAGS << ' -Wall'
+end
+
+create_makefile 'patron/session_ext'

data/ext/patron/session_ext.c

@@ -0,0 +1,357 @@
+// -------------------------------------------------------------------
+//
+// Patron HTTP Client: Interface to libcurl
+// Copyright (c) 2008 The Hive http://www.thehive.com/
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+//
+// -------------------------------------------------------------------
+#include <ruby.h>
+#include <curl/curl.h>
+
+static VALUE mPatron = Qnil;
+static VALUE cSession = Qnil;
+static VALUE ePatronError = Qnil;
+static VALUE eUnsupportedProtocol = Qnil;
+static VALUE eURLFormatError = Qnil;
+static VALUE eHostResolutionError = Qnil;
+static VALUE eConnectionFailed = Qnil;
+static VALUE ePartialFileError = Qnil;
+static VALUE eTimeoutError = Qnil;
+static VALUE eTooManyRedirects = Qnil;
+
+
+struct curl_state {
+  CURL* handle;
+  char* upload_buf;
+  char error_buf[CURL_ERROR_SIZE];
+  struct curl_slist* headers;
+};
+
+
+//------------------------------------------------------------------------------
+// Curl Callbacks
+//
+
+// Takes data streamed from libcurl and writes it to a Ruby string buffer.
+static size_t session_write_handler(char* stream, size_t size, size_t nmemb, VALUE out) {
+  rb_str_buf_cat(out, stream, size * nmemb);
+  return size * nmemb;
+}
+
+static size_t session_read_handler(char* stream, size_t size, size_t nmemb, char **buffer) {
+  size_t result = 0;
+
+  if (buffer != NULL && *buffer != NULL) {
+      int len = size * nmemb;
+      char *s1 = strncpy(stream, *buffer, len);
+      result = strlen(s1);
+      *buffer += result;
+  }
+
+  return result;
+}
+ 
+//------------------------------------------------------------------------------
+// Object allocation
+//
+
+// Cleans up the Curl handle when the Session object is garbage collected.
+void session_free(struct curl_state *curl) {
+  curl_easy_cleanup(curl->handle);
+  free(curl);
+}
+
+// Allocates curl_state data needed for a new Session object.
+VALUE session_alloc(VALUE klass) {
+  struct curl_state* curl;
+  VALUE obj = Data_Make_Struct(klass, struct curl_state, NULL, session_free, curl);
+  return obj;
+}
+
+
+//------------------------------------------------------------------------------
+// Method implementations
+//
+
+// Returns the version of the embedded libcurl as a string.
+VALUE libcurl_version(VALUE klass) {
+  char* value = curl_version();
+  return rb_str_new2(value);
+}
+
+// Initializes the libcurl handle on object initialization.
+// NOTE: This must be called from Session#initialize.
+VALUE session_ext_initialize(VALUE self) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  state->handle = curl_easy_init();
+
+  return self;
+}
+
+// URL escapes the provided string.
+VALUE session_escape(VALUE self, VALUE value) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  VALUE string = StringValue(value);
+  char* escaped = curl_easy_escape(state->handle,
+                                   RSTRING_PTR(string),
+                                   RSTRING_LEN(string));
+
+  VALUE retval = rb_str_new2(escaped);
+  curl_free(escaped);
+
+  return retval;
+}
+
+// Unescapes the provided string.
+VALUE session_unescape(VALUE self, VALUE value) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  VALUE string = StringValue(value);
+  char* unescaped = curl_easy_unescape(state->handle,
+                                       RSTRING_PTR(string),
+                                       RSTRING_LEN(string),
+                                       NULL);
+
+  VALUE retval = rb_str_new2(unescaped);
+  curl_free(unescaped);
+
+  return retval;
+}
+
+// Callback used to iterate over the HTTP headers and store them in an slist.
+static VALUE each_http_header(VALUE header, VALUE self) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  VALUE name = rb_obj_as_string(rb_ary_entry(header, 0));
+  VALUE value = rb_obj_as_string(rb_ary_entry(header, 1));
+
+  VALUE header_str = Qnil;
+  header_str = rb_str_plus(name, rb_str_new2(": "));
+  header_str = rb_str_plus(header_str, value);
+
+  state->headers = curl_slist_append(state->headers, StringValuePtr(header_str));
+  return Qnil;
+}
+
+// Set the options on the Curl handle from a Request object. Takes each field
+// in the Request object and uses it to set the appropriate option on the Curl
+// handle.
+void set_options_from_request(VALUE self, VALUE request) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  CURL* curl = state->handle;
+
+  ID action = SYM2ID(rb_iv_get(request, "@action"));
+  if (action == rb_intern("get")) {
+    curl_easy_setopt(curl, CURLOPT_HTTPGET, 1);
+  } else if (action == rb_intern("post")) {
+    VALUE data = rb_iv_get(request, "@upload_data");
+
+    state->upload_buf = StringValuePtr(data);
+    int len = RSTRING_LEN(data);
+
+    curl_easy_setopt(curl, CURLOPT_POST, 1);
+    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, state->upload_buf);
+    curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, len);
+  } else if (action == rb_intern("put")) {
+    VALUE data = rb_iv_get(request, "@upload_data");
+
+    state->upload_buf = StringValuePtr(data);
+    int len = RSTRING_LEN(data);
+
+    curl_easy_setopt(curl, CURLOPT_UPLOAD, 1);
+    curl_easy_setopt(curl, CURLOPT_READFUNCTION, &session_read_handler);
+    curl_easy_setopt(curl, CURLOPT_READDATA, &state->upload_buf);
+    curl_easy_setopt(curl, CURLOPT_INFILESIZE, len);
+  } else if (action == rb_intern("delete")) {
+    curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
+  } else if (action == rb_intern("head")) {
+    curl_easy_setopt(curl, CURLOPT_NOBODY, 1);
+  }
+
+  curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, state->error_buf);
+
+  VALUE url = rb_iv_get(request, "@url");
+  if (NIL_P(url)) {
+    rb_raise(rb_eArgError, "Must provide a URL");
+  }
+  curl_easy_setopt(curl, CURLOPT_URL, StringValuePtr(url));
+
+  VALUE timeout = rb_iv_get(request, "@timeout");
+  if (!NIL_P(timeout)) {
+    curl_easy_setopt(curl, CURLOPT_TIMEOUT, FIX2INT(timeout));
+  }
+
+  timeout = rb_iv_get(request, "@connect_timeout");
+  if (!NIL_P(timeout)) {
+    curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT_MS, FIX2INT(timeout));
+  }
+
+  VALUE redirects = rb_iv_get(request, "@max_redirects");
+  if (!NIL_P(redirects)) {
+    int r = FIX2INT(redirects);
+    curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, r == 0 ? 0 : 1);
+    curl_easy_setopt(curl, CURLOPT_MAXREDIRS, r);
+  }
+
+  VALUE headers = rb_iv_get(request, "@headers");
+  if (!NIL_P(headers)) {
+    if (rb_type(headers) != T_HASH) {
+      rb_raise(rb_eArgError, "Headers must be passed in a hash.");
+    }
+
+    rb_iterate(rb_each, headers, each_http_header, self);
+  }
+
+  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, state->headers);
+
+  VALUE credentials = rb_funcall(request, rb_intern("credentials"), 0);
+  if (!NIL_P(credentials)) {
+    curl_easy_setopt(curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+    curl_easy_setopt(curl, CURLOPT_USERPWD, StringValuePtr(credentials));
+  }
+}
+
+// Use the info in a Curl handle to create a new Response object.
+VALUE create_response(CURL* curl) {
+  VALUE response = rb_class_new_instance(0, 0,
+                      rb_const_get(mPatron, rb_intern("Response")));
+
+  char* url = NULL;
+  curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_URL, &url);
+  rb_iv_set(response, "@url", rb_str_new2(url));
+
+  long code = 0;
+  curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code);
+  rb_iv_set(response, "@status", INT2NUM(code));
+
+  long count = 0;
+  curl_easy_getinfo(curl, CURLINFO_REDIRECT_COUNT, &count);
+  rb_iv_set(response, "@redirect_count", INT2NUM(count));
+
+  return response;
+}
+
+// Raise an exception based on the Curl error code.
+VALUE select_error(CURLcode code) {
+  VALUE error = Qnil;
+  switch (code) {
+    case CURLE_UNSUPPORTED_PROTOCOL:  error = eUnsupportedProtocol; break;
+    case CURLE_URL_MALFORMAT:         error = eURLFormatError;      break;
+    case CURLE_COULDNT_RESOLVE_HOST:  error = eHostResolutionError; break;
+    case CURLE_COULDNT_CONNECT:       error = eConnectionFailed;    break;
+    case CURLE_PARTIAL_FILE:          error = ePartialFileError;    break;
+    case CURLE_OPERATION_TIMEDOUT:    error = eTimeoutError;        break;
+    case CURLE_TOO_MANY_REDIRECTS:    error = eTooManyRedirects;    break;
+
+    default: error = ePatronError;
+  }
+
+  return error;
+}
+
+// Perform the actual HTTP request by calling libcurl.
+static VALUE perform_request(VALUE self) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  CURL* curl = state->handle;
+
+  // headers
+  VALUE header_buffer = rb_str_buf_new(32768);
+  curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, &session_write_handler);
+  curl_easy_setopt(curl, CURLOPT_HEADERDATA, header_buffer);
+
+  // body
+  VALUE body_buffer = rb_str_buf_new(32768);
+  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, &session_write_handler);
+  curl_easy_setopt(curl, CURLOPT_WRITEDATA, body_buffer);
+
+  CURLcode ret = curl_easy_perform(curl);
+  if (CURLE_OK == ret) {
+    VALUE response = create_response(curl);
+    rb_iv_set(response, "@body", body_buffer);
+    rb_funcall(response, rb_intern("parse_headers"), 1, header_buffer);
+    return response;
+  } else {
+    rb_raise(select_error(ret), state->error_buf);
+  }
+}
+
+// Cleanup after each request by resetting the Curl handle and deallocating all
+// request related objects such as the header slist.
+static VALUE cleanup(VALUE self) {
+  struct curl_state *state;
+  Data_Get_Struct(self, struct curl_state, state);
+
+  curl_easy_reset(state->handle);
+
+  if (state->headers) {
+    curl_slist_free_all(state->headers);
+    state->headers = NULL;
+  }
+
+  state->upload_buf = NULL;
+
+  return Qnil;
+}
+
+VALUE session_handle_request(VALUE self, VALUE request) {
+  set_options_from_request(self, request);
+  return rb_ensure(&perform_request, self, &cleanup, self);
+}
+
+//------------------------------------------------------------------------------
+// Extension initialization
+//
+
+void Init_session_ext() {
+  curl_global_init(CURL_GLOBAL_NOTHING);
+  rb_require("patron/error");
+
+  mPatron = rb_define_module("Patron");
+
+  ePatronError = rb_const_get(mPatron, rb_intern("Error"));
+
+  eUnsupportedProtocol = rb_const_get(mPatron, rb_intern("UnsupportedProtocol"));
+  eURLFormatError = rb_const_get(mPatron, rb_intern("URLFormatError"));
+  eHostResolutionError = rb_const_get(mPatron, rb_intern("HostResolutionError"));
+  eConnectionFailed = rb_const_get(mPatron, rb_intern("ConnectionFailed"));
+  ePartialFileError = rb_const_get(mPatron, rb_intern("PartialFileError"));
+  eTimeoutError = rb_const_get(mPatron, rb_intern("TimeoutError"));
+  eTooManyRedirects = rb_const_get(mPatron, rb_intern("TooManyRedirects"));
+
+  rb_define_module_function(mPatron, "libcurl_version", libcurl_version, 0);
+
+  cSession = rb_define_class_under(mPatron, "Session", rb_cObject);
+  rb_define_alloc_func(cSession, session_alloc);
+
+  rb_define_method(cSession, "ext_initialize", session_ext_initialize, 0);
+  rb_define_method(cSession, "escape",         session_escape,         1);
+  rb_define_method(cSession, "unescape",       session_unescape,       1);
+  rb_define_method(cSession, "handle_request", session_handle_request, 1);
+}