Genderize 0.3.1

Genderize

Genderize.io Web服务的客户端。

基本用法

导入Genderize类，并使用一个包含名字的列表调用其get方法。

from genderize import Genderize
print(Genderize().get(['James', 'Eva', 'Thunderhorse']))

[{u'count': 1037, u'gender': u'male', u'name': u'James', u'probability': 0.99},
 {u'count': 234, u'gender': u'female', u'name': u'Eva', u'probability': 1.0},
 {u'gender': None, u'name': u'Thunderhorse'}]

Shell用法

如果作为脚本运行，将从stdin读取一个名字列表，并打印它们的性别。

echo "James\nEva\nThunderhorse" | python -m genderize

James: male
Eva: female
Thunderhorse: None

高级用法

使用自定义用户代理、API密钥以及比默认30秒更短的超时来创建一个Genderize实例。请注意，您需要使用自己的API密钥，否则此示例将无法工作。

from genderize import Genderize
genderize = Genderize(
    user_agent='GenderizeDocs/0.0',
    api_key='example_api_key',
    timeout=5.0)
print(genderize.get(['James', 'Eva', 'Thunderhorse']))

[{u'count': 1037, u'gender': u'male', u'name': u'James', u'probability': 0.99},
 {u'count': 234, u'gender': u'female', u'name': u'Eva', u'probability': 1.0},
 {u'gender': None, u'name': u'Thunderhorse'}]

维护

本地开发设置

virtualenv --prompt '(genderize) ' venv -p python3
pip install -r requirements.txt
pip install -r requirements-dev.txt

发布清单

1. 生成新的版本号：major.minor.micro。它应与PEP 440和SemVer 2.0.0兼容。

2. 在genderize/__init__.py中更新__version__。这由setup.py读取，在那里不需要更改。

3. 在CHANGES.rst中为新的版本添加一个变更日志条目和日期。

4. 提交更改。这可以作为其他更改的一部分完成。

5. 使用git tag major.minor.micro标记提交。

6. 使用git push origin major.minor.micro将标记推送到GitHub。

7. Travis将从一个标记创建新的PyPI发布。