I was going through the "Logging Cookbook" article, following perfectly... until the section entitled "Dealing with handlers that block" attributed to writer Vinay Sajip <vinay_sajip at red-dove dot com>. I skimmed his discussion and figured that I could look at the code to figure out which imports that he did not include in the code because everything was making perfect sense. Apparently one of the imports required was the code snippet for a module recently above... yet there is no link in the doc to take me to a simple article explaining how to take a module code and create a import module in the article.
Thus, the Logging Cookbook became immediately IRRELEVANT in being a reference article without having experience or knowledge in creating Python modules. Yes, I am working on a complex project for myself. and am ramping up as quickly as I can, yet with a total of about 3 years managing python scripts similar to DOS BAT files, I have no experience creating importable modules in Python. Doing this complex project, I plan on designing MANY custom personal import modules for myself, yet that has not become a required skill yet. **Thus** to make the "Logging Cookbook** more useful, there should probably be a link to a quick appendix article by Vijay describing how to create an importable module from his long description about "Dealing with handlers that block"... or after he presented the code for the module.
I still have a lot of the article to read and was REALLY enjoying the coding knowledge that I was getting about the topic of logging... yet at this point in the article, there is a MAJOR requirement in knowledge which could be a simple appendix to the article, omitted from the learning process.
Thank you for addressing this issue. I came to this Python document "Logging Cookbook" from IDLE reading Python documentation, and doing a search for "logging". I am not really sure if I am reading an online article or a downloaded file with online links in the footer of the "help" subsystem. Yet,, I am very disappointed that Vijay's awesome article has a stopping point where I cannot use the information presented because I do not possess the knowledge and am not directed to a place to get the knowledge.
Thank you for your attention to this problem that only needs a short appendix or attachment at the bottom of the article... or a link to "Creating local/private Modules Cookbook. ;)