twerp 0.0.5

README
======

**Twerp是电话黑客工具包。**

Twerp也是

* Twilio API的命令行界面

* 一个将彻底改变骚扰电话的工具（仅限从加利福尼亚到加拿大法语区合法。注意：我不是律师，但我看过所有《警察故事》的剧集。）

功能

* 从命令行购买美国、免长途话费以及Twilio销售的所有地区的电话号码
* 管理Twilio账户：创建新的子账户、列出、重命名账户
* 从命令行打电话
* 使用无状态的TwiML事务从命令行控制通话流程（无需网络应用）
* 命令行驱动的电话会议
* 发送和接收短信
* 从命令行读取Twilio日志
* 使用基于curses的命令行界面修改正在进行的通话或会议的流程
* 不必访问twilio.com网站仪表板，就可以做很多事情


待办事项

* 基于Python entry_points的插件系统
* 插件可以启动Bottle网络应用并通过localtunnel.com进行本地隧道
* Phox Flask网络应用插件


.. 内容：


安装
------------

pip安装twerp



配置twerp
---------------

~/.twerprc


ACCOUNT_SID=a902830980980980ff987yada

授权令牌=98798asdfas9df87sadf987yada

主叫方ID=+12135551212



用法：
=======

用法：twerp [选项]

选项
-h, --help 显示此帮助信息并退出
--version 显示twerp版本并退出。
-v, --verbose 显示更多输出内容。
--debug 显示调试信息。
-q, --quiet 显示较少输出。

常用选项
这些选项可用于短信和语音通话。

-c CALLERID, --callerid=CALLERID
您拨打电话或发送短信的电话号码。
-i, --interactive 拨号后进入交互式命令行模式（语音或会议）。


语音通话选项
进行电话通话，执行TWIML。

-d +12135551212,+14155551212, --dial=+12135551212,+14155551212
要拨打的号码列表，用逗号分隔。
-y 说些话，--say=说些话。
与--dial一起使用，以说些话。
-u TWIML的URL，--url=TWIML的URL
要传递给--call的TWIML的URL。
-b +12135551212, --buy=+12135551212
购买-x或-a列出的特定电话号码。
-a 区号，--area-code=区号
通过区号搜索要购买的电话号码。使用
-b 从这些结果购买。

-x 包含，--contains=包含
通过包含的数字或字母搜索要购买的电话号码。


会议（语音）选项
这些选项可用于语音会议通话。

-f +12135551212,+14155551212, --conference=+12135551212,+14155551212
使用逗号分隔的号码列表开始会议。


-o 房间，--room=房间
加入语音会议的房间。
-e, --conferences 显示进行中的会议。
-p, --conference-participants
显示所有进行中会议的参与者。

SMS选项
发送和接收短信文本消息。

-m <TXT MSG>, --message=<TXT MSG>
发送短信文本消息

-s +12135551212,+14155551212, --sms=+12135551212,+14155551212
向号码列表发送短信文本消息。

-l, --list-sms 显示传入的短信消息。

报告选项
列出您的Twilio电话号码以及每个电话号码的信息。

-n, --notifications
显示来自Twilio API的通知（错误消息和警告）。

-r, --numbers 显示所有我的Twilio电话号码。使用-Nv以获取每个号码的详细信息。

--sid=SID 显示给定SID的日志

应用程序
Twilio应用程序信息。

--applications 显示所有我的Twilio应用程序。


账户
Twilio账户和子账户管理

--list-accounts
列出所有Twilio账户和子账户。

--create-sub-account=名称
创建名为“名称”的子账户。

--rename-sub-account=名称
使用“名称”重命名账户或子账户。

交互式模式
================


提示符
----------

如果正在进行通话，提示符将包含SID的部分

twerp (CA3abc...) >>

如果您挂断通话，例如，将没有SID，因此提示符将如下所示

twerp (...) >>


交互式模式命令
-------------------------

* 列表 - 列出所有进行中、响铃或排队的通话
* 挂断 - 挂断提示符中显示的与SID关联的通话
* nuke - 挂断与账户关联的所有通话。全部都挂断！
* forward <nnnnnnnnnn> - 将当前通话重定向到另一个电话号码
* url <URL> - 将通话流重定向到URL上的TwiML
* info [<SID>] - 显示当前SID或给定SID的信息
* sid <SID> - 更改与交互式模式关联的当前SID


待办事项
----

见 http://blog.cakebread.info/



.. Twerp新闻

新闻
====

0.0.5
-----

* 发布日期：2012年4月4日

* 添加了会议功能
* 添加了账户管理，列出、重命名和创建新的Twilio子账户
* 添加了应用程序管理：列出所有Twilio应用程序
新增功能：购买新电话号码，支持按区号或短语进行基本搜索
重命名了许多命令行选项
增加了更多单元测试


0.0.3
-----

发布日期：2012年1月17日

添加了--interactive命令行功能，用于控制正在进行中的通话
更改了许多关键词选项，因为我们仍在超级++预alpha版本，所以我可以这样做。
在http://twerp.rtfd.org/添加了文档


0.0.2
-----

发布日期：2012年1月6日

添加了语音拨号功能

0.0.1
-----

发布日期：2012年1月5日

首次发布