OLD | NEW |
| (Empty) |
1 # Copyright 2012 Google Inc. All Rights Reserved. | |
2 # | |
3 # Licensed under the Apache License, Version 2.0 (the "License"); | |
4 # you may not use this file except in compliance with the License. | |
5 # You may obtain a copy of the License at | |
6 # | |
7 # http://www.apache.org/licenses/LICENSE-2.0 | |
8 # | |
9 # Unless required by applicable law or agreed to in writing, software | |
10 # distributed under the License is distributed on an "AS IS" BASIS, | |
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
12 # See the License for the specific language governing permissions and | |
13 # limitations under the License. | |
14 | |
15 from gslib.help_provider import HELP_NAME | |
16 from gslib.help_provider import HELP_NAME_ALIASES | |
17 from gslib.help_provider import HELP_ONE_LINE_SUMMARY | |
18 from gslib.help_provider import HelpProvider | |
19 from gslib.help_provider import HELP_TEXT | |
20 from gslib.help_provider import HelpType | |
21 from gslib.help_provider import HELP_TYPE | |
22 | |
23 _detailed_help_text = (""" | |
24 <B>OVERVIEW</B> | |
25 gsutil users can access publicly readable data without obtaining | |
26 credentials. For example, the gs://uspto-pair bucket contains a number | |
27 of publicly readable objects, so any user can run the following command | |
28 without first obtaining credentials: | |
29 | |
30 gsutil ls gs://uspto-pair/applications/0800401* | |
31 | |
32 Users can similarly download objects they find via the above gsutil ls | |
33 command. | |
34 | |
35 If a user without credentials attempts to access protected data using gsutil, | |
36 they will be prompted to run "gsutil config" to obtain credentials. | |
37 | |
38 See "gsutil help acls" for more details about data protection. | |
39 """) | |
40 | |
41 | |
42 class CommandOptions(HelpProvider): | |
43 """Additional help about Access Control Lists.""" | |
44 | |
45 help_spec = { | |
46 # Name of command or auxiliary help info for which this help applies. | |
47 HELP_NAME : 'anon', | |
48 # List of help name aliases. | |
49 HELP_NAME_ALIASES : ['anonymous', 'public'], | |
50 # Type of help: | |
51 HELP_TYPE : HelpType.ADDITIONAL_HELP, | |
52 # One line summary of this help. | |
53 HELP_ONE_LINE_SUMMARY : | |
54 'Accessing public data without obtaining credentials', | |
55 # The full help text. | |
56 HELP_TEXT : _detailed_help_text, | |
57 } | |
OLD | NEW |