[dZddlmZddlmZddlmZddlmZddlmZddlm Z ddlm Z dd lm Z d Z d Z d Zejej ej"j$Gd dej&Zejej ej"j*GddeZy)zCImplementation of Unix-like mv command for cloud storage providers.)absolute_import)division)unicode_literals)base)cp_command_util)errors)flags) storage_urla The mv command allows you to move data between your local file system and the cloud, move data within the cloud, and move data between cloud storage providers. *Renaming Groups Of Objects* You can use the mv command to rename all objects with a given prefix to have a new prefix. For example, the following command renames all objects under gs://my_bucket/oldprefix to be under gs://my_bucket/newprefix, otherwise preserving the naming structure: $ {command} gs://my_bucket/oldprefix gs://my_bucket/newprefix Note that when using mv to rename groups of objects with a common prefix, you cannot specify the source URL using wildcards; you must spell out the complete name. If you do a rename as specified above and you want to preserve ACLs. *Non-Atomic Operation* Unlike the case with many file systems, the mv command does not perform a single atomic operation. Rather, it performs a copy from source to destination followed by removing the source for each object. A consequence of this is that, in addition to normal network and operation charges, if you move a Nearline Storage, Coldline Storage, or Archive Storage object, deletion and data retrieval charges apply. See the documentation for pricing details. a To move all objects from a bucket to a local directory you could use: $ {command} gs://my_bucket/* dir Similarly, to move all objects from a local directory to a bucket you could use: $ {command} ./dir gs://my_bucket The following command renames all objects under gs://my_bucket/oldprefix to be under gs://my_bucket/newprefix, otherwise preserving the naming structure: $ {command} gs://my_bucket/oldprefix gs://my_bucket/newprefix  c0eZdZdZeedZedZdZ y)MvMoves or renames objects. DESCRIPTIONEXAMPLEScvtj||jtj|y)N)radd_cp_and_mv_flags ReleaseTrackr add_per_object_retention_flags)clsparsers lib/surface/storage/mv.pyArgszMv.ArgsXs)''0@0@0BC ((0cV|jD]w}tj|}t|tjr%|j st jd|jsdt jdd|_ tj|d|_ y)NzCannot mv buckets.zCannot mv stdin.T) delete_source) sourcer storage_url_from_string isinstanceCloudUrl is_objectrInvalidUrlErroris_stdio recursiverrun_cp exit_code)selfargs url_stringurls rRunzMv.Run]skk  / / ;c C-- .s}}$$%9:: $$%788 "DN$++DEDNrN) __name__ __module__ __qualname____doc___COMMAND_DESCRIPTION _GA_EXAMPLES detailed_help classmethodrr+rrr r Ns0"*- 11 Frr c eZdZdZeeezdZy)MvAlpharrN)r,r-r.r/r0r1_ALPHA_EXAMPLESr2r4rrr6r6js"*0-rr6N)r/ __future__rrrgooglecloudsdk.callioper"googlecloudsdk.command_lib.storagerrr r r0r1r7UniverseCompatible ReleaseTracksrGACommandr ALPHAr6r4rrr@sJ&'(>54:> D%%(()FF*F4D%%++,b-r