Today, I’m announcing the next stable release for the library that serves as base for Turpial. I’m happy to say that libturpial has reached it version 1.7.0!

But why is this so important?

Well, libturpial is the Python library that lets Turpial interact with the Twitter API and handle complex stuff like multi-accounts or multi-columns with just a couple lines of code (yes, it’s that awesome). libturpial is the foundation behind Turpial 3.0 and this new version will become in the major stable version so far because has been developed thinking in the long term.

There are no fancy-new features compared to the previous version but it has lot of fixes and a test cases that will help to guarantee it quality. Right now, most critical modules are covered by the tests and the overall coverage is of at least 93%.

Ok, What can I do with libturpial?

So far with libturpial you can:

• Get tweets from timeline, mentions, favorites, lists, etc
• Upload images and short URLs with a bunch of services (including with pic.twitter.com)
• Filter tweets
• Update your user profile
• Handle relationship (follow, unfollow, block, unblock, report as spam)
• Broadcast messages
• Manage multiple accounts
• Reach Twitter through a Proxy
• Preview images
• Get trending topics by location
• Interact with tweets (reply, mark as favorite, retweet, send messages, etc)
• Manage any kind of custom user configuration
• Do a lot of other crazy stuff

For more information about the features you can check the latest documentation. Remember that libturpial is JUST the library (not the whole client), and as library can be used for scripts or any other purpose that implies to interact with Twitter. If you want to play with the code take a look to the Quickstart Guide, that’s the best place to start. Soon we will be posting a brief tutorial of how to use libturpial to play with the Twitter API.

Show me the code!

Source code of libturpial 1.7.0 is available in our files repository as a tarball file and as a tag in the github repo.

Installation

To install libturpial from sources you just need to download the tarball and extract it (or fetch the code form the github repo), go to the libturpial folder and then execute:

sudo python setup.py install

libturpial is also available from PyPI, so you can install it using:

pip install libturpial

Running the tests

To run the tests you must go to the libturpial folder and execute:

py.test --cov libturpial --cov-config .coveragerc tests/

Note that you will need to have py.test installed in order to run the test cases.

What’s next?

This version is compatible with the previous version and packages for Ubuntu, Debian, Fedora, Arch and other distros will be available soon.

I’ll appreciate any help finding bugs or improving the library, so if you find anything not working properly register the issue in github or just let me know. The only known issue so far is that this version will enable pic.twitter.com as service for upload images and it WON’T WORK with Turpial 3.0 but it should work fine with the development version or any latest.

That’s all folks. Thanks for your support.

Featured image by (CC) antpaniagua / Flickr

In March 6th, libturpial passed from heavy development to beta status. Three betas have been released since then, lot of tests have been performed and everything seems to indicate that libturpial is in a very good shape. That’s why today I’m pleased to announce the first release candidate of libturpial 1.7.0.

This release has no new features but confirms that no new bugs have been detected. It includes all the changes and fixes from previous betas, so in this version you should expect: backward compatibility, working filters, an improved configuration module, lot of test cases and other minor fixes.

We need your help to find bugs and improve the library, so please try it. The only known issue so far is that this version of the library will enable pic.twitter.com as service for upload images and it WON’T WORK with Turpial 3.0 (the current stable version) but it should work fine with the development version of Turpial. If you find anything else not working properly, register the issue or just let me know.

Tarball for this release candidate is available in our files repository, there is a tag in the github repo and it is available in PyPI. Latest documentation for libturpial can be found at libturpial.readthedocs.org.

Test period for this release candidate will be until April 2nd and if no critical issues are discovered by the date, the final version will be published. I hope this final version has a really long lifetime.

Thanks for your support.

Featured image by (CC) gravitywave / Flickr

As part of the testing process a new beta has arrived with lots of issues fixed. Most important are:

• Fixed minor style issues
• Fixed issue when registering new config options
• Fixed filters
• Fixed several config methods
• Set pic.twitter.com as default service to upload images
• Fixed support for list names with hyphens
• Fixed POST requests to be RESTful compliant

This beta is backward compatible, so you can test it safely with the stable version of Turpial (3.0) or with the development branch but consider that it will enable pic.twitter.com as default service for upload images and it WON’T WORK in Turpial 3.0. If you find anything else not working properly, register the issue or just let me know and I will fix it.

