You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@libcloud.apache.org by an...@apache.org on 2016/04/06 07:32:53 UTC
svn commit: r1737921 - in /libcloud/site/trunk: generated/ generated/blog/
generated/blog/2016/04/06/ generated/blog/archives/2016/04/
generated/blog/tags/ source/_posts/
Author: anthonyshaw
Date: Wed Apr 6 05:32:53 2016
New Revision: 1737921
URL: http://svn.apache.org/viewvc?rev=1737921&view=rev
Log:
Updated site
Added:
libcloud/site/trunk/generated/blog/tags/API.html
Modified:
libcloud/site/trunk/generated/blog/2016/04/06/requests-support.html
libcloud/site/trunk/generated/blog/archives/2016/04/index.html
libcloud/site/trunk/generated/blog/atom.xml
libcloud/site/trunk/generated/blog/index.html
libcloud/site/trunk/generated/blog/tags/news.html
libcloud/site/trunk/generated/blog/tags/tutorial.html
libcloud/site/trunk/generated/index.html
libcloud/site/trunk/generated/sitemap.xml
libcloud/site/trunk/source/_posts/2016-04-06-requests-support.md
Modified: libcloud/site/trunk/generated/blog/2016/04/06/requests-support.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/2016/04/06/requests-support.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/2016/04/06/requests-support.html (original)
+++ libcloud/site/trunk/generated/blog/2016/04/06/requests-support.html Wed Apr 6 05:32:53 2016
@@ -1,15 +1,118 @@
-<hr>
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+
+
+ <meta name="author" content="The Apache Software Foundation">
+
+
+ <meta name="keywords" content="news,API,tutorial" />
+
+
+
+ <title>Experimental support for the requests package | Apache Libcloud</title>
+
+
+ <!-- fav icons -->
+ <link rel="shortcut icon" href="/images/favicon.png" />
+ <link rel="apple-touch-icon" href="/images/apple-touch-icon.png" />
+ <link rel="apple-touch-icon-precomposed" href="/images/apple-touch-icon.png" />
+
+ <link href="/blog/atom.xml" type="application/atom+xml" rel="alternate" title="Apache Libcloud Blog Feed" />
+
+ <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,400italic' rel='stylesheet' type='text/css'>
+ <link href='https://fonts.googleapis.com/css?family=Inconsolata' rel='stylesheet' type='text/css'>
+
+ <!-- Facebook OpenGraph tags -->
+ <meta content="Apache Libcloud" property="og:site_name">
+
+ <meta content="Experimental support for the requests package" property="og:title">
+
+
+
+
+
+
+
+ <meta content="article" property="og:type">
+
+
+
+ <meta content="https://libcloud.apache.org/blog/2016/04/06/requests-support.html" property="og:url">
+
+
+ <meta content="2016-04-06T00:00:00+10:00" property="article:published_time">
+ <meta content="https://libcloud.apache.org/about.html" property="article:author">
+
+
+
+
+ <meta content="news" property="article:tag">
+
+ <meta content="API" property="article:tag">
+
+ <meta content="tutorial" property="article:tag">
+
+
+
+ <link href='/assets/global-52715da7c55e2d86c5b5bfc2a8e7c73e.css' rel='stylesheet' type='text/css' />
+
+ </head>
+
+ <body data-spy="scroll" data-target=".sidebar-nav" data-offset="80">
+ <nav class="navbar navbar-fixed-top navbar-inverse" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html"><img src="/images/libcloud_logo.png" class="navbar-logo" /> Apache Libcloud</a>
+ </div>
+ <div class="collapse navbar-collapse navbar-ex1-collapse">
+ <ul class="nav navbar-nav">
+
+
+ <li ><a href="/" >Home</a></li>
+
+ <li ><a href="/about.html" >About</a></li>
+
+ <li ><a href="/getting-started.html" >Quick Start</a></li>
+
+ <li ><a href="https://libcloud.readthedocs.org/en/latest/" target="_blank">Documentation</a></li>
+
+ <li ><a href="/downloads.html" >Downloads</a></li>
+
+ <li ><a href="/community.html" >Community</a></li>
+
+ <li ><a href="/blog/" >Blog</a></li>
+
+ </ul>
+ </div><!-- /.navbar-collapse -->
+ </div><!-- /.container -->
+ </nav>
+
+ <div class="container main-container">
+ <div class="row section page-content">
+ <div class="col-lg-8 col-lg-offset-2">
+
+<div class="post">
+
+ <h2>Experimental support for the requests package</h2>
+
+
+
+
+
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
-<p>layout: post
-title: Experimental support for the requests package
-author: Anthony Shaw
-tags:
- - news
- - API</p>
-
-<h2> - tutorial</h2>
-
-<h2>Background</h2>
+ <div class="post-content">
+ <h2>Background</h2>
<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
@@ -86,3 +189,64 @@ that there are no regression bugs with t
<h2>Credit</h2>
<p>Credit to dz0ny on IRC for contributing some of the requests patch.</p>
+
+ </div>
+
+ <div class="row section post-meta">
+ <div class="col-md-12 post-tags">
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
+ </div>
+ </div>
+</div>
+
+Share : <a href="https://twitter.com/share" class="twitter-share-button"{count} data-via="libcloud" data-size="large" data-hashtags="cloud">Tweet</a>
+<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
+
+ </div>
+</div>
+
+
+ <hr />
+
+ <footer>
+ <div class="row">
+ <div class="col-lg-12 text-center">
+ <div class="footer-links">
+ <p><a href="http://www.apache.org/licenses/">License</a> | <a
+ href="/security.html">Security</a> | <a
+ href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> |
+ <a href="http://www.apache.org/foundation/thanks.html">Thanks</a> |
+ <a href="/credits.html">Credits</a> | <a href="/media.html">Media</a>
+</div>
+
+<div class="footer-text">
+ <p class="">Copyright © 2009-2016 <a href="https://www.apache.org/" target="_blank">The Apache Software Foundation</a></p>
+ <p class="">Apache Libcloud, Libcloud, Apache, the Apache feather, and the Apache Libcloud project logo are trademarks of the Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p>
+</div>
+
+ </div>
+ </div>
+ </footer>
+
+ </div><!-- /.container -->
+
+ <!-- JavaScript -->
+ <script src='/assets/global-9c9298ad4670c6fcb2e40b5291d6c657.js' type='text/javascript'></script>
+
+
+
+
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-23580482-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script>
+
+ </body>
+</html>
Modified: libcloud/site/trunk/generated/blog/archives/2016/04/index.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/archives/2016/04/index.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/archives/2016/04/index.html (original)
+++ libcloud/site/trunk/generated/blog/archives/2016/04/index.html Wed Apr 6 05:32:53 2016
@@ -95,27 +95,16 @@
<div class="post">
- <h2><a href="/blog/2016/04/06/requests-support.html">Requests Support</a></h2>
+ <h2><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a></h2>
- <span class="post-date-author">By on Apr 06, 2016</span>
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
<div class="post-content">
- <hr>
-
-<p>layout: post
-title: Experimental support for the requests package
-author: Anthony Shaw
-tags:
- - news
- - API</p>
-
-<h2> - tutorial</h2>
-
-<h2>Background</h2>
+ <h2>Background</h2>
<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
@@ -197,7 +186,7 @@ that there are no regression bugs with t
<div class="row section post-meta">
<div class="col-md-12 post-tags">
- <p>Tags: </p>
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
</div>
</div>
</div>
Modified: libcloud/site/trunk/generated/blog/atom.xml
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/atom.xml?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/atom.xml (original)
+++ libcloud/site/trunk/generated/blog/atom.xml Wed Apr 6 05:32:53 2016
@@ -5,32 +5,21 @@
<link href="https://libcloud.apache.org" rel="self" />
<link href="https://libcloud.apache.org" />
<id>https://libcloud.apache.org</id>
- <updated>2016-04-06T15:31:35+10:00</updated>
+ <updated>2016-04-06T15:32:30+10:00</updated>
<author>
<name>The Apache Software Foundation</name>
</author>
<entry>
- <title>Requests Support</title>
+ <title>Experimental support for the requests package</title>
<link href="https://libcloud.apache.org/blog/2016/04/06/requests-support.html" />
<id>https://libcloud.apache.org/blog/2016/04/06/requests-support.html</id>
<updated>2016-04-06T00:00:00+10:00</updated>
<author>
- <name></name>
+ <name>Anthony Shaw</name>
</author>
- <content type="html"><hr>
-
-<p>layout: post
-title: Experimental support for the requests package
-author: Anthony Shaw
-tags:
- - news
- - API</p>
-
-<h2> - tutorial</h2>
-
-<h2>Background</h2>
+ <content type="html"><h2>Background</h2>
<p>I&#39;ve just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
Modified: libcloud/site/trunk/generated/blog/index.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/index.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/index.html (original)
+++ libcloud/site/trunk/generated/blog/index.html Wed Apr 6 05:32:53 2016
@@ -97,27 +97,16 @@
<div class="post">
- <h2><a href="/blog/2016/04/06/requests-support.html">Requests Support</a></h2>
+ <h2><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a></h2>
- <span class="post-date-author">By on Apr 06, 2016</span>
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
<div class="post-content">
- <hr>
-
-<p>layout: post
-title: Experimental support for the requests package
-author: Anthony Shaw
-tags:
- - news
- - API</p>
-
-<h2> - tutorial</h2>
-
-<h2>Background</h2>
+ <h2>Background</h2>
<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
@@ -203,7 +192,7 @@ that there are no regression bugs with t
<div class="row section post-meta">
<div class="col-md-12 post-tags">
- <p>Tags: </p>
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
</div>
</div>
</div>
Added: libcloud/site/trunk/generated/blog/tags/API.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/tags/API.html?rev=1737921&view=auto
==============================================================================
--- libcloud/site/trunk/generated/blog/tags/API.html (added)
+++ libcloud/site/trunk/generated/blog/tags/API.html Wed Apr 6 05:32:53 2016
@@ -0,0 +1,249 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+
+
+ <meta name="author" content="The Apache Software Foundation">
+
+
+ <meta name="keywords" content="python,libcloud,cloud,cloud computing,rackspace,amazon ec2,cloudfiles,openstack,cloudstack" />
+
+
+
+ <title>Tag Archive | Apache Libcloud</title>
+
+
+ <!-- fav icons -->
+ <link rel="shortcut icon" href="/images/favicon.png" />
+ <link rel="apple-touch-icon" href="/images/apple-touch-icon.png" />
+ <link rel="apple-touch-icon-precomposed" href="/images/apple-touch-icon.png" />
+
+ <link href="/blog/atom.xml" type="application/atom+xml" rel="alternate" title="Apache Libcloud Blog Feed" />
+
+ <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,400italic' rel='stylesheet' type='text/css'>
+ <link href='https://fonts.googleapis.com/css?family=Inconsolata' rel='stylesheet' type='text/css'>
+
+ <!-- Facebook OpenGraph tags -->
+ <meta content="Apache Libcloud" property="og:site_name">
+
+ <meta content="Tag Archive" property="og:title">
+
+
+
+
+
+
+
+ <meta content="website" property="og:type">
+
+
+
+ <meta content="https://libcloud.apache.org/blog/tags/API.html" property="og:url">
+
+
+
+
+
+ <link href='/assets/global-52715da7c55e2d86c5b5bfc2a8e7c73e.css' rel='stylesheet' type='text/css' />
+
+ </head>
+
+ <body data-spy="scroll" data-target=".sidebar-nav" data-offset="80">
+ <nav class="navbar navbar-fixed-top navbar-inverse" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-ex1-collapse">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html"><img src="/images/libcloud_logo.png" class="navbar-logo" /> Apache Libcloud</a>
+ </div>
+ <div class="collapse navbar-collapse navbar-ex1-collapse">
+ <ul class="nav navbar-nav">
+
+
+ <li ><a href="/" >Home</a></li>
+
+ <li ><a href="/about.html" >About</a></li>
+
+ <li ><a href="/getting-started.html" >Quick Start</a></li>
+
+ <li ><a href="https://libcloud.readthedocs.org/en/latest/" target="_blank">Documentation</a></li>
+
+ <li ><a href="/downloads.html" >Downloads</a></li>
+
+ <li ><a href="/community.html" >Community</a></li>
+
+ <li ><a href="/blog/" >Blog</a></li>
+
+ </ul>
+ </div><!-- /.navbar-collapse -->
+ </div><!-- /.container -->
+ </nav>
+
+ <div class="container main-container">
+ <div class="row section page-content">
+ <div class="col-lg-8 col-lg-offset-2">
+ <h1>Tag: API</h1>
+
+
+
+
+ <div class="post">
+
+ <h2><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a></h2>
+
+
+
+
+
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
+
+ <div class="post-content">
+ <h2>Background</h2>
+
+<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
+
+<p>This article is for both users and developers of libcloud. If you want to give feedback, please join the developer mailing list.</p>
+
+<h2>Why?</h2>
+
+<ul>
+<li>requests is the defacto standard - it would be in the standard library but agreed against to allow it to develop faster https://github.com/kennethreitz/requests/issues/2424</li>
+<li>it works with python 2.6->3.5</li>
+<li>Our SSL experience has a lot to be desired for Windows users, having to download the CA cert package and setting environment variables just to get SSL working</li>
+<li>Developers can use requests_mock for deeper integration testing</li>
+<li>less code to maintain</li>
+<li>the role of libcloud is for cloud abstraction, we provide no value in writing and maintaining our own HTTP client library</li>
+</ul>
+
+<h2>Benefits of requests</h2>
+
+<p>There are a number of benefits to having a requests package</p>
+
+<ul>
+<li>The client library code is smaller, leaner and simpler.</li>
+<li>Requests has built in decompression support, we no longer need to support this</li>
+<li>Requests has built in RAW download, upload support, helping with our storage drivers</li>
+</ul>
+
+<h2>Implications of the change</h2>
+
+<ul>
+<li>There are no longer 2 classes (<code>LibcloudHTTPSConnection</code> and <code>LibcloudHTTPConnection</code>) to be provided to each driver, they are now 1 class - <code>LibcloudConnection</code>. You probably won't notice this because it is a property of the <code>Connection</code> class, but
+if you are developing or extending functionality then it is implicated.</li>
+<li>Unit tests will look slightly different (see below)</li>
+<li>This change broke 4200 unit tests (out of 6340)! I've since fixed them all since they were coupled to the original implementation, but now I don't know if all of tests are valid.</li>
+</ul>
+
+<h2>Testing with requests</h2>
+
+<p>Unit tests that were written like this:</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_classes</span> <span class="o">=</span> \
+ <span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="n">DigitalOceanMockHttp</span><span class="p">)</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<p>Because of the change have been modified to (I updated all of them - so this is just for future reference)</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_class</span> <span class="o">=</span> <span class="n">DigitalOceanMockHttp</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<h1>Check it out!</h1>
+
+<p>The package is on my personal apache site, you can download it and install it in a virtualenv for testing.</p>
+
+<p>`pip install -e http://people.apache.org/~anthonyshaw/libcloud/1.0.0-rc2-requests/apache-libcloud-1.0.0-rc2-requests.zip@feature#egg=apache-libcloud</p>
+
+<p>The hashes are my <a href="http://people.apache.org/%7Eanthonyshaw/libcloud/1.0.0-rc2-requests/">apache space</a></p>
+
+<p>Have a look at the <a href="https://github.com/apache/libcloud/pull/728/files">PR and the change set</a> for a list of changes</p>
+
+<h1>What might break?</h1>
+
+<p>What I'm really looking for is for users of Libcloud to take 15 minutes, an existing (working) libcloud script, install this package in a virtualenv and just validate
+that there are no regression bugs with this change.</p>
+
+<p>I'm particularly sceptical about the storage drivers.</p>
+
+<p>Once we have enough community feedback, we will propose a vote to merge this into trunk for future release.</p>
+
+<h2>Credit</h2>
+
+<p>Credit to dz0ny on IRC for contributing some of the requests patch.</p>
+
+ </div>
+
+ <div class="row section post-meta">
+ <div class="col-md-12 post-tags">
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
+ </div>
+ </div>
+</div>
+
+
+
+
+ </div>
+</div>
+
+
+ <hr />
+
+ <footer>
+ <div class="row">
+ <div class="col-lg-12 text-center">
+ <div class="footer-links">
+ <p><a href="http://www.apache.org/licenses/">License</a> | <a
+ href="/security.html">Security</a> | <a
+ href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a> |
+ <a href="http://www.apache.org/foundation/thanks.html">Thanks</a> |
+ <a href="/credits.html">Credits</a> | <a href="/media.html">Media</a>
+</div>
+
+<div class="footer-text">
+ <p class="">Copyright © 2009-2016 <a href="https://www.apache.org/" target="_blank">The Apache Software Foundation</a></p>
+ <p class="">Apache Libcloud, Libcloud, Apache, the Apache feather, and the Apache Libcloud project logo are trademarks of the Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p>
+</div>
+
+ </div>
+ </div>
+ </footer>
+
+ </div><!-- /.container -->
+
+ <!-- JavaScript -->
+ <script src='/assets/global-9c9298ad4670c6fcb2e40b5291d6c657.js' type='text/javascript'></script>
+
+
+
+
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-23580482-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script>
+
+ </body>
+</html>
Modified: libcloud/site/trunk/generated/blog/tags/news.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/tags/news.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/tags/news.html (original)
+++ libcloud/site/trunk/generated/blog/tags/news.html Wed Apr 6 05:32:53 2016
@@ -96,6 +96,111 @@
<div class="post">
+ <h2><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a></h2>
+
+
+
+
+
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
+
+ <div class="post-content">
+ <h2>Background</h2>
+
+<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
+
+<p>This article is for both users and developers of libcloud. If you want to give feedback, please join the developer mailing list.</p>
+
+<h2>Why?</h2>
+
+<ul>
+<li>requests is the defacto standard - it would be in the standard library but agreed against to allow it to develop faster https://github.com/kennethreitz/requests/issues/2424</li>
+<li>it works with python 2.6->3.5</li>
+<li>Our SSL experience has a lot to be desired for Windows users, having to download the CA cert package and setting environment variables just to get SSL working</li>
+<li>Developers can use requests_mock for deeper integration testing</li>
+<li>less code to maintain</li>
+<li>the role of libcloud is for cloud abstraction, we provide no value in writing and maintaining our own HTTP client library</li>
+</ul>
+
+<h2>Benefits of requests</h2>
+
+<p>There are a number of benefits to having a requests package</p>
+
+<ul>
+<li>The client library code is smaller, leaner and simpler.</li>
+<li>Requests has built in decompression support, we no longer need to support this</li>
+<li>Requests has built in RAW download, upload support, helping with our storage drivers</li>
+</ul>
+
+<h2>Implications of the change</h2>
+
+<ul>
+<li>There are no longer 2 classes (<code>LibcloudHTTPSConnection</code> and <code>LibcloudHTTPConnection</code>) to be provided to each driver, they are now 1 class - <code>LibcloudConnection</code>. You probably won't notice this because it is a property of the <code>Connection</code> class, but
+if you are developing or extending functionality then it is implicated.</li>
+<li>Unit tests will look slightly different (see below)</li>
+<li>This change broke 4200 unit tests (out of 6340)! I've since fixed them all since they were coupled to the original implementation, but now I don't know if all of tests are valid.</li>
+</ul>
+
+<h2>Testing with requests</h2>
+
+<p>Unit tests that were written like this:</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_classes</span> <span class="o">=</span> \
+ <span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="n">DigitalOceanMockHttp</span><span class="p">)</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<p>Because of the change have been modified to (I updated all of them - so this is just for future reference)</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_class</span> <span class="o">=</span> <span class="n">DigitalOceanMockHttp</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<h1>Check it out!</h1>
+
+<p>The package is on my personal apache site, you can download it and install it in a virtualenv for testing.</p>
+
+<p>`pip install -e http://people.apache.org/~anthonyshaw/libcloud/1.0.0-rc2-requests/apache-libcloud-1.0.0-rc2-requests.zip@feature#egg=apache-libcloud</p>
+
+<p>The hashes are my <a href="http://people.apache.org/%7Eanthonyshaw/libcloud/1.0.0-rc2-requests/">apache space</a></p>
+
+<p>Have a look at the <a href="https://github.com/apache/libcloud/pull/728/files">PR and the change set</a> for a list of changes</p>
+
+<h1>What might break?</h1>
+
+<p>What I'm really looking for is for users of Libcloud to take 15 minutes, an existing (working) libcloud script, install this package in a virtualenv and just validate
+that there are no regression bugs with this change.</p>
+
+<p>I'm particularly sceptical about the storage drivers.</p>
+
+<p>Once we have enough community feedback, we will propose a vote to merge this into trunk for future release.</p>
+
+<h2>Credit</h2>
+
+<p>Credit to dz0ny on IRC for contributing some of the requests patch.</p>
+
+ </div>
+
+ <div class="row section post-meta">
+ <div class="col-md-12 post-tags">
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
+ </div>
+ </div>
+</div>
+
+
+
+
+ <div class="post">
+
<h2><a href="/blog/2016/02/16/new-drivers-deprecated-drivers.html">New compute drivers and deprecated drivers in 1.0</a></h2>
Modified: libcloud/site/trunk/generated/blog/tags/tutorial.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/blog/tags/tutorial.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/blog/tags/tutorial.html (original)
+++ libcloud/site/trunk/generated/blog/tags/tutorial.html Wed Apr 6 05:32:53 2016
@@ -96,6 +96,111 @@
<div class="post">
+ <h2><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a></h2>
+
+
+
+
+
+ <span class="post-date-author">By Anthony Shaw on Apr 06, 2016</span>
+
+ <div class="post-content">
+ <h2>Background</h2>
+
+<p>I've just pushed a branch of the latest version of libcloud using the popular <code>requests</code> package by Kenneth Reitz instead of our home-rolled HTTP client library.</p>
+
+<p>This article is for both users and developers of libcloud. If you want to give feedback, please join the developer mailing list.</p>
+
+<h2>Why?</h2>
+
+<ul>
+<li>requests is the defacto standard - it would be in the standard library but agreed against to allow it to develop faster https://github.com/kennethreitz/requests/issues/2424</li>
+<li>it works with python 2.6->3.5</li>
+<li>Our SSL experience has a lot to be desired for Windows users, having to download the CA cert package and setting environment variables just to get SSL working</li>
+<li>Developers can use requests_mock for deeper integration testing</li>
+<li>less code to maintain</li>
+<li>the role of libcloud is for cloud abstraction, we provide no value in writing and maintaining our own HTTP client library</li>
+</ul>
+
+<h2>Benefits of requests</h2>
+
+<p>There are a number of benefits to having a requests package</p>
+
+<ul>
+<li>The client library code is smaller, leaner and simpler.</li>
+<li>Requests has built in decompression support, we no longer need to support this</li>
+<li>Requests has built in RAW download, upload support, helping with our storage drivers</li>
+</ul>
+
+<h2>Implications of the change</h2>
+
+<ul>
+<li>There are no longer 2 classes (<code>LibcloudHTTPSConnection</code> and <code>LibcloudHTTPConnection</code>) to be provided to each driver, they are now 1 class - <code>LibcloudConnection</code>. You probably won't notice this because it is a property of the <code>Connection</code> class, but
+if you are developing or extending functionality then it is implicated.</li>
+<li>Unit tests will look slightly different (see below)</li>
+<li>This change broke 4200 unit tests (out of 6340)! I've since fixed them all since they were coupled to the original implementation, but now I don't know if all of tests are valid.</li>
+</ul>
+
+<h2>Testing with requests</h2>
+
+<p>Unit tests that were written like this:</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_classes</span> <span class="o">=</span> \
+ <span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="n">DigitalOceanMockHttp</span><span class="p">)</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<p>Because of the change have been modified to (I updated all of them - so this is just for future reference)</p>
+
+<div class="highlight"><pre><code class="python language-python" data-lang="python"><span class="k">class</span> <span class="nc">DigitalOceanTests</span><span class="p">(</span><span class="n">LibcloudTestCase</span><span class="p">):</span>
+
+ <span class="k">def</span> <span class="nf">setUp</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+ <span class="n">DigitalOceanBaseDriver</span><span class="o">.</span><span class="n">connectionCls</span><span class="o">.</span><span class="n">conn_class</span> <span class="o">=</span> <span class="n">DigitalOceanMockHttp</span>
+ <span class="n">DigitalOceanMockHttp</span><span class="o">.</span><span class="n">type</span> <span class="o">=</span> <span class="bp">None</span>
+ <span class="bp">self</span><span class="o">.</span><span class="n">driver</span> <span class="o">=</span> <span class="n">DigitalOceanBaseDriver</span><span class="p">(</span><span class="o">*</span><span class="n">DIGITALOCEAN_v1_PARAMS</span><span class="p">)</span>
+</code></pre></div>
+
+<h1>Check it out!</h1>
+
+<p>The package is on my personal apache site, you can download it and install it in a virtualenv for testing.</p>
+
+<p>`pip install -e http://people.apache.org/~anthonyshaw/libcloud/1.0.0-rc2-requests/apache-libcloud-1.0.0-rc2-requests.zip@feature#egg=apache-libcloud</p>
+
+<p>The hashes are my <a href="http://people.apache.org/%7Eanthonyshaw/libcloud/1.0.0-rc2-requests/">apache space</a></p>
+
+<p>Have a look at the <a href="https://github.com/apache/libcloud/pull/728/files">PR and the change set</a> for a list of changes</p>
+
+<h1>What might break?</h1>
+
+<p>What I'm really looking for is for users of Libcloud to take 15 minutes, an existing (working) libcloud script, install this package in a virtualenv and just validate
+that there are no regression bugs with this change.</p>
+
+<p>I'm particularly sceptical about the storage drivers.</p>
+
+<p>Once we have enough community feedback, we will propose a vote to merge this into trunk for future release.</p>
+
+<h2>Credit</h2>
+
+<p>Credit to dz0ny on IRC for contributing some of the requests patch.</p>
+
+ </div>
+
+ <div class="row section post-meta">
+ <div class="col-md-12 post-tags">
+ <p>Tags: <a href="/blog/tags/news.html" rel="tag">news</a>, <a href="/blog/tags/API.html" rel="tag">API</a>, <a href="/blog/tags/tutorial.html" rel="tag">tutorial</a></p>
+ </div>
+ </div>
+</div>
+
+
+
+
+ <div class="post">
+
<h2><a href="/blog/2016/02/05/libcloud-containers-example.html">Using the container abstraction API in 1.0.0-pre1</a></h2>
Modified: libcloud/site/trunk/generated/index.html
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/index.html?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/index.html (original)
+++ libcloud/site/trunk/generated/index.html Wed Apr 6 05:32:53 2016
@@ -241,7 +241,7 @@
<h3>Latest Blog Posts</h3>
- <p><a href="/blog/2016/04/06/requests-support.html">Requests Support</a>
+ <p><a href="/blog/2016/04/06/requests-support.html">Experimental support for the requests package</a>
Modified: libcloud/site/trunk/generated/sitemap.xml
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/generated/sitemap.xml?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/generated/sitemap.xml (original)
+++ libcloud/site/trunk/generated/sitemap.xml Wed Apr 6 05:32:53 2016
@@ -314,7 +314,7 @@
</url>
<url>
<loc>https://libcloud.apache.org/blog/2016/04/06/requests-support.html</loc>
- <lastmod>2016-04-06T15:27:21+10:00</lastmod>
+ <lastmod>2016-04-06T00:00:00+10:00</lastmod>
</url>
<url>
<loc>https://libcloud.apache.org/about.html</loc>
@@ -346,7 +346,7 @@
</url>
<url>
<loc>https://libcloud.apache.org/</loc>
- <lastmod>2016-04-06T15:27:21+10:00</lastmod>
+ <lastmod>2016-04-06T15:30:55+10:00</lastmod>
</url>
<url>
<loc>https://libcloud.apache.org/getting-started.html</loc>
@@ -366,7 +366,7 @@
</url>
<url>
<loc>https://libcloud.apache.org/blog/blog/</loc>
- <lastmod>2016-04-06T15:27:21+10:00</lastmod>
+ <lastmod>2016-04-06T15:30:55+10:00</lastmod>
</url>
<url>
<loc>https://libcloud.apache.org/security.html</loc>
Modified: libcloud/site/trunk/source/_posts/2016-04-06-requests-support.md
URL: http://svn.apache.org/viewvc/libcloud/site/trunk/source/_posts/2016-04-06-requests-support.md?rev=1737921&r1=1737920&r2=1737921&view=diff
==============================================================================
--- libcloud/site/trunk/source/_posts/2016-04-06-requests-support.md (original)
+++ libcloud/site/trunk/source/_posts/2016-04-06-requests-support.md Wed Apr 6 05:32:53 2016
@@ -1,4 +1,4 @@
- ---
+---
layout: post
title: Experimental support for the requests package
author: Anthony Shaw