{"id":2920,"date":"2022-06-20T09:29:14","date_gmt":"2022-06-20T13:29:14","guid":{"rendered":"https:\/\/www.alpharithms.com\/?p=2920"},"modified":"2022-06-20T09:31:40","modified_gmt":"2022-06-20T13:31:40","slug":"python-howdoi","status":"publish","type":"post","link":"https:\/\/www.alpharithms.com\/python-howdoi-142909\/","title":{"rendered":"Python howdoi: Instant Command Line Code Help"},"content":{"rendered":"

The Python ecosystem is vast and powerful. Among the many incredible third-party libraries is howdoi<\/code>. This package allows developers to type in questions directly from the command line and have them answered. It requires an internet connection to work but can greatly improve workflow efficiency.<\/p>\n

This package is available in the Python pip catalog and can be installed as easily as it can be executed. It works by querying the Stackoverflow.com website, looking for the top answers to relevant questions, then returning those answers via terminal printout to developers. It has quite the list of dependencies and has a few quirks of which one should be aware, but overall is a useful tool.<\/p>\n

Quick Intro: Install, Setup, & Basic Use<\/h2>\n

The howdoi<\/code> package (aptly named) can be installed much like other Python packages:<\/p>\n

pip install howdoi<\/pre>\n
You should see the terminal output the typical updates of downloading and installing dependencies — there are a lot. Below is the list of dependencies, taken directly from the requirements.txt<\/code> of howdoi<\/code>:<\/p>\n
Pygments>=2.3.1\r\nargparse==1.4.0\r\ncssselect==1.1.0\r\nlxml>=4.2.5\r\npyquery==1.4.1\r\nrequests==2.24.0\r\ncachelib==0.1.1\r\nappdirs==1.4.4\r\nkeep==2.9\r\nrich==10.13.0\r\ncolorama==0.4.4<\/pre>\n
These libraries, based on the current system state, may require additional downloads. For example, the total install log of a recent howdoi<\/code> reads as follows:<\/p>\n
Installing collected packages: \r\npycparser, wrapt, urllib3, idna, charset-normalizer, cffi, certifi, requests, pynacl, pyjwt, deprecated, colorama, terminaltables, PyGithub, lxml, cssselect, click, pyquery, Pygments, keep, cachelib, appdirs, howdoi<\/pre>\n
That’s 23 dependencies total — not exactly lightweight. It is important to note that, while howdoi<\/code> is a Python package, questions are not limited to Python concerns. The howdoi<\/code> package can field any question — though those limited to the domain of programming and computer science-related concerns are ideal. For example, the query howdoi find inner peace<\/code> returns the following output:<\/p>\n
def search(sentences, keyword1, keyword2, window=3):\r\n    res = []\r\n    for sentence in sentences:\r\n        words = sentence.lower().split(\" \")\r\n        if keyword1 in words and keyword2 in words:\r\n            keyword1_idx = words.index(keyword1)\r\n            keyword2_idx = words.index(keyword2)\r\n            if keyword2_idx - keyword1_idx <= window:\r\n                res.append(sentence)\r\n    return res\r\n<\/pre>\n
Very interesting but not very\u00a0enlightening<\/em>. This package also provides some advanced customization features such as altering which StackExchange subdomain is queried, defining custom functions, and even aliasing custom functions. Read the documentation<\/a> for a full overview.<\/p>\n
Basic Usage<\/h2>\n
The howdoi<\/code> package provides users with command-line access to Stackoverflow answers (by default) and is used as such:<\/p>\n
$ howdoi [QUERY [QUERY ...]]<\/pre>\n
This command-line notation simply means that one uses the command howdoi<\/code> and passes some optional arguments. If no arguments are passed (e.g. $ howdoi<\/code>) it is the same as executing the howdoi -help<\/code> command. Let’s consider the output from a simple query:<\/p>\n
$ howdoi print something in python\r\nimport time\r\n\r\nx = input()\r\ntime.sleep(6)\r\nprint('Hello World!')\r\n\r\n$ \r\n<\/pre>\n
Immediately after the query howdoi print something in python<\/code> , we see output of an example of printing something in Python! It lacks an explanation but\u00a0does<\/em> address the question. Another helpful feature of howdoi<\/code> is to provide developers with the URL of the chosen answer. Let’s try our question again with a request for the URL:<\/p>\n
$ howdoi -l print something in python\r\nhttps:\/\/stackoverflow.com\/questions\/53679932\/how-do-i-print-something-after-n-seconds\r\n<\/pre>\n
Here we see only the link to the answer which, upon manual inspection, reveals the source of the initial answer:<\/p>\n
\"howdoi<\/a>
Figure 1: Stackoverflow answer source of the initial non-link generating query of “how to print something in python”<\/figcaption><\/figure>\n
This workflow would, essentially, save one from opening their browser, typing in stackoverflow.com<\/code>, entering the search phrase print something in python<\/code> into the search box, and clicking on the first answer. That’s actually quite an improvement in workflow provided one is happy with the first resulting post. On that note, let’s demo some usage of howdoi<\/code> that exemplifies some more advanced usage for those of us that might be pickier.<\/p>\n
Advanced Use<\/h2>\n
The howdoi<\/code> package provides several useful features that developers can enable, config, and disable via passing command line arguments. Three of the most notable are as follows:<\/p>\n
    \n
  • viewing the full text of an answer<\/li>\n
  • returning multiple answers<\/li>\n
  • save an answer to the local cache<\/li>\n<\/ul>\n
    There are certainly more features available but these provide a much wider range of use than the default howdoi [QUERY, [QUERY...]]<\/code> functionality. Let’s see a few in action!<\/p>\n
    View Full Text<\/h3>\n
    Passing in the --all<\/code> flag will return the full text of the answer (i.e. portions other than code blocks) as well as the URL from which the answer was obtained. Example code:<\/p>\n
    $ howdoi --all print something in python\r\n\u2605  Answer from https:\/\/stackoverflow.com\/questions\/53679932\/how-do-i-print-something-after-n-seconds \u2605\r\nuse import time\r\nimport time\r\n\r\nx = input()\r\ntime.sleep(6)\r\nprint('Hello World!')\r\n<\/pre>\n
    Return Multiple Answers<\/h3>\n
    Passing in the --num<\/code> flag with a proceeding integer argument as --num NUM<\/code> will return NUM<\/code> many answers (max). For this one, we’ll have to adjust our question since there is only 1 answer to the howdoi print something in python<\/code> query.<\/p>\n
    $ howdoi --num 3 install a package in python\r\n\u2605  Answer from https:\/\/stackoverflow.com\/questions\/34808902\/installing-package-in-python \u2605\r\nC:\\Python27\\Scripts\r\n\r\n================================================================================\r\n\r\n\u2605  Answer from https:\/\/stackoverflow.com\/questions\/65863547\/how-to-build-and-install-a-python-package-locally-without-uploading-to-pypi \u2605\r\npip install path_containing_fdroid_build_checker\/froid_buildchecker\r\n\r\n================================================================================\r\n\r\n\u2605  Answer from https:\/\/stackoverflow.com\/questions\/39473266\/how-to-install-module-and-package-in-python \u2605\r\npip\r\n<\/pre>\n
    At first glance, it appears the\u00a0 --all<\/code> command option has persisted. However, this is just a question-specific nuance as re-running the above with the --all<\/code> flag generates a much more detailed response (only first question shown here for brevity):<\/p>\n
    $ howdoi --all --num 3 install a package in python\r\n\u2605  Answer from https:\/\/stackoverflow.com\/questions\/34808902\/installing-package-in-python \u2605\r\nAdd C:\\Python27\\Scripts to your PATH in system settings, and you will be able to run:\r\npip3 thunder to install packages for Python 3.x\r\nand\r\npip2 thunder or pip2.7 thunder to install packages for Python 2.7.\r\nWithout modifying PATH, for Python 2.7 you can run the command directly:\r\nC:\\Python27\\Scripts\\pip thunder.\r\nAfter modifying the PATH pip command will be called from the directory found first, so if you add Python2.7 directory to the end you'll get pip to run for Python3, if you add Python2.7 to the start, you'll get pip to run for Python2.7.\r\n\r\n... (last two items omitted)\r\n<\/pre>\n
    Save an Answer to Local Cache<\/h3>\n
    Find yourself asking the same question over and over again? Save time and lower the risk of Google flagging your queries by using the local caching feature of howdoi<\/code>! The following code will ask a question and save the result in the local cache:<\/p>\n
    $ howdoi push an existing project to a github repo --save\r\nDetected fresh installation. Initializing environment in ~\/.keep directory\r\n...OK\r\n\r\nSTASH LIST:\r\n################################################################################\r\n\r\n$ push an existing project to a github repo\r\n\r\ngit init\r\ngit add .\r\ngit commit -m \"Initial commit\"\r\ngit remote add origin <project url>\r\ngit push -f origin master\r\n<\/pre>\n
    One can view the contents of the local “stash” at any time via the following command:<\/p>\n
    $ howdoi --view\r\n\r\nSTASH LIST:\r\n################################################################################\r\n\r\n$ push an existing project to a github repo\r\n\r\ngit init\r\ngit add .\r\ngit commit -m \"Initial commit\"\r\ngit remote add origin <project url>\r\ngit push -f origin master\r\n<\/pre>\n
    Running the\u00a0exact<\/em> same query will result in a notably faster turn-around time since howdoi<\/code> will retrieve the example from the local cache vs. making a query.\u00a0 The “stash” can be cleared either globally via the command howdoi --empty<\/code> or discretely via howdoi --remove QUERY<\/code>.<\/p>\n
    Final Thoughts<\/h2>\n
    The howdoi<\/code> package is a useful command-line assistant to help save developers some clicks. It has robust essential features and also provides a useful set of advanced features such as those seen above. In addition, howdoi<\/code> allows for searching of other stackexchange<\/code> properties (e.g. serverfault.stackexchange.com<\/code>), changing search engine, disabling SSL requirements, and disabling the cache feature entirely.<\/p>\n","protected":false},"excerpt":{"rendered":"
    The Python ecosystem is vast and powerful. Among the many incredible third-party libraries is howdoi. This package allows developers to type in questions directly from the command line and have them answered. It requires an internet connection to work but can greatly improve workflow efficiency. This package is available in the Python pip catalog and […]<\/p>\n","protected":false},"author":2,"featured_media":2922,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[186,655],"tags":[12,665,666,180,143],"acf":[],"_links":{"self":[{"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/posts\/2920"}],"collection":[{"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/comments?post=2920"}],"version-history":[{"count":3,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/posts\/2920\/revisions"}],"predecessor-version":[{"id":2925,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/posts\/2920\/revisions\/2925"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/media\/2922"}],"wp:attachment":[{"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/media?parent=2920"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/categories?post=2920"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.alpharithms.com\/wp-json\/wp\/v2\/tags?post=2920"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}