Some console tools for console command uses
Project description
PyConsoleCMDTools
A console toolkit for common uses
Installation
pip install consolecmdtools # install
pip install --upgrade consolecmdtools # update
Get Started
>>> import consolecmdtools as cct
>>> cct.__version__
'3.0.0'
Functions
>>> cct.banner("hello, world!") # Generate banner for text
#######################
# hello, world! #
#######################
>>> cct.md5("blah blah blah") # Return md5 hash for text.
'55e562bfee2bde4f9e71b8885eb5e303'
>>> cct.md5(42) # Return md5 hash for number.
'a1d0c6e83f027327d8461063f4ac58a6'
>>> cct.md5('file.txt') # Return md5 hash for file.
'd07aa6ddab4d6d2d2891aa9f3625a5db'
>>> cct.md5('file.txt', force_text=True) # Force to return the md5 has for text, even the file exists.
'3d8e577bddb17db339eae0b3d9bcf180'
>>> cct.crc32("blah blah blah") # Return crc32 hash for text.
753353432
>>> cct.crc32(42) # Return crc32 hash for number.
841265288
>>> cct.crc32('file.txt') # Return crc32 hash for file.
1030388931
>>> cct.crc32('file.txt', force_text=True) # Force to return the md5 has for text, even the file exists.
3774289445
>>> cct.main_color('image.jpg') # Get theme color of image.
(152, 156, 69) # RGB value
>>> cct.main_color('http://image-url/image', is_url=True) # Get theme color of web image.
(152, 156, 69) # RGB value
>>> cct.main_color('image.jpg', scale=500) # Cost more time to generate a preciser color. default scale is 200.
(152, 156, 69)
>>> cct.main_color('image.jpg', triplet='hex') # Return color in hex triplet format. default mode is 'rgb'.
'#989C45'
>>> cct.clear_screen() # Clear the console.
>>> cct.get_py_cmd() # Get python running command for different OS.
'python3'
>>> cct.run_cmd("echo hello") # Run console command. If the command failed, a warning message echoed. Returns bool.
*
| __RUN COMMAND__________________________
| (Command) echo hello
hello
`
>>> cct.read_cmd("echo hello") # Run a command and return the output.
'hello\n'
>>> cct.is_cmd_exist("ls") # Test if a command is exist.
True
>>> cct.get_dir("./file") # Get the parent folder path of the file.
'/path/to/dir' # '/path/to/dir/file' for example
>>> cct.get_dir("./file", mode="file") # Get the file absolute path.
'/path/to/dir/file'
>>> cct.get_dir("./file", mode="basename") # Get the parent folder name of the file.
'dir'
>>> cct.select_path() # Show file dialog to get file path. Additional args pass to tkinter.filedialog.askopenfilename()
'/path/to/dir/file'
>>> cct.select_path(multiple=True) # Show file dialog to get multiple file paths.
['/path/1', '/path/2']
>>> cct.select_path(folder=True) # Show file dialog to get folder path.
'/path/to/dir'
>>> cct.show_in_folder("/path/to/file") # Show file in Explorer/Finder/Folder.
>>> cct.show_in_folder("/path/to/file", ask=True) # Ask before show.
>>> cct.diff("str1", "str2") # Compare 2 strings, return the list of diffs.
[ # you can use `"\n".join(diff)` to print the diff.
"-str1",
"+str2"
]
>>> cct.diff("str1", "str2", meta=True) # show meta data in the first 3 lines.
[
"--- <class 'str'>",
"+++ <class 'str'>",
"@@ -1 +1 @@",
"-str1",
"+str2"
]
>>> cct.diff(["a", "b"], ["a", "b", "c"]) # Compare 2 lists and print diffs.
[
"+c"
]
>>> cct.diff(["a", "b"], ["a", "b", "c"], context=2) # Show diffs with 2 extra context lines.
[
" a", # context line
" b", # context line
"+c" # diff
]
>>> cct.diff("/path/to/file1", "/path/to/file2") # Compare between 2 files.
>>> cct.diff("/path/to/file1", "str") # Compare between file and str/list.
>>> cct.diff('str', 'str') # If no diff, return [].
[]
>>> cct.update_file('file', 'http://file-url') # Update file if the file is not as same as url content.
False # if already up-to-date.
>>> cct.read_file('file') # Read file using different encoding automatically.
"file content"
>>> cct.ajax('http://ajax-url') # Start a AJAX request.
{'result': 'data'} # As python dict.
>>> cct.ajax('http://ajax-url', {'data': 'value'}) # AJAX request with param.
{'result': 'data'}
>>> cct.ajax('http://ajax-url', method='post') # AJAX request using post. default is 'get'.
{'result': 'data'}
>>> if not cct.is_admin(): # Check does the script has admin privileges.
... cct.runas_admin(__file__) # run the script with admin privileges.
... else:
... # your code here
Updates
- 2021-01-29 v3.0.0:
- Deprecated
image_to_color()
, addmain_color()
.- use
main_color(..., is_url=True)
instead ofimage_to_color(...)
- use
- Deprecated
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
consolecmdtools-3.3.0.tar.gz
(10.0 kB
view hashes)
Built Distribution
Close
Hashes for consolecmdtools-3.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 591bb42f1d53814b18ac706f1de8dab8d9748b4e621eee7b8302343757447275 |
|
MD5 | ba217f800b1648ea047ec8271d4ca5a0 |
|
BLAKE2b-256 | 07385d83ed0023553e6f5acef8b47dbe5c4963d77428474e9411d746c08acdb3 |