Add documentation for storage.Blob's special methods (contains, next, etc)

Right now it's not really clear how to check for a key's existence (do I need to do if Key('name') in bucket? or just 'name' in bucket?

We need to make sure these special methods are documented with examples in the API docs for the Key class.

The implementation of bucket.__contains__ "wants" a string, but is actually willing to take a string and convert to a key. I would be in favor of dropping that myself, and asking the user to create the key, either via bucket.new_key(name) or by instantiating Key directly.

I think it'd be annoying to need to create the key to check for existence -- I kind of like the magical "we know what to do if you pass us a string".

So:

print 'my-key-name' in bucket
print Key('my-key-name') in bucket
print bucket.new_key('my-key-name') in bucket

should all return a boolean IMO.

You're in luck then: we already DTRT.

Documenting dunder (e.g. __iter__) methods without docstrings.

Attempting ssl verification skipping.

Merge branch 'verifyssl'

chore: remove obsolete replacements in owlbot.py (#60)

Only collapse double-slashes once. (#60)

chore: add custom sync repo settings (#60)

Release v0.4.1 (#60)

feat: add support for overriding `context.engine` by magic argument (#60

feat: pass 'client_options' to base class ctor (#60)

fix: use public pandas APIs where possible (#60)

chore(main): release 0.4.0 (#62)

chore: update templates (#60)

Sort out Query options. (#60)

Nox system test refactor (#60)

dbapi: parse out VALUES format specifiers in groups

dbapi: recognize missing pyformat args in add_missing_id

fix: don't escape collation name (#60)

fix(storage): fix blob metadata to None regression (#60)

Navigation Menu

Repository navigation

Add documentation for storage.Blob's special methods (contains, next, etc) #60

97 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Add documentation for storage.Blob's special methods (contains, next, etc) #60

Description

Activity

tseaver commented on Nov 12, 2014

jgeewax commented on Nov 12, 2014

tseaver commented on Nov 12, 2014

97 remaining items

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions