add_file

add_file(snapshot_code, file_path, file_type='main', use_handoff_dir=False, mode=None, create_icon=False)

Add a file to an already existing snapshot. This method is used in piecewise checkins. A blank snapshot can be created using create_snapshot(). This method can then be used to successively add files to the snapshot.

In order to check in the file, the server will need to have access to these files. There are a number of ways of getting the files to the server. When using copy or move mode, the files are either copied or moved to the "handoff_dir". This directory is an agreed upon directory in which to handoff the files to the server. This mode is generally used for checking in user files. For heavy bandwidth checkins, it is recommended to user preallocated checkins.

param:

snapshot_code - the unique code identifier of a snapshot

file_path - path of the file to add to the snapshot.

Optional: this can also be an array to add multiple files at once.

This has much faster performance that adding one file at a time.

Also, note that in this case, file_types must be an array

of equal size.

keyparam:

file_type - type of the file to be added.

Optional: this can also be an array. See file_path argument

for more information.

use_handoff_dir - DEPRECATED: (use mode arg) use handoff dir to checkin

file. The handoff dir is an agreed upon directory between the

client and server to transfer files.

mode - upload|copy|move|manual|inplace - determine the protocol which delievers

the file to the server.

create_icon - (True|False) determine whether to create an icon for

this appended file. Only 1 icon should be created for each

snapshot.

dir_naming - explicitly set a dir_naming expression to use

file_naming - explicitly set a file_naming expression to use

checkin_type - auto or strict which controls whether to auto create versionless and adopt some default dir/file naming

return:

dictionary - the resulting snapshot

example:

This will create a blank model snapshot for character chr001 and

add a file

        search_type = 'prod/asset'

        code = 'chr001'

        search_key = server.build_search_type(search_type, code)

        context = 'model'

        path = "./my_model.ma"



        snapshot = server.create_snapshot(search_key, context)

        server.add_file( snapshot.get('code'), path )

Different files should be separated by file type. For example,

to check in both a maya and houdin file in the same snapshot:

        maya_path = "./my_model.ma"

        houdini_path = "./my_model.hip"



        server.add_file( snapshot_code, maya_path, file_type='maya' )

        server.add_file( snapshot_code, houdini_path, file_type='houdini' )

To transfer files by uploading (using http protocol):

        server.add_file( snapshot_code, maya_path, mode='upload' )

To create an icon for this file

        path = 'image.jpg'

        server.add_file( snapshot_code, path, mode='upload', create_icon=True )

To add multiple files at once

        file_paths = [maya_path, houdini_path]

        file_types ['maya', 'houdini']

        server.add_file( snapshot_code, file_paths, file_types=file_types, mode='upload')