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