Tarball with source code of 1.7.0-b3 is available in our files repository, there is a tag in the github repo and it is available in PyPI. Documentation for libturpial can be found at libturpial.readthedocs.org.

Beta period will now be extended until March 21th, if no more issues are detected by the date a release candidate will be published.

Thanks to all the people helping to test.

Featured image by (CC) kodomut / Flickr

Due to the mistakes introduced to latest libturpial versions I’ve worked on lot of test cases in order to guarantee the quality and stability of the library and avoid this embarrassing situation again. So, today I bring to you a new version: libturpial 1.7.0-b1.

This version presents no new features but test cases for most critical modules of the library where coverage is at least of 93%. There are a few modules not covered yet (non-critical) but I hope to cover the whole library within the next releases.

Here you can see a detailed output of the current test coverage:

$ py.test --cov libturpial --cov-config .coveragerc tests/
============================================================ test session starts ============================================================
platform darwin -- Python 2.7.5 -- py-1.4.20 -- pytest-2.5.2
plugins: cov
collected 199 items

tests/test_account_manager.py ........
tests/test_column_manager.py .........
tests/test_common.py ..........
tests/test_config.py .................................
tests/test_core.py ..................................................................................
tests/test_exceptions.py ....
tests/interfaces/test_protocol.py .....
tests/interfaces/test_service.py .....
tests/models/test_account.py ..................
tests/models/test_column.py ..
tests/models/test_list.py ..
tests/models/test_media.py ....
tests/models/test_profile.py ....
tests/models/test_proxy.py ..
tests/models/test_status.py ......
tests/services/preview/test_preview_base.py ...
tests/services/upload/test_upload_base.py .
tests/services/url/test_shorturladapter.py .
---------------------------------------------- coverage: platform darwin, python 2.7.5-final-0 ----------------------------------------------
Name                                               Stmts   Miss  Cover
----------------------------------------------------------------------
libturpial/__init__                                    1      0   100%
libturpial/api/__init__                                0      0   100%
libturpial/api/core                                  362      4    99%
libturpial/api/managers/__init__                       0      0   100%
libturpial/api/managers/accountmanager                46      3    93%
libturpial/api/managers/columnmanager                 74      1    99%
libturpial/api/models/__init__                         0      0   100%
libturpial/api/models/account                         95      0   100%
libturpial/api/models/client                           4      0   100%
libturpial/api/models/column                          11      0   100%
libturpial/api/models/entity                           6      0   100%
libturpial/api/models/list                            12      0   100%
libturpial/api/models/media                           40      0   100%
libturpial/api/models/profile                         35      0   100%
libturpial/api/models/proxy                           20      0   100%
libturpial/api/models/status                          56      0   100%
libturpial/api/models/trend                           16      0   100%
libturpial/common/__init__                            52      0   100%
libturpial/common/tools                               39      0   100%
libturpial/config                                    277      3    99%
libturpial/exceptions                                 64      0   100%
libturpial/lib/__init__                                0      0   100%
libturpial/lib/http                                  136     76    44%
libturpial/lib/interfaces/__init__                     0      0   100%
libturpial/lib/interfaces/protocol                   143      0   100%
libturpial/lib/interfaces/service                     27      2    93%
libturpial/lib/protocols/__init__                      0      0   100%
libturpial/lib/protocols/twitter/__init__              0      0   100%
libturpial/lib/protocols/twitter/params                1      0   100%
libturpial/lib/protocols/twitter/twitter             495    418    16%
libturpial/lib/services/__init__                       0      0   100%
libturpial/lib/services/media/__init__                 0      0   100%
libturpial/lib/services/media/preview/__init__        10      0   100%
libturpial/lib/services/media/preview/base            23      0   100%
libturpial/lib/services/media/preview/flickr          28     16    43%
libturpial/lib/services/media/preview/imgur           24     12    50%
libturpial/lib/services/media/preview/instagram       22     11    50%
libturpial/lib/services/media/preview/lockerz         11      3    73%
libturpial/lib/services/media/preview/pictwitter      10      0   100%
libturpial/lib/services/media/preview/twitpic         12      4    67%
libturpial/lib/services/media/preview/viame           16      6    63%
libturpial/lib/services/media/preview/yfrog           11      3    73%
libturpial/lib/services/media/upload/__init__          7      0   100%
libturpial/lib/services/media/upload/base             23      0   100%
libturpial/lib/services/media/upload/imgly            16      9    44%
libturpial/lib/services/media/upload/mobypicture      15      7    53%
libturpial/lib/services/media/upload/twitgoo          14      7    50%
libturpial/lib/services/media/upload/twitpic          15      7    53%
libturpial/lib/services/media/upload/yfrog            17      9    47%
libturpial/lib/services/url/__init__                   6      0   100%
libturpial/lib/services/url/shorturladapter            9      0   100%
----------------------------------------------------------------------
TOTAL                                               2301    601    74%

