o ٷi_L @sdZddlmZddlmZmZmZddlmZddl m Z ddl m Z ddl m Z m Z dd l mZdd l mZdd l mZdd l mZdd l mZddl mZddlmZddlmZgdZedZGdddeZdeeeefdefddZdeedefddZdeedefddZ  d)deedeeedeeeedeefd d!Z deed"eedeefd#d$Z!deefd%d&Z"deefd'd(Z#dS)*zT Python wrapper around the SoX library. This module requires that SoX is installed. )Path)UnionOptionalList)Literal)core) file_info) ENCODING_VALS EncodingValue)SoxError) SoxiError VALID_FORMATS is_number)play)sox)logger) Transformer) concatenatemergemixz mix-powermultiplycseZdZdZfddZ ddeeefdeeefdede e e fd d Z dde eeefdede e e fd d Z      dd e e ede e e de e ede e ede e ede e ef ddZZS)CombinerzAudio file combiner. Class which allows multiple files to be combined to create an output file, saved to output_filepath. Inherits all methods from the Transformer class, thus any effects can be applied after combining. cstdSN)super__init__)self __class__?/home/ubuntu/.local/lib/python3.10/site-packages/sox/combine.pyr)szCombiner.__init__Ninput_filepath_listoutput_filepath combine_type input_volumesc Cst|t|t|t|t|||j}zt||Wnty.t dYnwg}| |j | d|gt ||}| || ||j||| |jt|\}} } |dkrqtd| d| t d||d|j| durt d | d S) aBuilds the output_file by executing the current set of commands. Parameters ---------- input_filepath_list : list of str List of paths to input audio files. output_filepath : str Path to desired output file. If a file already exists at the given path, the file will be overwritten. combine_type : str Input file combining method. One of the following values: * concatenate : combine input files by concatenating in the order given. * merge : combine input files by stacking each input file into a new channel of the output file. * mix : combine input files by summing samples in corresponding channels. * mix-power : combine input files with volume adjustments such that the output volume is roughly equivlent to one of the input signals. * multiply : combine input files by multiplying samples in corresponding samples. input_volumes : list of float, default=None List of volumes to be applied upon combining input files. Volumes are applied to the input files in order. If None, input files will be combined at their original volumes. Returns ------- status : bool True on success. z unable to validate file formats. --combinerzStdout: z Stderr: z,Created %s with combiner %s and effects: %s Nz[SoX] T)r validate_input_file_listvalidate_output_file_validate_combine_type_validate_volumes_build_input_format_list input_format_validate_file_formatsr rwarningextendglobals_build_input_args_output_format_args output_formatappendeffectsrr infojoin effects_log) rr#r$r%r&input_format_listargs input_argsstatusouterrr!r!r"build,sF &        zCombiner.buildcCs\ddg}||j|d|gt|||j}t||}||||jt|dS)aPlay a preview of the output with the current set of effects Parameters ---------- input_filepath_list : list of str List of paths to input audio files. combine_type : str Input file combining method. One of the following values: * concatenate : combine input files by concatenating in the order given. * merge : combine input files by stacking each input file into a new channel of the output file. * mix : combine input files by summing samples in corresponding channels. * mix-power : combine input files with volume adjustments such that the output volume is roughly equivlent to one of the input signals. * multiply : combine input files by multiplying samples in corresponding samples. input_volumes : list of float, default=None List of volumes to be applied upon combining input files. Volumes are applied to the input files in order. If None, input files will be combined at their original volumes. rz--no-show-progressr'N)r1r2r-r.r3r7r)rr#r%r&r<r;r=r!r!r"preview}s     zCombiner.preview file_typeratebitschannelsencoding ignore_lengthcCs|dur t|ts td|dur"tdd|Ds!tdtng}|dur1t|ts1td|durCtdd|DsBtdng}|durRt|tsRtd |durdtd d|Dsctd ng}|durst|tsstd |durtd d|Dstdng}|durt|tstd|durtdd|Dstdtng}|durt|tstd|durtdd|Dstdng}tt|t|t|t|t|t|g}g}t |D]} | gqt |D]\} } ||  d| gqt |D]\} } ||  d| gqt |D]\} } ||  d| gqt |D]\} }||  d|gq/t |D]\} }||  d|gqCt |D]\} }|durg||  dqW||_ |S)uSets input file format arguments. This is primarily useful when dealing with audio files without a file extension. Overwrites any previously set input file arguments. If this function is not explicity called the input format is inferred from the file extension or the file's header. Parameters ---------- file_type : list of str or None, default=None The file type of the input audio file. Should be the same as what the file extension would be, for ex. 'mp3' or 'wav'. rate : list of float or None, default=None The sample rate of the input audio file. If None the sample rate is inferred. bits : list of int or None, default=None The number of bits per sample. If None, the number of bits per sample is inferred. channels : list of int or None, default=None The number of channels in the audio file. If None the number of channels is inferred. encoding : list of str or None, default=None The audio encoding type. Sometimes needed with file-types that support more than one encoding type. One of: * signed-integer : PCM data stored as signed (‘two’s complement’) integers. Commonly used with a 16 or 24−bit encoding size. A value of 0 represents minimum signal power. * unsigned-integer : PCM data stored as unsigned integers. Commonly used with an 8-bit encoding size. A value of 0 represents maximum signal power. * floating-point : PCM data stored as IEEE 753 single precision (32-bit) or double precision (64-bit) floating-point (‘real’) numbers. A value of 0 represents minimum signal power. * a-law : International telephony standard for logarithmic encoding to 8 bits per sample. It has a precision equivalent to roughly 13-bit PCM and is sometimes encoded with reversed bit-ordering. * u-law : North American telephony standard for logarithmic encoding to 8 bits per sample. A.k.a. μ-law. It has a precision equivalent to roughly 14-bit PCM and is sometimes encoded with reversed bit-ordering. * oki-adpcm : OKI (a.k.a. VOX, Dialogic, or Intel) 4-bit ADPCM; it has a precision equivalent to roughly 12-bit PCM. ADPCM is a form of audio compression that has a good compromise between audio quality and encoding/decoding speed. * ima-adpcm : IMA (a.k.a. DVI) 4-bit ADPCM; it has a precision equivalent to roughly 13-bit PCM. * ms-adpcm : Microsoft 4-bit ADPCM; it has a precision equivalent to roughly 14-bit PCM. * gsm-full-rate : GSM is currently used for the vast majority of the world’s digital wireless telephone calls. It utilises several audio formats with different bit-rates and associated speech quality. SoX has support for GSM’s original 13kbps ‘Full Rate’ audio format. It is usually CPU-intensive to work with GSM audio. ignore_length : list of bool or None, default=None If True, overrides an (incorrect) audio length given in an audio file’s header. If this option is given then SoX will keep reading audio until it reaches the end of the input file. Nz!file_type must be a list or None.cSg|]}|tvqSr!r.0fr!r!r" z-Combiner.set_input_format..z$file_type elements must be one of {}zrate must be a list or None.cSsg|] }t|o |dkqSrr)rKrr!r!r"rMsz&rate elements must be positive floats.zbits must be a list or None.cSg|] }t|to |dkqSrO isinstanceint)rKbr!r!r"rMz#bit elements must be positive ints.z channels must be a list or None.cSrQrOrR)rKcr!r!r"rMrVz'channel elements must be positive ints.z encoding must be a list or None.cSrIr!)r )rKer!r!r"rMrNz&elements of encoding must be one of {}z%ignore_length must be a list or None.cSsg|]}t|tqSr!)rSbool)rKlr!r!r"rM$sz(ignore_length elements must be booleans.z-tz-rz-bz-cz-eTz--ignore-length)rSlist ValueErrorallformatrr maxlenranger6 enumerater1r.)rrCrDrErFrGrHmax_input_arg_lenr._irLrPrUrWrXrZr!r!r"set_input_formatsF    zCombiner.set_input_formatr)NNNNNN)__name__ __module__ __qualname____doc__rrstrr CombineTyperrfloatrArBrTr rYrf __classcell__r!r!rr"r sP     T  +      rr#r%cCs$t|||dkrt||dSdS)zValidate that combine method can be performed with given files. Raises IOError if input file formats are incompatible. rN)_validate_sample_rates_validate_num_channels)r#r%r!r!r"r/Is r/cC*dd|D}t|std|dS)zA Check if files in input file list have the same sample rate cSg|]}t|qSr!)r sample_raterJr!r!r"rMX z*_validate_sample_rates..zsInput files do not have the same sample rate. The {} combine type requires that all files have the same sample rateNr all_equalOSErrorr^)r#r% sample_ratesr!r!r"roTs rocCrq)zH Check if files in input file list have the same number of channels cSrrr!)r rFrJr!r!r"rMgrtz*_validate_num_channels..zInput files do not have the same number of channels. The {} combine type requires that all files have the same number of channelsNru)r#r%rFr!r!r"rpcs rpNr&r.returnc Cst|}g}t|D]}|gq |durdg|}n8t|}||kr8td|||||dg||}n||krMtd|||||d|}ndd|D}|durbddt|D}nDt|} | |krtd| ||| d d|D}|d dt|| Dn| |krtd | || ||d|}nd d|D}tt||D]\} \} } || d | g|| | q|S)aSet input formats given input_volumes. Parameters ---------- input_filepath_list : list of str List of input files input_volumes : list of float, default=None List of volumes to be applied upon combining input files. Volumes are applied to the input files in order. If None, input files will be combined at their original volumes. input_format : list of lists, default=None List of input formats to be applied to each input file. Formatting arguments are applied to the input files in order. If None, the input formats will be inferred from the file header. NrzkVolumes were only specified for %s out of %s files.The last %s files will remain at their original volumes.z\%s volumes were specified but only %s input files exist.The last %s volumes will be ignored.cSg|]}|qSr!r!)rKvr!r!r"rMz,_build_input_format_list..cSg|]}gqSr!r!rKrdr!r!r"rMr|zcInput formats were only specified for %s out of %s files.The last %s files will remain unformatted.cSrzr!r!rJr!r!r"rMr|cSr}r!r!r~r!r!r"rMr|zc%s Input formats were specified but only %s input files exist. The last %s formats will be ignored.cSrzr!r!rJr!r!r"rMr|z-v)r`rar6rr0r1rbzip) r#r&r.n_inputsr;rdvols n_volumesfmtsn_fmtsrevolfmtr!r!r"r-ssR       r-r;cCsZdd|D}t|t|krtdg}t||}|D]\}}||||q|S)zY Builds input arguments by stitching input filepaths and input formats together. cSsg|]}t|qSr!)rk)rKxr!r!r"rMrNz%_build_input_args..z=input_format_list & input_filepath_list are not the same size)r`r\rr1r6)r#r;r=zipped input_file input_fmtr!r!r"r3s    r3cCs|tvr tdtdS)zwCheck that the combine_type is valid. Parameters ---------- combine_type : str Combine type. z1Invalid value for combine_type. Must be one of {}N) COMBINE_VALSr\r^)r%r!r!r"r+s r+cCsN|dus t|ts tdt|tr#|D]}t|s"td|qdSdS)zCheck input_volumes contains a valid list of volumes. Parameters ---------- input_volumes : list list of volume values. Castable to numbers. Nz%input_volumes must be None or a list.z3Elements of input_volumes must be numbers: found {})rSr[ TypeErrorrrr\r^)r&rr!r!r"r,s   r,)NN)$rjpathlibrtypingrrrtyping_extensionsrrr r r r r rrrrlogr transformrrrlrrkr/rorprmr-r3r+r,r!r!r!r"sZ            +     M