shelmet 0.2.0

链接

• 项目：https://github.com/dgilland/shelmet
• 文档：https://shelmet.readthedocs.io
• PyPI:https://pypi.python.org/pypi/shelmet/
• Github操作：https://github.com/dgilland/shelmet/actions

特点

• Shell实用程序，如…
  • cp，mv，mkdir，touch
  • rm，rmfile，rmdir
  • ls，lsfiles，lsdirs
  • walk，walkfiles，walkdirs
  • cd，environ
  • 还有更多！在
  在
• 100%测试覆盖率
• 完全类型注释
• Python 3.6+

快速启动

使用pip安装：

pip3 install shelmet

导入sh模块：

执行一些文件操作：

# Make directories and sub-directories. Behaves like "$ mkdir -p"sh.mkdir("a","b","c","d/e/f/g")# Context-manager to change working directory temporarily. Behaves like "$ cd".withsh.cd("d/e/f/g"):sh.touch("1.txt","2.txt","3.txt")# Move files or directories. Works across file-systems. Behaves like "$ mv".sh.mv("1.txt","11.txt")# Copy files or directories. Behaves like "$ cp -r"sh.cp("2.txt","22.txt")# List top-level directory contents.# NOTE: sh.ls() and its siblings are generators.list(sh.ls())# Limit to files.list(sh.lsfiles())# Limit to directories.list(sh.lsdirs())# Remove files.sh.rmfile("11.txt","22.txt","3.txt")# Or use sh.rm which handles both files and directories.sh.rm("11.txt","22.txt","3.txt")# Recursively walk current directory.# NOTE: sh.walk() and its siblings are generators.list(sh.walk())# Or just a specified directory.list(sh.walk("d"))# Or just it's files or directories.list(sh.walkfiles())list(sh.walkdirs())# Remove directories.sh.rmdir("a","b","c","d")# Or use sh.rm which handles both files and directories.sh.rm("a","b","c","d")

以原子方式写入新文件，其中内容将写入临时文件，完成后再移动：

importoswithsh.atomicfile("path/to/atomic.txt")asfp:# Writes are sent to a temporary file in the same directory as the destination.print(fp.name)# will be something like "path/to/.atomic.txt_XZKVqrlk.tmp"fp.write("some text")fp.write("some more text")# File doesn't exist yet.assertnotos.path.exists("path/to/atomic.txt")# Exiting context manager will result in the temporary file being atomically moved to destination.# This will also result in a lower-level fsync on the destination file and directory.assertos.path.exists("path/to/atomic.txt")# File mode, sync skipping, and overwrite flag can be specified to change the default behavior which is...withsh.atomicfile("file.txt","w",skip_sync=False,overwrite=True):pass# Additional parameters to open() can be passed as keyword arguments.withsh.atomicfile("file.txt","w",**open_kwargs):pass

以原子方式创建一个新目录，其中的内容将写入临时目录，然后在完成后移动：

withsh.atomicdir("path/to/atomic_dir")aspath:# Yielded path is temporary directory within the same parent directory as the destination.# path will be something like "path/to/.atomic_dir_QGLDfPwz_tmp"some_file=path/"file.txt"some_file.write_text("contents")# file written to "path/to/.atomic_dir_QGLDfPwz_tmp/file.txt"some_dir=path/"dir"some_dir.mkdir()# directory created at "path/to/.atomic_dir_QGLDfPwz_tmp/dir/"# Directory doesn't exist yet.assertnotos.path.exists("path/to/atomic_dir")# Exiting context manager will result in the temporary directory being atomically moved to destination.assertos.path.exists("path/to/atomic_dir")# Sync skipping and overwrite flag can be specified to change the default behavior which is...withsh.atomicdir("atomic_dir",skip_sync=False,overwrite=True):pass

临时更改环境变量：

# Extend existing environment.withsh.environ({"KEY1":"value1","KEY2":"value2"})asnew_environ:# Do something while environment changed.# Environment variables include all previous ones and {"KEY1": "value1", "KEY2": "value2"}.pass# Replace the entire environment with a new one.withsh.environ({"KEY":"value"},replace=True):# Environment variables are replaced and are now just {"KEY": "value"}.pass

有关详细信息，请参阅位于https://shelmet.readthedocs.io的完整文档。在

变更日志