======================================================== 199 passed in 2.04 seconds =========================================================

Tarball with source code of 1.7.0-b1 is available in our files repository and there is a tag in the github repo for this release.

To run the tests you must go to the libturpial folder and execute:

py.test --cov libturpial --cov-config .coveragerc tests/

Note that you will need to have py.test installed in order to run the test cases.

I encourage you to test this libturpial version using both, Turpial 3.0 and Turpial development version, and if you find anything weird or not working properly, just let me know.

The test period of this beta will be until March 14th, if everything goes fine a release candidate will be published that date. In the meanwhile I’ll be working on new Turpial features.

Thanks for your patience and support.

Featured image by (CC) euthman / Flickr

Library used as Turpial 3 foundation got a new update. Changes made in libturpial 1.5.9 to fix issues in 1.1.16 introduced a couple of bugs that didn’t break Turpial but prevent users to use preferences dialog and fetch direct messages.

In this version I reverted some default values in configuration module to avoid breaking backward compatibility, fixed error loading direct messages and fixed proxy support. You can check the ChangeLog for more information. This version fixes the backward compatibility and allow users to run Turpial 3 again without problems.

libturpial 1.6.0 is available from our files repository and from PyPI. You can install it from sources or via pip using:

pip install libturpial

This version should be available already in ArchLinux via AUR and, as usual, our friends packagers will be working to make it available for Ubuntu, Debian and Fedora as soon as possible.

NOTE: You need to remove the Turpial config file after update:

rm ~/.config/turpial/config

I apologize for the inconveniences this regression could cause. Thanks for your support.

Featured image by (CC) 50501312@N05 / Flickr

Due to a bug in the previous version of libturpial (1.1.16) I’ve released a new version with the proper fix and I encourage to everyone to upgrade as soon as possible. Previous version doesn’t work and will be deprecated, please don’t use it anymore. I apologize for all the inconveniences.

This time I’ve added more than fixes and this release includes:

• Support to upload images using pic.twitter.com
• Preview for Instagram pictures
• Fixed filters
• Parameter to enable/disable cache when getting profile image
• Implemented retweet count in statuses
• Possibility to fetch a single column or a single account
• Change profile image
• Support for trend locations and trending topics
• Fixed issue with previous version

You can check the full ChangeLog for more information. This version is backward compatible and safe to use with your current Turpial installation.

libturpial 1.5.9 is available from our files repository and from PyPI. You can install it from sources or via pip using:

pip install libturpial

This version should be available already in ArchLinux via AUR and our friends packagers will be working to make it available for Ubuntu, Debian and Fedora as soon as they can.

Thanks for your patience.

Featured image by (CC) guitavares / Flickr

86 weeks have passed since the last update of Turpial’s PPA but we are glad to announce that Turpial is back to Ubuntu.

Efrain Valles has packaged Turpial 3 for Ubuntu Saucy and it’s already available in Turpial stable PPA. To install it you need to add this PPA to your system’s Software Sources and then use apt-get. You can do it in a terminal executing:

sudo add-apt-repository ppa:effie-jayx/turpial
sudo apt-get update && sudo apt-get install turpial

Or if you don’t like PPA’s just download .deb files for libturpial and turpial, install them (manually or double clicking the files) and enjoy!

I’m excited to have Turpial back in Ubuntu and I’ll be doing my best to enhance desktop integration and user experience in this Linux distro. And yes! I used an old-fashioned Ubuntu picture

UPDATE: This version has a bug that breaks Turpial. Please use libturpial 1.5.9 instead.

