rtiss_soap4r 2.1.0 → 3.0.0.beta

data/Gemfile.lock

@@ -0,0 +1,221 @@
+PATH
+  remote: .
+  specs:
+    rtiss_soap4r (3.0.0.beta)
+      addressable
+      cookiejar (~> 0.3.4)
+      httpclient (~> 2.9)
+      libxml-ruby (~> 5.0, >= 5.0.3)
+      logger-application
+      nokogiri (~> 1.16, >= 1.16.2)
+      oga (~> 3.4)
+      ox (~> 2.14, >= 2.14.22)
+      rake
+      savon (~> 2.14)
+      webrick (~> 1.9, >= 1.9.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (8.0.2)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    addressable (2.4.0)
+    akami (1.3.3)
+      base64
+      gyoku (>= 0.4.0)
+      nokogiri
+    ansi (1.5.0)
+    ast (2.4.3)
+    awesome_print (1.9.2)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    builder (3.3.0)
+    byebug (12.0.0)
+    codeclimate-test-reporter (1.0.9)
+      simplecov (<= 0.13)
+    coderay (1.1.3)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
+    cookiejar (0.3.4)
+    date (3.4.1)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    docile (1.1.5)
+    drb (2.2.1)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.11.0)
+      rchardet (~> 1.8)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    gyoku (1.4.0)
+      builder (>= 2.1.2)
+      rexml (~> 3.0)
+    hashie (5.0.0)
+    highline (3.1.2)
+      reline
+    httpclient (2.9.0)
+      mutex_m
+    httpi (3.0.2)
+      base64
+      mutex_m
+      nkf
+      rack (< 3)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.0)
+    jeweler (2.3.9)
+      builder
+      bundler
+      git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych
+      rake
+      rdoc
+      semver2
+    json (2.10.2)
+    jwt (2.10.1)
+      base64
+    libxml-ruby (5.0.3)
+    logger (1.7.0)
+    logger-application (0.0.2)
+    mail (2.8.1)
+      mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
+    method_source (1.1.0)
+    mime-types (2.99.3)
+    mini_mime (1.1.5)
+    minitest (5.25.4)
+    multi_json (1.15.0)
+    multi_xml (0.7.1)
+      bigdecimal (~> 3.1)
+    multipart-post (2.4.1)
+    mutex_m (0.3.0)
+    net-imap (0.5.6)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.2)
+      timeout
+    net-smtp (0.5.1)
+      net-protocol
+    nkf (0.2.0)
+    nokogiri (1.18.7-x86_64-linux-gnu)
+      racc (~> 1.4)
+    nori (2.7.1)
+      bigdecimal
+    oauth2 (1.4.8)
+      faraday (>= 0.8, < 3.0)
+      jwt (>= 1.0, < 3.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    oga (3.4)
+      ast
+      ruby-ll (~> 2.1)
+    ox (2.14.22)
+      bigdecimal (>= 3.0)
+    power_assert (2.0.5)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    psych (5.2.3)
+      date
+      stringio
+    racc (1.8.1)
+    rack (2.2.13)
+    rake (13.2.1)
+    rchardet (1.9.0)
+    rdoc (6.13.1)
+      psych (>= 4.0.0)
+    reline (0.6.1)
+      io-console (~> 0.5)
+    rexml (3.4.1)
+    ruby-ll (2.1.3)
+      ansi
+      ast
+    savon (2.15.0)
+      akami (~> 1.2)
+      builder (>= 2.1.2)
+      gyoku (~> 1.2)
+      httpi (>= 2.4.5, < 5)
+      mail (~> 2.5)
+      nokogiri (>= 1.8.1)
+      nori (~> 2.4)
+      wasabi (>= 3.7, < 6)
+    securerandom (0.4.1)
+    semver2 (3.4.2)
+    shoulda (4.0.0)
+      shoulda-context (~> 2.0)
+      shoulda-matchers (~> 4.0)
+    shoulda-context (2.0.0)
+    shoulda-matchers (4.5.1)
+      activesupport (>= 4.2.0)
+    simplecov (0.13.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    stringio (3.1.6)
+    test-unit (3.6.8)
+      power_assert
+    thread_safe (0.3.6)
+    timeout (0.4.3)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.0.3)
+    wasabi (4.0.0)
+      addressable
+      httpi (~> 3.0)
+      nokogiri (>= 1.13.9)
+    webrick (1.9.1)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  addressable
+  awesome_print
+  byebug
+  codeclimate-test-reporter
+  cookiejar (~> 0.3.4)
+  httpclient (~> 2.9)
+  jeweler (~> 2.3, >= 2.3.9)
+  libxml-ruby (~> 5.0, >= 5.0.3)
+  logger-application
+  minitest (= 5.25.4)
+  nokogiri (~> 1.16, >= 1.16.2)
+  oga (~> 3.4)
+  ox (~> 2.14, >= 2.14.22)
+  pry
+  rake
+  rtiss_soap4r!
+  savon (~> 2.14)
+  shoulda
+  test-unit
+  webrick (~> 1.9, >= 1.9.1)
+
+BUNDLED WITH
+   2.4.22

data/README.md

@@ -0,0 +1,57 @@
+# rtiss_soap4r (soap4r for > Ruby 3.2)
+[![Gem Version](https://badge.fury.io/rb/soap4r-ng.svg)](http://badge.fury.io/rb/soap4r-ng)
+[![GitHub version](https://badge.fury.io/gh/rubyjedi%2Fsoap4r.svg)](http://badge.fury.io/gh/rubyjedi%2Fsoap4r)
+[![Code Climate](https://codeclimate.com/github/rubyjedi/soap4r/badges/gpa.svg)](https://codeclimate.com/github/rubyjedi/soap4r)
+[![Build Status](https://travis-ci.org/rubyjedi/soap4r.svg?branch=master)](https://travis-ci.org/rubyjedi/soap4r)
+
+#### Rtiss Soap4R (as maintained by Tu Wien)
+
+#### How to Install 
+##### (Bundler Gemfile / GitHub Hosted)
+```
+## Performance Boosting Gems
+gem 'ox'         # For faster XML Parsing, use Ox or Nokogiri. Ox has highest priority if available.
+gem 'nokogiri'   # For faster XML Parsing. If neither Ox nor Nokogiri available, we'll fall back to REXML.
+gem 'httpclient' # Absolutely necessary for soap4r-ng. Net::HTTP Fallback is quite broken, so don't let that happen.
+
+```
+##### Standard Ruby Gem
+```
+gem install rtiss_soap4r
+```
+#### How to Use
+* [NaHi's Original documentation](https://web.archive.org/web/20101212040735/http://dev.ctor.org/soap4r/wiki/) -- the authoritative reference material is still available through the Wayback Machine, thankfully!
+* [Soap4R-NG Website](http://rubyjedi.github.io/soap4r/) -- My own attempt at incorporating and modernizing the above into GitHub Pages -- still a work in progress at this time.
+
+#### How to Get a Speed Boost : Use Nokogiri or Ox, not REXML
+Be sure to have Nokogiri or Ox available in your Gemset. Soap4R-ng will find and use what's available (Ox has highest precedence, then Nokogiri, falling back to REXML as the last-resort if needed. 
+
+I personally recommend **Nokogiri** as the best performing, most flexible parser at this time, as it handles "special characters" like HTML ampersand-escaped characters internally. Ox doesn't handle such an extensive set of special-characters natively, so to get things up to par, I added **htmlentities** support if it's available when using the Ox parser. Using **htmlentities** with **Ox** in this manner adds a bit of a performance penalty, however.
+
+If you know your incoming XML is "clean", Ox is a really great alternative.
+
+**LibXML** is somewhat broken at this time. It's low-priority on the task list, as **Nokogiri** and **Ox** are more readily available. In fact, I may drop support for the **LibXML** parser in a future release.
+
+
+#### Project Motivation
+
+I have a personal vested interest in making this the ***fastest, most reliable*** successor to [NaHi's original Soap4R library](https://github.com/nahi/soap4r), and in maintaining and documenting **Soap4R** to the best of my reasonably expected ability.
+
+Soap4R has received a less-than-stellar reputation amongst the Ruby Community for far too long; and I've grown tired of seeing shoddy advice floating around to abandon **Soap4R** in favor of other SOAP Implementations. That's just nonsense -- especially when you're faced with the challenge of updating large, already-written, revenue-generating systems.
+
+IMHO, NaHi did a freaking brilliant job with **Soap4R**. The code is tight, the Unit Tests are astonishingly comprehensive, and -- aside from finding someone willing to invest time to carry **Soap4R** forward -- there's really no good reason why **Soap4R** should be so neglected.
+
+In fact, I'd much prefer spending time forward-porting **Soap4R** to keep this known-good foundation library going, versus taking on the risky task of migrating already-written applications to a completely new SOAP implementation. Along the way in this journey, I'm adding support for newer XML Parsers like **[Ox](https://github.com/ohler55/ox)** (which is screaming fast, btw!) and **[Nokogiri](https://github.com/sparklemotion/nokogiri)**. I also have future plans to add support for newer HTTP Clients such as **[Curb](https://github.com/taf2/curb)**.
+
+#### Why Name This "Soap4R-ng" ?
+As **[felipec/soap4r](https://github.com/felipec/soap4r)** (now **[soap2r](https://github.com/felipec/soap4r)**) pointed out upon renaming his fork to **soap2r** , there is a LOT of competition to uniquely name the a "successor" to the original Soap4R. **soap2r** came into being because **"[Soap5R](https://github.com/aforward/soap4r)"** had already been claimed. :-)
+
+#### Other Soap4R Forks/Networks of Interest
+ * [nahi/soap4r](https://github.com/nahi/soap4r) - The original Soap4R by NaHi
+ * [spox/soap4r-spox](https://github.com//spox/soap4r-spox) - One of the first Ruby 1.9-compatible forks
+ * [felipec/soap4r](https://github.com//felipec/soap4r) - **Soap2R**
+
+#### Testing or Contributing
+Diving into the Source? Sure, I can always use more eyes to improve the code quality. Welcome aboard!
+
+I assume you know how to check out the Git Repository, set up **rvm** or equivalent environment, and run **Bundler** to pull in the suggested Gems. From there, do a **rake test:surface** to run the smaller set of Unit Tests; or **rake test:deep** to run the complete set of Unit Tests.