在导入过程中复制其他文件和目录的甜菜插件。
beets-extrafiles的Python项目详细描述
甜菜附加文件
用于beets的插件,在导入过程中复制其他文件和目录。
安装
important:即使beets支持python 2和windows,这个插件也不支持-它只支持类unix操作系统上的python 3。有关详细信息,请参见F.A.Q. section。
插件在PyPI上发布,可以通过以下方式安装:
$ pip3 install --user beets-extrafiles
还可以克隆git存储库并手动安装插件:
$ git clone https://github.com/Holzhaus/beets-extrafiles.git
$ cd beets-extrafiles
$ ./setup.py install --user
用法
通过将插件添加到甜菜的plugins
列表中来激活插件config.yaml
:
plugins:# [...]-extrafiles
此外,还需要添加匹配的glob patterns。
模式匹配与相册根目录(所有相册文件的公用目录)相关的文件。
这意味着,如果相册在albumdir/CD1
和albumdir/CD2
中有文件,则所有模式都将与albumdir
相匹配。
下面的代码片段将添加名为all
的模式组,该模式组与具有扩展名的所有文件匹配。
extrafiles:patterns:all:'*.*'
如果要自定义将要复制或移动文件的目标路径,则模式名称非常有用。
以下配置将匹配名为scans
、Scans
、artwork
或Artwork
(使用模式组artworkdir
)的所有文件夹,将它们复制到相册路径并将其重命名为artwork
:
extrafiles:patterns:artworkdir:-'[sS]cans/'-'[aA]rtwork/'paths:artworkdir:$albumpath/artwork
开发
克隆git存储库后,可以使用setup.py
为您设置必要的符号链接:
$ git clone https://github.com/Holzhaus/beets-extrafiles.git
$ cd beets-extrafiles
$ ./setup.py develop --user
添加更改时,请遵循PEP 8。
另外,请将docstring添加到您创建的所有模块、函数和方法中。
use可以通过使用^{
使用pre-commit将在提交更改时自动执行这些检查。 您可以通过在git存储库的根目录中执行此操作来安装预提交挂钩:
$ pre-commit install
您还应该通过运行unittests测试每个提交,即:
$ ./setup.py test
如果测试失败,请在创建pull请求之前修复它。 如果您不小心提交了仍然包含错误的内容,请修改、压缩或修正该提交内容,而不要添加新的。
F.A.Q.
为什么不使用copyartifacts
插件呢?
samit barakat的^{
然而,它似乎还未被维护: 上一次提交是在一年前完成的,而且每次运行时都会遇到一个bug问题,导致它崩溃。 前一段时间我写了一个补丁并提交了一个Pull Request,但是我还没有合并。
此外,还希望通过支持文件夹和进行更细粒度路径自定义的能力,朝着不同的方向发展。
因此,我写了beets-extrafiles
。
为什么这个插件不支持Python2和Windows?
我刚开始写这个插件,因为我需要它。 因为我既不使用python 2也不使用windows,所以我没有实现支持。
如果你真的需要支持,可以写一个补丁并提交一个请求。 只要代码不太难读,我就合并它。
对于windows支持,还需要某种持续集成(ci)解决方案来防止将来的中断。
这个项目使用什么许可证?
这个项目是根据MIT license的条款发布的。