g >SSKrSSKJrJrJrJrJrJrJrJ r J r SSK J r SSK JrJrJrJrJr SSKJrJrJrJrJrJrJr SSKJr SSKJr "S S \5r "S S \ S 9r!g)N) ERR_NO_SUCH_OBJECT FLAG_MOD_ADDFLAG_MOD_REPLACELdbErrorMessageMessageElement SCOPE_BASESCOPE_ONELEVEL SCOPE_SUBTREE)SDUtils) DeleteError FieldErrorNotFound ProtectErrorUnprotectError) DateTimeFieldDnFieldField GUIDField IntegerFieldSIDField StringField)Query)MODELSc(^\rSrSrU4SjrSrU=r$) ModelMeta&c >[TU]"XX#40UD6n[[R"US55UlXlUR5nU[U'U$)Nc"[U[5$N) isinstancer)fs ;/usr/lib/python3/dist-packages/samba/domain/models/model.py#ModelMeta.__new__..*s Jq%;s 33G3G3Ir')default objectGUID objectSid uSNChanged uSNCreated whenChanged whenCreatedc SUlURR5H`up#URU5nUbUnO8[ UR 5(aUR U5nO UR n[ XU5 Mb g)zCreate a new model instance and optionally populate fields. Does not save the object to the database, call .save() for that. :param kwargs: Optional input fields to populate object with N)_messager-itemsgetcallablerOsetattr)selfr4 field_namefield field_valuerOs r$__init__Model.__init__Csp !%!2!2!4 J **Z0K&%%--((----- Dg ."5r'c<SURRSUS3$)z,Return object representation for this model.)r7r:r\s r$__repr__Model.__repr__\s"4>>**+2dV155r'c,[UR5$)z4Stringify model instance to implement in each model.)strrCres r$__str__ Model.__str__`s477|r'c<UcgURUR:H$)zrBasic object equality check only really checks if the dn matches. :param other: The other object to compare with FrE)r\others r$__eq__ Model.__eq__ds =77ehh& &r'c &UR"S0UD6$)z1Automatically called by custom JSONEncoder class.r9)as_dict)r\r4s r$__json__Model.__json__ns||%f%%r'c"UR5$)zwReturn the base DN for the container of this model. :param samdb: SamDB connection :return: Dn to use for new objects )get_default_basedn)samdbs r$ get_base_dnModel.get_base_dnrs''))r'c$URU5$)zReturn the DN used for querying. By default, this just calls get_base_dn, but it is possible to return a different Dn for querying. :param samdb: SamDB connection :return: Dn to use for searching )rx)r5rws r$ get_search_dnModel.get_search_dn{su%%r'cg)z'Returns the objectClass for this model.topr9r9r'r$r/Model.get_object_classsr'c6U"5nURX5 U$)zCreate a new model instance from the Ldb Message object. :param samdb: SamDB connection :param message: Ldb Message object to create instance from )_apply)r5rwmessagerMs r$ _from_messageModel._from_messagese 5" r'c X lURR5H?up4URU;dM[ XUR XUR55 MA g)zInternal method to apply Ldb Message to current object. :param samdb: SamDB connection :param message: Ldb Message object to apply N)rWr-rXr1r[ from_db_value)r\rwrattrr^s r$r Model._applysL ;;,,.KDzzW$E$7$7uzz?R$ST/r'Nc^U(a)UVs/sHo0RURPM snOSnURUR[US9nURXS5 gs snf![ a5nUR S[:Xa[SUR35eeSnAff=f)zuRefresh object from database. :param samdb: SamDB connection :param fields: Optional list of field names to refresh N)scopeattrsrzRefresh failed, object gone: ) r-r1searchrEr rargsrrr)r\rwr-r#rreses r$refresh Model.refreshs :@f5fQ$$f5T ,,twwj,FC Eq6"6  vvay..!>twwiHII  s"A(A-- B,70B''B,Fc 0nURR5HBupEUR(a U(dM[X5nUS/4;dM4XcUR'MD U$)zReturns a dict representation of the model. :param include_hidden: Include fields with hidden=True when set :returns: dict representation of model using Ldb field names as keys N)r-rXrGgetattrr1)r\include_hiddenr4obj_dictrr^values r$rr Model.as_dictsV ;;,,.KD<<>>+r *+0UZZ( / r'c 4[U5nUR5US'[U5nUS:XaSOSnUR5HEupVURR U5nUc[ SUS35eXGRU5- nMG US:aUS- nU$)zoBuild LDAP search expression from kwargs. :param kwargs: fields to use for expression using model field names r6r z(&zUnknown field ''))r*r/lenrXr-rY ValueError expression)r5r4criteria num_fieldsrr]rr^s r$build_expressionModel.build_expressions<##7#9 ] %?R !)!1 JJJNN:.E} ?:,a!@AA **51 1J "2 > # Jr'c UcURU5nURUUUR"S0UD6S9n[XXb5$![a+nURS[ :Xa[ SU35eeSnAff=f)aKReturns a search query for this model. NOTE: If polymorphic is enabled then querying will return instances of that specific model, for example querying User can return Computer and ManagedServiceAccount instances. By default, polymorphic querying is disabled, and querying User will only return User instances. :param samdb: SamDB connection :param polymorphic: If true enables polymorphic querying (see note) :param base_dn: Optional provide base dn for searching or use the model :param scope: Ldb search scope (default SCOPE_SUBTREE) :param kwargs: Search criteria as keyword args N)rrrzContainer does not exist: r9)r{rrrrrrr)r5rw polymorphicbase_dnrr4resultrs r$query Model.querys$ ?''.G \\'(--0-A-A-KF-K"MFS55  vvay..!;G9EFF  s!A A8 &A33A8c $URS5nU(a)URU[S9nUR XS5$UR"U40UD6R5$![a"nURS[ :XaSnAgeSnAff=f)a~Get one object, must always return one item. Either find object by dn=, or any combination of attributes via kwargs. If there are more than one result, MultipleObjectsReturned is raised. :param samdb: SamDB connection :param kwargs: Search criteria as keyword args :returns: Model instance or None if not found :raises: MultipleObjects returned if there are more than one results rErrN)rYrr rrrrr)r5rwr4rErrs r$rY Model.getsZZ   ll2Zl8$$UF3 399U-f-113 3 66!9 22  sA## B-B  B  Bc 8U"S0UD6nURU5 U$)zCreate object constructs object and calls save straight after. :param samdb: SamDB connection :param kwargs: Fields to populate object from :returns: object r9)save)r5rwr4rMs r$create Model.create smFm  r'c UR"U40UD6nUc4[U5nUbURU5 UR"U40UD6S4$US4$)zRetrieve object and if it doesn't exist create a new instance. :param samdb: SamDB connection :param defaults: Attributes only used for create but not search :param kwargs: Attributes used for searching existing object :returns: (object, bool created) TF)rYr*updater)r5rwdefaultsr4rMrs r$ get_or_createModel.get_or_create,sZgge&v& ;LE# X&::e-u-t3 3: r'cH[RXR[SS9$)z/Returns a Query of the current models children.T)rrr)rArrEr )r\rws r$childrenModel.children>s%{{ 77.dL Lr'cURGcURU5nURSUR=(d UR35 X l[ URS9nUR R5HjupEUS:wdM UR(aM [X5nURX[5nUcMG[U5(dMYURU5 Ml URU5 UR!U["S9n UR%XS5 gUR'XR(5n [ URS9nUR R5HupEUS:wdM UR(aM [X5n[X5n Xk:wdM=URX[*5nUS/4;a[-/[*UR5nURU5 M [U5(a#UR/U5 UR1U5 gg![an[XS9eSnAff=f![an[XS9eSnAff=f)a|Save model to Ldb database. The save operation will save all fields excluding fields that return None when calling their `to_db_value` methods. The `to_db_value` method can either return a ldb Message object, or None if the field is to be excluded. For updates, the existing object is fetched and only fields that are changed are included in the update ldb Message. Also for updates, any fields that currently have a value, but are to be set to None will be seen as a delete operation. After the save operation the object is refreshed from the server, as often the server will populate some fields. :param samdb: SamDB connection NzCN=rmrE)r^rr)rErx add_childrCr1rr-rXrHr to_db_valuerrrraddrr rrrWrrmodifyr) r\rwrErrr^rdb_valuerr existing_obj old_values r$r Model.saveCs( 77?!!%(B LL3tww3$))45 6G)G#{{002 4<#D/E9#(#4#4U<#P  +H  H- 3 IIg ,,r,4C KK1v & --e]]CL)G#{{002 4<#D/E ' ;I)=','8'89I(KH $bz1'5b6F6;jj(BH H-# 3(7|| W% U# Q&9(889: *=",Q"<<=s00H42I4 I > II  I' I""I'cURc [S5eURUR5 g![an[SU35eSnAff=f)z{Delete item from Ldb database. If self.dn is None then the object has not yet been saved. :param samdb: SamDB connection Nz,Cannot delete object that doesn't have a dn.zDelete failed: )rErdeleter)r\rwrs r$r Model.deletesP 77?LM M 5 LL ! 5s34 4 5s6 AAAc[U5nURURS5 g![an[ SU35eSnAff=f)zIProtect object from accidental deletion. :param samdb: SamDB connection (D;;DTSD;;;WD)zFailed to protect object: N)r dacl_add_acerErrr\rwutilsrs r$protect Model.protectsM  A   tww(8 9 A!;A3?@ @ A* AAAc[U5nURURS5 g![an[ SU35eSnAff=f)zKUnprotect object from accidental deletion. :param samdb: SamDB connection rzFailed to unprotect object: N)r dacl_delete_acesrErrrs r$ unprotectModel.unprotectsM  E  " "477,< = E #?s!CD D Er)rWrEr!)F)2r:r;r<r=rrCrdistinguished_namerErds_core_propagation_datar instance_typer1object_categoryr6r object_guidr object_sid usn_changed usn_created when_changed when_createdr`rfrjrors staticmethodrx classmethodr{r/rrrrrrr rrYrrrrrrrr>r9r'r$rArA1s T B !45 B,-D484 I 0M v D./O}'IKLL)K+&J|D4HK|D4HK tdKL tdKL/26'&** & & U#$ 2&+T66@44<  "L K$Z 5 A Er'rA) metaclass)"r+ldbrrrrrrr r r samba.sd_utilsr exceptionsrrrrrr-rrrrrrrrrregistryrtyperrAr9r'r$rsY.000#)),,,DEiDEr'