创建、编辑、查看和列出github注册表的cli

gists.cli的Python项目详细描述


**目录**由[doctoc]生成(http://doctoc.herokuapp.com/)*

-[gists.cli](gistscli)
-[概述](概述)
-[临时用户](临时用户)
-[安装](安装)
-[验证](验证)
-[用法]
-[对于高级用户](对于高级用户)
-[提示](提示)
-[用法](用法-1)
-[对于开发人员](对于开发人员)
-[安装](安装-1)
-[非mac/os x系统测试](非macos-x系统测试)
-[正在开发](正在开发中)
-[i问题和路线图](问题和路线图)
-[故障排除](故障排除)
-[信用](信用)




gists.cli

>一个易于使用的cli来管理*您的*github gists。创建、编辑、附加、查看、搜索和备份您的注册表。

-github-https://github.com/khilnani/gists.cli
-python包-https://pypi.python.org/pypi/gists.cli

ipad和iphone应用程序很棒,但当我真的需要要点时,我就在命令行。

主要目标是创建专门用于捕获快速笔记/链接的内容,同时需要最少的键入量。
除了常规的查看、下载、编辑和删除支持之外,应用程序还尝试考虑各种方案-

-附加-应用程序功能结束文本,而不是下载,编辑和更新。
-ios支持-[pythonista](http://omz-software.com/pythonista/)非常酷。使用[pypi.py](https://gist.github.com/anonymous/5243199)或[pipista](https://gist.github.com/pudquick/4116558)
-vga终端-使用鼠标复制/粘贴gists id很好,但当鼠标不方便时,可以使用索引号代替gist id。
-使用"gists.1"或"gists:1"或"gists%1"查看第一个要点。比"gist233hs2233"简单但不太明确
-不需要下载即可执行-您可以根据需要将应用程序的输出通过管道传输到解释器。例如,`gist1111 sh`
-每个命令/操作都有适合您偏好的别名/格式。
-如果您喜欢标准的cli选项,请使用"gists--help"或"gists-h";如果您希望键入较少的内容,请使用"gists-help"或"gists h" />-安装python安装工具
-linux
-run`yum install python setup tools`
-manual install
-run`curl-v https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py sudo python`或按照[https://pypi.python.org/pypi/setuptools installation in指令]
-安装python包管理器pip(http://www.pip-installer.org/)
-运行"sudo easy_install pip"
-安装pip后,
-运行"sudo pip install gists.cli"
-运行"sudo pip install gists.cli--升级时升级。

身份验证

>;自0.350起支持双因素身份验证(短信和应用程序)

-默认情况下,应用程序将尝试使用基本身份验证进行身份验证,即每次运行时都会提示输入用户名/密码。
-如果文件`~/.git凭据'可用,则它将使用第一个OAuth令牌入口。
-如果找到带有github oauth令牌的文件` ~/.gists',则将优先使用上述两种机制。
-运行`gists token--token t-t`以避免用户名/密码提示并使用` ~/.git凭据'以外的oauth令牌。保存到` ~/.gists`.

new create`,同时还有"gists c n new create--new--create-n-c"run"gists help--help-h了解更多信息。*

**list所有gists**

-`gists`

**查看gist**

-`gists id`-在控制台上使用id查看gist中的所有文件。

>;id可以是gist id或索引id(列表视图中gist的)索引必须采用````、`%n`、`.n`或`:n`

**下载gist**

-`gists id path`-将id为的gist文件下载到path。将提示确认。

>;id可以是gist id,也可以是索引id(列表视图中的gist的索引id),索引的格式必须是````、`%n`、`.n`或`:n`

**创建gist**

我们将根据需要提示gist type(public/private)、description和gist content等内容。

-`gists new`或`gists create`.
-`gists file`-使用文件的内容创建一个gist
-`gists content`-使用字符串"content"创建一个gist


以避免公共/私有gist类型提示-

>;bool对于public应该是"true",对于private应该是"false"

-` gists bool file`
-`gists bool"content"`

**附加到gist**

>;-如果描述或内容是'?',将跳过该字段。
>;-例如"gists 223322?"指向酷网站的新链接"`将追加新行,但不会更新说明
>;-例如'gists 223322'更新说明?`将只更新说明
>;-id可以是gist id或索引id(列表视图中的gist的)索引必须采用`` n`、`%n`、`.n`或`:n`

*注意-如果gist包含多个文件,则每个文件都将在发送的内容后附加一行内容。*

-`gists id description file`
-`gists id description"content"`

**delete to a gist**

-`gists delete id`-将提示确认。


` gists new create `,但同时也要` gists c n new;--new;--create-n-c ` run ` gists help;--help-h `了解更多信息
-id可以是gist id,也可以是索引id(列表视图中的gist的gist的gist id)索引必须采用` n`,`%n`,`.n`或`:n` ` `.n`或`:n `:n
-add‘debug;--debug-debug-debug `执行完毕查看低级详细信息。例如,"gists调试"。*注意-这将显示您的OAuth ID,而不是您的基本身份验证密码。*
-在任何执行结束时添加"superss""silent""superss""silient""以抑制任何确认提示,如果您希望危险地生活。
-例如"gists-n file--supress--debug"。

|--list-l l`

**查看gist**

-`gists view--view v-v id`-在控制台上查看gist中ID为的所有文件。
-`gists view--view-v id file`-在控制台上查看gist中的特定文件(文件)。匹配不区分大小写。

>;id可以是gist id,也可以是索引id(列表视图中的gist的索引id),索引的格式必须为`````n`、`%n`、`.n`或`:n`

**下载gist**

-`gists get `--get ``g `-g id path`-下载id为path的gist文件。将提示确认。
-`gists get--get g-g id file path`-下载gist to path中的特定文件(文件)。匹配不区分大小写。

>;id可以是gist id,也可以是索引id(列表视图中的gist的),索引的格式必须为````、`%n`、`.n`或`:n`

**设置oauth token**

-`gists token`t`--token`t`-设置为使用oauth token而不是`~/.git credentials`。保存到`~/.gists`.

**创建一个gist**

>;-文件-是一个相对或绝对的文件路径。
>;-bool-对于public为true,对于private为false。支持true、false、1、0、yes、no、y、n。不区分大小写
>;-说明和内容-文本内容w在引号



但是,这支持较少的参数组合。

-`gists file`
-`gists"content"`
-`gists bool file`
-`gists bool"content"`
-`gists"description"file`
-`gists"description"content`
-`gists bool"description"file`
-`gists bool"description"content"`



如果您喜欢键入或指定,也可以使用命令行选项。系统会根据需要提示您输入gist类型、说明和gist内容等内容。

*option*=`new--new-n-n create--create-c`

-`gists option`
-`gists option file`
-`gists option"content"`
-`gists option bool file`
-`gists option bool"content"`
-`gists option"description"文件`
-`gists option"description""content"`
-`gists option bool"description"文件`
-`gists option bool"description""content"`


**附加到gist**

>;-如果描述或内容是'?',将跳过该字段。
>;-例如"gists 223322?"指向酷网站的新链接"`将追加新行,但不会更新说明
>;-例如'gists 223322'更新说明?`将只更新说明
>;-id可以是gist id或索引id(列表视图中的gist的)索引必须采用`` n`、`%n`、`.n`或`:n`



*注意-如果一个gist包含多个文件,则每个文件都将在发送的内容后追加一行。*

-`gists id description file`
-`gists id description"content"`

选项ID文件`
-`gists option id content`
-`gists option id description file`
-`gists option id description content`


**更新**

>;-如果描述或内容是'?',将跳过该字段。
>;-例如"gists 223322?"指向酷网站的新链接"`将追加新行,但不会更新说明
>;-例如'gists 223322'更新说明?`将只更新说明
>;-id可以是gist id或索引id(列表视图中的gist的)索引必须采用`` n`、`%n`、`.n`或`:n`

*注意-只有在发送的文件名完全匹配时,才会更新gist中的文件。如果没有找到匹配的文件名,则会在gist中添加一个新文件。*

*option*=`update--update u-u`

-`gists option id file`
-`gists option id content`
-`gists option id description file`
-`gists option id description content`

**删除**

-`gists删除del d--删除--del-d id`--删除一个要点。将提示确认。

>;id可以是gist id,也可以是索引id(列表视图中的gist的),索引的格式必须是```、`%n`、`.n`或`:n`






**搜索


>
-`gists search查询查询查询查询查询查询注册信息。

****misc

>
















对代码库进行更改

-获取代码
-fork和"git clone"fork,或者…
-`git clone https://github.com/khilnani/gists.cli.git`,或者…
-从https://github.com/khilnani/gists.cli下载最新的标记存档文件
-*不建议下载存档文件,因为它不是easy合并代码*
-通过运行`./dependencies.sh`安装依赖项。
-这将安装PIP(如果尚未安装),然后安装依赖项。
-按如下所示运行安装程序。如果使用"sudo…"运行时出现任何错误
-`./install.py`不带参数将安装到`/usr/local/bin`.
-`./install.py install_path`将安装到特定目录。

nd ubuntu.
-先决条件
-vagrant
-安装vagrant-http://vagrantup.com/downloads
-ansible
-在Mac OS X或centos/rhel上安装ansible-https://github.com/khilnani/devops/tree/master/ansible
-虚拟框
-安装virtual box-https://www.virtualbox.org/wiki/downloads to download/install
-运行
-运行'vagrant up'同时安装centos6.5和ubuntu,或'vagrant up centos'或'vagrant up ubuntu'-启动vms
-如果尚未安装My Box,则将下载并安装它们
-运行'vagrant ssh centos`or`vagrant ssh ubuntu`-到ssh over
-一旦ssh over,当前目录在vm上的`/git_data`中可用
-debug
-将目录更改为`.//u vagrant`
-运行`./debug.ssh up centos`或`./debug.ssh up ubuntu`-这将运行带有调试级别信息的vagrant

#问题和路线图

-查看https://github.com/khilnani/gists.cli/issues以查看问题和里程碑。

请确保已升级安装工具。请参阅上面的"安装python安装工具/手动安装"一节以升级安装工具。
-此依赖项是在pypi 1.5中引入的,并将在pypi 1.5.1中删除[http://pip.readthedocs.org/en/1.5.x/news.html\
-如果您得到错误"attribute error:verifiedhttpsconnection实例没有属性"\u tunnel\u host",这可能是因为您运行了python 2.6.2或更早版本。
-运行"sudo pip install requests==1.2.3"可以解决此问题。requests 2.0库使用urllib3,它使用了一些仅在python 2.6.3中可用的功能

\credits

-author-nik khilnani-http://khilnani.org
-feedback和spellcheck-alexander-https://github.com/alexander bzz
-stack overflow-http://stackoverflow.com/questions/taged/python
-pythonista论坛-https://omz-forums.appspot.com/pythonista/post/4691117899513856

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java如何创建一个透明的Android应用程序,它将占据整个屏幕(位于状态/导航栏上方)?   Spark Java编码器。bean无法转换为Scala定义的类   java无法在可执行jar中加载资源   java如何避免Checkstyle的FinalClass模块在存在从基继承的内部类时抱怨?   文件Netbeans java小程序项目屏幕弹出   java解析增量特性的增量不会超过值1   java从另一个类创建一个对话框,该类在Android中有自己的线程   java如何在绘制线条时向JPanel添加背景网格?   方法来确定路径字符串是本地计算机还是Java的远程计算机   批处理文件在java中如何在执行命令之前设置目录   需要关于Java8流逻辑的帮助吗   java Guice注入和请求工厂:扩展ServiceLayerCorator