gcloud 0.1.1 → 0.2.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (35) hide show
  1. checksums.yaml +8 -8
  2. data/AUTHENTICATION.md +1 -1
  3. data/CHANGELOG.md +14 -0
  4. data/OVERVIEW.md +87 -0
  5. data/lib/gcloud.rb +106 -0
  6. data/lib/gcloud/credentials.rb +1 -1
  7. data/lib/gcloud/datastore.rb +44 -31
  8. data/lib/gcloud/datastore/credentials.rb +1 -1
  9. data/lib/gcloud/datastore/dataset.rb +20 -14
  10. data/lib/gcloud/datastore/entity.rb +25 -18
  11. data/lib/gcloud/datastore/key.rb +11 -8
  12. data/lib/gcloud/pubsub.rb +375 -0
  13. data/lib/gcloud/pubsub/connection.rb +284 -0
  14. data/lib/gcloud/pubsub/credentials.rb +29 -0
  15. data/lib/gcloud/pubsub/errors.rb +91 -0
  16. data/lib/gcloud/pubsub/message.rb +90 -0
  17. data/lib/gcloud/pubsub/project.rb +408 -0
  18. data/lib/gcloud/pubsub/received_message.rb +170 -0
  19. data/lib/gcloud/pubsub/subscription.rb +605 -0
  20. data/lib/gcloud/pubsub/subscription/list.rb +50 -0
  21. data/lib/gcloud/pubsub/topic.rb +640 -0
  22. data/lib/gcloud/pubsub/topic/list.rb +46 -0
  23. data/lib/gcloud/storage.rb +84 -66
  24. data/lib/gcloud/storage/bucket.rb +87 -68
  25. data/lib/gcloud/storage/bucket/acl.rb +140 -105
  26. data/lib/gcloud/storage/credentials.rb +1 -1
  27. data/lib/gcloud/storage/errors.rb +8 -0
  28. data/lib/gcloud/storage/file.rb +138 -78
  29. data/lib/gcloud/storage/file/acl.rb +98 -80
  30. data/lib/gcloud/storage/project.rb +42 -32
  31. data/lib/gcloud/version.rb +1 -1
  32. metadata +16 -9
  33. data/CONTRIBUTING.md +0 -93
  34. data/LICENSE +0 -201
  35. data/README.md +0 -110
data/lib/gcloud/storage/bucket/acl.rb CHANGED
@@ -21,11 +21,12 @@ module Gcloud
21
21
  #
22
22
  # Represents a Bucket's Access Control List.
23
23
  #
24
- # require "glcoud/storage"
24
+ # require "gcloud"
25
25
  #
26
- # storage = Gcloud.storage
26
+ # gcloud = Gcloud.new
27
+ # storage = gcloud.storage
27
28
  #
28
- # bucket = storage.find_bucket "my-bucket"
29
+ # bucket = storage.bucket "my-bucket"
29
30
  #
30
31
  # bucket.acl.readers.each { |reader| puts reader }
31
32
  #
@@ -61,11 +62,12 @@ module Gcloud
61
62
  #
62
63
  # === Example
63
64
  #
64
- # require "glcoud/storage"
65
+ # require "gcloud"
65
66
  #
66
- # storage = Gcloud.storage
67
+ # gcloud = Gcloud.new
68
+ # storage = gcloud.storage
67
69
  #
68
- # bucket = storage.find_bucket "my-bucket"
70
+ # bucket = storage.bucket "my-bucket"
69
71
  #
70
72
  # bucket.acl.refresh!
71
73
  #
@@ -86,11 +88,12 @@ module Gcloud
86
88
  #
87
89
  # === Example
88
90
  #
89
- # require "glcoud/storage"
91
+ # require "gcloud"
90
92
  #
91
- # storage = Gcloud.storage
93
+ # gcloud = Gcloud.new
94
+ # storage = gcloud.storage
92
95
  #
