# HG changeset patch
# User Marcin Kuzminski <marcin@python-works.com>
# Date 1302114950 -7200
# Node ID f7b24987d5fb236be774de46230cef7b11fb3aa6
# Parent  2c246d24eb90fb805a13e6e159c3e9f3006e962b
fixed setup.py file to use same platform as defined in main rhodecode PLATFORM_OTHERS,
added docs for lib

diff -r 2c246d24eb90 -r f7b24987d5fb rhodecode/lib/__init__.py
--- a/rhodecode/lib/__init__.py	Wed Apr 06 20:25:51 2011 +0200
+++ b/rhodecode/lib/__init__.py	Wed Apr 06 20:35:50 2011 +0200
@@ -23,20 +23,33 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-def str2bool(s):
-    if s is None:
+
+def str2bool(_str):
+    """
+    returs True/False value from given string, it tries to translate the
+    string into boolean
+
+    :param _str: string value to translate into boolean
+    :rtype: boolean
+    :returns: boolean from given string
+    """
+    if _str is None:
         return False
-    if s in (True, False):
-        return s
-    s = str(s).strip().lower()
-    return s in ('t', 'true', 'y', 'yes', 'on', '1')
+    if _str in (True, False):
+        return _str
+    _str = str(_str).strip().lower()
+    return _str in ('t', 'true', 'y', 'yes', 'on', '1')
+
 
 def generate_api_key(username, salt=None):
     """
-    Generates uniq API key for given username
+    Generates unique API key for given username,if salt is not given
+    it'll be generated from some random string
 
     :param username: username as string
     :param salt: salt to hash generate KEY
+    :rtype: str
+    :returns: sha1 hash from username+salt
     """
     from tempfile import _RandomNameSequence
     import hashlib
@@ -46,11 +59,12 @@
 
     return hashlib.sha1(username + salt).hexdigest()
 
+
 def safe_unicode(_str, from_encoding='utf8'):
     """
     safe unicode function. In case of UnicodeDecode error we try to return
     unicode with errors replace
-    
+
     :param _str: string to decode
     :rtype: unicode
     :returns: unicode object
diff -r 2c246d24eb90 -r f7b24987d5fb setup.py
--- a/setup.py	Wed Apr 06 20:25:51 2011 +0200
+++ b/setup.py	Wed Apr 06 20:35:50 2011 +0200
@@ -2,6 +2,7 @@
 from rhodecode import get_version
 from rhodecode import __platform__
 from rhodecode import __license__
+from rhodecode import PLATFORM_OTHERS
 
 py_version = sys.version_info
 
@@ -36,7 +37,7 @@
     requirements.append("simplejson")
     requirements.append("pysqlite")
 
-if __platform__ in ('Linux', 'Darwin'):
+if __platform__ in PLATFORM_OTHERS:
     requirements.append("py-bcrypt")