python package for glottolog data curation
Project description
pyglottolog
Programmatic access to Glottolog data.
Install
To install pyglottolog
you need a python installation on your system, running python 2.7 or >3.4. Run
pip install pyglottolog
This will also install the command line interface glottolog
.
Note: To make use of pyglottolog
you also need a local copy of the
Glottolog data. This can be
- a clone of the clld/glottolog repository or your fork of it,
- an unzipped released version of Glottolog from GitHub,
- or an unzipped download of a released version of Glottolog from ZENODO.
Make sure you remember where this local copy of the data is located - you always
have to pass this location as argument when using pyglottolog
.
Python API
Glottolog data can also be accessed programmatically from within python programs.
All functionality is mediated through an instance of pyglottolog.api.Glottolog
, e.g.
>>> from pyglottolog.api import Glottolog
>>> api = Glottolog('.')
>>> print(api)
<Glottolog repos v0.2-259-g27ac0ef at /.../glottolog>
Accessing languoid data
>>> api.languoid('stan1295')
<Language stan1295>
>>> print(api.languoid('stan1295'))
German [stan1295]
Accessing reference data
>>> print(api.bibfiles['hh.bib']['s:Karang:Tati-Harzani'])
@book{s:Karang:Tati-Harzani,
author = {'Abd-al-'Ali Kārang},
title = {Tāti va Harzani},
publisher = {Tabriz: Tabriz University Press},
address = {Tabriz},
pages = {6+160},
year = {1334 [1953]},
glottolog_ref_id = {41999},
hhtype = {grammar_sketch},
inlg = {Farsi [pes]},
lgcode = {Harzani [hrz]},
macro_area = {Eurasia}
}
Command line interface
Command line functionality is implemented via sub-commands of glottolog
. The list of
available sub-commands can be inspected running
$ glottolog --help
usage: glottolog [-h] [--verbosity VERBOSITY] [--log-level LOG_LEVEL]
[--repos REPOS]
command ...
Main command line interface of the pyglottolog package.
positional arguments:
command isobib | show | edit | create | bib | tree | newick |
index | check | metadata | refsearch | refindex |
langsearch | langindex | tree2lff | lff2tree
args
optional arguments:
-h, --help show this help message and exit
--verbosity VERBOSITY
increase output verbosity
--log-level LOG_LEVEL
log level [ERROR|WARN|INFO|DEBUG]
--repos REPOS path to glottolog data repository
Use 'glottolog help <cmd>' to get help about individual commands.
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
Built Distribution
Hashes for pyglottolog-1.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5ccf121cfa61edd01a1aa24bf9ba8a4bc4135112a3f4652e961fa6fa72e4fe7 |
|
MD5 | 0477ff44e658de34cd7a01f19f44767d |
|
BLAKE2b-256 | b65135c5aa2e4a2de061e0eb5300c5cb9ab32af5ef9bedd57bcfc7af5803321a |