93
- # bucket = storage.find_bucket "my-bucket"
96
+ # bucket = storage.bucket "my-bucket"
94
97
  #
95
98
  # bucket.acl.owners.each { |owner| puts owner }
96
99
  #
@@ -108,11 +111,12 @@ module Gcloud
108
111
  #
109
112
  # === Example
110
113
  #
111
- # require "glcoud/storage"
114
+ # require "gcloud"
112
115
  #
113
- # storage = Gcloud.storage
116
+ # gcloud = Gcloud.new
117
+ # storage = gcloud.storage
114
118
  #
115
- # bucket = storage.find_bucket "my-bucket"
119
+ # bucket = storage.bucket "my-bucket"
116
120
  #
117
121
  # bucket.acl.writers.each { |writer| puts writer }
118
122
  #
@@ -130,11 +134,12 @@ module Gcloud
130
134
  #
131
135
  # === Example
132
136
  #
133
- # require "glcoud/storage"
137
+ # require "gcloud"
134
138
  #
135
- # storage = Gcloud.storage
139
+ # gcloud = Gcloud.new
140
+ # storage = gcloud.storage
136
141
  #
137
- # bucket = storage.find_bucket "my-bucket"
142
+ # bucket = storage.bucket "my-bucket"
138
143
  #
139
144
  # bucket.acl.readers.each { |reader| puts reader }
140
145
  #
@@ -166,11 +171,12 @@ module Gcloud
166
171
  # Access to a bucket can be granted to a user by appending +"user-"+ to
167
172
  # the email address:
168
173
  #
169
- # require "glcoud/storage"
174
+ # require "gcloud"
170
175
  #
171
- # storage = Gcloud.storage
176
+ # gcloud = Gcloud.new
177
+ # storage = gcloud.storage
172
178
  #
173
- # bucket = storage.find_bucket "my-bucket"
179
+ # bucket = storage.bucket "my-bucket"
174
180
  #
175
181
  # email = "heidi@example.net"
176
182
  # bucket.acl.add_owner "user-#{email}"
@@ -178,11 +184,12 @@ module Gcloud
178
184
  # Access to a bucket can be granted to a group by appending +"group-"+
179
185
  # to the email address:
180
186
  #
181
- # require "glcoud/storage"
187
+ # require "gcloud"
182
188
  #
183
- # storage = Gcloud.storage
189
+ # gcloud = Gcloud.new
190
+ # storage = gcloud.storage
184
191
  #
185
- # bucket = storage.find_bucket "my-bucket"
192
+ # bucket = storage.bucket "my-bucket"
186
193
  #
187
194
  # email = "authors@example.net"
188
195
  # bucket.acl.add_owner "group-#{email}"
@@ -220,11 +227,12 @@ module Gcloud
220
227
  # Access to a bucket can be granted to a user by appending +"user-"+ to
221
228
  # the email address:
222
229
  #
223
- # require "glcoud/storage"
230
+ # require "gcloud"
224
231
  #
225
- # storage = Gcloud.storage
232
+ # gcloud = Gcloud.new
233
+ # storage = gcloud.storage
226
234
  #
227
- # bucket = storage.find_bucket "my-bucket"
235
+ # bucket = storage.bucket "my-bucket"
228
236
  #
229
237
  # email = "heidi@example.net"
230
238
  # bucket.acl.add_writer "user-#{email}"
@@ -232,11 +240,12 @@ module Gcloud
232
240
  # Access to a bucket can be granted to a group by appending +"group-"+
233
241
  # to the email address:
234
242
  #
235
- # require "glcoud/storage"
243
+ # require "gcloud"
236
244
  #
237
- # storage = Gcloud.storage
245
+ # gcloud = Gcloud.new
246
+ # storage = gcloud.storage
238
247
  #
239
- # bucket = storage.find_bucket "my-bucket"
248
+ # bucket = storage.bucket "my-bucket"
240
249
  #
241
250
  # email = "authors@example.net"
242
251
  # bucket.acl.add_writer "group-#{email}"
@@ -274,11 +283,12 @@ module Gcloud
274
283
  # Access to a bucket can be granted to a user by appending +"user-"+ to
275
284
  # the email address:
276
285
  #
277
- # require "glcoud/storage"
286
+ # require "gcloud"
278
287
  #
279
- # storage = Gcloud.storage
288
+ # gcloud = Gcloud.new
289
+ # storage = gcloud.storage
280
290
  #
281
- # bucket = storage.find_bucket "my-bucket"
291
+ # bucket = storage.bucket "my-bucket"
282
292
  #
283
293
  # email = "heidi@example.net"
284
294
  # bucket.acl.add_reader "user-#{email}"
@@ -286,11 +296,12 @@ module Gcloud
286
296
  # Access to a bucket can be granted to a group by appending +"group-"+
287
297
  # to the email address:
288
298
  #
289
- # require "glcoud/storage"
299
+ # require "gcloud"
290
300
  #
291
- # storage = Gcloud.storage
301
+ # gcloud = Gcloud.new
302
+ # storage = gcloud.storage
292
303
  #
293
- # bucket = storage.find_bucket "my-bucket"
304
+ # bucket = storage.bucket "my-bucket"
294
305
  #
295
306
  # email = "authors@example.net"
296
307
  # bucket.acl.add_reader "group-#{email}"
@@ -325,11 +336,12 @@ module Gcloud
325
336
  #
326
337
  # === Example
327
338
  #
328
- # require "glcoud/storage"
339
+ # require "gcloud"
329
340
  #
330
- # storage = Gcloud.storage
341
+ # gcloud = Gcloud.new
342
+ # storage = gcloud.storage
331
343
  #
332
- # bucket = storage.find_bucket "my-bucket"
344
+ # bucket = storage.bucket "my-bucket"
333
345
  #
334
346
  # email = "heidi@example.net"
335
347
  # bucket.acl.delete "user-#{email}"
@@ -357,11 +369,12 @@ module Gcloud
357
369
  #
358
370
  # === Example
359
371
  #
360
- # require "glcoud/storage"
372
+ # require "gcloud"
361
373
  #
362
- # storage = Gcloud.storage
374
+ # gcloud = Gcloud.new
375
+ # storage = gcloud.storage
363
376
  #
364
- # bucket = storage.find_bucket "my-bucket"
377
+ # bucket = storage.bucket "my-bucket"
365
378
  #
366
379
  # bucket.acl.auth!
367
380
  #
@@ -379,11 +392,12 @@ module Gcloud
379
392
  #
380
393
  # === Example
381
394
  #
382
- # require "glcoud/storage"
395
+ # require "gcloud"
383
396
  #
384
- # storage = Gcloud.storage
397
+ # gcloud = Gcloud.new
398
+ # storage = gcloud.storage
385
399
  #
386
- # bucket = storage.find_bucket "my-bucket"
400
+ # bucket = storage.bucket "my-bucket"
387
401
  #
388
402
  # bucket.acl.private!
389
403
  #
@@ -397,11 +411,12 @@ module Gcloud
397
411
  #
398
412
  # === Example
399
413
  #
400
- # require "glcoud/storage"
414
+ # require "gcloud"
401
415
  #
402
- # storage = Gcloud.storage
416
+ # gcloud = Gcloud.new
417
+ # storage = gcloud.storage
403
418
  #
404
- # bucket = storage.find_bucket "my-bucket"
419
+ # bucket = storage.bucket "my-bucket"
405
420
  #
406
421
  # bucket.acl.project_private!
407
422
  #
@@ -416,11 +431,12 @@ module Gcloud
416
431
  #
417
432
  # === Example
418
433
  #
419
- # require "glcoud/storage"
434
+ # require "gcloud"
420
435
  #
