Add an example to importlib docs on setting up an importer

[brettcannon]

BPO	26252
Nosy	@brettcannon, @pitrou, @matejcik, @ethanfurman, @soltysh, @dstufft, @efahl

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/brettcannon'
closed_at = <Date 2016-03-18.18:55:46.405>
created_at = <Date 2016-01-31.17:56:12.961>
labels = ['docs']
title = 'Add an example to importlib docs on setting up an importer'
updated_at = <Date 2016-03-18.18:55:46.403>
user = 'https://github.com/brettcannon'

bugs.python.org fields:

activity = <Date 2016-03-18.18:55:46.403>
actor = 'brett.cannon'
assignee = 'brett.cannon'
closed = True
closed_date = <Date 2016-03-18.18:55:46.405>
closer = 'brett.cannon'
components = ['Documentation']
creation = <Date 2016-01-31.17:56:12.961>
creator = 'brett.cannon'
dependencies = []
files = []
hgrepos = []
issue_num = 26252
keywords = []
message_count = 3.0
messages = ['259295', '261985', '261986']
nosy_count = 10.0
nosy_names = ['brett.cannon', 'pitrou', 'matejcik', 'hodgestar', 'cvrebert', 'ethan.furman', 'python-dev', 'maciej.szulik', 'dstufft', 'eric.fahlgren']
pr_nums = []
priority = 'low'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue26252'
versions = ['Python 3.6']

[brettcannon]

This past week a lot of people have asked me about how to set up an importer. It's enough to warrant adding an example in the new Examples section of the importlib docs to explain how to do this using the pre-existing classes in importlib.machinery for illustrative purposes.

[python-dev]

New changeset dc24ab548e2b by Brett Cannon in branch 'default':
Issue bpo-26252: Add an example on how to register a finder
https://hg.python.org/cpython/rev/dc24ab548e2b

[brettcannon]

I added an example on how to register both a meta path and path entry finder. It's a rather simple example, but hopefully using the classes that importlib uses will help also point people towards the appropriate classes to learn about for their own needs.