o N in ã@sVdZddlmZddlmZer"ddlmZddlmZddl m Z Gdd„dƒZ d S) z5The data collector components for sphinx.environment.é)Ú annotations)Ú TYPE_CHECKING)Únodes)ÚSphinx)ÚBuildEnvironmentc@sdeZdZUdZdZded<d$d d „Zd$d d „Zd%dd„Zd&dd„Z d'dd„Z d(dd„Z d)d"d#„Z dS)*ÚEnvironmentCollectora¬An EnvironmentCollector is a specific data collector from each document. It gathers data and stores :py:class:`BuildEnvironment ` as a database. Examples of specific data would be images, download files, section titles, metadatas, index entries and toctrees, etc. .. note:: This class essentially wraps a sub-set of :ref:`Sphinx event callbacks `. Nzdict[str, int] | NoneÚ listener_idsÚapprÚreturnÚNonecCsV|jdusJ‚| d|j¡| d|j¡| d|j¡| d|j¡| d|j¡dœ|_dS)Nú doctree-readúenv-merge-infoú env-purge-docúenv-get-updatedúenv-get-outdated)r r rrr)rÚconnectÚ process_docÚ merge_otherÚ clear_docÚget_updated_docsÚget_outdated_docs)Úselfr ©rúZ/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/environment/collectors/__init__.pyÚenables      ûzEnvironmentCollector.enablecCs2|jdusJ‚|j ¡D]}| |¡q d|_dS)N)rÚvaluesÚ disconnect)rr Ú listener_idrrrÚdisable's  zEnvironmentCollector.disableÚenvrÚdocnameÚstrcCót‚)z™Remove specified data of a document. This method is called on the removal of the document. .. seealso:: :event:`env-purge-doc` ©ÚNotImplementedError)rr rr rrrr-ózEnvironmentCollector.clear_docÚdocnamesúset[str]ÚothercCr")zÇMerge in specified data regarding docnames from a different `BuildEnvironment` object which coming from a subprocess in parallel builds. .. seealso:: :event:`env-merge-info` r#)rr rr&r(rrrr6s z EnvironmentCollector.merge_otherÚdoctreeúnodes.documentcCr")z¤Process a document and gather specific data from it. This method is called after the document is read. .. seealso:: :event:`doctree-read` r#)rr r)rrrrDr%z EnvironmentCollector.process_docú list[str]cCógS)z¢Return a list of docnames to re-read. This method is called after reading the whole of documents. .. seealso:: :event:`env-get-updated` r)rr rrrrrMr%z%EnvironmentCollector.get_updated_docsÚaddedÚchangedÚremovedcCr,)z›Return a list of docnames to re-read. This method is called before reading the documents. .. seealso:: :event:`env-get-outdated` r)rr rr-r.r/rrrrVsz&EnvironmentCollector.get_outdated_docs)r rr r )r rrrr r!r r ) r rrrr&r'r(rr r )r rr)r*r r )r rrrr r+) r rrrr-r'r.r'r/r'r r+) Ú__name__Ú __module__Ú __qualname__Ú__doc__rÚ__annotations__rrrrrrrrrrrrs      rN) r3Ú __future__rÚtypingrÚdocutilsrÚsphinx.applicationrÚsphinx.environmentrrrrrrÚs