421
- # storage = Gcloud.storage
436
+ # gcloud = Gcloud.new
437
+ # storage = gcloud.storage
422
438
  #
423
- # bucket = storage.find_bucket "my-bucket"
439
+ # bucket = storage.bucket "my-bucket"
424
440
  #
425
441
  # bucket.acl.public!
426
442
  #
@@ -435,11 +451,12 @@ module Gcloud
435
451
  #
436
452
  # === Example
437
453
  #
438
- # require "glcoud/storage"
454
+ # require "gcloud"
439
455
  #
440
- # storage = Gcloud.storage
456
+ # gcloud = Gcloud.new
457
+ # storage = gcloud.storage
441
458
  #
442
- # bucket = storage.find_bucket "my-bucket"
459
+ # bucket = storage.bucket "my-bucket"
443
460
  #
444
461
  # bucket.acl.public_write!
445
462
  #
@@ -469,11 +486,12 @@ module Gcloud
469
486
  #
470
487
  # Represents a Bucket's Default Access Control List.
471
488
  #
472
- # require "glcoud/storage"
489
+ # require "gcloud"
473
490
  #
474
- # storage = Gcloud.storage
491
+ # gcloud = Gcloud.new
492
+ # storage = gcloud.storage
475
493
  #
476
- # bucket = storage.find_bucket "my-bucket"
494
+ # bucket = storage.bucket "my-bucket"
477
495
  #
478
496
  # bucket.default_acl.readers.each { |reader| puts reader }
479
497
  #
@@ -510,11 +528,12 @@ module Gcloud
510
528
  #
511
529
  # === Example
512
530
  #
513
- # require "glcoud/storage"
531
+ # require "gcloud"
514
532
  #
515
- # storage = Gcloud.storage
533
+ # gcloud = Gcloud.new
534
+ # storage = gcloud.storage
516
535
  #
517
- # bucket = storage.find_bucket "my-bucket"
536
+ # bucket = storage.bucket "my-bucket"
518
537
  #
519
538
  # bucket.default_acl.refresh!
520
539
  #
@@ -535,11 +554,12 @@ module Gcloud
535
554
  #
536
555
  # === Example
537
556
  #
538
- # require "glcoud/storage"
557
+ # require "gcloud"
539
558
  #
540
- # storage = Gcloud.storage
559
+ # gcloud = Gcloud.new
560
+ # storage = gcloud.storage
541
561
  #
542
- # bucket = storage.find_bucket "my-bucket"
562
+ # bucket = storage.bucket "my-bucket"
543
563
  #
544
564
  # bucket.default_acl.owners.each { |owner| puts owner }
545
565
  #
@@ -557,11 +577,12 @@ module Gcloud
557
577
  #
558
578
  # === Example
559
579
  #
560
- # require "glcoud/storage"
580
+ # require "gcloud"
561
581
  #
562
- # storage = Gcloud.storage
582
+ # gcloud = Gcloud.new
583
+ # storage = gcloud.storage
563
584
  #
564
- # bucket = storage.find_bucket "my-bucket"
585
+ # bucket = storage.bucket "my-bucket"
565
586
  #
566
587
  # bucket.default_acl.writers.each { |writer| puts writer }
567
588
  #
@@ -579,11 +600,12 @@ module Gcloud
579
600
  #
580
601
  # === Example
581
602
  #
582
- # require "glcoud/storage"
603
+ # require "gcloud"
583
604
  #
584
- # storage = Gcloud.storage
605
+ # gcloud = Gcloud.new
606
+ # storage = gcloud.storage
585
607
  #
586
- # bucket = storage.find_bucket "my-bucket"
608
+ # bucket = storage.bucket "my-bucket"
587
609
  #
588
610
  # bucket.default_acl.readers.each { |reader| puts reader }
589
611
  #
@@ -615,11 +637,12 @@ module Gcloud
615
637
  # Access to a bucket can be granted to a user by appending +"user-"+ to
