patron-new 0.4.19

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: faae4f5916e996609a897c58b816eb85aefa4aaa
+  data.tar.gz: f235825bd133b963b32b4be53e3598667fef273b
+SHA512:
+  metadata.gz: b0014227c16f760d95788d885eeef6be92a54545e4a6f139d3555909cf3afe689246bcfc13162b394da6bfc8520d2da71617a3f5e965e858b4b1eaedc7af1392
+  data.tar.gz: 28659d63080f4da203e39bca65bd828a1dbf84100ef09618928ec291bbfc3dc618e57e229982a8008f0d7fba0bb6b695d697c3d9a0f930976e2e08c92ed42784

data/.autotest

@@ -0,0 +1,15 @@
+Autotest.add_hook :initialize do |at|
+  at.clear_mappings
+
+  at.add_mapping(%r{^spec/.+_spec\.rb$}) do |filename,_|
+    filename
+  end
+
+  at.add_mapping(%r{^lib/patron/(.+)\.rb$}) do |_,match|
+    [ "spec/#{match[1]}_spec.rb" ]
+  end
+
+  at.add_mapping(%r{^spec/spec_helper\.rb$}) do
+    at.files_matching(%r{^spec/.+_spec\.rb$})
+  end
+end

data/.gitignore

@@ -0,0 +1,8 @@
+.rbenv*
+.rvmrc
+*.bundle
+coverage
+rdoc
+doc
+pkg
+tmp

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Gemfile.lock

@@ -0,0 +1,31 @@
+PATH
+  remote: .
+  specs:
+    patron (0.4.18)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    rake (0.9.2.2)
+    rake-compiler (0.7.9)
+      rake
+    rcov (0.9.11)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  patron!
+  rake-compiler (>= 0.7.5)
+  rcov (>= 0.9.9)
+  rspec (>= 2.3.0)

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,57 @@
+= 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'
+    sess.enable_debug "/tmp/patron.debug"
+
+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,69 @@
+## -------------------------------------------------------------------
+##
+## 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 'rake/clean'
+require 'rake/rdoctask'
+require 'rake/extensiontask'
+require 'rspec/core/rake_task'
+require 'bundler'
+
+Rake::ExtensionTask.new do |ext|
+  ext.name = 'session_ext'           # indicate the name of the extension.
+  ext.ext_dir = 'ext/patron'         # search for 'hello_world' inside it.
+  ext.lib_dir = 'lib/patron'         # put binaries into this folder.
+end
+
+Bundler::GemHelper.install_tasks
+
+CLEAN.include FileList["ext/patron/*"].exclude(/^.*\.(rb|c|h)$/)
+CLOBBER.include %w( doc coverage pkg )
+
+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 = 'rdoc'
+  rdoc.title = 'Patron documentation'
+  rdoc.main = 'README.txt'
+  rdoc.rdoc_files.include('README.txt')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts = %w( --colour --format progress )
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task :spec => [:compile]
+
+desc "Run specs with RCov"
+RSpec::Core::RakeTask.new('spec:rcov') do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.rcov = true
+  t.rcov_opts = %q(--sort coverage --comments --exclude "spec")
+end
+
+task :default => :spec

data/ext/patron/.gitignore

@@ -0,0 +1,4 @@
+*.bundle
+*.o
+mkmf.log
+Makefile

data/ext/patron/extconf.rb

@@ -0,0 +1,49 @@
+## -------------------------------------------------------------------
+##
+## 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'
+
+dir_config('curl')
+
+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 << ' -pedantic -Wall'
+end
+
+$defs.push("-DUSE_TBR")
+$defs.push("-DHAVE_TBR") if have_func('rb_thread_blocking_region')
+
+create_makefile 'patron/session_ext'

data/ext/patron/membuffer.c

