Initial commit

Author: davidlis

.gitignore

@@ -0,0 +1 @@
+sightengine/*.pyc

README.MD

@@ -0,0 +1,36 @@
+Sightengine Python Client
+===============
+
+Nudity detection and moderation - Python library to connect to the Sightengine API
+
+About
+-----
+
+Use the Sightengine nudity API to instantly moderate adult content in user-submitted photos. See http://sightengine.com for more information.
+
+
+Instructions
+------
+
+1. Create an account on http://sightengine.com, you will get your own API_USER and API_SECRET values
+2. Import the Sightengine package
+3. Create a SightengineClient object and use it as shown in the example
+
+
+Examples
+--------
+
+Moderate an image accessible through a public URL:
+
+  from sightengine import client
+  sightengine_client = client.SightengineClient("YOUR_API_USER", "YOUR_API_SECRET")
+  output = sightengine_client.check_nudity("http://img09.deviantart.net/2bd0/i/2009/276/c/9/magic_forrest_wallpaper_by_goergen.jpg")
+  print output
+
+
+Moderate a local image:
+
+  from sightengine import client
+  sightengine_client = client.SightengineClient("YOUR_API_USER", "YOUR_API_SECRET")
+  output = sightengine_client.check_nudity("/full/path/to/image.jpg")
+  print output

example.py

@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+
+from sightengine import client
+
+# Once you create an account on sightengine.com, you will get your own API user and API secret values
+# Please do not forget to replace them here
+sightengine_client = client.SightengineClient("YOUR_API_USER", "YOUR_API_SECRET")
+
+# Call the Sightengine servers to check for nudity. You can either pass a public URL or a local path. This call will raise an HTTPError if the HTTP connection fails
+output = sightengine_client.check_nudity("http://img09.deviantart.net/2bd0/i/2009/276/c/9/magic_forrest_wallpaper_by_goergen.jpg")
+
+print output

sightengine/__init__.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2015 Sightengine
+http://www.sightengine.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.
+"""

sightengine/client.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2015 Sightengine
+http://www.sightengine.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.
+"""
+
+import requests
+import json
+
+class SightengineClient(object):
+
+    def __init__(self, api_user, api_secret):
+        """
+        Sightengine Client initialization
+        """
+        self._api_user = api_user
+        self._api_secret = api_secret
+
+    @property
+    def api_user(self):
+        return self._api_user
+
+    @property
+    def api_secret(self):
+        return self._api_secret
+
+    def check_nudity(self, image):
+        endpoint = 'http://api.sightengine.com'
+        version = '1.0'
+        url = endpoint+'/'+version+'/nudity.json'
+
+        if image[:7].lower()=='http://' or image[:8].lower()=='https://':
+            r = requests.post(url, data={'url':image, 'api_user':self._api_user, 'api_secret':self._api_secret})
+        else:
+            r = requests.post(url, files={'photo': open(image, 'rb')}, data={'api_user':self._api_user, 'api_secret':self._api_secret})
+
+        r.raise_for_status()
+
+        output = json.loads(r.text)
+
+        return output