h'eZGddZGddZGddZGddeZGdd eZGd d ZGd d ZGddZ dS)ceZdZddZdZdS)Limitc"||_||_dSN)offsetcount)selfrrs ]/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/redis/commands/search/aggregation.py__init__zLimit.__init__s  cf|jr)dt|jt|jgSgS)NLIMIT)rstrrr s r build_argszLimit.build_args s0 : S--s4:? ?Ir N)rr__name__ __module__ __qualname__r rr r rrs7r rc8eZdZdZdZdZdZedZdS)Reducerzr Base reducer object for all reducers. See the `redisearch.reducers` module for the actual reducers. Nc0||_d|_d|_dSr)_args_field_aliasr argss r r zReducer.__init__s   r cp|tur%|jstd|jdd}||_|S)a Set the alias for this reducer. ### Parameters - **alias**: The value of the alias for this reducer. If this is the special value `aggregation.FIELDNAME` then this reducer will be aliased using the same name as the field upon which it operates. Note that using `FIELDNAME` is only possible on reducers which operate on a single field value. This method returns the `Reducer` object making it suitable for chaining. z(Cannot use FIELDNAME alias with no fieldN) FIELDNAMEr ValueErrorr)r aliass r r#z Reducer.aliassD I  ; M !KLLLKOE  r c|jSr)rrs r rz Reducer.args5s zr ) rrr__doc__NAMEr r#propertyrrr r rrs^ D .Xr rceZdZdZdZdZdS) SortDirectionz@ This special class is used to indicate sort direction. Nc||_dSr)field)r r+s r r zSortDirection.__init__As  r )rrrr% DIRSTRINGr rr r r)r):s4Ir r)ceZdZdZdZdS)AsczK Indicate that the given field should be sorted in ascending order ASCNrrrr%r,rr r r.r.EsIIIr r.ceZdZdZdZdS)DesczL Indicate that the given field should be sorted in descending order DESCNr0rr r r2r2MsIIIr r2c^eZdZdZddZdZdZdZdZdZ d Z d Z d Z ddZ dZdZdS)AggregateRequestzH Aggregation request which can be passed to `Client.aggregate`. *c||_g|_g|_d|_d|_d|_d|_g|_d|_dS)a} Create an aggregation request. This request may then be passed to `client.aggregate()`. In order for the request to be usable, it must contain at least one group. - **query** Query string for filtering records. All member methods (except `build_args()`) return the object itself, making them useful for chaining. FrN) _query_aggregateplan _loadfields_loadall_max _with_schema _verbatim_cursor_dialect)r querys r r zAggregateRequest.__init__ZsJ    !  r cN|r|j|nd|_|S)aC Indicate the fields to be returned in the response. These fields are returned in addition to any others implicitly specified. ### Parameters - **fields**: If fields not specified, all the fields will be loaded. Otherwise, fields should be given in the format of `@field`. T)r:extendr;)r fieldss r loadzAggregateRequest.loadqs2  !   # #F + + + + DM r c t|tr|gn|}t|tr|gn|}dtt|g|}|D][}|d|jtt|jgz }||j|j |d|jgz }\|j||S)a| Specify by which fields to group the aggregation. ### Parameters - **fields**: Fields to group by. This can either be a single string, or a list of strings. both cases, the field should be specified as `@field`. - **reducers**: One or more reducers. Reducers may be found in the `aggregation` module. GROUPBYREDUCENAS) isinstancerrlenr&rrCrr9)r rDreducersretreducers r group_byzAggregateRequest.group_bys(44@&&!+Hg!>!>LH::H#c&kk**4V4 . .G HglCGL0A0A,B,BC CC JJw| $ $ $~)gn-- ""3''' r c |D],\}}d|g}||d|gz }|j|-|S)aQ Specify one or more projection expressions to add to each result ### Parameters - **kwexpr**: One or more key-value pairs for a projection. The key is the alias for the projection, and the value is the projection expression itself, for example `apply(square_root="sqrt(@foo)")` APPLYNrI)itemsr9rC)r kwexprr#exprrMs r applyzAggregateRequest.applys["<<>> , ,KE4D/C e}$   & &s + + + + r c~t||}|j||S)a Sets the limit for the most recent group or query. If no group has been defined yet (via `group_by()`) then this sets the limit for the initial pool of results from the query. Otherwise, this limits the number of items operated on from the previous group. Setting a limit on the initial search results may be useful when attempting to execute an aggregation on a sample of a large data set. ### Parameters - **offset**: Result offset from which to begin paging - **num**: Number of results to return Example of sorting the initial results: ``` AggregateRequest("@sale_amount:[10000, inf]") .limit(0, 10) .group_by("@state", r.count()) ``` Will only group by the states found in the first 10 results of the query `@sale_amount:[10000, inf]`. On the other hand, ``` AggregateRequest("@sale_amount:[10000, inf]") .limit(0, 1000) .group_by("@state", r.count() .limit(0, 10) ``` Will group all the results matching the query, but only return the first 10 groups. If you only wish to return a *top-N* style query, consider using `sort_by()` instead. )rr9rCr)r rnum_limits r limitzAggregateRequest.limits<Tvs## ""6#4#4#6#6777 r ct|ttfr|g}g}|D]/}t|tr||j|jgz })||gz }0dtt |g}|||dd}|dkr|dt|gz }|j||S)a, Indicate how the results should be sorted. This can also be used for *top-N* style queries ### Parameters - **fields**: The fields by which to sort. This can be either a single field or a list of fields. If you wish to specify order, you can use the `Asc` or `Desc` wrapper classes. - **max**: Maximum number of results to return. This can be used instead of `LIMIT` and is also faster. Example of sorting by `foo` ascending and `bar` descending: ``` sort_by(Asc("@foo"), Desc("@bar")) ``` Return the top 10 customers: ``` AggregateRequest() .group_by("@customer", r.sum("@paid").alias(FIELDNAME)) .sort_by(Desc("@paid"), max=10) ``` SORTBYmaxrMAX) rJrr)r+r,rKrCgetr9)r rDkwargs fields_argsfrMr\s r sort_byzAggregateRequest.sort_bys8 fsM2 3 3 XF  # #A!]++ #55 s" S--../ ;jj"" 77 E3s88$ $C ""3''' r cxt|tr|g}|D]}|jd|g|S)z Specify filter for post-query results using predicates relating to values in the result set. ### Parameters - **fields**: Fields to group by. This can either be a single string, or a list of strings. FILTER)rJrr9rC)r expressions expressions r filterzAggregateRequest.filter sP k3 ' ' (&-K% ? ?J   & &*'= > > > > r cd|_|S)z| If set, the `schema` property will contain a list of `[field, type]` entries in the result object. T)r=rs r with_schemazAggregateRequest.with_schemas ! r cd|_|S)NT)r>rs r verbatimzAggregateRequest.verbatim#s r rcxdg}|r|dt|gz }|r|dt|dzgz }||_|S)N WITHCURSORCOUNTMAXIDLEi)rr?)r rmax_idlers r cursorzAggregateRequest.cursor'sU~  * Wc%jj) )D  6 YHtO 4 45 5D  r cZ|jg}|jr|d|jr|d|jr ||jz }|jr+|d|dnj|jrc|d|tt|j| |j|j r| d|j g| |j |S)N WITHSCHEMAVERBATIMLOADr6DIALECT) r8r=appendr>r?r;r:rrKrCr@r9)r rMs r rzAggregateRequest.build_args0s{m   % JJ| $ $ $ > # JJz " " " < 4< C = ) JJv    JJsOOOO   ) JJv    JJs3t/0011 2 2 2 JJt' ( ( ( = 3 JJ 4=1 2 2 2 4&''' r c||_|S)z Add a dialect field to the aggregate command. - **dialect** - dialect version to execute the query under )r@)r dialects r rzzAggregateRequest.dialectLs    r N)r6)rrl)rrrr%r rErOrUrYrbrgrirkrrrrzrr r r5r5Us. 2$,,,\---^$8r r5ceZdZdZdZdS)Cursorc0||_d|_d|_dS)Nr)cidrqrr r~s r r zCursor.__init__Ws  r ct|jg}|jr|dt|jgz }|jr|dt|jgz }|S)Nrpro)rr~rqrrs r rzCursor.build_args\sZDH  = 4 YDM 2 23 3D : / Wc$*oo. .D r Nrrr r r|r|Vs2 r r|ceZdZdZdZdS)AggregateResultc0||_||_||_dSr)rowsrrschema)r rrrrs r r zAggregateResult.__init__fs   r c |jr |jjnd}d|jjdt |ddt |jd|d S)N)rrr~ __class__ridrKrrs r __repr__zAggregateResult.__repr__ksm!%4dkoo" 4' 4 4r$xx < 4 4 NN 4 4-0 4 4 4 r N)rrrr rrr r rres2      r rN) objectr!rrr)r.r2r5r|rrr r rsh FHH         ''''''''T-=~~~~~~~~B                   r