René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Explore going the route of using Clients ?","articleBody":"After our last talk, there have been quite a few different ideas tossed around to make it clear and obvious which credentials and project IDs are in use during a particular API call, some of those have been....\n1. Changing the default values globally\n2. Making \"Connections\" a context manager (`with connection: # do something`)\n3. Creating the concept of a client\n\nWe do (1), are talking about doing (2), while the others tend to do (3) -- and comparing the code, I think (3) is the nicest. \n\ngcloud-node:\n\n``` javascript\nvar gcloud = require('gcloud');\nvar project1_storage = gcloud.storage({projectId: 'project1', keyFilename: '/path/to/key'});\nvar project2_storage_auto = gcloud.storage();\n\n# Do things with the two \"clients\"...\nbucket1 = project1_storage.get_bucket('bucket-1')\nbucket2 = project2_storage_auto.get_bucket('bucket2')\n```\n\ngcloud-ruby\n\n``` ruby\nrequire 'gcloud/storage'\nproject1_storage = Gcloud.storage \"project-id-1\" \"/path/to/key\"\nproject2_storage_auto = Gcloud.storage  # Magically figure out the project ID and credentials\n\n# Do things with the two \"clients\"...\nbucket1 = project1_storage.find_bucket \"bucket-1\"\nbucket2 = project2_storage_auto.find_bucket \"bucket-2\"\n```\n\ngcloud-python\n\n``` python\nfrom gcloud import storage\nfrom gcloud.credentials import get_for_service_account_json\n\n# Create two different credentials.\ncredentials1 = get_for_service_account_json('key1.json')\ncredentials2 = get_for_service_account_json('key2.json')\n\n# Create two different connections.\nconnection1 = storage.Connection(credentials=credentials1)\nconnection2 = storage.Connection(credentials=credentials2)\n\n# Get two different buckets\nbucket1 = storage.get_bucket('bucket-1', project='project1', connection=connection1)\nbucket2 = storage.get_bucket('bucket-2', project='project2', connection=connection2)\n```\n\ngcloud-python if we followed the client pattern:\n\n``` python\nfrom gcloud import storage\n\nproject1_storage = storage.Client('project1', '/path/to/key')\nproject2_storage_auto = storage.Client()\n\n# Do things with the two \"clients\"...\nbucket1 = project1_storage.get_bucket('bucket-1')\nbucket2 = project2_storage_auto.get_bucket('bucket-2')\n```\n\nAnother option for gcloud-python using the client pattern:\n\n``` python\nimport gcloud\n\nproject1_storage = gcloud.storage('project1', '/path/to/key')\nproject2_storage_auto = gcloud.storage()\n\n# Do things with the two \"clients\"\nbucket1 = project1_storage.get_bucket('bucket-1')\nbucket2 = project2_storage_auto.get_bucket('bucket-2')\n```\n\n/cc @dhermes @tseaver \n","author":{"url":"https://github.com/jgeewax","@type":"Person","name":"jgeewax"},"datePublished":"2015-05-05T19:08:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":60},"url":"https://github.com/861/google-cloud-python/issues/861"}