add head method to high-level interface, closes #547

2 files changed, 16 insertions, 0 deletions

diff --git a/python/curl/__init__.py b/python/curl/__init__.py
index 977f3aa..187913b 100644
--- a/python/curl/__init__.py
+++ b/python/curl/__init__.py
@@ -100,6 +100,13 @@ class Curl:
         self.set_option(pycurl.HTTPGET, 1)
         return self.__request(url)
 
+    def head(self, url="", params=None):
+        "Ship a HEAD request for a specified URL, capture the response."
+        if params:
+            url += "?" + urllib_parse.urlencode(params)
+        self.set_option(pycurl.NOBODY, 1)
+        return self.__request(url)
+
     def post(self, cgi, params):
         "Ship a POST request to a specified CGI, capture the response."
         self.set_option(pycurl.POST, 1)
diff --git a/tests/high_level_curl_test.py b/tests/high_level_curl_test.py
index 3dce1b3..ce3e250 100644
--- a/tests/high_level_curl_test.py
+++ b/tests/high_level_curl_test.py
@@ -18,6 +18,15 @@ class RelativeUrlTest(unittest.TestCase):
     def tearDown(self):
         self.curl.close()
 
+    def test_get(self):
+        result = self.curl.get('/success')
+        self.assertEqual('success', result.decode())
+
+    def test_head(self):
+        result = self.curl.head('/success')
+        self.assertEqual('', result.decode())
+        self.assertEqual(200, self.curl.info()['http-code'])
+
     def test_reuse(self):
         result = self.curl.get('/success')
         self.assertEqual('success', result.decode())