616
638
  # the email address:
617
639
  #
618
- # require "glcoud/storage"
640
+ # require "gcloud"
619
641
  #
620
- # storage = Gcloud.storage
642
+ # gcloud = Gcloud.new
643
+ # storage = gcloud.storage
621
644
  #
622
- # bucket = storage.find_bucket "my-bucket"
645
+ # bucket = storage.bucket "my-bucket"
623
646
  #
624
647
  # email = "heidi@example.net"
625
648
  # bucket.default_acl.add_owner "user-#{email}"
@@ -627,11 +650,12 @@ module Gcloud
627
650
  # Access to a bucket can be granted to a group by appending +"group-"+
628
651
  # to the email address:
629
652
  #
630
- # require "glcoud/storage"
653
+ # require "gcloud"
631
654
  #
632
- # storage = Gcloud.storage
655
+ # gcloud = Gcloud.new
656
+ # storage = gcloud.storage
633
657
  #
634
- # bucket = storage.find_bucket "my-bucket"
658
+ # bucket = storage.bucket "my-bucket"
635
659
  #
636
660
  # email = "authors@example.net"
637
661
  # bucket.default_acl.add_owner "group-#{email}"
@@ -669,11 +693,12 @@ module Gcloud
669
693
  # Access to a bucket can be granted to a user by appending +"user-"+ to
670
694
  # the email address:
671
695
  #
672
- # require "glcoud/storage"
696
+ # require "gcloud"
673
697
  #
674
- # storage = Gcloud.storage
698
+ # gcloud = Gcloud.new
699
+ # storage = gcloud.storage
675
700
  #
676
- # bucket = storage.find_bucket "my-bucket"
701
+ # bucket = storage.bucket "my-bucket"
677
702
  #
678
703
  # email = "heidi@example.net"
679
704
  # bucket.default_acl.add_writer "user-#{email}"
@@ -681,11 +706,12 @@ module Gcloud
681
706
  # Access to a bucket can be granted to a group by appending +"group-"+
682
707
  # to the email address:
683
708
  #
684
- # require "glcoud/storage"
709
+ # require "gcloud"
685
710
  #
686
- # storage = Gcloud.storage
711
+ # gcloud = Gcloud.new
712
+ # storage = gcloud.storage
687
713
  #
688
- # bucket = storage.find_bucket "my-bucket"
714
+ # bucket = storage.bucket "my-bucket"
689
715
  #
690
716
  # email = "authors@example.net"
691
717
  # bucket.default_acl.add_writer "group-#{email}"
@@ -723,11 +749,12 @@ module Gcloud
723
749
  # Access to a bucket can be granted to a user by appending +"user-"+ to
724
750
  # the email address:
725
751
  #
726
- # require "glcoud/storage"
752
+ # require "gcloud"
727
753
  #
728
- # storage = Gcloud.storage
754
+ # gcloud = Gcloud.new
755
+ # storage = gcloud.storage
729
756
  #
730
- # bucket = storage.find_bucket "my-bucket"
757
+ # bucket = storage.bucket "my-bucket"
731
758
  #
732
759
  # email = "heidi@example.net"
733
760
  # bucket.default_acl.add_reader "user-#{email}"
@@ -735,11 +762,12 @@ module Gcloud
735
762
  # Access to a bucket can be granted to a group by appending +"group-"+
736
763
  # to the email address:
737
764
  #
738
- # require "glcoud/storage"
765
+ # require "gcloud"
739
766
  #
740
- # storage = Gcloud.storage
767
+ # gcloud = Gcloud.new
768
+ # storage = gcloud.storage
741
769
  #
742
- # bucket = storage.find_bucket "my-bucket"
770
+ # bucket = storage.bucket "my-bucket"
743
771
  #
744
772
  # email = "authors@example.net"
745
773
  # bucket.default_acl.add_reader "group-#{email}"
