samplecmd
SampleCMD is a CLI application which prepares sample commands for users based on search words.
Install
$ pip install samplecmdNOTE: this project developed for python3.
Example
$ samplecmd grep -l 2Result:
>>> 1: Show files containing "foo" and "bar" and "baz"
grep -l 'baz' $(grep -l 'bar' $(grep -lr 'foo' *) )
>>> 2: Search git logs (case-insensitive)
git log -i --grep='needle'Arguments
Command input structure: samplecmd <COMMAND NAME> [EXTRA OPTIONS]
| Description | Argument | Value |
|---|---|---|
| Show command description | -d | |
| Show command source link | -s | |
| Limit results | -l | number |
Add Extra Sites
To add extra sites, just do these steps:
$ mkdir ~/.samplecmd/sites/ -pThen create your site file with .ini extension and fill required variables.
This is configuration file of BashOneLiners site (HTML):
[GENERAL]
# Enable to be search
enable = yes
[SITE INFO]
# General site info
site_name = BashOneLiners
site_url = http://www.bashoneliners.com/
site_search_url = http://www.bashoneliners.com/oneliners/search/?query={}
[CONTENT INFO]
# Site content type (html or json)
site_content_type = html
# How to get content of request (get or post)
site_content_action = get
[CONTENT PATTERN]
# These variables should be "xpath" or "json key" based on the site returned content
parent = //div[contains(@class, 'oneliner oneliner-')]
title = h3[@class='summary']/a
command = pre[@class='line']/span[@class='oneliner-line']
description = div[@class='explanation']//pThis is configuration file of of CommandLineFu site (JSON):
[GENERAL]
# Enable to be search
enable = yes
[SITE INFO]
# General site info
site_name = CommandLineFu
site_url = http://www.commandlinefu.com/
site_search_url = http://www.commandlinefu.com/commands/matching/{0}/base64({0})/json
[CONTENT INFO]
# Site content type (html or json)
site_content_type = json
# How to get content of request (get or post)
site_content_action = get
[CONTENT PATTERN]
# These variables should be "xpath" or "json key" based on the site returned content
# parent tag could contain "/" like: parent/sub_parent
parent =
title = summary
command = command
description =NOTE: if your sites returns HTML, then fill CONTENT PATTERN section with xpath format, otherwise if it returns JSON, then fill this section with JSON key names.
If you want to call extra function in your url, just put your function name in it like commandlinefu configuration file and implement your function as a staticmethod in Utils class.
Contribute
If you know a website or a service which provide sample commands, kindly keep me in touch, I will update the source links, or you could create your source link configuation file and send me a pull request.
