re: Introducing McTwit

  • From: Alex Hall <mehgcap@xxxxxxx>
  • To: programmingblind@xxxxxxxxxxxxx
  • Date: Fri, 10 Apr 2009 07:40:43 -0400

This sounds good for those on Twitter! A suggestion that you may already have implemented: after setting a default username and password, you can update your status(send a tweet) by simply running:

mctwit -t I just finished my tcp test; I hope I did well!
where -t is a "tweet" flag and the whole mctwit program runs with its default logon, sends the tweet, and closes. Possibly even understand the text argument as a tweet with no flag, since that will be the most common use I imagine. Just a thought.

Have a great day,
Alex

----- Original Message -----
From: Jamal Mazrui <empower@xxxxxxxxx
To: ProgrammingBlind@xxxxxxxxxxxxx
Date sent: Fri, 10 Apr 2009 01:20:00 -0400 (EDT)
Subject: Introducing McTwit

From the archive
http://EmpowermentZone.com/McTwit.zip

I have developed a command-line Twitter client for Windows called
McTwit.
Initially, it is mainly a Windows port of the Python package
called twyt
by Andrew Price, built as a stand-alone, console-mode executable
via the
py2exe package.

Run McTwit.exe at a command prompt, passing it parameters as
explained in
the sections below. I collected all twyt documentation I could
find, and
combined it into a single file called McTwit.txt.

I hope to add a GUI front end to subsequent versions of McTwit,
using
wxPython. I welcome help from other Python programmers in this
open
source project.

Below are selected parts of the documentation, intended to give
you a
sense of what is currently possible with this Twitter client.

Jamal

----------

twyt  Twyt - A Twitter client for the easily distracted
---------------------------------------------------

How to use
------------

The online help system is available by using the three handy
command
forms:

 twyt --help
 twyt --commands
 twyt COMMAND --help


Your first tweet
------------------

Here's how to tell twyt which username you want to use by
default:

   twyt user set --user=yourusername ---default

This will prompt you for your password to save it to your
profile.  You can
leave it blank if you would prefer not to save your password, but
then you
will
be prompted for your password each time twyt needs it (which can
get
annoying
very soon).

Here's an example of the two commands you're most likely to use
often:

1.  twyt tweet "My first tweet"\!

   This sets 'My first tweet!' as your Twitter status message.*

2.  twyt friendstl

This lists up to the last 20 status messages in your friends
timeline.
(Your
friends timeline is the aggregation of your status messages
and your
friends' status messages. The 20 limit is enforced by
Twitter but you
can
use the -s option to get earlier tweets. You can also use
the -P
option to
   get the next page of status updates.)

* Note that in command 1 the exclamation mark needed some extra
escaping
magic.
This is because bash treats ! specially and even putting it
inside the
quotes
doesn't work.

----------

twyt - Command line twitter client
SYNOPSIS
twyt [options]
twyt COMMAND [options] [...]
DESCRIPTION
This manual page documents briefly the
twyt
command.

twyt
is a command line Twitter client which allows you to update your
Twitter
status,
retrieve the different timelines that Twitter offers and
generally keep up
with
what your friends are tweeting about.

Use the --help (or -h) option with any form of the command to get
some usage hints and details of accepted options.

Use the --version option with any form of the command to make
twyt print
its version.
MISC.  COMMANDS

user [options] (set|unset)
allows you to save your account details in twyt's config file so
that you
don't
need to enter your password when running twyt commands which
require
authentication. You can set many accounts and then choose one as
the
default
using the -u (or --user) and -d (or --default) options.
The -l (--list) option makes twyt list your saved accounts.

namecache [options]
Access and manipulate the name cache. This can be used in, for
example,
tab
completion scripts.
STATUS MESSAGE COMMANDS

tweet [options] MESSAGE...
sends a tweet to Twitter. In other words it updates your twitter
status to
MESSAGE.

MESSAGE can also be supplied on stdin, i.e. using pipes or
redirection.
In this case, the MESSAGE argument is ignored and stdin is used
in
preference.

delete [options] ID
deletes the status message matching the numerical ID.

publictl [options]
shows new status messages (max 20) in the public timeline.

friendstl [options]
shows new status messages (max 20) in your friends timeline.

usertl [options] [USERNAME]
shows your, or another person's, timeline.

replies [options]
lists statuses which are replies to you (statuses with
@yourusername in
them)

show ID
shows a single status message whose id matches ID.
DIRECT MESSAGE COMMANDS

direct [options] RECIPIENT MESSAGE...
sends a direct message to RECIPIENT.

directtl [options]
shows up to 20 direct messages sent to you.

directsent [options]
shows up to 20 direct messages sent by you.

directdel [options] ID
deletes a direct message that was sent to you. The directtl
command is
handy for finding out IDs.

AUTHOR
twyt is maintained by Andrew Price <andy@xxxxxxxxxxxxxxxxx>.

----------

Usage: mctwit  COMMAND [options] [args]

Available commands:
block Blocks a user specified by ID (numerical ID or screen
name)
    delete Deletes a tweet by ID
    direct Sends a direct message to another user
 directdel Delete a direct message which was sent to you
directsent Prints the 20 last direct messages sent by you
  directtl Prints the 20 last direct messages sent to you