@@ -0,0 +1,85 @@
+#include <ruby.h>
+#include <assert.h>
+#include "membuffer.h"
+
+#define DEFAULT_CAPACITY  4096
+#define MAXVAL(a, b) ((a) > (b) ? (a) : (b))
+
+static int membuffer_ensure_capacity( membuffer* m, size_t length ) {
+  size_t new_capacity;
+  char* tmp_buf;
+
+  if (m->capacity >= length) { return MB_OK; }
+
+  new_capacity = MAXVAL(m->capacity, DEFAULT_CAPACITY);
+  while (new_capacity < length) { new_capacity *= 2; }
+
+  tmp_buf = ruby_xrealloc(m->buf, new_capacity+1);
+  if (NULL == tmp_buf) { return MB_OUT_OF_MEMORY; }
+  else {
+    m->buf = tmp_buf;
+    m->capacity = new_capacity;
+  }
+
+  return MB_OK;
+}
+
+void membuffer_init( membuffer* m ) {
+  assert(NULL != m);
+
+  m->buf = NULL;
+  m->length = 0;
+  m->capacity = 0;
+}
+
+void membuffer_destroy( membuffer* m ) {
+  if (NULL == m) { return; }
+
+  if (NULL != m->buf) { ruby_xfree(m->buf); }
+  m->buf = NULL;
+  m->length = 0;
+  m->capacity = 0;
+}
+
+void membuffer_clear( membuffer* m ) {
+  assert(NULL != m);
+
+  if (NULL != m->buf) {
+    memset(m->buf, 0, m->capacity+1);
+    m->length = 0;
+  }
+}
+
+int membuffer_insert( membuffer* m, size_t index, const void* src, size_t length ) {
+  int rc = MB_OK;
+  assert(NULL != m);
+
+  /* sanity checks on the inputs */
+  if (index > m->length) { return MB_OUT_OF_BOUNDS; }
+  if (NULL == src || 0 == length) { return MB_OK; }
+
+  /* increase capacity if needed */
+  rc = membuffer_ensure_capacity( m, m->length + length );
+  if (MB_OK != rc) { return rc; }
+
+  /* move data in the buffer to the right of the insertion point */
+  memmove( m->buf + index + length, m->buf + index, m->length - index );
+
+  /* copy date into the insertion point */
+  memcpy( m->buf + index, src, length );
+  m->length += length;
+  m->buf[m->length] = 0;  /* null terminate the buffer */
+
+  return MB_OK;
+}
+
+int membuffer_append( membuffer* m, const void* src, size_t length ) {
+  assert(NULL != m);
+  return membuffer_insert( m, m->length, src, length );
+}
+
+VALUE membuffer_to_rb_str( membuffer* m ) {
+  assert(NULL != m);
+  return rb_str_new(m->buf, m->length);
+}
+

data/ext/patron/membuffer.h

@@ -0,0 +1,78 @@
+
+#ifndef PATRON_MEMBUFER_H
+#define PATRON_MEMBUFER_H
+
+#include <stdlib.h>
+
+#define MB_OK             0
+#define MB_OUT_OF_MEMORY  1
+#define MB_OUT_OF_BOUNDS  2
+
+/**
+ * Implementation of a simple memory buffer for collecting the response body
+ * and headers from a curl request. The memory buffer will grow to accomodate
+ * the data inserted into it.
+ *
+ * When the memory buffer needs more capacity, it will reallocate memory from
+ * the heap. It will request twice it's current capacity.
+ */
+typedef struct {
+  char    *buf;
+  size_t   length;
+  size_t   capacity;
+} membuffer;
+
+/**
+ * Initialize the memory buffer by setting default values of 0 for the length
+ * and capacity.
+ */
+void membuffer_init( membuffer* m );
+
+/**
+ * Free any memory used by the memory buffer.
+ */
+void membuffer_destroy( membuffer* m );
+
+/**
+ * Clear the contents of the memory buffer. The length will be set to zero,
+ * but the capacity will remain unchanged - i.e. memory will not be freed by
+ * his method.
+ */
+void membuffer_clear( membuffer* m );
+
+/**
+ * Attempt to insert the given _src_ data into the memory buffer at the given
+ * _index_. This method will shift data in the memory buffer to the right in
+ * order to insert the _src_ data.
+ *
+ * This method will fail if the _index_ is out of bounds for the memory
+ * buffer, if the _src_ is NULL or the _length_ to insert is 0. This method
+ * can also fail if the memory buffer needs to expand it's capacity but no
+ * memory is available.
+ *
+ * Return Codes:
+ *   MB_OK
+ *   MB_OUT_OF_MEMORY
+ *   MB_OUT_OF_BOUNDS
+ */
+int membuffer_insert( membuffer* m, size_t index, const void* src, size_t length );
+
+/**
+ * Append the given _src_ data to the end of the memory buffer. This method
+ * calls `membuffer_insert` to append the data.
+ *
+ * Return Codes:
+ *   MB_OK
+ *   MB_OUT_OF_MEMORY
+ */
+int membuffer_append( membuffer* m, const void* src, size_t length );
+
+/**
+ * Convert the memory buffer into a Ruby String instance. This method will
+ * return an empty String instance if the memory buffer is empty. This method
+ * will never return Qnil.
+ */
+VALUE membuffer_to_rb_str( membuffer* m );
+
+#endif
+