blob: ae4d255f8ec7dc2c9ddd87589f4ad5407f985a19 (plain)

ofs	hex dump	ascii
0000	cb 0d 0d 0a 00 00 00 00 4f e0 a7 68 89 0a 00 00 e3 00 00 00 00 00 00 00 00 00 00 00 00 04 00 00	........O..h....................
0020	00 00 00 00 01 f3 e6 00 00 00 97 00 64 00 5a 00 64 01 64 02 6c 01 6d 02 5a 02 01 00 64 01 64 03	............d.Z.d.d.l.m.Z...d.d.
0040	6c 03 6d 04 5a 04 01 00 64 01 64 04 6c 05 6d 06 5a 06 6d 07 5a 07 01 00 64 01 64 05 6c 08 5a 08	l.m.Z...d.d.l.m.Z.m.Z...d.d.l.Z.
0060	09 00 64 01 64 06 6c 09 6d 0a 5a 0a 01 00 64 01 64 07 6c 0c 6d 0d 5a 0d 01 00 65 06 72 0a 64 01	..d.d.l.m.Z...d.d.l.m.Z...e.r.d.
0080	64 08 6c 0e 6d 0f 5a 0f 6d 10 5a 10 6d 11 5a 11 01 00 02 00 65 0a 64 09 65 12 ac 0a ab 02 00 00	d.l.m.Z.m.Z.m.Z.....e.d.e.......
00a0	00 00 00 00 5a 13 64 05 65 08 6a 28 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 65 0d	....Z.d.e.j(..................e.
00c0	6a 2a 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 66 03 09 00 09 00 09 00 09 00 09 00	j*..................f...........
00e0	09 00 09 00 64 0c 64 0b 84 05 5a 16 79 05 23 00 65 0b 24 00 72 09 01 00 64 01 64 06 6c 05 6d 0a	....d.d...Z.y.#.e.$.r...d.d.l.m.
0100	5a 0a 01 00 59 00 8c 4d 77 00 78 03 59 00 77 01 29 0d 7a 32 0a 48 65 6c 70 65 72 73 20 72 65 6c	Z...Y..Mw.x.Y.w.).z2.Helpers.rel
0120	61 74 65 64 20 74 6f 20 28 64 79 6e 61 6d 69 63 29 20 72 65 73 6f 75 72 63 65 20 72 65 74 72 69	ated.to.(dynamic).resource.retri
0140	65 76 61 6c 2e 0a e9 00 00 00 00 29 01 da 0b 61 6e 6e 6f 74 61 74 69 6f 6e 73 a9 01 da 09 6c 72	eval.......)...annotations....lr
0160	75 5f 63 61 63 68 65 29 02 da 0d 54 59 50 45 5f 43 48 45 43 4b 49 4e 47 da 08 43 61 6c 6c 61 62	u_cache)...TYPE_CHECKING..Callab
0180	6c 65 4e 29 01 da 07 54 79 70 65 56 61 72 29 01 da 08 52 65 73 6f 75 72 63 65 29 03 da 03 55 52	leN)...TypeVar)...Resource)...UR
01a0	49 da 01 44 da 08 52 65 74 72 69 65 76 65 da 02 5f 54 29 01 da 07 64 65 66 61 75 6c 74 63 03 00	I..D..Retrieve.._T)...defaultc..
01c0	00 00 00 00 00 00 00 00 00 00 04 00 00 00 03 00 00 01 f3 38 00 00 00 87 00 87 01 87 02 97 00 89	...................8............
01e0	00 80 0c 74 01 00 00 00 00 00 00 00 00 64 01 ac 02 ab 01 00 00 00 00 00 00 8a 00 64 04 88 00 88	...t.........d.............d....
0200	02 88 01 66 03 64 03 84 0c 7d 03 7c 03 53 00 29 05 61 47 06 00 00 0a 20 20 20 20 43 72 65 61 74	...f.d...}.|.S.).aG........Creat
0220	65 20 61 20 72 65 74 72 69 65 76 65 72 20 77 68 69 63 68 20 63 61 63 68 65 73 20 69 74 73 20 72	e.a.retriever.which.caches.its.r
0240	65 74 75 72 6e 20 76 61 6c 75 65 73 20 66 72 6f 6d 20 61 20 73 69 6d 70 6c 65 72 20 63 61 6c 6c	eturn.values.from.a.simpler.call
0260	61 62 6c 65 2e 0a 0a 20 20 20 20 54 61 6b 65 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 68 69 63	able.......Takes.a.function.whic
0280	68 20 72 65 74 75 72 6e 73 20 74 68 69 6e 67 73 20 6c 69 6b 65 20 73 65 72 69 61 6c 69 7a 65 64	h.returns.things.like.serialized
02a0	20 4a 53 4f 4e 20 28 73 74 72 69 6e 67 73 29 20 61 6e 64 0a 20 20 20 20 72 65 74 75 72 6e 73 20	.JSON.(strings).and.....returns.
02c0	73 6f 6d 65 74 68 69 6e 67 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 70 61 73 73 69 6e 67 20 74	something.suitable.for.passing.t
02e0	6f 20 60 52 65 67 69 73 74 72 79 60 20 61 73 20 61 20 72 65 74 72 69 65 76 65 0a 20 20 20 20 66	o.`Registry`.as.a.retrieve.....f
0300	75 6e 63 74 69 6f 6e 2e 0a 0a 20 20 20 20 54 68 69 73 20 64 65 63 6f 72 61 74 6f 72 20 62 6f 74	unction.......This.decorator.bot
0320	68 20 72 65 64 75 63 65 73 20 61 20 73 6d 61 6c 6c 20 62 69 74 20 6f 66 20 62 6f 69 6c 65 72 70	h.reduces.a.small.bit.of.boilerp
0340	6c 61 74 65 20 66 6f 72 20 61 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 0a 20 20 20 20 28 64 65 73 65	late.for.a.common.case.....(dese
0360	72 69 61 6c 69 7a 69 6e 67 20 4a 53 4f 4e 20 66 72 6f 6d 20 73 74 72 69 6e 67 73 20 61 6e 64 20	rializing.JSON.from.strings.and.
0380	63 72 65 61 74 69 6e 67 20 60 52 65 73 6f 75 72 63 65 60 20 6f 62 6a 65 63 74 73 20 66 72 6f 6d	creating.`Resource`.objects.from
03a0	20 74 68 65 0a 20 20 20 20 72 65 73 75 6c 74 29 20 61 73 20 77 65 6c 6c 20 61 73 20 6d 61 6b 65	.the.....result).as.well.as.make
03c0	73 20 74 68 65 20 70 72 6f 62 61 62 6c 65 20 6e 65 65 64 20 66 6f 72 20 63 61 63 68 69 6e 67 20	s.the.probable.need.for.caching.
03e0	61 20 62 69 74 20 65 61 73 69 65 72 2e 0a 20 20 20 20 52 65 74 72 69 65 76 65 72 73 20 77 68 69	a.bit.easier......Retrievers.whi
0400	63 68 20 6f 74 68 65 72 77 69 73 65 20 64 6f 20 65 78 70 65 6e 73 69 76 65 20 6f 70 65 72 61 74	ch.otherwise.do.expensive.operat
0420	69 6f 6e 73 20 28 6c 69 6b 65 20 68 69 74 74 69 6e 67 20 74 68 65 0a 20 20 20 20 6e 65 74 77 6f	ions.(like.hitting.the.....netwo
0440	72 6b 29 20 6d 69 67 68 74 20 6f 74 68 65 72 77 69 73 65 20 62 65 20 63 61 6c 6c 65 64 20 72 65	rk).might.otherwise.be.called.re
0460	70 65 61 74 65 64 6c 79 2e 0a 0a 20 20 20 20 45 78 61 6d 70 6c 65 73 0a 20 20 20 20 2d 2d 2d 2d	peatedly.......Examples.....----
0480	2d 2d 2d 2d 0a 0a 20 20 20 20 2e 2e 20 74 65 73 74 63 6f 64 65 3a 3a 0a 0a 20 20 20 20 20 20 20	----.........testcode::.........
04a0	20 66 72 6f 6d 20 72 65 66 65 72 65 6e 63 69 6e 67 20 69 6d 70 6f 72 74 20 52 65 67 69 73 74 72	.from.referencing.import.Registr
04c0	79 0a 20 20 20 20 20 20 20 20 66 72 6f 6d 20 72 65 66 65 72 65 6e 63 69 6e 67 2e 74 79 70 69 6e	y.........from.referencing.typin
04e0	67 20 69 6d 70 6f 72 74 20 55 52 49 0a 20 20 20 20 20 20 20 20 69 6d 70 6f 72 74 20 72 65 66 65	g.import.URI.........import.refe
0500	72 65 6e 63 69 6e 67 2e 72 65 74 72 69 65 76 61 6c 0a 0a 0a 20 20 20 20 20 20 20 20 40 72 65 66	rencing.retrieval...........@ref
0520	65 72 65 6e 63 69 6e 67 2e 72 65 74 72 69 65 76 61 6c 2e 74 6f 5f 63 61 63 68 65 64 5f 72 65 73	erencing.retrieval.to_cached_res
0540	6f 75 72 63 65 28 29 0a 20 20 20 20 20 20 20 20 64 65 66 20 72 65 74 72 69 65 76 65 28 75 72 69	ource().........def.retrieve(uri
0560	3a 20 55 52 49 29 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 72 69 6e 74 28 66 22 52 65 74 72	:.URI):.............print(f"Retr
0580	69 65 76 65 64 20 7b 75 72 69 7d 22 29 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 23 20 4e 6f 72	ieved.{uri}")..............#.Nor
05a0	6d 61 6c 6c 79 2c 20 67 6f 20 67 65 74 20 73 6f 6d 65 20 65 78 70 65 6e 73 69 76 65 20 4a 53 4f	mally,.go.get.some.expensive.JSO
05c0	4e 20 66 72 6f 6d 20 74 68 65 20 6e 65 74 77 6f 72 6b 2c 20 61 20 66 69 6c 65 20 2e 2e 2e 0a 20	N.from.the.network,.a.file......
05e0	20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 27 27 27 0a 20 20 20 20 20 20 20 20 20 20	...........return.'''...........
0600	20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 24 73 63	......{....................."$sc
0620	68 65 6d 61 22 3a 20 22 68 74 74 70 73 3a 2f 2f 6a 73 6f 6e 2d 73 63 68 65 6d 61 2e 6f 72 67 2f	hema":."https://json-schema.org/
0640	64 72 61 66 74 2f 32 30 32 30 2d 31 32 2f 73 63 68 65 6d 61 22 2c 0a 20 20 20 20 20 20 20 20 20	draft/2020-12/schema",..........
0660	20 20 20 20 20 20 20 20 20 20 20 22 66 6f 6f 22 3a 20 22 62 61 72 22 0a 20 20 20 20 20 20 20 20	..........."foo":."bar".........
0680	20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 27 27 27 0a 0a 20 20 20 20 20	........}.............'''.......
06a0	20 20 20 6f 6e 65 20 3d 20 52 65 67 69 73 74 72 79 28 72 65 74 72 69 65 76 65 3d 72 65 74 72 69	...one.=.Registry(retrieve=retri
06c0	65 76 65 29 2e 67 65 74 5f 6f 72 5f 72 65 74 72 69 65 76 65 28 22 75 72 6e 3a 65 78 61 6d 70 6c	eve).get_or_retrieve("urn:exampl
06e0	65 3a 66 6f 6f 22 29 0a 20 20 20 20 20 20 20 20 70 72 69 6e 74 28 6f 6e 65 2e 76 61 6c 75 65 2e	e:foo").........print(one.value.
0700	63 6f 6e 74 65 6e 74 73 5b 22 66 6f 6f 22 5d 29 0a 0a 20 20 20 20 20 20 20 20 23 20 52 65 74 72	contents["foo"])..........#.Retr
0720	69 65 76 69 6e 67 20 74 68 65 20 73 61 6d 65 20 55 52 49 20 61 67 61 69 6e 20 72 65 75 73 65 73	ieving.the.same.URI.again.reuses
0740	20 74 68 65 20 73 61 6d 65 20 76 61 6c 75 65 20 28 61 6e 64 20 74 68 75 73 20 64 6f 65 73 6e 27	.the.same.value.(and.thus.doesn'
0760	74 0a 20 20 20 20 20 20 20 20 23 20 70 72 69 6e 74 20 61 6e 6f 74 68 65 72 20 72 65 74 72 69 65	t.........#.print.another.retrie
0780	76 61 6c 20 6d 65 73 73 61 67 65 20 68 65 72 65 29 0a 20 20 20 20 20 20 20 20 74 77 6f 20 3d 20	val.message.here).........two.=.
07a0	52 65 67 69 73 74 72 79 28 72 65 74 72 69 65 76 65 3d 72 65 74 72 69 65 76 65 29 2e 67 65 74 5f	Registry(retrieve=retrieve).get_
07c0	6f 72 5f 72 65 74 72 69 65 76 65 28 22 75 72 6e 3a 65 78 61 6d 70 6c 65 3a 66 6f 6f 22 29 0a 20	or_retrieve("urn:example:foo")..
07e0	20 20 20 20 20 20 20 70 72 69 6e 74 28 74 77 6f 2e 76 61 6c 75 65 2e 63 6f 6e 74 65 6e 74 73 5b	.......print(two.value.contents[
0800	22 66 6f 6f 22 5d 29 0a 0a 20 20 20 20 2e 2e 20 74 65 73 74 6f 75 74 70 75 74 3a 3a 0a 0a 20 20	"foo"]).........testoutput::....
0820	20 20 20 20 20 20 52 65 74 72 69 65 76 65 64 20 75 72 6e 3a 65 78 61 6d 70 6c 65 3a 66 6f 6f 0a	......Retrieved.urn:example:foo.
0840	20 20 20 20 20 20 20 20 62 61 72 0a 20 20 20 20 20 20 20 20 62 61 72 0a 0a 20 20 20 20 4e 29 01	........bar.........bar......N).
0860	da 07 6d 61 78 73 69 7a 65 63 01 00 00 00 00 00 00 00 00 00 00 00 05 00 00 00 13 00 00 01 f3 24	..maxsizec.....................$
0880	00 00 00 95 03 87 00 97 00 89 02 64 02 88 03 88 04 88 00 66 03 64 01 84 0c ab 00 00 00 00 00 00	...........d.......f.d..........
08a0	00 7d 01 7c 01 53 00 29 03 4e 63 01 00 00 00 00 00 00 00 00 00 00 00 03 00 00 00 13 00 00 01 f3	.}.|.S.).Nc.....................
08c0	34 00 00 00 95 03 97 00 02 00 89 05 7c 00 ab 01 00 00 00 00 00 00 7d 01 02 00 89 04 7c 01 ab 01	4...........|.........}.....|...
08e0	00 00 00 00 00 00 7d 02 02 00 89 03 7c 02 ab 01 00 00 00 00 00 00 53 00 29 01 4e a9 00 29 06 da	......}.....|.........S.).N..)..
0900	03 75 72 69 da 08 72 65 73 70 6f 6e 73 65 da 08 63 6f 6e 74 65 6e 74 73 da 0d 66 72 6f 6d 5f 63	.uri..response..contents..from_c
0920	6f 6e 74 65 6e 74 73 da 05 6c 6f 61 64 73 da 08 72 65 74 72 69 65 76 65 73 06 00 00 00 20 20 20	ontents..loads..retrieves.......
0940	80 80 80 fa 5c 2f 68 6f 6d 65 2f 62 6c 61 63 6b 68 61 6f 2f 75 69 75 63 2d 63 6f 75 72 73 65 2d	....\/home/blackhao/uiuc-course-
0960	67 72 61 70 68 2f 2e 76 65 6e 76 2f 6c 69 62 2f 70 79 74 68 6f 6e 33 2e 31 32 2f 73 69 74 65 2d	graph/.venv/lib/python3.12/site-
0980	70 61 63 6b 61 67 65 73 2f 72 65 66 65 72 65 6e 63 69 6e 67 2f 72 65 74 72 69 65 76 61 6c 2e 70	packages/referencing/retrieval.p
09a0	79 da 0f 63 61 63 68 65 64 5f 72 65 74 72 69 65 76 65 7a 3e 74 6f 5f 63 61 63 68 65 64 5f 72 65	y..cached_retrievez>to_cached_re
09c0	73 6f 75 72 63 65 2e 3c 6c 6f 63 61 6c 73 3e 2e 64 65 63 6f 72 61 74 6f 72 2e 3c 6c 6f 63 61 6c	source.<locals>.decorator.<local
09e0	73 3e 2e 63 61 63 68 65 64 5f 72 65 74 72 69 65 76 65 54 00 00 00 73 20 00 00 00 f8 80 00 e1 17	s>.cached_retrieveT...s.........
0a00	1f a0 03 93 7d 88 48 d9 17 1c 98 58 93 7f 88 48 d9 13 20 a0 18 d3 13 2a d0 0c 2a f3 00 00 00 00	....}.H....X...H.......*..*.....
0a20	29 02 72 14 00 00 00 72 0a 00 00 00 72 13 00 00 00 29 05 72 19 00 00 00 72 1b 00 00 00 da 05 63	).r....r....r....).r....r......c
0a40	61 63 68 65 72 17 00 00 00 72 18 00 00 00 73 05 00 00 00 60 20 80 80 80 72 1a 00 00 00 da 09 64	acher....r....s....`....r......d
0a60	65 63 6f 72 61 74 6f 72 7a 25 74 6f 5f 63 61 63 68 65 64 5f 72 65 73 6f 75 72 63 65 2e 3c 6c 6f	ecoratorz%to_cached_resource.<lo
0a80	63 61 6c 73 3e 2e 64 65 63 6f 72 61 74 6f 72 53 00 00 00 73 1d 00 00 00 f9 80 00 d8 09 0e f6 02	cals>.decoratorS...s............
0aa0	03 09 2b f3 03 00 0a 0f f0 02 03 09 2b f0 0a 00 10 1f d0 08 1e 72 1c 00 00 00 29 02 72 19 00 00	..+.........+........r....).r...
0ac0	00 7a 13 43 61 6c 6c 61 62 6c 65 5b 5b 55 52 49 5d 2c 20 5f 54 5d 72 04 00 00 00 29 04 72 1d 00	.z.Callable[[URI],._T]r....).r..
0ae0	00 00 72 18 00 00 00 72 17 00 00 00 72 1e 00 00 00 73 04 00 00 00 60 60 60 20 72 1a 00 00 00 da	..r....r....r....s....```.r.....
0b00	12 74 6f 5f 63 61 63 68 65 64 5f 72 65 73 6f 75 72 63 65 72 1f 00 00 00 19 00 00 00 73 22 00 00	.to_cached_resourcer........s"..
0b20	00 fa 80 00 f0 6e 01 00 08 0d 80 7d dc 10 19 a0 24 d4 10 27 88 05 f7 04 07 05 1f f0 12 00 0c 15	.....n.....}....$..'............
0b40	d0 04 14 72 1c 00 00 00 29 08 72 1d 00 00 00 7a 2b 43 61 6c 6c 61 62 6c 65 5b 5b 52 65 74 72 69	...r....).r....z+Callable[[Retri
0b60	65 76 65 5b 44 5d 5d 2c 20 52 65 74 72 69 65 76 65 5b 44 5d 5d 20 7c 20 4e 6f 6e 65 72 18 00 00	eve[D]],.Retrieve[D]].|.Noner...
0b80	00 7a 11 43 61 6c 6c 61 62 6c 65 5b 5b 5f 54 5d 2c 20 44 5d 72 17 00 00 00 7a 1a 43 61 6c 6c 61	.z.Callable[[_T],.D]r....z.Calla
0ba0	62 6c 65 5b 5b 44 5d 2c 20 52 65 73 6f 75 72 63 65 5b 44 5d 5d da 06 72 65 74 75 72 6e 7a 2c 43	ble[[D],.Resource[D]]..returnz,C
0bc0	61 6c 6c 61 62 6c 65 5b 5b 43 61 6c 6c 61 62 6c 65 5b 5b 55 52 49 5d 2c 20 5f 54 5d 5d 2c 20 52	allable[[Callable[[URI],._T]],.R
0be0	65 74 72 69 65 76 65 5b 44 5d 5d 29 17 da 07 5f 5f 64 6f 63 5f 5f da 0a 5f 5f 66 75 74 75 72 65	etrieve[D]])...__doc__..__future
0c00	5f 5f 72 03 00 00 00 da 09 66 75 6e 63 74 6f 6f 6c 73 72 05 00 00 00 da 06 74 79 70 69 6e 67 72	__r......functoolsr......typingr
0c20	06 00 00 00 72 07 00 00 00 da 04 6a 73 6f 6e da 11 74 79 70 69 6e 67 5f 65 78 74 65 6e 73 69 6f	....r......json..typing_extensio
0c40	6e 73 72 08 00 00 00 da 0b 49 6d 70 6f 72 74 45 72 72 6f 72 da 0b 72 65 66 65 72 65 6e 63 69 6e	nsr......ImportError..referencin
0c60	67 72 09 00 00 00 da 12 72 65 66 65 72 65 6e 63 69 6e 67 2e 74 79 70 69 6e 67 72 0a 00 00 00 72	gr......referencing.typingr....r
0c80	0b 00 00 00 72 0c 00 00 00 da 03 73 74 72 72 0d 00 00 00 72 18 00 00 00 72 17 00 00 00 72 1f 00	....r......strr....r....r....r..
0ca0	00 00 72 13 00 00 00 72 1c 00 00 00 72 1a 00 00 00 fa 08 3c 6d 6f 64 75 6c 65 3e 72 2b 00 00 00	..r....r....r......<module>r+...
0cc0	01 00 00 00 73 93 00 00 00 f0 03 01 01 01 f1 02 02 01 04 f5 08 00 01 23 e5 00 1f df 00 2a db 00	....s..................#.....*..
0ce0	0b f0 04 03 01 1f dd 04 29 f5 08 00 01 21 e1 03 10 df 04 33 d1 04 33 f1 06 00 06 0d 88 54 98 33	........)....!.....3..3......T.3
0d00	d4 05 1f 80 02 f0 08 00 3a 3e d8 1f 23 9f 7a 99 7a d8 30 38 d7 30 46 d1 30 46 f0 07 43 01 01 15	........:>..#.z.z.08.0F.0F..C...
0d20	d8 0b 36 f0 03 43 01 01 15 e0 0b 1c f0 05 43 01 01 15 f0 06 00 14 2e f0 07 43 01 01 15 f0 08 00	..6..C........C..........C......
0d40	06 32 f4 09 43 01 01 15 f8 f0 19 00 08 13 f2 00 01 01 1f df 04 1e f0 03 01 01 1f fa 73 11 00 00	.2..C.......................s...
0d60	00 9c 06 41 22 00 c1 22 0b 41 30 03 c1 2f 01 41 30 03	...A"..".A0../.A0.