| OLD | NEW |
| 1 # -*- coding: utf-8 -*- |
| 1 # Copyright 2012 Google Inc. All Rights Reserved. | 2 # Copyright 2012 Google Inc. All Rights Reserved. |
| 2 # | 3 # |
| 3 # Licensed under the Apache License, Version 2.0 (the "License"); | 4 # 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 not use this file except in compliance with the License. |
| 5 # You may obtain a copy of the License at | 6 # You may obtain a copy of the License at |
| 6 # | 7 # |
| 7 # http://www.apache.org/licenses/LICENSE-2.0 | 8 # http://www.apache.org/licenses/LICENSE-2.0 |
| 8 # | 9 # |
| 9 # Unless required by applicable law or agreed to in writing, software | 10 # Unless required by applicable law or agreed to in writing, software |
| 10 # distributed under the License is distributed on an "AS IS" BASIS, | 11 # distributed under the License is distributed on an "AS IS" BASIS, |
| 11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 # See the License for the specific language governing permissions and | 13 # See the License for the specific language governing permissions and |
| 13 # limitations under the License. | 14 # limitations under the License. |
| 15 """Additional help about object versioning.""" |
| 14 | 16 |
| 15 from gslib.help_provider import HELP_NAME | 17 from __future__ import absolute_import |
| 16 from gslib.help_provider import HELP_NAME_ALIASES | 18 |
| 17 from gslib.help_provider import HELP_ONE_LINE_SUMMARY | |
| 18 from gslib.help_provider import HelpProvider | 19 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 | 20 |
| 23 _detailed_help_text = (""" | 21 _DETAILED_HELP_TEXT = (""" |
| 24 <B>OVERVIEW</B> | 22 <B>OVERVIEW</B> |
| 25 Versioning-enabled buckets maintain an archive of objects, providing a way to | 23 Versioning-enabled buckets maintain an archive of objects, providing a way to |
| 26 un-delete data that you accidentally deleted, or to retrieve older versions of | 24 un-delete data that you accidentally deleted, or to retrieve older versions of |
| 27 your data. You can turn versioning on or off for a bucket at any time. Turning | 25 your data. You can turn versioning on or off for a bucket at any time. Turning |
| 28 versioning off leaves existing object versions in place, and simply causes the | 26 versioning off leaves existing object versions in place, and simply causes the |
| 29 bucket to stop accumulating new object versions. In this case, if you upload | 27 bucket to stop accumulating new object versions. In this case, if you upload |
| 30 to an existing object the current version is overwritten instead of creating | 28 to an existing object the current version is overwritten instead of creating |
| 31 a new version. | 29 a new version. |
| 32 | 30 |
| 33 Regardless of whether you have enabled versioning on a bucket, every object | 31 Regardless of whether you have enabled versioning on a bucket, every object |
| (...skipping 223 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 257 | 255 |
| 258 <B>FOR MORE INFORMATION</B> | 256 <B>FOR MORE INFORMATION</B> |
| 259 For more details on how to use versioning and preconditions, see | 257 For more details on how to use versioning and preconditions, see |
| 260 https://developers.google.com/storage/docs/object-versioning | 258 https://developers.google.com/storage/docs/object-versioning |
| 261 """) | 259 """) |
| 262 | 260 |
| 263 | 261 |
| 264 class CommandOptions(HelpProvider): | 262 class CommandOptions(HelpProvider): |
| 265 """Additional help about object versioning.""" | 263 """Additional help about object versioning.""" |
| 266 | 264 |
| 267 help_spec = { | 265 # Help specification. See help_provider.py for documentation. |
| 268 # Name of command or auxiliary help info for which this help applies. | 266 help_spec = HelpProvider.HelpSpec( |
| 269 HELP_NAME : 'versions', | 267 help_name='versions', |
| 270 # List of help name aliases. | 268 help_name_aliases=['concurrency', 'concurrency control'], |
| 271 HELP_NAME_ALIASES : ['concurrency', 'concurrency control'], | 269 help_type='additional_help', |
| 272 # Type of help: | 270 help_one_line_summary='Object Versioning and Concurrency Control', |
| 273 HELP_TYPE : HelpType.ADDITIONAL_HELP, | 271 help_text=_DETAILED_HELP_TEXT, |
| 274 # One line summary of this help. | 272 subcommand_help_text={}, |
| 275 HELP_ONE_LINE_SUMMARY : 'Object Versioning and Concurrency Control', | 273 ) |
| 276 # The full help text. | |
| 277 HELP_TEXT : _detailed_help_text, | |
| 278 } | |
| OLD | NEW |