As part of the improvement process and to anticipate to the restriction that Twitter will be implementing to the HTTP connections on January 14th, 2014, I’ve released a new libturpial version.

This maintenance version includes the following changes:

• Method to handle socket timeout
• Proxy configuration handled via model
• Fixed cache calculation
• Refactored and fixed configuration module
• Fixed list support
• Added/removed friends to local list after follow, unfollow, block and report as spam
• Fixed broadcast when passing no arguments
• Profile model now indicates if the user is following you or not
• New fields to status model

libturpial 1.1.16 is now available from our files repository and from PyPI. You can install it from sources or via pip using:

pip install libturpial

Take a look at our Quickstart Guide to test libturpial or follow the instructions to generate the documentation for a full API reference.

This version is compatible with the previous version and you should upgrade as soon as possible, otherwise Turpial (and libturpial) will stop working by January 14th, 2014.

If you find any issue please report it on Github or in our mailing-list.

Thanks to the great job of our friends Miguel Landaeta and Edwind Contreras Turpial 3 is now available in Debian and Fedora repos respectively.

For Debian, Turpial is available on Sid and Jessie, and Miguel continues working on backports for Wheezy. You should be able to install Turpial via apt-get, aptitude, software center or any other tool in the mentioned versions. More info about Debian packages in the links below.

http://packages.debian.org/sid/turpial
http://packages.debian.org/sid/python-libturpial
http://packages.debian.org/jessie/turpial
http://packages.debian.org/jessie/python-libturpial

In Fedora, Turpial is available for Fedora 19 and 20, whilst libturpial is available only for Fedora 20 but in testing for Fedora 19. libturpial should be migrated soon from testing to stable in Fedora 19. More info about Fedora packages in the links below.

https://apps.fedoraproject.org/packages/turpial
https://apps.fedoraproject.org/packages/python-libturpial

For Arch Linux, Turpial doesn’t hit any official repo yet but is still available from AUR. You can install it via yaourt.

https://aur.archlinux.org/packages/turpial-git/

And for Ubuntu, we have our friend Efrain Valles working on a fresh set of new packages, so we should have news about it soon.

If you or some friend are interested in packaging Turpial for other platforms, let me know

Almost two years have passed since the last stable release of Turpial but today that situation will change. Write down this day in your calendar because today I’m pleased to announce a new stable release: Turpial 3 is finally out!

I’ve worked hard on deliver a beauty, stable and fully featured application but without losing of sight the resource consumption, one of the most distinctive characteristics of Turpial so far. Main features of this version include:

• New backend on top of libturpial
• Rewrite of the whole interface using Qt
• Multiple accounts and multiple columns
• Pre-visualization of images and user avatars
• Messages queue
• Added support for Mac OS (and Windows theoretically)
• Broadcasting messages
• Autologin
• Cleaned and improved overall UI
• Improved user interaction
• Links, mentions and hashtags are clickable
• Enhanced Twitter search
• More services to short URLs and upload pictures
• Improved conversation interface
• Welcome screen
• Restored window geometry at startup
• Available in 11 languages: Catalan, German, Esperanto, Spanish, French, Italian, Japanese, Portuguese (Brazil), Portuguese (Portugal), Russian (Russia) and Turkish

Because of the deadline, I haven’t had chance to deliver as much features as I would like, however I’ve a big To-Do list with things that I’ll be working on like:

• Enable filters (currently disabled because a bug with libturpial)
• Updates and notifications per column
• More social tools
• Show DMs as conversations
• Handle lists
• Improve support for Ubuntu Unity (and more OS stuffs)
• Option to open images in browser or in preview window
• Enable sounds and notifications in Mac OS X
• Streaming support
• Support for upload pictures with pic.twitter
• Button for manual refresh

There are things that I probably won’t touch in the mid-term like move columns or GIF support for the image preview window, so don’t ask for it.

In the next days I’ll be updating the download page and the site layout, so expect changes.

Source code is available in our files repository and should be available soon in Debian, Fedora, Ubuntu and Arch repos. I encourage you to download the .sha1sum file to verify the tarball integrity.

I would like to say thanks to translators, testers, bug reporters, packagers and to all the people that have helped and supported the project until today. This release is for you. Enjoy it!