friendstl Returns 20 most recent statuses in your friends
timeline
 namecache Access and manipulate the username cache.
publictl Shows the 20 most recent statuses in Twitter's public
timeline
replies Lists statuses which are replies to you (statuses
with
@yourusername in them)
      show Show a single status message by ID
      sing Similar to 'tweet', wraps the status in musical notes
     tweet Updates the authenticating user's Twitter status
unblock Unblocks a user specified by ID (numerical ID or
screen name)
user Get and set Twyt user options, e.g. remembered
passwords and
Twitter usernames
    usertl Show your timeline, or USERNAME's timeline

For command-specific help, use mctwit COMMAND --help
----------

Usage: mctwit block [options] ID

Blocks a user specified by ID (numerical ID or screen name)

----------

Usage: mctwit delete [options] ID

Deletes a tweet by ID


----------

Usage: mctwit direct [options] RECIPIENT MESSAGE...

Sends a direct message to another user


----------

Usage: mctwit directdel [options] ID

Delete a direct message which was sent to you


----------

Usage: mctwit directtl [options]

Prints the 20 last direct messages sent to you

Options:

 -s SINCE, --since=SINCE
The date or ID of a message to list
direct
messages
                       from.
-P PAGE, --page=PAGE Lists the PAGEth page of direct messages
(default
1)
Usage: mctwit directsent [options]

Prints the 20 last direct messages sent by you

Options:

 -s SINCE, --since=SINCE
The date or ID of a message to list
direct
messages
                       from.
-P PAGE, --page=PAGE Lists the PAGEth page of direct messages
(default
1)
----------

Usage: mctwit friendstl [options]

Returns 20 most recent statuses in your friends timeline

Options:

 -s SINCE, --since=SINCE
The date or ID of a message to list
status
messages
                       from.
 -P PAGE, --page=PAGE  Lists the PAGEth page of status updates
----------

Usage: mctwit namecache [options]

Access and manipulate the username cache.

Options:
 -c, --clear    Clear the name cache.
 -v, --verbose  Lists real names along with user names.
 -@, --at       Prepend usernames with '@'.
----------

Usage: mctwit publictl [options]

Shows the 20 most recent statuses in Twitter's public timeline


Usage: mctwit replies [options]

Lists statuses which are replies to you (statuses with
@yourusername in
them)

Options:

 -s SINCE, --since=SINCE
                       The date or ID to list replies from.
 -P PAGE, --page=PAGE  Shows the PAGEth page of replies.
----------

Usage: mctwit show ID

Show a single status message by ID


----------

Usage: mctwit sing [options] message...

Similar to 'tweet', wraps the status in musical notes

Options:

-r ID, --replyto=ID Explicitly sets the ID of the status
message to
reply
                       to.
----------

Usage: mctwit tweet [options] message...

Updates the authenticating user's Twitter status

Options:

-r ID, --replyto=ID Explicitly sets the ID of the status
message to
reply
                       to.
----------

Usage: mctwit unblock [options] ID

Unblocks a user specified by ID (numerical ID or screen name)


----------

Usage: mctwit user [options] (set|unset)

Get and set Twyt user options, e.g. remembered passwords and
Twitter
usernames

Options:
 -u USER, --user=USER  Specify a Twitter username.
 -p PASS, --pass=PASS  Specify a password.
 -l, --list            Shows all stored usernames.
 -d, --default         Set the given username as default.
----------

Usage: mctwit usertl [options] [USERNAME]

Show your timeline, or USERNAME's timeline

Options:

 -s SINCE, --since=SINCE
                       The date or ID to list statuses from.
 -P PAGE, --page=PAGE  Lists the PAGEth page of status updates
 -c COUNT, --count=COUNT
                       The number of statuses to show, max 20
----------

Bits of the twitter API that have been implemented and bits that
need
implementing in twitter.py
-----------------------------------------------------------------
------

o See http://apiwiki.twitter.com/REST+API+Documentation

o API methods are wrapped in the Twitter class in twitter.py. In
order to
implement
a new one, use a naming scheme such as status_public_timeline
or
friendship_create
for the method name. The implementing method should accept
arguments
which mirror
 the arguments required in the API docs.

o Status Methods
public_timeline                 Done
friends_timeline                Done
user_timeline                   Done
show                            Done
update                          Done
replies                         Done
destroy                         Done

o User Methods
friends                         Done
followers                       Done
show                            Done

o Direct Message Methods
direct_messages                 Done
sent                            Done
new                             Done
destroy                         Done

o Friendship Methods
create                          Done
destroy                         Done
exists                          Done

o Social Graph Methods
ids (friends)
ids (followers)

o Account Methods
verify_credentials
end_session
update_location
update_delivery_device
update_profile_colors
update_profile_image
update_profile_background_image
rate_limit_status
update_profile

o Favorite Methods
favorites
create
destroy

o Notification Methods
follow
leave

o Block Methods
create                          Done
destroy                         Done

o Help Methods
test
downtime_schedule
----------
End of Excerpts


__________
View the list's information and change your settings at
//www.freelists.org/list/programmingblind

__________
View the list's information and change your settings at //www.freelists.org/list/programmingblind

Other related posts: