o w+f+@sTGdddeZGdddeZGdddeZGdddeZGdd d eZd S) c@seZdZdZ dddZddZddZed d Zej d d Zed d Z e j dd Z eddZ e j ddZ eddZ e j ddZ eddZ e j ddZ eddZej ddZeddZej ddZdS)StatszP Object for building query params for a global email statistics request NcCs<d|_d|_d|_d|_d|_d|_d|_|r||_dSdS)zCreate a Stats object :param start_date: Date of when stats should begin in YYYY-MM-DD format, defaults to None :type start_date: string, optional N) _start_date _end_date_aggregated_by_sort_by_metric_sort_by_direction_limit_offset start_date)selfr r O/var/www/html/venv/lib/python3.10/site-packages/sendgrid/helpers/stats/stats.py__init__s zStats.__init__cCs t|S)zJGet a JSON representation of this object. :rtype: string )strgetr r r r __str__s z Stats.__str__cCsi}|jdur |j|d<|jdur|j|d<|jdur |j|d<|jdur*|j|d<|jdur4|j|d<|jdur>|j|d<|jdurH|j|d<|S) z Get a JSON-ready representation of Stats :returns: This GlobalStats, ready for use in a request body. :rtype: response stats dict Nr end_date aggregated_bysort_by_metricsort_by_directionlimitoffset)r rrrrrrr statsr r r rs               z Stats.getcC|jS)zUDate of when stats should begin in YYYY-MM-DD format :rtype: string rrr r r r 7zStats.start_datecC ||_dS)zDate of when stats should begin in YYYY-MM-DD format :param value: Date representing when stats should begin :type value: string Nrr valuer r r r ? cCr)zSDate of when stats should end in YYYY-MM-DD format :rtype: string rrr r r rHrzStats.end_datecCr)zDate of when stats should end in YYYY-MM-DD format :param value: Date representing when stats should end :type value: string Nr!rr r r rPr cCr)zfChosen period (e.g. 'day', 'week', 'month') for how stats get grouped :rtype: string rrr r r rYrzStats.aggregated_bycCr)zChosen period (e.g. 'day', 'week', 'month') for how stats get grouped :param value: Period for how keys will get formatted :type value: string Nr"rr r r rar cCr)z8Metric to sort stats by :rtype: string rrr r r rjrzStats.sort_by_metriccCr)zyMetric to sort stats by :param value: Chosen metric stats will by sorted by :type value: string Nr#rr r r rrr cCr)zVDirection data will be sorted, either 'asc' or 'desc' :rtype: string rrr r r r{rzStats.sort_by_directioncCr)zDirection data will be sorted, either 'asc' or 'desc' :param value: Direction of data, either 'asc' or 'desc' :type value: string Nr$rr r r rr cCr)zBMax amount of results to be returned :rtype: int rrr r r rrz Stats.limitcCr)zsMax amount of results to be returned :param value: Max amount of results :type value: int Nr%rr r r rr cCr)zWNumber of places a starting point of a data set will move :rtype: int rrr r r rrz Stats.offsetcCr)zNumber of places a starting point of a data set will move :param value: Number of positions to move from starting point :type value: int Nr&rr r r rr N)__name__ __module__ __qualname____doc__r rrpropertyr setterrrrrrrr r r r rsD              rc>eZdZdZd fdd ZddZeddZd d ZZ S) CategoryStatszL object for building query params for a category statistics request NcFd|_tt||r|r||_|D] }|t|qdSdSdS)a7Create a CategoryStats object :param start_date: Date of when stats should begin in YYYY-MM-DD format, defaults to None :type start_date: string, optional :param categories: list of categories to get results of, defaults to None :type categories: list(string), optional N) _categoriessuperr/r r add_categoryCategory)r r categoriescat_name __class__r r r zCategoryStats.__init__cCi}|jdur |j|d<|jdur|j|d<|jdur |j|d<|jdur*|j|d<|jdur4|j|d<|jdur>|j|d<|jdurH|j|d<|jdurWd d |jD|d <|S) zw Get a JSON-ready representation of this CategoryStats. :return: response category stats dict Nr rrrrrrcSg|]}|qSr r).0categoryr r r z%CategoryStats.get..r5)r rrrrrrr5rr r r r(                zCategoryStats.getcCr)z;List of categories :rtype: list(Category) )r1rr r r r5rzCategoryStats.categoriescC |jdurg|_|j|dS)zAppends a category to this object's category list :param category: Category to append to CategoryStats :type category: Category N)r1append)r r>r r r r3 zCategoryStats.add_categoryNN) r(r)r*r+r rr,r5r3 __classcell__r r r7r r/ r/cr.) SubuserStatszJ object of building query params for a subuser statistics request Ncr0)a0Create a SubuserStats object :param start_date: Date of when stats should begin in YYYY-MM-DD format, defaults to None :type start_date: string, optional :param subusers: list of subusers to get results of, defaults to None :type subusers: list(string), optional N) _subusersr2rHr r add_subuserSubuser)r r subusers subuser_namer7r r r r9zSubuserStats.__init__cCr:) zu Get a JSON-ready representation of this SubuserStats. :return: response subuser stats dict Nr rrrrrrcSr;r r<)r=subuserr r r r?r@z$SubuserStats.get..rL)r rrrrrrrLrr r r rrAzSubuserStats.getcCr)z8List of subusers :rtype: list(Subuser) )rIrr r r rL rzSubuserStats.subuserscCrB)zAppends a subuser to this object's subuser list :param subuser: Subuser to append to SubuserStats :type subuser: Subuser N)rIrC)r rNr r r rJ(rDzSubuserStats.add_subuserrE) r(r)r*r+r rr,rLrJrFr r r7r rHrGrHc@<eZdZdZd ddZeddZejddZdd ZdS) r4zZ Represents a searchable statistics category to be used in a CategoryStats object NcCd|_|dur ||_dSdS)zCreate a Category object :param name: name of category, defaults to None :type name: string, optional N_namer namer r r r 7 zCategory.__init__cCr)z5Get name of category :rtype: string rQrr r r rTArz Category.namecCr)zqSet name of category :param value: name of the statistical category :type value: string NrQrr r r rTIr cCr)zj Get a string representation of Category. :return: string of the category's name rTrr r r rRrz Category.getr' r(r)r*r+r r,rTr-rr r r r r43    r4c@rO) rKzM Represents a searchable subuser to be used in a SubuserStats object NcCrP)z}Create a Subuser object :param name: name of subuser, defaults to None :type name: string, optional NrQrSr r r r _rUzSubuser.__init__cCr)z8Get name of the subuser :rtype: string rQrr r r rTirz Subuser.namecCr)zgSet name of the subuser :param value: name of the subuser :type value: string NrQrr r r rTqr cCr)zh Get a string representation of Subuser. :return: string of the subuser's name rVrr r r rzrz Subuser.getr'rWr r r r rK[rXrKN)objectrr/rHr4rKr r r r s /BB(