Re: Introducing McTwit

  • From: "Octavian Rasnita" <orasnita@xxxxxxxxx>
  • To: <programmingblind@xxxxxxxxxxxxx>
  • Date: Fri, 10 Apr 2009 09:56:56 +0300

A GUI would probably be very helpful for those who use Twitter.

Twitter shell access is also offered by more perl modules like Twitter::Shell or App::Tweet.

--
Octavian

----- Original Message ----- From: "Jamal Mazrui" <empower@xxxxxxxxx>
To: <ProgrammingBlind@xxxxxxxxxxxxx>
Sent: Friday, April 10, 2009 8:20 AM
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: