跳转到主要内容

Kids文本操作助手。

项目描述

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

kids.txt 是一个Python库,提供管理文本的助手。它是“Kids”(为保持简单)库的一部分。

目前,它是一个非常简单的包。

功能

使用 kids.txt

  • 您将在Python 2中也有缩进/缩进/缩短命令。

  • 您将能够包裹文本,同时保持段落分离。

  • 一些小的助手函数,如 ucfirst 函数。

  • 使用 udiff 可以轻松地生成两个字符串之间的统一差异。

安装

由于 kids.txt 已在PyPI上提供,因此您不需要下载代码的GIT版本。因此,您应该能够运行

pip install kids.txt

如果您已下载了GIT源代码,那么您也可以通过传统方式安装当前版本

python setup.py install

如果您没有GIT源代码但希望从GitHub获取最新主分支或分支,您也可以

pip install git+https://github.com/0k/kids.txt

或者甚至选择特定的修订版本(分支/标签/提交)

pip install git+https://github.com/0k/kids.txt@master

使用方法

缩进

您可以使用以下方式轻松缩进文本

>>> from __future__ import print_function
>>> from kids import txt

>>> string = 'This is first line.\nThis is second line\n'

>>> print(txt.indent(string, prefix="| "))
| This is first line.
| This is second line
|

缩进

您也可以缩进文本

>>> print(txt.dedent(
...    '''This is a doc
...
...       with fancy indentation, that should just work also.
...       Without removing too much neither as:
...          - more space.'''))
This is a doc
<BLANKLINE>
with fancy indentation, that should just work also.
Without removing too much neither as:
   - more space.

段落包裹

分别包裹段落

>>> string = 'This is first paragraph which is quite long don\'t you \
... think ? Well, I think so.\n\nThis is second paragraph\n'

>>> print(txt.paragraph_wrap(string))
This is first paragraph which is quite long don't you think ? Well, I
think so.
This is second paragraph

Notice that that each paragraph has been wrapped separately.

ucfirst

此函数将返回强制将第一个字符转换为大写的给定字符串

>>> txt.ucfirst('foo')
'Foo'

缩短

此函数将截断给定的字符串到指定的长度,如果需要的话。它将用“..”替换最后两个字符以指示截断

>>> txt.shorten('fool', l=5)
'fool'
>>> txt.shorten('supercalifragilisticexpialidocious', l=5)
'sup..'

udiff

显示两个文本之间的统一差异

>>> print(txt.udiff('a\n\nc', 'b\n\nc'))
--- None
+++ None
@@ -1,3 +1,3 @@
-a
+b
<BLANKLINE>
 c
<BLANKLINE>

贡献

欢迎任何建议或问题。非常欢迎推送请求,请查看指南。

推送请求指南

您可以发送任何代码。我会查看它,并将其集成到代码库中,您将作为作者保留。这个过程可能需要时间,如果您遵循以下指南,则所需时间会更短。

  • 使用PEP8或pylint检查您的代码。尽量保持80列宽。

  • 按最小关注点分开您的提交。

  • 每个提交都应该通过测试(以便于轻松二分查找)。

  • 每个功能/错误修复提交应包含代码、测试和文档。

  • 优先提交带有排版或代码美化的微小更改。这些应在提交摘要中用!minor标记。

  • 提交消息应遵循gitchangelog规则(检查git日志以获取示例)。

  • 如果提交修复了问题或完成了功能的实现,请在摘要中提及。

如果您对此处未回答的指南有疑问,请检查当前的git log,您可能会找到以前的提交,这些提交会向您展示如何处理您的问题。

许可

版权(c)2015 Valentin Lab。

许可协议为BSD许可证

变更日志

0.0.2 (2015-02-04)

新增

  • 添加了udiff以获取字符串的统一差异。 [Valentin Lab]

  • 添加了ucfirstshorten。 [Valentin Lab]

  • 添加了dedent()函数。 [Valentin Lab]

修复

  • indent会忽略设置为空字符串的first。 [Valentin Lab]

0.0.1 (2014-05-13)

  • 首次导入。 [Valentin Lab]

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪一个,请了解有关安装包的更多信息。

源代码分发

kids.txt-0.0.2.tar.gz (6.1 kB 查看哈希)

源代码

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面