Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython2 / d0005ff41fdb3e8806aaaf812a71ba507a83b14c / . / Lib / importlib / NOTES
blob: d607449cd5325de3835789adbc44bfc7232dc096 [file] [log] [blame]
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]1to do
2/////
3
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]4* Create reasonable base tests that all finders and loaders must pass so
5 that various implementations can just subclass as needed.
6
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]7* Reorganize support code.
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]8
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]9 + Separate general support code and importer-specific (e.g. source) support
10 code.
11 - Create support modules for each subdirectory (as needed).
12 + Add a file loader mock that returns monotonically increasing mtime.
13 - Use in source/test_reload.
14 - Use in source/test_load_module_mixed.
15
16* API simplification?
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]17
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]18 + read_source -> get_data/source_path
19 + read_bytecode -> get_data/bytecode_path
20 + write_bytecode -> complete set of bytes for bytecode instead of
21 individual arguments.
22
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]23* Create meta_path importer for sys.path.
24
25* OPTIMIZE!
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]26
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]27 + Write benchmark suite.
28 + Fast path common cases.
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]29
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]30 - Absolute name from sys.path.
31 - Relative name from sys.path.
32
Brett Cannond0005ff2009-01-26 01:54:40 +0000[diff] [blame^]33* Implement PEP 302 protocol for loaders (should just be a matter of testing).
34
35 + Built-in.
36 + Frozen.
37 + Extension.
38 + Source/bytecode.
39
Brett Cannonafccd632009-01-20 02:21:27 +0000[diff] [blame]40* Public API to expose (w/ docs!)
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]41
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]42 + abc
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]43
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]44 - Finder
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]45
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]46 * find_module
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]47
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]48 - Loader
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]49
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]50 * load_module
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]51
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]52 - ResourceLoader(Loader)
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]53
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]54 * get_data
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]55
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]56 - InspectLoader(Loader)
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]57
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]58 * is_package
59 * get_code
60 * get_source
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]61
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]62 - (?) SourceLoader(ResourceLoader)
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]63
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]64 * source_path
65 * bytecode_path
66 * write_bytecode
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]67
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]68 + util
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]69
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]70 - get_module decorator (new name)
71 - check_name decorator (new name)
Brett Cannond0005ff2009-01-26 01:54:40 +0000[diff] [blame^]72 - resolve_name
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]73
74 + machinery
75
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]76 - (?) Chained path hook/finder
77 - BuiltinImporter
78 - FrozenImporter
79 - (?) FileFinder
80 - Extensions importers
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]81
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]82 * ExtensionFinder
83 * (?) Loader
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]84
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]85 - Source/bytecode importers
Brett Cannon5abdc932009-01-22 22:43:07 +0000[diff] [blame]86
Brett Cannon23cbd8a2009-01-18 00:24:28 +0000[diff] [blame]87 * SourceFinder
88 * (?) Loader
Brett Cannon24b6a2c2009-01-18 00:36:55 +0000[diff] [blame]89
90* Bootstrap importlib as implementation of builtins.__import__