update readme file

Author: bassel-zeidan

scala/README.md

@@ -1,22 +1,22 @@
 # ibmos2spark
 
-The package sets Spark Hadoop configurations for connecting to 
+The package sets Spark Hadoop configurations for connecting to
 IBM Bluemix Object Storage and Softlayer Account Object Storage instances. This packages uses the new [stocator](https://github.com/SparkTC/stocator) driver, which implements the `swift2d` protocol, and is availble
-on the latest IBM Apache Spark Service instances (and through IBM Data Science Experience). 
+on the latest IBM Apache Spark Service instances (and through IBM Data Science Experience).
 
-Using the `stocator` driver connects your Spark executor nodes directly 
+Using the `stocator` driver connects your Spark executor nodes directly
 to your data in object storage.
 This is an optimized, high-performance method to connect Spark to your data. All IBM Apache Spark kernels
-are instantiated with the `stocator` driver in the Spark kernel's classpath. 
-You can also run this locally by installing the [stocator driver](https://github.com/SparkTC/stocator) 
-and adding it to your local Apache Spark kernel's classpath. 
+are instantiated with the `stocator` driver in the Spark kernel's classpath.
+You can also run this locally by installing the [stocator driver](https://github.com/SparkTC/stocator)
+and adding it to your local Apache Spark kernel's classpath.
 
 
 ## Installation
 
 This library is cross-built on both Scala 2.10 (for Spark 1.6.0) and Scala 2.11 (for Spark 2.0.0 and greater)
 
-### Releases 
+### Releases
 
 #### SBT library dependency
 
@@ -69,8 +69,8 @@ Data Science Experience](http://datascience.ibm.com), will install the package.
 
 ### Snapshots
 
-From time-to-time, a snapshot version may be released if fixes or new features are added. 
-The following snipets show how to install snapshot releases. 
+From time-to-time, a snapshot version may be released if fixes or new features are added.
+The following snipets show how to install snapshot releases.
 Replace the version number (`0.0.7`) in the following examples with the version you desire.
 
 ##### SBT library dependency
@@ -138,24 +138,46 @@ Add SNAPSHOT repository to pom.xml
 ## Usage
 
 The usage of this package depends on *from where* your Object Storage instance was created. This package
-is intended to connect to IBM's Object Storage instances obtained from Bluemix or Data Science Experience 
-(DSX) or from a separate account on IBM Softlayer. The instructions below show how to connect to 
-either type of instance. 
+is intended to connect to IBM's Object Storage instances obtained from Bluemix or Data Science Experience
+(DSX) or from a separate account on IBM Softlayer. It also supports IBM cloud object storage (COS).
+The instructions below show how to connect to either type of instance.
 
 The connection setup is essentially the same. But the difference for you is how you deliver the
 credentials. If your Object Storage was created with Bluemix/DSX, with a few clicks on the side-tab
 within a DSX Jupyter notebook, you can obtain your account credentials in the form of a HashMap object.
 If your Object Storage was created with a Softlayer account, each part of the credentials will
-be found as text that you can copy and paste into the example code below. 
+be found as text that you can copy and paste into the example code below.
+
+### IBM Cloud Object Storage / Data Science Experience
+```scala
+import com.ibm.ibmos2spark.CloudObjectStorage
+
+// The credentials HashMap may be created for you with the
+// "insert to code" link in your DSX notebook.
+
+var credentials = scala.collection.mutable.HashMap[String, String](
+  "auth_url"->"https://identity.open.softlayer.com",
+  "project_id"->"xx",
+  "region"->"xx",
+  "user_id"->"xx",
+  "password"->"xx",
+)
+var bucketName = "myBucket"
+var objectname = "mydata"
+
+var bmos = new CloudObjectStorage(sc, credentials)
+var rdd = sc.textFile(bmos.url(bucketName , objectname))
+```
+
 
 ### Bluemix / Data Science Experience
 
 
 ```scala
 import com.ibm.ibmos2spark.bluemix
 
-// The credentials HashMap may be created for you with the 
-// "insert to code" link in your DSX notebook. 
+// The credentials HashMap may be created for you with the
+// "insert to code" link in your DSX notebook.
 
 var credentials = scala.collection.mutable.HashMap[String, String](
   "auth_url"->"https://identity.open.softlayer.com",
@@ -199,7 +221,7 @@ var rdd = sc.textFile(slos.url(container , objectname))
 ### Package Info
 
 One can use the automatically generated object, `BuildInfo`, to obtain the package version
-and other information. This object is automatically generated by the 
+and other information. This object is automatically generated by the
 [`sbt-buildinfo`](https://github.com/sbt/sbt-buildinfo) plugin.
 
 ```
@@ -208,9 +230,9 @@ import com.ibm.ibmos2spark.BuildInfo
 var buildstring = BuildInfo.toString
 var buildbmap = BuildInfo.toMap
 var buildjson = BuildInfo.toJson
-``` 
+```
 
-## License 
+## License
 
 Copyright 2016 IBM Cloud Data Services
 

scala/src/main/scala/Osconfig.scala

@@ -152,11 +152,8 @@ class bluemix(sc: SparkContext, name: String, creds: HashMap[String, String],
              If this value is not specified, you need to pass it when
              you use the url function.
 *
-* When using this from a IBM Spark service instance that
-* is configured to connect to particular Bluemix object store
-* instances, the values for these credentials can be obtained
-* by clicking on the 'insert to code' link just below a data
-* source.
+    Warning: creating a new instance of this class would overwrite the existing
+              spark hadoop configs if set before if used with the same spark context instance.
 */
 class CloudObjectStorage(sc: SparkContext, credentials: HashMap[String, String], cosId: String = "") {