Fix minor problems with the new security module (#452)

- The API documentation was missing
- The documentation for it is written like a section and distorts
the menu. The sections are converted to subsections.
- The code sample was missing a new line, and was resulting in error.
- The documentation at the client constructor had a wrong module name
- Removed the `security` folder and moved everything to `security` module
to match with the style of the rest of the code base.

Author: mdumandag

docs/api/modules.rst

@@ -14,6 +14,7 @@ API Documentation
     partition
     predicate
     proxy/modules
+    security
     serialization
     sql
     transaction

docs/api/security.rst

@@ -0,0 +1,4 @@
+Security
+========
+
+.. automodule:: hazelcast.security

docs/securing_client_connection.rst

@@ -261,7 +261,7 @@ and ``ssl_keyfile`` on top of the other TLS/SSL configurations. See the
 section for the details of these options.
 
 Username/Password Authentication
-================================
+--------------------------------
 
 You can protect your cluster using a username and password pair.
 In order to use it, enable it in member configuration:
@@ -293,7 +293,7 @@ Check out the documentation on `Password Credentials
 of the Hazelcast Documentation.
 
 Token-Based Authentication
-==========================
+--------------------------
 
 Python client supports token-based authentication via token providers.
 A token provider is a class derived from :class:`hazelcast.security.TokenProvider`.
@@ -316,6 +316,7 @@ In order to use token based authentication, first define in the member configura
 Using :class:`hazelcast.security.BasicTokenProvider` you can pass the given token the member:
 
 .. code:: python
+
     token_provider = BasicTokenProvider("MY-SECRET")
     client = hazelcast.HazelcastClient(
         token_provider=token_provider

hazelcast/client.py

@@ -329,8 +329,9 @@ class SomeClassSerializer(StreamSerializer):
             successful replicas. By default, set to ``False`` (do not fail).
         creds_username (str): Username for credentials authentication (Enterprise feature).
         creds_password (str): Password for credentials authentication (Enterprise feature).
-        token_provider (hazelcast.token_provider.TokenProvider): Token provider for custom authentication (Enterprise feature).
-            Note that token_provider setting has priority over credentials settings.
+        token_provider (hazelcast.security.TokenProvider): Token provider for
+            custom authentication (Enterprise feature). Note that token_provider
+            setting has priority over credentials settings.
     """
 
     _CLIENT_ID = AtomicInteger()

hazelcast/security/token_provider.py renamed to hazelcast/security.py

@@ -1,6 +1,6 @@
 import unittest
 
-from hazelcast.security.token_provider import BasicTokenProvider
+from hazelcast.security import BasicTokenProvider
 
 
 class BasicTokenProviderTestCase(unittest.TestCase):