双向映射库bidict

状态

.. image:: https://img.shields.io/pypi/v/bidict.svg :target: https://pypi.org/project/bidict :alt: 最新版本

.. image:: https://img.shields.io/readthedocs/bidict/main.svg :target: https://bidict.readthedocs.io/en/main/ :alt: 文档

.. image:: https://github.com/jab/bidict/actions/workflows/test.yml/badge.svg :target: https://github.com/jab/bidict/actions/workflows/test.yml?query=branch%3Amain :alt: GitHub Actions CI状态

.. image:: https://img.shields.io/pypi/l/bidict.svg :target: https://raw.githubusercontent.com/jab/bidict/main/LICENSE :alt: 授权协议

.. image:: https://static.pepy.tech/badge/bidict :target: https://pepy.tech/project/bidict :alt: PyPI下载量

.. image:: https://img.shields.io/badge/GitHub-sponsor-ff69b4 :target: https://github.com/sponsors/jab :alt: 赞助

特性

• 成熟: 被Google、Venmo、CERN、百度、腾讯等多家公司和团队依赖,使用已有9年

• 熟悉、Pythonic的API设计,注重安全性、简单性、灵活性和人机交互

• 轻量,无需运行时依赖项

• 采用简洁、结构优秀、全类型提示的Python代码实现,既注重运行效率,也注重长期维护和稳定性

• 有完善的文档

• 100% 测试覆盖,在所支持的Python版本上持续运行(包括基于属性的测试和基准测试)

安装

pip install bidict

快速开始

.. code:: python

from bidict import bidict element_by_symbol = bidict({'H': 'hydrogen'}) element_by_symbol['H'] 'hydrogen' element_by_symbol.inverse['hydrogen'] 'H'

要了解更多用法,请查看:doc:intro。

企业支持

可通过Tidelift订阅或直接与我联系获得bidict的企业级支持。我有15年以上的专业经验,可为公司成功提供软件和支持。您也可以通过多个平台赞助我的工作,详见下方"赞助"部分。

社区支持

在提出问题之前,请先在GitHub上搜索现有的问题和答案。如果没有找到答复您问题的内容,欢迎在GitHub上新开讨论或提出issue。

使用通知

如果您使用了bidict,特别是您的使用或组织对其有重要意义,请通过以下任一方式告知我:

• 在GitHub上给bidict点star
• 在GitHub Discussions上发帖
• 发送电子邮件给我

变更日志

有关bidict的发行说明,请查看:doc:changelog。

发布通知

关注bidict在GitHub上的发布,以获取新版本发布的通知。点击"Watch"下拉菜单,选择"Custom",然后选择"Releases"。

从bidict中学习

bidict触及了令人惊讶的许多有趣的Python角落,这是它最好的一点。如果您对此感兴趣,可查看:doc:learning-from-bidict。

贡献

我从一开始就是bidict的唯一维护者和活跃贡献者。您的帮助将是最宝贵的!请查看:doc:contributors-guide了解更多信息。

赞助

bidict是我15年多来无偿工作的成果。如果bidict帮助了您或您的公司完成工作,请通过以下方式赞助我的工作,或要求您的公司这样做:

• GitHub
• PayPal
• Tidelift
• thanks.dev
• Gumroad
• 与我的有限公司进行支持合作

文档查找

如果您正在查看bidict.readthedocs.io上的文档,请注意有多个版本的文档可供选择。请确保您查看的是与您要使用的bidict版本对应的文档版本。

如果您在GitHub、PyPI或其他无法正确呈现和链接此文档的地方查看本文,请改用以下替代链接:

.. [#fn-intro] <https://bidict.readthedocs.io/intro.html>__ | <docs/intro.rst>__

.. [#fn-changelog] <https://bidict.readthedocs.io/changelog.html>__ | <CHANGELOG.rst>__

.. [#fn-learning] <https://bidict.readthedocs.io/learning-from-bidict.html>__ | <docs/learning-from-bidict.rst>__

.. [#fn-contributing] <https://bidict.readthedocs.io/contributors-guide.html>__ | <CONTRIBUTING.rst>__