访问CLDF参考目录的Python库
cldfcatalog的Python项目详细描述
CLDF目录
使用git
存储库克隆和引用目录的实用程序。在
研究数据——尤其是CLDF数据——通常使用git
存储库进行管理
用于版本控制。^{git.Repo
类的包装器,公开相关功能
在这种情况下。在
CLDF的一个特别重要的数据是参考目录,它是
在CLDF数据创建期间咨询。同样,此类目录通常可以作为
git
托管在GitHub上的存储库,例如
Glottolog或
Concepticon。在
这些目录的典型使用场景如下:
- 为了跟踪目录的上游开发,用户可以在本地克隆
存储库,定期同步运行
git pull origin
。在 - 当创建CLDF数据集时,将参考目录的特定发布版本。
因此,我们想
- 签出特定版本的目录
- 运行CLDF创建
- 还原存储库克隆的先前状态。在
这正是^{
>>>fromcldfcatalogimportCatalog>>>glottolog=Catalog('../../glottolog/glottolog','v4.0')>>>glottolog.active_branch'master'>>>withglottolog:...print(glottolog.describe())...v4.0>>>glottolog.describe()'v4.0-52-ga4cfc90'
配置
cldfcatalog
支持通过配置文件发现目录克隆的本地路径。
如果在appdirs.user_config_dir('cldf')
找到一个文件catalog.ini
(请参见appdirs),则其clones
部分将用作
从Catalog.cli_name()
映射到克隆路径。因此
目录可以初始化为
withCatalog.from_config('clts',tag='v1.0'):...
克隆目录时,
运行Catalog.clone
,appdirs.user_config_dir('cldf')
将用作
克隆和路径将写入配置文件。在
要将添加路径添加到配置文件,请将其用作上下文管理器:
fromcldfcatalogimportConfigwithConfig.from_file()ascfg:cfg.add_clone(key,path)
- 项目
标签: