From 33abe404629e931f831f37411743915fb2fafbe0 Mon Sep 17 00:00:00 2001 From: darksun Date: Thu, 28 Dec 2017 11:00:19 +0800 Subject: [PATCH] translate done: 20171222 Improve your code searching skills with pss.md --- ...ove your code searching skills with pss.md | 83 ------------------- ...ove your code searching skills with pss.md | 82 ++++++++++++++++++ 2 files changed, 82 insertions(+), 83 deletions(-) delete mode 100644 sources/tech/20171222 Improve your code searching skills with pss.md create mode 100644 translated/tech/20171222 Improve your code searching skills with pss.md diff --git a/sources/tech/20171222 Improve your code searching skills with pss.md b/sources/tech/20171222 Improve your code searching skills with pss.md deleted file mode 100644 index d273287f15..0000000000 --- a/sources/tech/20171222 Improve your code searching skills with pss.md +++ /dev/null @@ -1,83 +0,0 @@ -translating by lujun9972 -Improve your code searching skills with pss -====== -Searching a code base is a part of every day developer activities. From fixing a bug, to learning a new code base or checking how to call an api, being able to quickly navigate your way into a code base is a great skill to have. Luckily, we have dedicated tools to search code. Let's see how to install and use one of them - [**pss**][1]. - -### What is pss? - -**pss** is a command line tool that helps searching inside source code file. **pss** searches recursively within a directory tree, knows which extensions and file names to search and which to ignore, automatically skips directories you wouldn't want to search in (for example `.svn` or `.git`), colors its output in a helpful way, and much more. - -### Installing pss - -Install **pss** on Fedora with the following command: -``` - $ dnf install pss -``` - -Once the installation is complete you can now call **pss** in your terminal -``` - $ pss -``` - -Calling **pss** without any argument or with the -h flag will print a detailed usage message. - -### Usage examples - -Now that you have installed **pss** let 's go through some Usage examples. -``` - $ pss foo -``` - -This command simply looks for `foo`. You can be more restrictive and ask pss to look for `foo` only in python files: -``` - $ pss foo --py -``` - -and for `bar` in all other files: -``` - $ pss bar --nopy -``` - -Additionally, **pss** supports most of the well known source file types, to get the full list execute: -``` -$ pss --help-types -``` - -You can also ignore some directories. Note that by default, **pss** will ignore directories like .git, __pycache__, .metadata and more. -``` -$ pss foo --py --ignore-dir=dist -``` - -Furthermore, **pss** also gives you the possibility to get more context from your search using the following : -``` -$ pss -A 5 foo -``` - -will display 5 line of context after the matching word -``` -$ pss -B 5 foo -``` - -will display 5 line of context before the matching word -``` -$ pss -C 5 foo -``` - -will display 5 line of context before & after the matching word - -If you would like to learn how to use **pss ** with regular expression and other options, more examples are available [here][2]. - - --------------------------------------------------------------------------------- - -via: https://fedoramagazine.org/improve-code-searching-skills-pss/ - -作者:[Author Archive;Author Website;Clément Verna][a] -译者:[lujun9972](https://github.com/lujun9972) -校对:[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出 - -[a]:https://fedoramagazine.org -[1]:https://github.com/eliben/pss -[2]:https://github.com/eliben/pss/wiki/Usage-samples diff --git a/translated/tech/20171222 Improve your code searching skills with pss.md b/translated/tech/20171222 Improve your code searching skills with pss.md new file mode 100644 index 0000000000..a03999c9bd --- /dev/null +++ b/translated/tech/20171222 Improve your code searching skills with pss.md @@ -0,0 +1,82 @@ +使用 pss 提升你的代码搜索能力 +====== +搜索代码库是开发者每天都要做的事情。从修改 bug 到学习新代码,或者查看如何调用某个 api,能快速在代码库中导航的能力都是一大助力。幸运的是,我们有专门的工具来搜索代码。[**pss**][1] 就是其中一个工具,让我们来看看如何安装和使用它吧。 + +### 什么是 pss? + +**pss** 是一个帮你在源代码文件中进行搜索的命令行工具。**pss** 递归地在目录树中进行搜索,它能自动根据文件名和后缀判断哪些文件需要搜索,哪些文件不需搜索,并且会自动跳过那些你不会想搜索的目录(比如 `.svn` 和 `.git`),还能用色彩渲染输出以方便人们阅读,以及其他很多功能。 + +### 安装 pss + +使用下面命令在 Fedora 上安装 **pss**: +``` + $ dnf install pss +``` + +安装好后就能在终端调用 **pss** 了 +``` + $ pss +``` + +不带参数调用 **pss** 或者带上 `-h` 标志会输出详细的使用说明。 + +### 使用案例 + +现在你安装好 **pss** 了,下面来看一些例子吧。 +``` + $ pss foo +``` + +该命令只是简单的搜索 `foo`。你也可以限制 pss 让它只在 python 文件中搜索 `foo`: +``` + $ pss foo --py +``` + +还能在非 python 文件中搜索 `bar`: +``` + $ pss bar --nopy +``` + +而且,**pss** 支持大多数常见的源代码文件类型,要获取完整的支持列表,执行: +``` +$ pss --help-types +``` + +你还能指定忽略某些目录不进行搜索。默认情况下,**pss** 会忽略类似 `.git`,`__pycache__`,`.metadata` 等目录。 +``` +$ pss foo --py --ignore-dir=dist +``` + +此外,**pss** 还能显示搜索结果的上下文: +``` +$ pss -A 5 foo +``` +会现实匹配结果的后面 5 行内容 + +``` +$ pss -B 5 foo +``` + +会现实匹配结果的前面 5 行内容 +``` +$ pss -C 5 foo +``` + +会现实匹配结果的前后各 5 行内容 + +如果你想知道如何使用 **pss ** 进行正则表达式搜索以及它的其他选项的话,可以在[这里 ][2] 看到更多的例子。 + + +-------------------------------------------------------------------------------- + +via: https://fedoramagazine.org/improve-code-searching-skills-pss/ + +作者:[Author Archive;Author Website;Clément Verna][a] +译者:[lujun9972](https://github.com/lujun9972) +校对:[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出 + +[a]:https://fedoramagazine.org +[1]:https://github.com/eliben/pss +[2]:https://github.com/eliben/pss/wiki/Usage-samples