o }oi$ @s~ddlmZddlZddlmZddlmZddlmZGdddej Z Gdd d ej Z ed d d d Gddde Z dS)) annotationsN)Iterable)Any)deprecated_classc@s0eZdZdZejdddZejdd d Zd S)BaseJournalBackendBase class for Journal storages. Storage classes implementing this base class must guarantee process safety. This means, multiple processes might concurrently call ``read_logs`` and ``append_logs``. If the backend storage does not internally support mutual exclusion mechanisms, such as locks, you might want to use :class:`~optuna.storages.journal.JournalFileSymlinkLock` or :class:`~optuna.storages.journal.JournalFileOpenLock` for creating a critical section. log_number_fromintreturnIterable[dict[str, Any]]cCt)adRead logs with a log number greater than or equal to ``log_number_from``. If ``log_number_from`` is 0, read all the logs. Args: log_number_from: A non-negative integer value indicating which logs to read. Returns: Logs with log number greater than or equal to ``log_number_from``. NotImplementedError)selfrrQ/home/ubuntu/.local/lib/python3.10/site-packages/optuna/storages/journal/_base.py read_logsszBaseJournalBackend.read_logslogslist[dict[str, Any]]NonecCr )zAppend logs to the backend. Args: logs: A list that contains json-serializable logs. r )rrrrr append_logs%s zBaseJournalBackend.append_logsN)rr r r )rrr r)__name__ __module__ __qualname____doc__abcabstractmethodrrrrrrr s  rc@s0eZdZdZejd ddZejd d d Zd S)BaseJournalSnapshotzOptional base class for Journal storages. Storage classes implementing this base class may work faster when constructing the internal state from the large amount of logs. snapshotbytesr rcCr )ziSave snapshot to the backend. Args: snapshot: A serialized snapshot (bytes) r )rrrrr save_snapshot8z!BaseJournalSnapshot.save_snapshot bytes | NonecCr )zLoad snapshot from the backend. Returns: A serialized snapshot (bytes) if found, otherwise :obj:`None`. r )rrrr load_snapshotAr!z!BaseJournalSnapshot.load_snapshotN)rrr r)r r")rrrrrrr r#rrrrr1s  rz4.0.0z6.0.0zAUse :class:`~optuna.storages.journal.BaseJournalBackend` instead.)textc@seZdZdZdS)BaseJournalLogStoragerN)rrrrrrrrr%Ksr%) __future__rrcollections.abcrtypingroptuna._deprecatedrABCrrr%rrrrs    '