@@ -775,11 +803,12 @@ module Gcloud
775
803
  #
776
804
  # === Example
777
805
  #
778
- # require "glcoud/storage"
806
+ # require "gcloud"
779
807
  #
780
- # storage = Gcloud.storage
808
+ # gcloud = Gcloud.new
809
+ # storage = gcloud.storage
781
810
  #
782
- # bucket = storage.find_bucket "my-bucket"
811
+ # bucket = storage.bucket "my-bucket"
783
812
  #
784
813
  # email = "heidi@example.net"
785
814
  # bucket.default_acl.delete "user-#{email}"
@@ -807,11 +836,12 @@ module Gcloud
807
836
  #
808
837
  # === Example
809
838
  #
810
- # require "glcoud/storage"
839
+ # require "gcloud"
811
840
  #
812
- # storage = Gcloud.storage
841
+ # gcloud = Gcloud.new
842
+ # storage = gcloud.storage
813
843
  #
814
- # bucket = storage.find_bucket "my-bucket"
844
+ # bucket = storage.bucket "my-bucket"
815
845
  #
816
846
  # bucket.acl.auth!
817
847
  #
@@ -829,11 +859,12 @@ module Gcloud
829
859
  #
830
860
  # === Example
831
861
  #
832
- # require "glcoud/storage"
862
+ # require "gcloud"
833
863
  #
834
- # storage = Gcloud.storage
864
+ # gcloud = Gcloud.new
865
+ # storage = gcloud.storage
835
866
  #
836
- # bucket = storage.find_bucket "my-bucket"
867
+ # bucket = storage.bucket "my-bucket"
837
868
  #
838
869
  # bucket.acl.owner_full!
839
870
  #
@@ -848,11 +879,12 @@ module Gcloud
848
879
  #
849
880
  # === Example
850
881
  #
851
- # require "glcoud/storage"
882
+ # require "gcloud"
852
883
  #
853
- # storage = Gcloud.storage
884
+ # gcloud = Gcloud.new
885
+ # storage = gcloud.storage
854
886
  #
855
- # bucket = storage.find_bucket "my-bucket"
887
+ # bucket = storage.bucket "my-bucket"
856
888
  #
857
889
  # bucket.acl.owner_read!
858
890
  #
@@ -867,11 +899,12 @@ module Gcloud
867
899
  #
868
900
  # === Example
869
901
  #
870
- # require "glcoud/storage"
902
+ # require "gcloud"
871
903
  #
872
- # storage = Gcloud.storage
904
+ # gcloud = Gcloud.new
905
+ # storage = gcloud.storage
873
906
  #
874
- # bucket = storage.find_bucket "my-bucket"
907
+ # bucket = storage.bucket "my-bucket"
875
908
  #
876
909
  # bucket.acl.private!
877
910
  #
@@ -885,11 +918,12 @@ module Gcloud
885
918
  #
886
919
  # === Example
887
920
  #
888
- # require "glcoud/storage"
921
+ # require "gcloud"
889
922
  #
890
- # storage = Gcloud.storage
923
+ # gcloud = Gcloud.new
924
+ # storage = gcloud.storage
891
925
  #
892
- # bucket = storage.find_bucket "my-bucket"
926
+ # bucket = storage.bucket "my-bucket"
893
927
  #
894
928
  # bucket.acl.project_private!
895
929
  #
@@ -904,11 +938,12 @@ module Gcloud
904
938
  #
905
939
  # === Example
906
940
  #
907
- # require "glcoud/storage"
941
+ # require "gcloud"
908
942
  #
909
- # storage = Gcloud.storage
943
+ # gcloud = Gcloud.new
944
+ # storage = gcloud.storage
910
945
  #
911
- # bucket = storage.find_bucket "my-bucket"
946
+ # bucket = storage.bucket "my-bucket"
912
947
  #
913
948
  # bucket.acl.public!
914
949
  #