Äcdocutils.nodes
document
q)Åq}q(U	nametypesq}q(X/���use case 42 - update system metadata propertiesqNX���goalqNX���triggersqNX���processq	NX���summaryq
NX
���preconditionsqNX���uc42qàX���post conditionsq
NX���actorsqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU
decorationqNUautofootnote_startqKUnameidsq}q(hU-use-case-42-update-system-metadata-propertiesqhUgoalqhUtriggersqh	Uprocessqh
UsummaryqhU
preconditionsqhUuc42qh
Upost-conditionsqhUactorsq uUchildrenq!]q"(cdocutils.nodes
target
q#)Åq$}q%(U	rawsourceq&X	���.. _UC42:Uparentq'hUsourceq(Xj���/var/lib/jenkins/jobs/API_Documentation_trunk/workspace/api-documentation/source/design/UseCases/42_uc.txtq)Utagnameq*Utargetq+U
attributesq,}q-(Uidsq.]Ubackrefsq/]Udupnamesq0]Uclassesq1]Unamesq2]Urefidq3huUlineq4KUdocumentq5hh!]ubcdocutils.nodes
section
q6)Åq7}q8(h&U�h'hh(h)Uexpect_referenced_by_nameq9}q:hh$sh*Usectionq;h,}q<(h0]h1]h/]h.]q=(hheh2]q>(hheuh4Kh5hUexpect_referenced_by_idq?}q@hh$sh!]qA(cdocutils.nodes
title
qB)ÅqC}qD(h&X/���Use Case 42 - Update System Metadata PropertiesqEh'h7h(h)h*UtitleqFh,}qG(h0]h1]h/]h.]h2]uh4Kh5hh!]qHcdocutils.nodes
Text
qIX/���Use Case 42 - Update System Metadata PropertiesqJÖÅqK}qL(h&hEh'hCubaubcsphinx.addnodes
index
qM)ÅqN}qO(h&U�h'h7h(h)h*UindexqPh,}qQ(h.]h/]h0]h1]h2]UentriesqR]qS((UsingleqTX���Use Case 42Uindex-0qUU�NtqV(hTX���update system metadatahUU�NtqW(hTX���UC42hUU�NtqXeUinlineqYâuh4Kh5hh!]ubh#)ÅqZ}q[(h&U�h'h7h(h)h*h+h,}q\(h.]h/]h0]h1]h2]h3hUuh4Kh5hh!]ubh6)Åq]}q^(h&U�h'h7h(h)h9}h*h;h,}q_(h0]h1]h/]h.]q`(hhUeh2]qahauh4K	h5hh?}qbhUhZsh!]qc(hB)Åqd}qe(h&X���Goalqfh'h]h(h)h*hFh,}qg(h0]h1]h/]h.]h2]uh4K	h5hh!]qhhIX���GoalqiÖÅqj}qk(h&hfh'hdubaubcdocutils.nodes
paragraph
ql)Åqm}qn(h&X,���Alter mutable properties of System Metadata.qoh'h]h(h)h*U	paragraphqph,}qq(h0]h1]h/]h.]h2]uh4Kh5hh!]qrhIX,���Alter mutable properties of System Metadata.qsÖÅqt}qu(h&hoh'hmubaubeubh6)Åqv}qw(h&U�h'h7h(h)h*h;h,}qx(h0]h1]h/]h.]qyhah2]qzh
auh4Kh5hh!]q{(hB)Åq|}q}(h&X���Summaryq~h'hvh(h)h*hFh,}q(h0]h1]h/]h.]h2]uh4Kh5hh!]qÄhIX���SummaryqÅÖÅqÇ}qÉ(h&h~h'h|ubaubhl)ÅqÑ}qÖ(h&X™���System Metadata provides low level information about each object in DataONE and
inlcudes properties that are immutable and others that may be mutated by
different agents.qÜh'hvh(h)h*hph,}qá(h0]h1]h/]h.]h2]uh4Kh5hh!]qàhIX™���System Metadata provides low level information about each object in DataONE and
inlcudes properties that are immutable and others that may be mutated by
different agents.qâÖÅqä}qã(h&hÜh'hÑubaubhl)Åqå}qç(h&Xt���This use case desribes the general pattern of updating System Metadata
properties by agents with authority to do so.qéh'hvh(h)h*hph,}qè(h0]h1]h/]h.]h2]uh4Kh5hh!]qêhIXt���This use case desribes the general pattern of updating System Metadata
properties by agents with authority to do so.qëÖÅqí}qì(h&héh'håubaubhl)Åqî}qï(h&Xí���In version 1.x of the DataONE infrastructure, System Metadata may only be
altered through Coordinating Nodes (after creation and synchronization).qñh'hvh(h)h*hph,}qó(h0]h1]h/]h.]h2]uh4Kh5hh!]qòhIXí���In version 1.x of the DataONE infrastructure, System Metadata may only be
altered through Coordinating Nodes (after creation and synchronization).qôÖÅqö}qõ(h&hñh'hîubaubhl)Åqú}qù(h&Xñ��In version 2.x of the DataONE infrastructure, properties of System Metadata are
managed by the Authoritative Member Node with the exception of Replica
information, which is managed by the Coordinating Nodes. In version 2.x, the
System Metadata serialVersion property is only updated by Coordinating Nodes
during replication processing. Only the Authoritative Member Node can update
dataSysMetadataModified.qûh'hvh(h)h*hph,}qü(h0]h1]h/]h.]h2]uh4Kh5hh!]q†hIXñ��In version 2.x of the DataONE infrastructure, properties of System Metadata are
managed by the Authoritative Member Node with the exception of Replica
information, which is managed by the Coordinating Nodes. In version 2.x, the
System Metadata serialVersion property is only updated by Coordinating Nodes
during replication processing. Only the Authoritative Member Node can update
dataSysMetadataModified.q°ÖÅq¢}q£(h&hûh'húubaubeubh6)Åq§}q•(h&U�h'h7h(h)h*h;h,}q¶(h0]h1]h/]h.]qßh ah2]q®hauh4K#h5hh!]q©(hB)Åq™}q´(h&X���Actorsq¨h'h§h(h)h*hFh,}q≠(h0]h1]h/]h.]h2]uh4K#h5hh!]qÆhIX���ActorsqØÖÅq∞}q±(h&h¨h'h™ubaubcdocutils.nodes
bullet_list
q≤)Åq≥}q¥(h&U�h'h§h(h)h*Ubullet_listqµh,}q∂(Ubulletq∑X���-h.]h/]h0]h1]h2]uh4K%h5hh!]q∏(cdocutils.nodes
list_item
qπ)Åq∫}qª(h&X���A content ownerqºh'h≥h(h)h*U	list_itemqΩh,}qæ(h0]h1]h/]h.]h2]uh4Nh5hh!]qøhl)Åq¿}q¡(h&hºh'h∫h(h)h*hph,}q¬(h0]h1]h/]h.]h2]uh4K%h!]q√hIX���A content ownerqƒÖÅq≈}q∆(h&hºh'h¿ubaubaubhπ)Åq«}q»(h&X���Coordinating Nodeq…h'h≥h(h)h*hΩh,}q (h0]h1]h/]h.]h2]uh4Nh5hh!]qÀhl)ÅqÃ}qÕ(h&h…h'h«h(h)h*hph,}qŒ(h0]h1]h/]h.]h2]uh4K&h!]qœhIX���Coordinating Nodeq–ÖÅq—}q“(h&h…h'hÃubaubaubhπ)Åq”}q‘(h&X���Member Nodeq’h'h≥h(h)h*hΩh,}q÷(h0]h1]h/]h.]h2]uh4Nh5hh!]q◊hl)Åqÿ}qŸ(h&h’h'h”h(h)h*hph,}q⁄(h0]h1]h/]h.]h2]uh4K'h!]q€hIX���Member Nodeq‹ÖÅq›}qfi(h&h’h'hÿubaubaubhπ)Åqfl}q‡(h&X ���Replication target Member Node

h'h≥h(h)h*hΩh,}q·(h0]h1]h/]h.]h2]uh4Nh5hh!]q‚hl)Åq„}q‰(h&X���Replication target Member NodeqÂh'hflh(h)h*hph,}qÊ(h0]h1]h/]h.]h2]uh4K(h!]qÁhIX���Replication target Member NodeqËÖÅqÈ}qÍ(h&hÂh'h„ubaubaubeubeubh6)ÅqÎ}qÏ(h&U�h'h7h(h)h*h;h,}qÌ(h0]h1]h/]h.]qÓhah2]qÔhauh4K,h5hh!]q(hB)ÅqÒ}qÚ(h&X
���PreconditionsqÛh'hÎh(h)h*hFh,}qÙ(h0]h1]h/]h.]h2]uh4K,h5hh!]qıhIX
���PreconditionsqˆÖÅq˜}q¯(h&hÛh'hÒubaubh≤)Åq˘}q˙(h&U�h'hÎh(h)h*hµh,}q˚(h∑X���-h.]h/]h0]h1]h2]uh4K.h5hh!]q¸hπ)Åq˝}q˛(h&X)���Object exists within the DataONE system

