Cloudmesh Common
Installation and Documentation
Please note that several packages are available which are pointed to in the
installation documentation.
Highlighted features
This library contains a number of useful functions and APIs that we highlight
here. They are used to interact with the system and provide a number of
functions to implement command line programs and shells.
Console
The console provides convenient way to print colored messages types in the
terminal, such as errors, info, and regular messages
from cloudmesh.common.console import Console
Console.error("this is an error printed in red with prefix ERROR:")
Console.msg("this is a msg printed in black")
Console.ok("this is an ok message printed in green")
Shell
We have lots of shell commands that call linux commands, but also have a
convenient execution command that returns the results in a string.
For more information we like you to inspect the source code:
from cloudmesh.common.Shell import Shell
shell = Shell()
print(shell.terminal_type())
r = shell.execute('pwd')
print(r)
r = shell.live('pwd')
print(r)
shell.terminal("ls")
shell.pip("install cloudmesh-common")
We have many such build in commands, please see the source
Printer
A convenient way to print dictionaries and lists with repeated
entries as tables, csv, json, yaml. The dictionaries can even be hierarchical.
Let us assume we have
data = [
{
"name": "Gregor",
"address": {
"street": "Funny Lane 11",
"city": "Cloudville"
{
},
{
"name": "Albert",
"address": {
"street": "Memory Lane 1901",
"city": "Cloudnine"
}
}
]
Then we can print it nicely with
print(Printer.flatwrite(self.data,
sort_keys=["name"],
order=["name", "address.street", "address.city"],
header=["Name", "Street", "City"],
output="table")
)
Other formats such as csv, json, dict are also supported.
In addition we have also printers for printing attribute lists. Please consult
the source code.
StopWatch
See: https://colab.research.google.com/drive/1tG7IcP-XMQiNVxU05yazKQYciQ9GpMat#scrollTo=TZAjATZiQh4q&uniqifier=1 for an example
Using Cloudmesh StopWatch Inline
from cloudmesh.common.StopWatch import StopWatch
import time
StopWatch.start("a")
time.sleep(3)
StopWatch.stop("a")
StopWatch.status("a", True)
StopWatch.benchmark()
Using Cloudmesh Benchmark wrapped in Functions
If it is not wrapped in functions, do not use it this way.
from cloudmesh.common.Benchmark import Benchmark
import time
def b():
Benchmark.Start()
time.sleep(3)
Benchmark.Stop()
def c():
Benchmark.Start()
time.sleep(1)
Benchmark.Stop()
b()
c()
Benchmark.print()
dotdict
One dimensional Dictionaries in dot format.
from cloudmesh.common.dotdict import doctict
d = dotdict({"name": "Gregor"})
print(d["name"])
print(d.name)
ssh
util
Very useful functions are included in util
Especially useful are
- generating passwords
- banners
- yn_choices
- path_expansion
- grep (simple line matching)
- HEADING() which without parameter identifies the name of the function and
prints its name within a banner
Changes
- added support for terminals with dark background
Acknowledgments
Continued work was in part funded by the NSF
CyberTraining: CIC: CyberTraining for Students and Technologies
from Generation Z with the award numbers 1829704 and 2200409.