i%SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r SSK J r J r Jr SSKJr SSKJr SSKJrJr SSKJrJr SSKJr SS KJr SS KJrJrJrJ r J!r!J"r" SS K#J$r$J%r% SS K&J'r'J(r( SS K)J*r*J+r+ SSK,J-r- SSK.J/r/J0r0 SSK1J2r2 SSK3J4r4J5r5 SSK6J7r7 /SQr8\(aSSK9J:r: \;\\;-r<\!\=S'\>\?\?4r@\!\=S'\>\?\?S-4rA\!\=S'\>\ S\@4\>\ S\A4-rB\!\=S'\ \B/\4rC\!\=S'S\\a\a44S9jrcS:\ \2S\?4S;jrdS8\?S\>\2S<44S=jreS8\?S\>\2S<4S-4S>jrfg!\Sa \KRRrRGNf=f!\Xa Nf=f)@N)CallableIterable)datetime timedeltatimezone) lru_cache)sha384)PathLikegetenv)PathPurePath)Queue)Thread) TYPE_CHECKINGAnyClassVarLiteral TypeAliascast) HTTPErrorURLError)Requesturlopen) BadZipFileZipFile)storage_directory)HypothesisExceptionHypothesisWarning)ChoiceT)UniqueIdentifiernot_set)note_deprecation)DirectoryBasedExampleDatabaseExampleDatabaseGitHubArtifactDatabaseInMemoryExampleDatabaseMultiplexedDatabaseReadOnlyDatabase) BaseObserverStrPathT SaveDataT DeleteDataTsavedeleteListenerEventT ListenerTpathreturncf[U5nUR5(d#URnUR5(dM#UR5=(aG [R "U[R [R-[R-5$![a gf=f)z Returns True if the desired path can be used as database path because either the directory exists and can be used, or its root directory can be used and we can make the directory as needed. F) r existsparentis_dirosaccessR_OKW_OKX_OKPermissionErrorr1s R/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/hypothesis/database.py _usable_dirr?Cs{ :D++--;;D++--{{}M42771BRWW1L!MM s6B#AB## B0/B0:memory:r$c2U[Lad[R"S5b [S5e[ SSS9n[ U5(d([ R"SU<3[SS9 [5$US ;a [5$[[U5n[U5$) NHYPOTHESIS_DATABASE_FILEzThe $HYPOTHESIS_DATABASE_FILE environment variable no longer has any effect. Configure your database location via a settings profile instead. https://hypothesis.readthedocs.io/en/latest/settings.html#settings-profilesexamplesF)intent_to_writezThe database setting is not configured, and the default location is unusable - falling back to an in-memory database for this session. path= stacklevel)Nr@) r!r7r rrr?warningswarnrr&rr*r#r=s r> _db_for_pathrJUs w 99/ 0 <%^  !UC4  MM5/3g7"  +, , !!&(( $ D ( ..c8^\rSrSrS\S\SS4U4SjjrSrU=r$)_EDMetapargskwargsr2r$cb>U[La[SSSS9 [U0UD6$[TU]"U0UD6$)Na%Creating a database using the abstract ExampleDatabase() class is deprecated. Prefer using a concrete subclass, like InMemoryExampleDatabase() or DirectoryBasedExampleDatabase(path). In particular, the special string ExampleDatabase(":memory:") should be replaced by InMemoryExampleDatabase().z 2025-04-07F)since has_codemod)r$r"rJsuper__call__)selfrOrP __class__s r>rU_EDMeta.__call__qsH ? " C #!  00 0w000rK)__name__ __module__ __qualname____firstlineno__rrU__static_attributes__ __classcell__rWs@r>rMrMps# 1c 1S 15F 1 1rKrMsphinxz$hypothesis.database._EDMeta.__call__c.\rSrSrSrSSjr\RS\S\SS4Sj5r \RS\S\ \4S j5r \RS\S\SS4S j5r S \S \S\SS4S jr S\SS4SjrS\SS4SjrSSjrS\SS4SjrSSjrSSjrSrg)r$a A Hypothesis database, for use in |settings.database|. Hypothesis automatically saves failures to the database set in |settings.database|. The next time the test is run, Hypothesis will replay any failures from the database in |settings.database| for that test (in |Phase.reuse|). The database is best thought of as a cache that you never need to invalidate. Entries may be transparently dropped when upgrading your Hypothesis version or changing your test. Do not rely on the database for correctness; to ensure Hypothesis always tries an input, use |@example|. A Hypothesis database is a simple mapping of bytes to sets of bytes. Hypothesis provides several concrete database subclasses. To write your own database class, see :doc:`/how-to/custom-database`. Change listening ---------------- An optional extension to |ExampleDatabase| is change listening. On databases which support change listening, calling |ExampleDatabase.add_listener| adds a function as a change listener, which will be called whenever a value is added, deleted, or moved inside the database. See |ExampleDatabase.add_listener| for details. All databases in Hypothesis support change listening. Custom database classes are not required to support change listening, though they will not be compatible with features that require change listening until they do so. .. note:: While no Hypothesis features currently require change listening, change listening is required by `HypoFuzz `_. Database methods ---------------- Required methods: * |ExampleDatabase.save| * |ExampleDatabase.fetch| * |ExampleDatabase.delete| Optional methods: * |ExampleDatabase.move| Change listening methods: * |ExampleDatabase.add_listener| * |ExampleDatabase.remove_listener| * |ExampleDatabase.clear_listeners| * |ExampleDatabase._start_listening| * |ExampleDatabase._stop_listening| * |ExampleDatabase._broadcast_change| r2Nc/UlgN _listenersrVs r>__init__ExampleDatabase.__init__s +-rKkeyvaluecD[[U5RS35e)z`Save ``value`` under ``key``. If ``value`` is already present in ``key``, silently do nothing. z.saveNotImplementedErrortyperZrVrkrls r>r-ExampleDatabase.saves! "T$Z%8%8$9"?@@rKcD[[U5RS35e)z5Return an iterable over all values matching this key.z.fetchrnrVrks r>fetchExampleDatabase.fetchs!"T$Z%8%8$9"@AArKcD[[U5RS35e)z]Remove ``value`` from ``key``. If ``value`` is not present in ``key``, silently do nothing. z.deleternrqs r>r.ExampleDatabase.deletes! "T$Z%8%8$9"ABBrKsrcdestcvX:XaURX5 gURX5 URX#5 g)a Move ``value`` from key ``src`` to key ``dest``. Equivalent to ``delete(src, value)`` followed by ``save(src, value)``, but may have a more efficient implementation. Note that ``value`` will be inserted at ``dest`` regardless of whether it is currently present at ``src``. N)r-r.rVryrzrls r>moveExampleDatabase.moves0 ; IIc !  C $rKfc[UR5nURRU5 U(dUR5 gg)a/ Add a change listener. ``f`` will be called whenever a value is saved, deleted, or moved in the database. ``f`` can be called with two different event values: * ``("save", (key, value))`` * ``("delete", (key, value))`` where ``key`` and ``value`` are both ``bytes``. There is no ``move`` event. Instead, a move is broadcasted as a ``delete`` event followed by a ``save`` event. For the ``delete`` event, ``value`` may be ``None``. This might occur if the database knows that a deletion has occurred in ``key``, but does not know what value was deleted. N)boolrgappend_start_listening)rVr had_listenerss r> add_listenerExampleDatabase.add_listeners8&T__-  q!  ! ! #rKcXR;agURRU5 UR(dUR5 gg)zy Removes ``f`` from the list of change listeners. If ``f`` is not in the list of change listeners, silently do nothing. N)rgremove_stop_listening)rVrs r>remove_listenerExampleDatabase.remove_listener&s; OO #  q!  "rKc[UR5nURR5 U(aUR5 gg)zRemove all change listeners.N)rrgclearr)rVrs r>clear_listenersExampleDatabase.clear_listeners2s4T__-     " rKeventc:URH nU"U5 M g)a Called when a value has been either added to or deleted from a key in the underlying database store. The possible values for ``event`` are: * ``("save", (key, value))`` * ``("delete", (key, value))`` ``value`` may be ``None`` for the ``delete`` event, indicating we know that some value was deleted under this key, but not its exact value. Note that you should not assume your instance is the only reference to the underlying database store. For example, if two instances of |DirectoryBasedExampleDatabase| reference the same directory, _broadcast_change should be called whenever a file is added or removed from the directory, even if that database was not responsible for changing the file. Nrf)rVrlisteners r>_broadcast_change!ExampleDatabase._broadcast_change9s$H UO(rKcR[R"URS3[SS9 g)a Called when the database adds a change listener, and did not previously have any change listeners. Intended to allow databases to wait to start expensive listening operations until necessary. ``_start_listening`` and ``_stop_listening`` are guaranteed to alternate, so you do not need to handle the case of multiple consecutive ``_start_listening`` calls without an intermediate ``_stop_listening`` call. z' does not support listening for changesrFNrHrIrWrrhs r>r ExampleDatabase._start_listeningNs&  ~~E F  rKcR[R"URS3[SS9 g)a Called whenever no change listeners remain on the database. ``_stop_listening`` and ``_start_listening`` are guaranteed to alternate, so you do not need to handle the case of multiple consecutive ``_stop_listening`` calls without an intermediate ``_start_listening`` call. z0 does not support stopping listening for changesrrFNrrhs r>rExampleDatabase._stop_listening_s&  ~~N O  rKrfr2N)rZr[r\r]__doc__riabcabstractmethodbytesr-rrur.r}r0rrrr/rrrr^rYrKr>r$r$s8t. AAeAAA BB8E?BB C%CC$CCU5T $i$t$0 # #$ ##~$* "  rK) metaclassc^\rSrSrSrSU4SjjrS\4SjrS\S\ 4Sjr S \ S\ \ 4S jr S \ S \ SS4S jrS \ S \ SS4S jrSSjrSSjrSrU=r$)r&ioa+A non-persistent example database, implemented in terms of an in-memory dictionary. This can be useful if you call a test function several times in a single session, or for testing other database implementations, but because it does not persist between runs we do not recommend it for general use. r2Nc0>[TU]5 0Ulgre)rTridata)rVrWs r>ri InMemoryExampleDatabase.__init__xs -/ rKc$SUR<S3$)NzInMemoryExampleDatabase()rrhs r>__repr__ InMemoryExampleDatabase.__repr__|s)$))a88rKotherc`[U[5=(a URURL$re) isinstancer&rrVrs r>__eq__InMemoryExampleDatabase.__eq__s"%!89Udii5::>UUrKrkc#X# URRUS5ShvN gN7fNrY)rgetrts r>ruInMemoryExampleDatabase.fetchs99==b)))s *(*rlc[U5nURRU[55nX#;nUR U5 U(aUR SX445 ggNr-)rr setdefaultsetaddrrVrkrlvalueschangeds r>r-InMemoryExampleDatabase.savesTe %%c351% 5   " "FSL#9 : rKc[U5nURRU[55nX#;nUR U5 U(aUR SX445 ggNr.)rrrrdiscardrrs r>r.InMemoryExampleDatabase.deletesQe sCE*/u   " "Hsl#; < rKcgrerYrhs r>r(InMemoryExampleDatabase._start_listenings rKcgrerYrhs r>r'InMemoryExampleDatabase._stop_listening rKrr)rZr[r\r]rristrrobjectrrrrrur-r.rrr^r_r`s@r>r&r&os09#9VFVtV**8E?*;;e;;=%==$=   rKr&rkc:[U5R5SS$)N)r hexdigestrks r>_hashrs #; "3B ''rKc(^\rSrSr%SrSr\\\S'\ "\5r \\ \S'S\ SS4U4S jjr S\ 4S jrS \S\4S jrS \S\4SjrS \S\S\4SjrS \S\\4SjrS \S\SS4SjrS\S\S\SS4SjrS \S\SS4SjrSSjrSSjrSrU=r$)r#iaUse a directory to store Hypothesis examples as files. Each test corresponds to a directory, and each example to a file within that directory. While the contents are fairly opaque, a |DirectoryBasedExampleDatabase| can be shared by checking the directory into version control, for example with the following ``.gitignore``:: # Ignore files cached by Hypothesis... .hypothesis/* # except for the examples directory !.hypothesis/examples/ Note however that this only makes sense if you also pin to an exact version of Hypothesis, and we would usually recommend implementing a shared database with a network datastore - see |ExampleDatabase|, and the |MultiplexedDatabase| helper. s.hypothesis-keys_metakeys_name_metakeys_hashr1r2Nc^>[TU]5 [U5Ul0UlSUlgre)rTrir r1keypaths _observer)rVr1rWs r>ri&DirectoryBasedExampleDatabase.__init__s' J +- .2rKc$SUR<S3$)NzDirectoryBasedExampleDatabase(rr=rhs r>r&DirectoryBasedExampleDatabase.__repr__s/ }A>>rKrcb[U[5=(a URUR:H$re)rr#r1rs r>r$DirectoryBasedExampleDatabase.__eq__s$ u; < XejjAX rKrkcURU$![a Of=fUR[U5- URU'URU$re)rKeyErrorr1rrts r> _key_path'DirectoryBasedExampleDatabase._key_pathsR ==% %   !YYs3 c}}S!!s  rlc<URU5[U5- $re)rrrqs r> _value_path)DirectoryBasedExampleDatabase._value_paths~~c"U5\11rKc## URU5nUR5(dg[R"U5HnX#- R 5v M g![ a M*f=f![ a gf=f7fre)rr6r7listdir read_bytesOSError)rVrkkpr1s r>ru#DirectoryBasedExampleDatabase.fetchsr ^^C yy{{   290022'   sL(A?A/AA/A? A,(A/+A,,A// A<9A?;A<<A?cURU5nURUR:waURURU5 UR SSS9 UR X5nUR5(dx[R"5upV[U5n[R"XR5 [R"U5 URU5 UR5(aegg![ainUR [ R":Xa1UR%UR'55 O![a Of=fUR)5 SnANSnAff=f![a gf=f)NTexist_okparents)rnamerr-rmkdirrr4tempfilemkstempr r7writecloserenamererrnoEXDEV write_bytesrunlink) rVrkrlkey_pathr1fdtmpnametmppatherrs r>r-"DirectoryBasedExampleDatabase.saves8>>#& ==D// / IId))3 /   NND$N 7##C/D;;== '..0 w-#  %NN4(#>>+++++)!%yyEKK/! ,,W-?-?-AB&! !NN$$%   sa BE.C8E.8 E+E&!EE& E E& EE&!E.&E++E.. E;:E;ryrzcX:XaURX5 gURX5nURX#5nURU5R5(dURURU5 [ R "XE5 g![a% URX5 URX#5 gf=fre) r-rrr4rr7renamesrr.)rVryrzrlsrc_path dest_paths r>r}"DirectoryBasedExampleDatabase.move s ; IIc ! ##C/$$T1 ~~d#**,, IId))4 0 # JJx + # KK # IId " #s;B,CCcURX5R5 URU5R 5 UR UR U5 g![a gf=f![a gf=fre)rrrrrmdirr.rrqs r>r.$DirectoryBasedExampleDatabase.deletesu    S ( / / 1  2 NN3  % % ' KK++S 1      s"AA. A+*A+. A;:A;c z^^^^^ ^ ^ ^ ^ SSKJmJmJmJmJm Jm Jn SSKJ n UR!UR"5Vs0sHn[%U5U_M snm UR&m UR(m "UUUUU U U U U 4 SjS U5nUR*R-S S S 9 U"5UlUR.R1U"5UR*S TT T /S 9 UR.R35 g![a5 [R"SURRS3[SS9 gf=fs snf) Nr)DirCreatedEventDirDeletedEvent DirMovedEventFileCreatedEventFileDeletedEventFileMovedEventFileSystemEventHandler)Observerzlistening for changes in a zR requires the watchdog library. To install, run `pip install hypothesis[watchdog]`rrFc> \rSrSrSYY-SS4UUUU4SjjrSYY-SS4UUU4SjjrSYY-SS4UUU4SjjrSrg) ?DirectoryBasedExampleDatabase._start_listening..HandleriGrr2Nc>[UT5(ae[UR[5(de[UR5nURR nUT:XaUR 5T UR 'gT RU5nUcgUR 5nT"SXE445 g![a gf=f![a gf=fr) rrrr r5rrrr) _selfr value_pathkey_hashrkrlrrr hash_to_keys r> on_createdJDirectoryBasedExampleDatabase._start_listening..Handler.on_createdJs%e_===="%..#6666!%..1 %,,11~-7A7L7L7N JOO4 !ooh/;&113E"6C<"89%# s$(B8C8 CC CCc>[UT5(ae[UR[5(de[UR5nTR UR R 5nUcgT"SUS445 gr)rrrr rr5r)rVrrrkrrrs r> on_deletedJDirectoryBasedExampleDatabase._start_listening..Handler.on_deletedlsn%e_====!%..#6666!%..1 !ooj&7&7&<&<=;!8c4["9:rKc>[UT5(ae[UR[5(de[UR[5(de[ UR5n[ UR5nT R UR R5nT R UR R5nUbUcgUR5nT"SXF445 T"SXV445 g![a gf=f)Nr.r-) rrrrr rr5rrr) rVrrrk1k2rlrrrs r>on_movedHDirectoryBasedExampleDatabase._start_listening..Handler.on_movedws%e];;;;!%..#6666!%//37777/ 1  __X__%9%9: __Y%5%5%:%:;:%002E"8b["9:!6B;"78 sC:: DDrY)rZr[r\r]rrrr^) rrrrrrrrrs r>Handlerr Gs^ :)9O)K :PT : :D ;(8?(J ;t ; ; 9n}&D 9 9 9rKrTr) recursive event_filter)watchdog.eventsrrrrrrr watchdog.observersr  ImportErrorrHrIrWrZrrurrrrr1rrschedulestart)rVr r rkrrrrrrrrrrs @@@@@@@@@r>r.DirectoryBasedExampleDatabase._start_listening-s*     437**T=P=P2QR2Q3uSz32QR ,, 22C 9C 9 "C 9T t4!  I II*,r-DirectoryBasedExampleDatabase._stop_listenings9~~)))  rK)rrr1r)rZr[r\r]rrrr__annotations__rrrr*rirrrrr rrrrur-r}r.rrr^r_r`s@r>r#r#s&':NHUO9$).$9NHSM93X3$3 ?#? F t "U"t"2u2U2t2  8E? ##e##J##U#5#T#$2%22$2$n`rKr#c^\rSrSrSrS\SS4U4SjjrS\4SjrS\ S\ 4S jr S \ S\ \ 4S jrS \ S \ SS4S jrS \ S \ SS4SjrSSjrSSjrSrU=r$)r(iaA wrapper to make the given database read-only. The implementation passes through ``fetch``, and turns ``save``, ``delete``, and ``move`` into silent no-ops. Note that this disables Hypothesis' automatic discarding of stale examples. It is designed to allow local machines to access a shared database (e.g. from CI servers), without propagating changes back from a local or in-development branch. dbr2Nc\>[TU]5 [U[5(deXlgre)rTrirr$_wrappedrVr+rWs r>riReadOnlyDatabase.__init__s& "o.... rKc$SUR<S3$)NzReadOnlyDatabase(rr-rhs r>rReadOnlyDatabase.__repr__s"4=="3155rKrcb[U[5=(a URUR:H$re)rr(r-rs r>rReadOnlyDatabase.__eq__s"%!12Vt}}7VVrKrkc#V# URRU5ShvN gN7fre)r-rurts r>ruReadOnlyDatabase.fetchs==&&s+++s )')rlcgrerYrqs r>r-ReadOnlyDatabase.saverrKcgrerYrqs r>r.ReadOnlyDatabase.deleterrKcgrerYrhs r>r!ReadOnlyDatabase._start_listenings rKcgrerYrhs r>r ReadOnlyDatabase._stop_listeningrrKr1r)rZr[r\r]rr$rirrrrrrrrur-r.rrr^r_r`s@r>r(r(s?t 6#6WFWtW,,8E?,  e   %  $    rKr(c^\rSrSrSrS\SS4U4SjjrS\4SjrS\ S\ 4S jr S \ S\ \ 4S jrS \ S \ SS4S jrS \ S \ SS4SjrS\ S\ S \ SS4SjrSSjrSSjrSrU=r$)r'iaA wrapper around multiple databases. Each ``save``, ``fetch``, ``move``, or ``delete`` operation will be run against all of the wrapped databases. ``fetch`` does not yield duplicate values, even if the same value is present in two or more of the wrapped databases. This combines well with a :class:`ReadOnlyDatabase`, as follows: .. code-block:: python local = DirectoryBasedExampleDatabase("/tmp/hypothesis/examples/") shared = CustomNetworkDatabase() settings.register_profile("ci", database=shared) settings.register_profile( "dev", database=MultiplexedDatabase(local, ReadOnlyDatabase(shared)) ) settings.load_profile("ci" if os.environ.get("CI") else "dev") So your CI system or fuzzing runs can populate a central shared database; while local runs on development machines can reproduce any failures from CI but will only cache their own failures locally and cannot remove examples from the shared database. dbsr2Nc`>[TU]5 [SU55(deXlg)Nc3B# UHn[U[5v M g7fre)rr$).0r+s r> /MultiplexedDatabase.__init__..sASr:b/22Ss)rTriallr-)rVr@rWs r>riMultiplexedDatabase.__init__s* ASAAAAA rKcrSRSR[[UR555$)NzMultiplexedDatabase({})z, )formatr'mapreprr-rhs r>rMultiplexedDatabase.__repr__s'(// #dDMM:R0STTrKrcb[U[5=(a URUR:H$re)rr'r-rs r>rMultiplexedDatabase.__eq__s$ u1 2 Vt}}7V rKrkc## [5nURH7nURU5HnXB;dM Uv URU5 M! M9 g7fre)rr-rur)rVrkseenr+rls r>ruMultiplexedDatabase.fetchsBu--B#$KHHUO' s 1AArlcLURHnURX5 M gre)r-r-rVrkrlr+s r>r-MultiplexedDatabase.saves--B GGC  rKcLURHnURX5 M gre)r-r.rSs r>r.MultiplexedDatabase.deletes--B IIc ! rKryrzcNURHnURXU5 M gre)r-r})rVryrzrlr+s r>r}MultiplexedDatabase.moves--B GGCu % rKc`URHnURUR5 M gre)r-rrrVr+s r>r$MultiplexedDatabase._start_listenings"--B OOD22 3 rKc`URHnURUR5 M gre)r-rrrZs r>r#MultiplexedDatabase._stop_listening s$--B   t55 6 rKr1r)rZr[r\r]rr$rirrrrrrrrur-r.r}rrr^r_r`s@r>r'r's2_ U#U F t $$8E?$  e  "%""$"&&U&5&T&477rKr'c @^\rSrSrSrS\"SS9S4S\S\S \S \S \S-4 U4S jjjrS \4Sjr S\ S \ 4Sjr S Sjr S SjrS\S \S-4SjrS \S-4Sjr\\S\S \4Sj55rS\S \\4SjrS\S\S S4SjrS\S\S\S S4SjrS\S\S S4SjrSrU=r$)!r%ia A file-based database loaded from a `GitHub Actions `_ artifact. You can use this for sharing example databases between CI runs and developers, allowing the latter to get read-only access to the former. This is particularly useful for continuous fuzzing (i.e. with `HypoFuzz `_), where the CI system can help find new failing examples through fuzzing, and developers can reproduce them locally without any manual effort. .. note:: You must provide ``GITHUB_TOKEN`` as an environment variable. In CI, Github Actions provides this automatically, but it needs to be set manually for local usage. In a developer machine, this would usually be a `Personal Access Token `_. If the repository is private, it's necessary for the token to have ``repo`` scope in the case of a classic token, or ``actions:read`` in the case of a fine-grained token. In most cases, this will be used through the :class:`~hypothesis.database.MultiplexedDatabase`, by combining a local directory-based database with this one. For example: .. code-block:: python local = DirectoryBasedExampleDatabase(".hypothesis/examples") shared = ReadOnlyDatabase(GitHubArtifactDatabase("user", "repo")) settings.register_profile("ci", database=local) settings.register_profile("dev", database=MultiplexedDatabase(local, shared)) # We don't want to use the shared database in CI, only to populate its local one. # which the workflow should then upload as an artifact. settings.load_profile("ci" if os.environ.get("CI") else "dev") .. note:: Because this database is read-only, you always need to wrap it with the :class:`ReadOnlyDatabase`. A setup like this can be paired with a GitHub Actions workflow including something like the following: .. code-block:: yaml - name: Download example database uses: dawidd6/action-download-artifact@v9 with: name: hypothesis-example-db path: .hypothesis/examples if_no_artifact_found: warn workflow_conclusion: completed - name: Run tests run: pytest - name: Upload example database uses: actions/upload-artifact@v3 if: always() with: name: hypothesis-example-db path: .hypothesis/examples In this workflow, we use `dawidd6/action-download-artifact `_ to download the latest artifact given that the official `actions/download-artifact `_ does not support downloading artifacts from previous workflow runs. The database automatically implements a simple file-based cache with a default expiration period of 1 day. You can adjust this through the ``cache_timeout`` property. For mono-repo support, you can provide a unique ``artifact_name`` (e.g. ``hypofuzz-example-db-frontend``). zhypothesis-example-db)daysNownerrepo artifact_name cache_timeoutr1c.>[TU]5 XlX lX0lX@l[ S5UlUc([[SURS355Ul O[U5Ul SUl SUl SUl SUlSUlg)N GITHUB_TOKENzgithub-artifacts//Fz{This database is read-only. Please wrap this class with ReadOnlyDatabasei.e. ReadOnlyDatabase(GitHubArtifactDatabase(...)).)rTrirarbrcrdr tokenr rr1 _initialized _disabled _artifact _access_cache_read_only_message)rVrarbrcrdr1rWs r>riGitHubArtifactDatabase.__init__Us   **"(!7 <"!$5d6H6H5I"KLDIT DI#($'+CG B rKr2c\SUR<SUR<SUR<S3$)NzGitHubArtifactDatabase(owner=z, repo=z, artifact_name=r)rarbrcrhs r>rGitHubArtifactDatabase.__repr__s6+DJJ>:II= 01C1C0Fa I rKrc"[U[5=(ay URUR:H=(aY URUR:H=(a9 URUR:H=(a UR UR :H$re)rr%rarbrcr1rs r>rGitHubArtifactDatabase.__eq__sn u4 5 ( ekk) ( UZZ' (""e&9&99 ( UZZ'  rKcURcS5eUR(ag[UR5nUR5(a[eSSS5 0Ul[UR5nUR 5nUHnURU5nUR5(a"[5UR [U5'MK[U5RnUR UR[U55 M SSS5 SUlg!,(df  N=f!,(df  N'=f![a$ [R"S[SS9 SUlNWf=f)NzArtifact not loaded.zThe downloaded artifact from GitHub is invalid. This could be because the artifact was corrupted, or because the artifact was not created by Hypothesis. rErFT)rkrirtestziprrlnamelistgetinfor6rr r5rrHrIrrj)rVrzfrufilenamefileinfokeypaths r>_prepare_for_io&GitHubArtifactDatabase._prepare_for_ios6~~)A+AA)     "(A99;;$$)"$D (B;;= (H!zz(3H((AD**8H+=>#+8"4";";**73778JK!)),!A)()( " MMJ"  "DN "sGED,$E>BD=E, D:6E= E E E+E<;E<c[URR5 URRSSS9 [ URR S5SS9nUSSHnUR 5 M USnUbj[R"[R5[R"URRSS55- UR:aX0lOzUR#5nU(aUbUR 5 X@lOIUb$[$R&"S U3[(S S 9 X0lO"[$R&"S [(S S 9 SUlgUR-5 g![a SnGNf=f) NTrz*.zipcb[R"URRSS55$)N_:)r fromisoformatstemreplaceas r>7GitHubArtifactDatabase._initialize_db..s(00S1IJrKrrrz:Using an expired artifact as a fallback for the database: rFz@Couldn't acquire a new or existing artifact. Disabling database.)rr1rrsortedglobr IndexErrorrnowrutcrrrrdrk_fetch_artifactrHrIrrjr{)rVcached_artifactsartifactfound_artifact new_artifacts r>_initialize_db%GitHubArtifactDatabase._initialize_dbsa$))..) t4" IINN7 #J  )"-H OO . "-b1N  % LL &$$^%8%8%@%@c%JK L   !,N //1L!-"))+!-+ P%&(%  "0 V%  "& G "!N "s;E88 FFurlc[USSSUR3S.S9nSnSn[U5nUR5nSSS5 Ub[R"U[S S 9 gU$!,(df  N.=f![a/nUR S:XaSnOSnUR 5 SnANeSnAf[a S nNv[a S nNf=f) Nzapplication/vnd.github+jsonz 2022-11-28 zBearer )AcceptzX-GitHub-Api-Version Authorization)headersizAuthorization failed when trying to download artifact from GitHub. Check that you have a valid GITHUB_TOKEN set in your environment.zpCould not get the latest artifact from GitHub. This could be because the repository or artifact does not exist. z8Could not connect to GitHub to get the latest artifact. zNCould not connect to GitHub to get the latest artifact (connection timed out).rrF) rrhrreadrcoderr TimeoutErrorrHrIr)rVrrequestwarning_messageresponse_bytesresponsees r> _get_bytes!GitHubArtifactDatabase._get_bytess 7(5#*4::,!7 '+ !X!)"0  & MM/+< K9"! vv}X 3 GGII YXO *  s? A6A%A6% A3/A63A66 C %B**C ; C C clSURSURS3nURU5nUcg[R"U5SnUVs/sHoDSUR :XdMUPM nnU(dg[ USS9nUSnURU5nUcg[R"[R5R5RS S 5nURUS 3- nURU5 U$s snf![a [ R""S [$S S9 gf=f)Nzhttps://api.github.com/repos/rgz/actions/artifacts artifactsrc US$)N created_atrYrs r>r8GitHubArtifactDatabase._fetch_artifact..'s,rKrarchive_download_urlrrz.zipz0Could not save the latest artifact from GitHub. rErF)rarbrjsonloadsrcmaxrrrr isoformatrr1rrrHrIr) rVrrrrrartifact_bytes timestamp artifact_paths r>r&GitHubArtifactDatabase._fetch_artifacts0-djj\499+EWX-  !JJ~.{; )M 1vY$:L:L-LQ My&?@-.-  ! LL.88:BB3L  yk$66    % %n 5;N*  MMB!    sD*D4D $D32D3rkc0[[U5S-5$)Nrg)r rrs r>r GitHubArtifactDatabase._key_path@sc S())rKc#4# UR(agUR(d"UR5 UR(agURceURceUR U5n[ UR5nURRUS5nUH=nURUR55nUR5v SSS5 M? SSS5 g!,(df  MY=f!,(df  g=f7fr) rjrirrkrlrrropenas_posixr)rVrkrrw filenamesrxrs r>ruGitHubArtifactDatabase.fetchEs >>      !~~~~)))!!--- ^^C  T^^ $**..r26I%WWX..01Q&&(N21&% $21 % $s7B D AD C5 D, D5 D ?D DDrlc,[UR5ere RuntimeErrorrmrqs r>r-GitHubArtifactDatabase.save[42233rKryrzc,[UR5ererr|s r>r}GitHubArtifactDatabase.move^rrKc,[UR5ererrqs r>r.GitHubArtifactDatabase.deletearrK) rlrkrjrirmrcrdrar1rbrhr)rZr[r\r]rrrr*rirrrrr{rrrr r staticmethodrr rrrur-r}r.r^r_r`s@r>r%r%sHCR5#,!#4 $ ( ( (  ( ! ( o ( ( T #  F t (!T5n(c(edl(T%%N*u***##8E?#,44e4444U454T44%44$44rKr%c^\rSrSrSrS\SS4U4SjjrSrS\4Sjr S \ S\ 4S jr SS jr SS \S-SS4S jjrS\S\\4SjrS\S\SS4SjrS\S\SS4SjrS\S\S\SS4SjrSSjrSSjrSrU=r$)BackgroundWriteDatabaseiezA wrapper which defers writes on the given database to a background thread. Calls to :meth:`~hypothesis.database.ExampleDatabase.fetch` wait for any enqueued writes to finish before fetching from the database. r+r2NcZ>[TU]5 Xl[5UlSUlgre)rTri_dbr_queue_threadr.s r>ri BackgroundWriteDatabase.__init__ls# _ensure_thread&BackgroundWriteDatabase._ensure_threadrsI << !dCDL LL      T::s 3 rKc$SUR<S3$)NzBackgroundWriteDatabase(r)rrhs r>r BackgroundWriteDatabase.__repr__zs)$((Q77rKrcb[U[5=(a URUR:H$re)rrrrs r>rBackgroundWriteDatabase.__eq__}s"%!89Sdhh%))>SSrKcURR5up[URU5"U6 URR 5 MQre)rrgetattrr task_done)rVmethodrOs r>rBackgroundWriteDatabase._workers?;;??,LF DHHf %t , KK ! ! #rKtimeoutcURR URR(aBURRRU5 URR(aMBSSS5 g!,(df  g=fre)rall_tasks_doneunfinished_taskswait)rVrs r>rBackgroundWriteDatabase._joinsR [[ ' '++.. **//8++...( ' 's AA>> B rkcXUR5 URRU5$re)rrrurts r>ruBackgroundWriteDatabase.fetchs xx~~c""rKrlc`UR5 URRSX445 grrrputrqs r>r-BackgroundWriteDatabase.saves%  #./rKc`UR5 URRSX445 grrrqs r>r.BackgroundWriteDatabase.deletes%  C<01rKryrzcbUR5 URRSXU445 g)Nr}rr|s r>r}BackgroundWriteDatabase.moves(  #U!345rKcNURRUR5 gre)rrrrhs r>r(BackgroundWriteDatabase._start_listenings d445rKcNURRUR5 gre)rrrrhs r>r'BackgroundWriteDatabase._stop_listenings   !7!78rK)rrrrre)rZr[r\r]rr$rirrrrrrrfloatrrrrur-r.r}rrr^r_r`s@r>rres +?+t+ 48#8TFTtT$ 9UT\9T9 ##8E?#00e002%22$266U656T6699rKrrlc[5nUS:deUS-nUS-nU(aUS-nURU5 U(dOM1[U5$)z Serialize an integer into variable-length bytes. For each byte, the first 7 bits represent (part of) the integer, while the last bit indicates whether the integer continues into the next byte. https://en.wikipedia.org/wiki/LEB128 r) bytearrayrr)rlpartsbytes r> _pack_uleb128rs\ KE A::  % !   FND T   <rKbuffercrSn[U5H up#US-nXUS---nUS- (aM O WS-U4$)zY Inverts _pack_uleb128, and also returns the index at which at which we stopped reading. rrrr_) enumerate)rrlirns r>_unpack_uleb128rsP EV$ L ! q1uqyy  % E5>rKchoicesc/nUGHen[U[5(aURU(aSOS5 M5[U[5(aSn[R "SU5nO}[U[ 5(a(SnURSUR5S--SS S 9nO@[U[5(aS nO([U[5(deS nURS S9n[U5nUS:a$URX4-RSS55 O>URUS-RSS55 UR[U55 URU5 GMh SRU5$)zISerialize a list of choices to a bytestring. Inverts choices_from_bytes. !d@r_bigTsigned`r surrogatepasserrorsrK)rrrrstructpackintto_bytes bit_lengthrrencodelenrr')rrchoicetagsizes r>choices_to_bytesrs@ E fd # # LL&e 4  fe $ $C[[v.F  $ $C__Q):):)<)A%A5QU_VF  & &Cfc** **C]]/]:F6{ '> LL#*..q%8 9 LL#-11!U; < LLt, - V58 88E?rK.cZ/nSnU[U5:Ga XS- nXS-nUS- nUS:XaUR[U55 MEUS:Xa[XS5upTX%- nXX$-nX$- nUS:Xa4US:XdS5eUR [ R "SU55 OiUS:Xa%UR[RUS S S 95 O>US :XaURU5 O&US :XdeURURSS95 U[U5:aGM [U5$)Nrrr_rzexpected float64rrrTr rErr r ) rrrrextendrunpackr from_bytesdecodetuple)rridxrroffsetchunks r>_choices_from_bytesr%s%E C F kQ{W$ q !8 LLd $  7?*6$<8LF MCSZ(  !819 00 09 LLtU3 4 AX LLuTB C AX LL !8O8 LL_= >/ F 0 <rKc:[U5$![a gf=f)z Deserialize a bytestring to a tuple of choices. Inverts choices_to_bytes. Returns None if the given bytestring is not a valid serialization of choice sequences. N)r% Exception)rs r>choices_from_bytesr(s&"6** s re)grrrr7rsysrrHrcollections.abcrrrrr functoolsrhashlibr r r pathlibr r queuer threadingrtypingrrrrrr urllib.errorrrurllib.requestrrzipfilerrhypothesis.configurationrhypothesis.errorsrr%hypothesis.internal.conjecture.choicerhypothesis.utils.conventionsr r!hypothesis.utils.deprecationr"__all__watchdog.observers.apir)rr*r)r!rr+r,r/r0rr?rJABCMetarMmodulessphinx.ext.autodocra signature'sphinx.ext.autodoc._dynamic._signaturesextautodoc_dynamic _signatures_moduler!r_METACLASS_CALL_BLACKLIST frozensetrr'r$r&rr#r(r'r%rrrrrr%r(rYrKr>rGs .22"-+'6D9B9 3HSM)))UE\* 9*uedl23 Y3 '&/9 $%gh.?.L(MM   0# 56 96h4&FJ/ % % (; ;d B//6 1ckk 1H s{{= !:  ) E E g77 C C070Q0QU1G -  - - 4 4Y ? A A H/ o/ d(u((|O|~$ $ NA7/A7HS4_S4l ;9o;9|0 E eCHo %hw/%u%PU7C<-@> u E'3,,?$,F i# )jj((G )    s<I2I.-I2I2I/+I2.I//I22I;:I;