h'h˘h(h)h*hΩh,}qˇ(h0]h1]h/]h.]h2]uh4Nh5hh!]r���hl)År��}r��(h&X'���Object exists within the DataONE systemr��h'h˝h(h)h*hph,}r��(h0]h1]h/]h.]h2]uh4K.h!]r��hIX'���Object exists within the DataONE systemr��ÖÅr��}r��(h&j��h'j��ubaubaubaubeubh6)År	��}r
��(h&U�h'h7h(h)h*h;h,}r��(h0]h1]h/]h.]r��hah2]r
��hauh4K2h5hh!]r��(hB)År��}r��(h&X���Triggersr��h'j	��h(h)h*hFh,}r��(h0]h1]h/]h.]h2]uh4K2h5hh!]r��hIX���Triggersr��ÖÅr��}r��(h&j��h'j��ubaubh≤)År��}r��(h&U�h'j	��h(h)h*hµh,}r��(h∑X���-h.]h/]h0]h1]h2]uh4K4h5hh!]r��hπ)År��}r��(h&XV���A user or agent wishes to alter mutable properties of System Metadata for an
object.

h'j��h(h)h*hΩh,}r��(h0]h1]h/]h.]h2]uh4Nh5hh!]r��hl)År��}r ��(h&XT���A user or agent wishes to alter mutable properties of System Metadata for an
object.r!��h'j��h(h)h*hph,}r"��(h0]h1]h/]h.]h2]uh4K4h!]r#��hIXT���A user or agent wishes to alter mutable properties of System Metadata for an
object.r$��ÖÅr%��}r&��(h&j!��h'j��ubaubaubaubeubh6)År'��}r(��(h&U�h'h7h(h)h*h;h,}r)��(h0]h1]h/]h.]r*��hah2]r+��h
auh4K9h5hh!]r,��(hB)År-��}r.��(h&X���Post Conditionsr/��h'j'��h(h)h*hFh,}r0��(h0]h1]h/]h.]h2]uh4K9h5hh!]r1��hIX���Post Conditionsr2��ÖÅr3��}r4��(h&j/��h'j-��ubaubh≤)År5��}r6��(h&U�h'j'��h(h)h*hµh,}r7��(h∑X���-h.]h/]h0]h1]h2]uh4K;h5hh!]r8��(hπ)År9��}r:��(h&X-���The properties of System Metadata are alteredr;��h'j5��h(h)h*hΩh,}r<��(h0]h1]h/]h.]h2]uh4Nh5hh!]r=��hl)År>��}r?��(h&j;��h'j9��h(h)h*hph,}r@��(h0]h1]h/]h.]h2]uh4K;h!]rA��hIX-���The properties of System Metadata are alteredrB��ÖÅrC��}rD��(h&j;��h'j>��ubaubaubhπ)ÅrE��}rF��(h&X+���All replicas of System Metadata are in syncrG��h'j5��h(h)h*hΩh,}rH��(h0]h1]h/]h.]h2]uh4Nh5hh!]rI��hl)ÅrJ��}rK��(h&jG��h'jE��h(h)h*hph,}rL��(h0]h1]h/]h.]h2]uh4K<h!]rM��hIX+���All replicas of System Metadata are in syncrN��ÖÅrO��}rP��(h&jG��h'jJ��ubaubaubhπ)ÅrQ��}rR��(h&X2���Search indices are updated to reflect the change

h'j5��h(h)h*hΩh,}rS��(h0]h1]h/]h.]h2]uh4Nh5hh!]rT��hl)ÅrU��}rV��(h&X0���Search indices are updated to reflect the changerW��h'jQ��h(h)h*hph,}rX��(h0]h1]h/]h.]h2]uh4K=h!]rY��hIX0���Search indices are updated to reflect the changerZ��ÖÅr[��}r\��(h&jW��h'jU��ubaubaubeubeubh6)År]��}r^��(h&U�h'h7h(h)h*h;h,}r_��(h0]h1]h/]h.]r`��hah2]ra��h	auh4KAh5hh!]rb��(hB)Årc��}rd��(h&X���Processre��h'j]��h(h)h*hFh,}rf��(h0]h1]h/]h.]h2]uh4KAh5hh!]rg��hIX���Processrh��ÖÅri��}rj��(h&je��h'jc��ubaubcsphinxcontrib.plantuml
plantuml
rk��)Årl��}rm��(h&X[��.. uml::

  @startuml images/42_seq_a.png
  autonumber
  actor Bob
  participant "Authoritative" as MN <<Member Node>>
  participant "Coordinating Node" as CN <<Coordinating Node>>
  participant "Replica" as MN_repl <<Member Node>>
  note right of CN
    System Metadata
    Serial Version = 1
    dateSysMetadataModified = t1
  end note
  note right of MN
    System Metadata
    Serial Version = 1
    dateSysMetadataModified = t1
  end note
  note right of MN_repl
    System Metadata
    Serial Version = 1
    dateSysMetadataModified = t1
  end note
  Bob -> CN : Alter Property
  activate CN
  CN -> CN : update property\nserialVersion++\ndateSysMetadataModified = now()
  note right of CN
    System Metadata
    Serial Version = 2
    dateSysMetadataModified = t2
  end note
  CN ->] : <<internal>> Notify System Metadata Changed
  note right of CN
    Indexing and other CN services
    are notified of the change
  end note
  CN -> Bob: ack
  deactivate CN

  group Update All Member Nodes
  CN -> MN: systemMetadataChanged
  activate MN
  CN->MN_repl: systemMetadataChanged
  activate MN_repl
  MN -> CN: getSystemMetadata
  activate CN
  CN -> MN: SystemMetadata
  deactivate CN
  MN -> MN : update property
  note right of MN
    System Metadata
    Serial Version = 2
    dateSysMetadataModified = t2
  end note
  deactivate MN
  MN_repl -> CN: getSystemMetadata
  activate CN
  CN -> MN_repl: SystemMetadata
  deactivate CN
  MN_repl -> MN_repl : update property
  note right of MN_repl
    System Metadata
    Serial Version = 2
    dateSysMetadataModified = t2
  end note
  deactivate MN_repl
  end
  @enduml

h'j]��h(h)h*Uplantumlrn��h,}ro��(h.]h/]h0]h1]h2]Uumlrp��X��@startuml images/42_seq_a.png
autonumber
actor Bob
participant "Authoritative" as MN <<Member Node>>
participant "Coordinating Node" as CN <<Coordinating Node>>
participant "Replica" as MN_repl <<Member Node>>
note right of CN
  System Metadata
  Serial Version = 1
  dateSysMetadataModified = t1
end note
note right of MN
  System Metadata
  Serial Version = 1
  dateSysMetadataModified = t1
end note
note right of MN_repl
  System Metadata
  Serial Version = 1
  dateSysMetadataModified = t1
end note
Bob -> CN : Alter Property
activate CN
CN -> CN : update property\nserialVersion++\ndateSysMetadataModified = now()
note right of CN
  System Metadata
  Serial Version = 2
  dateSysMetadataModified = t2
end note
CN ->] : <<internal>> Notify System Metadata Changed
note right of CN
  Indexing and other CN services
  are notified of the change
end note
CN -> Bob: ack
deactivate CN

group Update All Member Nodes
CN -> MN: systemMetadataChanged
activate MN
CN->MN_repl: systemMetadataChanged
activate MN_repl
MN -> CN: getSystemMetadata
activate CN
CN -> MN: SystemMetadata
deactivate CN
MN -> MN : update property
note right of MN
  System Metadata
  Serial Version = 2
  dateSysMetadataModified = t2
end note
deactivate MN
MN_repl -> CN: getSystemMetadata
activate CN
CN -> MN_repl: SystemMetadata
deactivate CN
MN_repl -> MN_repl : update property
note right of MN_repl
  System Metadata
  Serial Version = 2
  dateSysMetadataModified = t2
end note
deactivate MN_repl
end
@endumluh4Kàh5hh!]ubhl)Årq��}rr��(h&X™��**Figure 2a.** Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 1.x infrastructure where Coordinating Nodes are the authoritative source
for System Metadata. In this scenario, user Bob updates properties of System
Metadata (e.g. Access Policy) for an object, and that change is propogated to
copies throughout the federation.h'j]��h(h)h*hph,}rs��(h0]h1]h/]h.]h2]uh4Kâh5hh!]rt��(cdocutils.nodes
strong
ru��)Årv��}rw��(h&X���**Figure 2a.**h,}rx��(h0]h1]h/]h.]h2]uh'jq��h!]ry��hIX
���Figure 2a.rz��ÖÅr{��}r|��(h&U�h'jv��ubah*Ustrongr}��ubhIXú�� Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 1.x infrastructure where Coordinating Nodes are the authoritative source
for System Metadata. In this scenario, user Bob updates properties of System
Metadata (e.g. Access Policy) for an object, and that change is propogated to
copies throughout the federation.r~��ÖÅr��}rÄ��(h&Xú�� Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 1.x infrastructure where Coordinating Nodes are the authoritative source
for System Metadata. In this scenario, user Bob updates properties of System
Metadata (e.g. Access Policy) for an object, and that change is propogated to
copies throughout the federation.h'jq��ubeubjk��)ÅrÅ��}rÇ��(h&X,��.. uml::
  @startuml images/42_seq_b.png
  autonumber
  actor Bob
  participant "Authoritative" as MN <<Member Node>>
  participant "Coordinating Node" as CN <<Coordinating Node>>
  participant "Replica" as MN_repl <<Member Node>>
  Bob -> MN: getSystemMetadata
  note right of MN
   System Metadata
   serialVersion = 10
   dateSysMetadataModified = t1
  end note
  note right of CN
   System Metadata
   serialVersion = 10
   dateSysMetadataModified = t1
  end note
  note right of MN_repl
   System Metadata
   serialVersion = 10
   dateSysMetadataModified = t1
  end note
  activate MN
  MN -> Bob: dateSysMetadataModified = t1
  deactivate MN
  Bob -> MN : updateSystemMetadata\ndateSysMetadataModified=t1
  activate MN
  MN -> MN: check dateSysMetadataModified == t1
  MN -> MN: update properties\ndateSysMetadataModified = now()
  note right of MN
    System Metadata
    serialVersion = 10
    dateSysMetadataModified = t2

    Mutable properties other than Replica
    entries may be updated by a user
    with appropriate permission.
  end note
  MN -> CN: synchronize
  activate CN
  CN -> CN: schedule update
  CN -> MN: ack
  deactivate CN
  MN -> Bob: ack
  deactivate MN

  ... __Potentially long delay__ ...

  CN -> MN : getSystemMetadata
  activate CN
  activate MN
  MN -> CN: systemMetadata
  deactivate MN
  CN -> CN: update properties
  note right of CN
   System Metadata
   serialVersion = 10
   dateSysMetadataModified = t2
  end note
  CN ->] : <<internal>> Notify System Metadata Changed
  note right of CN
    Indexing and other CN services
    are notified of the change
  end note

  group Update only replica nodes
  CN -> MN_repl: systemMetadataChanged
  activate MN_repl
  deactivate CN

  MN_repl -> CN: getSystemMetadata
  activate CN
  CN -> MN_repl: SystemMetadata
  deactivate CN
  note right of MN_repl
   System Metadata
   serialVersion = 10
   dateSysMetadataModified = t2

   On replica MNs, all mutable System
   Metadata properties may be updated
   by a CN
  end note
  MN_repl -> MN_repl: update properties
  deactivate MN_repl
  end
  @enduml

h'j]��h(h)h*jn��h,}r��(h.]h/]h0]h1]h2]jp��X��@startuml images/42_seq_b.png
autonumber
actor Bob
participant "Authoritative" as MN <<Member Node>>
participant "Coordinating Node" as CN <<Coordinating Node>>
participant "Replica" as MN_repl <<Member Node>>
Bob -> MN: getSystemMetadata
note right of MN
 System Metadata
 serialVersion = 10
 dateSysMetadataModified = t1
end note
note right of CN
 System Metadata
 serialVersion = 10
 dateSysMetadataModified = t1
end note
note right of MN_repl
 System Metadata
 serialVersion = 10
 dateSysMetadataModified = t1
end note
activate MN
MN -> Bob: dateSysMetadataModified = t1
deactivate MN
Bob -> MN : updateSystemMetadata\ndateSysMetadataModified=t1
activate MN
MN -> MN: check dateSysMetadataModified == t1
MN -> MN: update properties\ndateSysMetadataModified = now()
note right of MN
  System Metadata
  serialVersion = 10
  dateSysMetadataModified = t2

  Mutable properties other than Replica
  entries may be updated by a user
  with appropriate permission.
end note
MN -> CN: synchronize
activate CN
CN -> CN: schedule update
CN -> MN: ack
deactivate CN
MN -> Bob: ack
deactivate MN

... __Potentially long delay__ ...

CN -> MN : getSystemMetadata
activate CN
activate MN
MN -> CN: systemMetadata
deactivate MN
CN -> CN: update properties
note right of CN
 System Metadata
 serialVersion = 10
 dateSysMetadataModified = t2
end note
CN ->] : <<internal>> Notify System Metadata Changed
note right of CN
  Indexing and other CN services
  are notified of the change
end note

group Update only replica nodes
CN -> MN_repl: systemMetadataChanged
activate MN_repl
deactivate CN

MN_repl -> CN: getSystemMetadata
activate CN
CN -> MN_repl: SystemMetadata
deactivate CN
note right of MN_repl
 System Metadata
 serialVersion = 10
 dateSysMetadataModified = t2

 On replica MNs, all mutable System
 Metadata properties may be updated
 by a CN
end note
MN_repl -> MN_repl: update properties
deactivate MN_repl
end
@endumluh4KÍh5hh!]ubhl)ÅrÑ��}rÖ��(h&X¯��**Figure 2b.** Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 2.x infrastructure where Member Nodes are the authoritative source
for System Metadata except for replication information (for which Coordinating
Nodes are authoritative). In this scenario, user Bob updates properties of
System Metadata (e.g. Access Policy) for an object, and that change is
propogated to copies throughout the federation.h'j]��h(h)h*hph,}rÜ��(h0]h1]h/]h.]h2]uh4KÎh5hh!]rá��(ju��)Årà��}râ��(h&X���**Figure 2b.**h,}rä��(h0]h1]h/]h.]h2]uh'jÑ��h!]rã��hIX
���Figure 2b.rå��ÖÅrç��}ré��(h&U�h'jà��ubah*j}��ubhIXÍ�� Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 2.x infrastructure where Member Nodes are the authoritative source
for System Metadata except for replication information (for which Coordinating
Nodes are authoritative). In this scenario, user Bob updates properties of
System Metadata (e.g. Access Policy) for an object, and that change is
propogated to copies throughout the federation.rè��ÖÅrê��}rë��(h&XÍ�� Sequence diagram for Use Case 42 illustrating the high level
sequence of operations associated with altering system metadata of an object for
version 2.x infrastructure where Member Nodes are the authoritative source
for System Metadata except for replication information (for which Coordinating
Nodes are authoritative). In this scenario, user Bob updates properties of
System Metadata (e.g. Access Policy) for an object, and that change is
propogated to copies throughout the federation.h'j��ubeubeubeubeh&U�Utransformerr�NU
footnote_refsrì��}rî��Urefnamesrï��}rñ��Usymbol_footnotesró��]rò��Uautofootnote_refsrô��]rö��Usymbol_footnote_refsrõ��]rú��U	citationsrù��]rû��h5hUcurrent_linerü��NUtransform_messagesr†��]r°��(cdocutils.nodes
system_message
r¢��)År£��}r§��(h&U�h,}r•��(h0]UlevelKh.]h/]Usourceh)h1]h2]UlineKUtypeUINFOr¶��uh!]rß��hl)År®��}r©��(h&U�h,}r™��(h0]h1]h/]h.]h2]uh'j£��h!]r´��hIX*���Hyperlink target "uc42" is not referenced.r¨��ÖÅr≠��}rÆ��(h&U�h'j®��ubah*hpubah*Usystem_messagerØ��ubj¢��)År∞��}r±��(h&U�h,}r≤��(h0]UlevelKh.]h/]Usourceh)h1]h2]UlineKUtypej¶��uh!]r≥��hl)År¥��}rµ��(h&U�h,}r∂��(h0]h1]h/]h.]h2]uh'j∞��h!]r∑��hIX-���Hyperlink target "index-0" is not referenced.r∏��ÖÅrπ��}r∫��(h&U�h'j¥��ubah*hpubah*jØ��ubeUreporterrª��NUid_startrº��KU
autofootnotesrΩ��]ræ��U
citation_refsrø��}r¿��Uindirect_targetsr¡��]r¬��Usettingsr√��(cdocutils.frontend
Values
rƒ��or≈��}r∆��(Ufootnote_backlinksr«��KUrecord_dependenciesr»��NUrfc_base_urlr…��Uhttps://tools.ietf.org/html/r ��U	tracebackrÀ��àUpep_referencesrÃ��NUstrip_commentsrÕ��NU
toc_backlinksrŒ��Uentryrœ��U
language_coder–��Uenr—��U	datestampr“��NUreport_levelr”��KU_destinationr‘��NU
halt_levelr’��KU
strip_classesr÷��NhFNUerror_encoding_error_handlerr◊��Ubackslashreplacerÿ��UdebugrŸ��NUembed_stylesheetr⁄��âUoutput_encoding_error_handlerr€��Ustrictr‹��U
sectnum_xformr›��KUdump_transformsrfi��NU
docinfo_xformrfl��KUwarning_streamr‡��NUpep_file_url_templater·��Upep-%04dr‚��Uexit_status_levelr„��KUconfigr‰��NUstrict_visitorrÂ��NUcloak_email_addressesrÊ��àUtrim_footnote_reference_spacerÁ��âUenvrË��NUdump_pseudo_xmlrÈ��NUexpose_internalsrÍ��NUsectsubtitle_xformrÎ��âUsource_linkrÏ��NUrfc_referencesrÌ��NUoutput_encodingrÓ��Uutf-8rÔ��U
source_urlr��NUinput_encodingrÒ��U	utf-8-sigrÚ��U_disable_configrÛ��NU	id_prefixrÙ��U�U	tab_widthrı��KUerror_encodingrˆ��UUTF-8r˜��U_sourcer¯��h)Ugettext_compactr˘��àU	generatorr˙��NUdump_internalsr˚��NUsmart_quotesr¸��âUpep_base_urlr˝��U https://www.python.org/dev/peps/r˛��Usyntax_highlightrˇ��Ulongr���Uinput_encoding_error_handlerr��j‹��Uauto_id_prefixr��Uidr��Udoctitle_xformr��âUstrip_elements_with_classesr��NU
_config_filesr��]Ufile_insertion_enabledr��àUraw_enabledr��KU
dump_settingsr	��NubUsymbol_footnote_startr
��K�Uidsr��}r��(hj'��hh]hj	��hj]��hhvhh7h h§hh7hUh]hhÎuUsubstitution_namesr
��}r��h*h5h,}r��(h0]h.]h/]Usourceh)h1]h2]uU	footnotesr��]r��Urefidsr��}r��(hU]r��hZah]r��h$auub.