2024-08-23 16:22:29 +02:00
# coding: utf-8
"""
Codex API
List of endpoints and interfaces available to Codex API users
The version of the OpenAPI document : 0.0 .1
Generated by OpenAPI Generator ( https : / / openapi - generator . tech )
Do not edit the class manually .
""" # noqa: E501
import warnings
from pydantic import validate_call , Field , StrictFloat , StrictStr , StrictInt
from typing import Any , Dict , List , Optional , Tuple , Union
from typing_extensions import Annotated
from pydantic import Field , StrictBytes , StrictStr
from typing import Optional , Union
from typing_extensions import Annotated
2024-12-18 14:22:21 +01:00
from codex_api_client . models . data_item import DataItem
from codex_api_client . models . data_list import DataList
from codex_api_client . models . space import Space
2024-08-23 16:22:29 +02:00
2024-12-18 14:22:21 +01:00
from codex_api_client . api_client import ApiClient , RequestSerialized
from codex_api_client . api_response import ApiResponse
from codex_api_client . rest import RESTResponseType
2024-08-23 16:22:29 +02:00
class DataApi :
""" NOTE: This class is auto generated by OpenAPI Generator
Ref : https : / / openapi - generator . tech
Do not edit the class manually .
"""
def __init__ ( self , api_client = None ) - > None :
if api_client is None :
api_client = ApiClient . get_default ( )
self . api_client = api_client
@validate_call
def download_local (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > bytearray :
""" Download a file from the local node in a streaming manner. If the file is not available locally, a 404 is returned.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_local_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def download_local_with_http_info (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ bytearray ] :
""" Download a file from the local node in a streaming manner. If the file is not available locally, a 404 is returned.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_local_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def download_local_without_preload_content (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Download a file from the local node in a streaming manner. If the file is not available locally, a 404 is returned.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_local_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _download_local_serialize (
self ,
cid ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
if cid is not None :
_path_params [ ' cid ' ] = cid
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/octet-stream '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' GET ' ,
resource_path = ' /data/ {cid} ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def download_network (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
2024-12-18 14:22:21 +01:00
) - > DataItem :
""" Download a file from the network to the local node if it ' s not available locally. Note: Download is performed async. Call can return before download is completed.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def download_network_with_http_info (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ DataItem ] :
""" Download a file from the network to the local node if it ' s not available locally. Note: Download is performed async. Call can return before download is completed.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def download_network_without_preload_content (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Download a file from the network to the local node if it ' s not available locally. Note: Download is performed async. Call can return before download is completed.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _download_network_serialize (
self ,
cid ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
if cid is not None :
_path_params [ ' cid ' ] = cid
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/json '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' POST ' ,
resource_path = ' /data/ {cid} /network ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def download_network_manifest (
self ,
cid : Annotated [ StrictStr , Field ( description = " File for which the manifest is to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > DataItem :
""" Download only the dataset manifest from the network to the local node if it ' s not available locally.
: param cid : File for which the manifest is to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_manifest_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def download_network_manifest_with_http_info (
self ,
cid : Annotated [ StrictStr , Field ( description = " File for which the manifest is to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ DataItem ] :
""" Download only the dataset manifest from the network to the local node if it ' s not available locally.
: param cid : File for which the manifest is to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_manifest_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def download_network_manifest_without_preload_content (
self ,
cid : Annotated [ StrictStr , Field ( description = " File for which the manifest is to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Download only the dataset manifest from the network to the local node if it ' s not available locally.
: param cid : File for which the manifest is to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _download_network_manifest_serialize (
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataItem " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _download_network_manifest_serialize (
self ,
cid ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
if cid is not None :
_path_params [ ' cid ' ] = cid
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/json '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' GET ' ,
resource_path = ' /data/ {cid} /network/manifest ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def download_network_stream (
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
2024-08-23 16:22:29 +02:00
) - > bytearray :
""" Download a file from the network in a streaming manner. If the file is not available locally, it will be retrieved from other nodes in the network if able.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
2024-12-18 14:22:21 +01:00
_param = self . _download_network_stream_serialize (
2024-08-23 16:22:29 +02:00
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
2024-12-18 14:22:21 +01:00
def download_network_stream_with_http_info (
2024-08-23 16:22:29 +02:00
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ bytearray ] :
""" Download a file from the network in a streaming manner. If the file is not available locally, it will be retrieved from other nodes in the network if able.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
2024-12-18 14:22:21 +01:00
_param = self . _download_network_stream_serialize (
2024-08-23 16:22:29 +02:00
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
2024-12-18 14:22:21 +01:00
def download_network_stream_without_preload_content (
2024-08-23 16:22:29 +02:00
self ,
cid : Annotated [ StrictStr , Field ( description = " File to be downloaded. " ) ] ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Download a file from the network in a streaming manner. If the file is not available locally, it will be retrieved from other nodes in the network if able.
: param cid : File to be downloaded . ( required )
: type cid : str
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
2024-12-18 14:22:21 +01:00
_param = self . _download_network_stream_serialize (
2024-08-23 16:22:29 +02:00
cid = cid ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " bytearray " ,
' 400 ' : None ,
' 404 ' : None ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
2024-12-18 14:22:21 +01:00
def _download_network_stream_serialize (
2024-08-23 16:22:29 +02:00
self ,
cid ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
if cid is not None :
_path_params [ ' cid ' ] = cid
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/octet-stream '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' GET ' ,
2024-12-18 14:22:21 +01:00
resource_path = ' /data/ {cid} /network/stream ' ,
2024-08-23 16:22:29 +02:00
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def list_data (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > DataList :
""" Lists manifest CIDs stored locally in node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _list_data_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataList " ,
' 400 ' : None ,
' 404 ' : None ,
2024-12-18 14:22:21 +01:00
' 422 ' : None ,
2024-08-23 16:22:29 +02:00
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def list_data_with_http_info (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ DataList ] :
""" Lists manifest CIDs stored locally in node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _list_data_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataList " ,
' 400 ' : None ,
' 404 ' : None ,
2024-12-18 14:22:21 +01:00
' 422 ' : None ,
2024-08-23 16:22:29 +02:00
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def list_data_without_preload_content (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Lists manifest CIDs stored locally in node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _list_data_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " DataList " ,
' 400 ' : None ,
' 404 ' : None ,
2024-12-18 14:22:21 +01:00
' 422 ' : None ,
2024-08-23 16:22:29 +02:00
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _list_data_serialize (
self ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/json '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' GET ' ,
resource_path = ' /data ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def space (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > Space :
""" Gets a summary of the storage space allocation of the node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _space_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " Space " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def space_with_http_info (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ Space ] :
""" Gets a summary of the storage space allocation of the node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _space_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " Space " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def space_without_preload_content (
self ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Gets a summary of the storage space allocation of the node.
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _space_serialize (
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " Space " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _space_serialize (
self ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
# process the query parameters
# process the header parameters
# process the form parameters
# process the body parameter
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' application/json '
]
)
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' GET ' ,
resource_path = ' /space ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)
@validate_call
def upload (
self ,
2024-12-18 14:22:21 +01:00
content_type : Annotated [ Optional [ StrictStr ] , Field ( description = " The content type of the file. Must be valid. " ) ] = None ,
content_disposition : Annotated [ Optional [ StrictStr ] , Field ( description = " The content disposition used to send the filename. " ) ] = None ,
2024-08-23 16:22:29 +02:00
body : Optional [ Union [ StrictBytes , StrictStr ] ] = None ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > str :
""" Upload a file in a streaming manner. Once finished, the file is stored in the node and can be retrieved by any node in the network using the returned CID.
2024-12-18 14:22:21 +01:00
: param content_type : The content type of the file . Must be valid .
: type content_type : str
: param content_disposition : The content disposition used to send the filename .
: type content_disposition : str
2024-08-23 16:22:29 +02:00
: param body :
: type body : bytearray
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _upload_serialize (
2024-12-18 14:22:21 +01:00
content_type = content_type ,
content_disposition = content_disposition ,
2024-08-23 16:22:29 +02:00
body = body ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " str " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
) . data
@validate_call
def upload_with_http_info (
self ,
2024-12-18 14:22:21 +01:00
content_type : Annotated [ Optional [ StrictStr ] , Field ( description = " The content type of the file. Must be valid. " ) ] = None ,
content_disposition : Annotated [ Optional [ StrictStr ] , Field ( description = " The content disposition used to send the filename. " ) ] = None ,
2024-08-23 16:22:29 +02:00
body : Optional [ Union [ StrictBytes , StrictStr ] ] = None ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > ApiResponse [ str ] :
""" Upload a file in a streaming manner. Once finished, the file is stored in the node and can be retrieved by any node in the network using the returned CID.
2024-12-18 14:22:21 +01:00
: param content_type : The content type of the file . Must be valid .
: type content_type : str
: param content_disposition : The content disposition used to send the filename .
: type content_disposition : str
2024-08-23 16:22:29 +02:00
: param body :
: type body : bytearray
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _upload_serialize (
2024-12-18 14:22:21 +01:00
content_type = content_type ,
content_disposition = content_disposition ,
2024-08-23 16:22:29 +02:00
body = body ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " str " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
response_data . read ( )
return self . api_client . response_deserialize (
response_data = response_data ,
response_types_map = _response_types_map ,
)
@validate_call
def upload_without_preload_content (
self ,
2024-12-18 14:22:21 +01:00
content_type : Annotated [ Optional [ StrictStr ] , Field ( description = " The content type of the file. Must be valid. " ) ] = None ,
content_disposition : Annotated [ Optional [ StrictStr ] , Field ( description = " The content disposition used to send the filename. " ) ] = None ,
2024-08-23 16:22:29 +02:00
body : Optional [ Union [ StrictBytes , StrictStr ] ] = None ,
_request_timeout : Union [
None ,
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Tuple [
Annotated [ StrictFloat , Field ( gt = 0 ) ] ,
Annotated [ StrictFloat , Field ( gt = 0 ) ]
]
] = None ,
_request_auth : Optional [ Dict [ StrictStr , Any ] ] = None ,
_content_type : Optional [ StrictStr ] = None ,
_headers : Optional [ Dict [ StrictStr , Any ] ] = None ,
_host_index : Annotated [ StrictInt , Field ( ge = 0 , le = 0 ) ] = 0 ,
) - > RESTResponseType :
""" Upload a file in a streaming manner. Once finished, the file is stored in the node and can be retrieved by any node in the network using the returned CID.
2024-12-18 14:22:21 +01:00
: param content_type : The content type of the file . Must be valid .
: type content_type : str
: param content_disposition : The content disposition used to send the filename .
: type content_disposition : str
2024-08-23 16:22:29 +02:00
: param body :
: type body : bytearray
: param _request_timeout : timeout setting for this request . If one
number provided , it will be total request
timeout . It can also be a pair ( tuple ) of
( connection , read ) timeouts .
: type _request_timeout : int , tuple ( int , int ) , optional
: param _request_auth : set to override the auth_settings for an a single
request ; this effectively ignores the
authentication in the spec for a single request .
: type _request_auth : dict , optional
: param _content_type : force content - type for the request .
: type _content_type : str , Optional
: param _headers : set to override the headers for a single
request ; this effectively ignores the headers
in the spec for a single request .
: type _headers : dict , optional
: param _host_index : set to override the host_index for a single
request ; this effectively ignores the host_index
in the spec for a single request .
: type _host_index : int , optional
: return : Returns the result object .
""" # noqa: E501
_param = self . _upload_serialize (
2024-12-18 14:22:21 +01:00
content_type = content_type ,
content_disposition = content_disposition ,
2024-08-23 16:22:29 +02:00
body = body ,
_request_auth = _request_auth ,
_content_type = _content_type ,
_headers = _headers ,
_host_index = _host_index
)
_response_types_map : Dict [ str , Optional [ str ] ] = {
' 200 ' : " str " ,
' 500 ' : None ,
}
response_data = self . api_client . call_api (
* _param ,
_request_timeout = _request_timeout
)
return response_data . response
def _upload_serialize (
self ,
2024-12-18 14:22:21 +01:00
content_type ,
content_disposition ,
2024-08-23 16:22:29 +02:00
body ,
_request_auth ,
_content_type ,
_headers ,
_host_index ,
) - > RequestSerialized :
_host = None
_collection_formats : Dict [ str , str ] = {
}
_path_params : Dict [ str , str ] = { }
_query_params : List [ Tuple [ str , str ] ] = [ ]
_header_params : Dict [ str , Optional [ str ] ] = _headers or { }
_form_params : List [ Tuple [ str , str ] ] = [ ]
_files : Dict [ str , Union [ str , bytes ] ] = { }
_body_params : Optional [ bytes ] = None
# process the path parameters
# process the query parameters
# process the header parameters
2024-12-18 14:22:21 +01:00
if content_type is not None :
_header_params [ ' content-type ' ] = content_type
if content_disposition is not None :
_header_params [ ' content-disposition ' ] = content_disposition
2024-08-23 16:22:29 +02:00
# process the form parameters
# process the body parameter
if body is not None :
# convert to byte array if the input is a file name (str)
if isinstance ( body , str ) :
with open ( body , " rb " ) as _fp :
_body_params = _fp . read ( )
else :
_body_params = body
# set the HTTP header `Accept`
if ' Accept ' not in _header_params :
_header_params [ ' Accept ' ] = self . api_client . select_header_accept (
[
' text/plain '
]
)
# set the HTTP header `Content-Type`
if _content_type :
_header_params [ ' Content-Type ' ] = _content_type
else :
_default_content_type = (
self . api_client . select_header_content_type (
[
' application/octet-stream '
]
)
)
if _default_content_type is not None :
_header_params [ ' Content-Type ' ] = _default_content_type
# authentication setting
_auth_settings : List [ str ] = [
]
return self . api_client . param_serialize (
method = ' POST ' ,
resource_path = ' /data ' ,
path_params = _path_params ,
query_params = _query_params ,
header_params = _header_params ,
body = _body_params ,
post_params = _form_params ,
files = _files ,
auth_settings = _auth_settings ,
collection_formats = _collection_formats ,
_host = _host ,
_request_auth = _request_auth
)