+ 4Ssi >^RIt^RIHtHtHtHtHtHtHtH t H t ^RI H t ^RI HtHtHtHtHt^RIHtHtHtHtHtHtHt^RIHt^RIHt!RR ]4t !R R ] R 7t!R#) N) ERR_NO_SUCH_OBJECT FLAG_MOD_ADDFLAG_MOD_REPLACELdbErrorMessageMessageElement SCOPE_BASESCOPE_ONELEVEL SCOPE_SUBTREE)SDUtils) DeleteError FieldErrorNotFound ProtectErrorUnprotectError) DateTimeFieldDnFieldField GUIDField IntegerFieldSIDField StringField)Query)MODELSc2aa]tRt^&toV3RltRtVtV;t#) ModelMetac <\SV`!WW#3/VBp\\P!VR44VnWnVP4pV\V&V#)c"\V\4#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 RVnVPP4Fbwr#VPV4pVeTpM9\ VP 4'dVP V4pM VP p\ WV4Kd R#)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+itemsgetcallablerNsetattr)selfr2 field_namefield field_valuerNs&, r"__init__Model.__init__Csp !%!2!2!4 J **Z0K&%%--((----- Dg ."5r%c <RVPP RV R2#)z,Return object representation for this model.)r5r8r[s&r"__repr__Model.__repr__\s"4>>**+2dV155r%c ,\VP4#)z4Stringify model instance to implement in each model.)strrBrds&r"__str__ Model.__str__`s477|r%c @VfR#VPVP8H#)zrBasic object equality check only really checks if the dn matches. :param other: The other object to compare with FrD)r[others&&r"__eq__ Model.__eq__ds =77ehh& &r%c &VP!R/VB#)z1Automatically called by custom JSONEncoder class.r7)as_dict)r[r2s&,r"__json__Model.__json__ns||%f%%r%c "VP4#)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 $VPV4#)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 )rw)r3rvs&&r" get_search_dnModel.get_search_dn{su%%r%c R#)z'Returns the objectClass for this model.topr7r7r%r"r-Model.get_object_classsr%c 6V!4pVPW4V#)zCreate a new model instance from the Ldb Message object. :param samdb: SamDB connection :param message: Ldb Message object to create instance from )_apply)r3rvmessagerLs&&& r" _from_messageModel._from_messagese 5" r%c  W nVPP4FDwr4VPV9gK\ WVP WVP,44KF R#)zInternal method to apply Ldb Message to current object. :param samdb: SamDB connection :param message: Ldb Message object to apply N)rVr+rWr/rZ from_db_value)r[rvrattrr]s&&& r"r Model._applysL ;;,,.KDzzW$E$7$7uzz?R$ST/r%Nc V'd-VUu.uFq0PV,PNK! upMRpVPVP\VR7pTPY^,4R#uupi \ d;pTP ^,\8Xd\RTP 24hhRp?ii;i)zuRefresh object from database. :param samdb: SamDB connection :param fields: Optional list of field names to refresh N)scopeattrszRefresh failed, object gone: ) r+r/searchrDr rargsrrr)r[rvr+r!rreses&&& r"refresh Model.refreshs :@f5fQ$$f5T ,,twwj,FC Eq6"6  vvay..!>twwiHII  s%A4"A99 B>5B99B>Fc /pVPP4FEwrEVP'd V'gK!\W4pVR.39gK7WcVP&KG V#)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+rWrFgetattrr/)r[include_hiddenr2obj_dictrr]values&&, r"rq Model.as_dictsX ;;,,.KD<<<>>+r *+0UZZ( / r%c J\V4pVP4VR&\V4pV^8XdRMRpVP4FJwrVVPP V4pVf\ RV R24hWGPV4, pKL V^8d VR, pV#)zoBuild LDAP search expression from kwargs. :param kwargs: fields to use for expression using model field names r4z(&zUnknown field ''))r(r-lenrWr+rX ValueError expression)r3r2criteria num_fieldsrr\rr]s&, r"build_expressionModel.build_expressions<##7#9 ] %?R !)!1 JJJNN:.E} ?:,a!@AA **51 1J "2 > # Jr%c VfVPV4pVPVVVP!R/VBR7p\YYb4# \d1pTP^,\ 8Xd\ RT 24hhRp?ii;i)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)rrzContainer does not exist: r7)rzrrrrrrr)r3rv polymorphicbase_dnrr2resultrs&&&&&, r"query Model.querys$ ?''.G \\'(--0-A-A-KF-K"MFS55  vvay..!;G9EFF  s$A B+A==Bc BVPR4pV'd1VPV\R7pTP Y^,4#VP!V3/VBP4# \d)pTP^,\ 8XdRp?R#hRp?ii;i)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 rDrN)rXrr rrrrr)r3rvr2rDrrs&&, r"rX Model.getsZZ   ll2Zl8$$UF3 399U-f-113 3 66!9 22  sA++ B6BBBc 8V!R/VBpVPV4V#)zCreate object constructs object and calls save straight after. :param samdb: SamDB connection :param kwargs: Fields to populate object from :returns: object r7)save)r3rvr2rLs&&, r"create Model.create smFm  r%c VP!V3/VBpVf6\V4pVeVPV4VP!V3/VBR3#VR3#)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)rXr(updater)r3rvdefaultsr2rLrs&&&, r" get_or_createModel.get_or_create,sZgge&v& ;LE# X&::e-u-t3 3: r%c N\PWP\RR7#)z/Returns a Query of the current models children.T)rrr)rArrDr )r[rvs&&r"childrenModel.children>s%{{ 77.dL Lr%c VPEf.VPV4pTPRVP;'g VP 24W n\ VPR7pVP P4FnwrEVR8wgKVP'dK"\W4pVPW\4pTfKJ\T4'gK]TPT4Kp VPV4VP!V\"R7p VP%W^,4R#VP'WP(4p \ VPR7pVP P4FwrEVR8wgKVP'dK"\W4p\W4p Wk8wgK@VPW\*4pTR.39d\-.\*TP4pTPT4K \V4'd%VP/V4VP1V4R#R# \dp\YR7hRp?ii;i \dp\YR7hRp?ii;i)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=rlrD)r]r)rDrw add_childrBr/rr+rWrGr to_db_valuerrrraddrr rrrVrrmodifyr) r[rvrDrrr]rdb_valuerr existing_obj old_values && r"r Model.saveCs( 77?!!%(B LL3tww33$))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"<<=s07I I. I+ I&&I+. J 9 JJ c VPf \R4hVPVP4R# \dp\RT 24hRp?ii;i)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: )rDr deleter)r[rvrs&& r"r Model.deletesP 77?LM M 5 LL ! 5s34 4 5s8 AAAc \V4pVPVPR4R# \dp\ RT 24hRp?ii;i)zIProtect object from accidental deletion. :param samdb: SamDB connection (D;;DTSD;;;WD)zFailed to protect object: N)r dacl_add_acerDrrr[rvutilsrs&& r"protect Model.protectsM  A   tww(8 9 A!;A3?@ @ A+ A AA c \V4pVPVPR4R# \dp\ RT 24hRp?ii;i)zKUnprotect object from accidental deletion. :param samdb: SamDB connection rzFailed to unprotect object: N)r dacl_delete_acesrDrrrs&& r" unprotectModel.unprotectsM  E  " "477,< = E #?s!CD D Er)rVrDr)F)3r8r9r:r;rrBrdistinguished_namerDrds_core_propagation_datar instance_typer/object_categoryr4r object_guidr object_sid usn_changed usn_created when_changed when_createdr_rerirnrr staticmethodrw classmethodrzr-rrrrqrr rrXrrrrrrrr<r=)r?s@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 E Er%rA) metaclass)"r)ldbrrrrrrr r r samba.sd_utilsr exceptionsr rrrrr+rrrrrrrrrregistryrtyperrAr7r%r"rsY.000#)),,,DEiDEr%