Disclaimer: If you are not comfortable with the command line, do not try this.

If you have installed an app from the Ovi Store web portal, you would have noticed that the process is not fast. Clicking the Download link opens the Application-Manager which takes anywhere from 30-40 seconds to prepare the system before actually starting the download. For those who don’t like to wait, the apt-get command is a great alternative to speed up things and also allow installing multiple apps (at least the ones that are free) in one go.

Prerequisites

There are two things required before starting the download. Setting up the Ovi Repo and creating an Archive folder. You need to do this only once.

Ovi Repo

If you have never used the Ovi Store, you would need to have the repo installed first. Downloading an app from the store automatically adds the repo the first time but you need an Ovi account. So if you want the apps but don’t like signing in, you can add the repo manually:
Name: Ovi
Web: https://downloads.maemo.nokia.com/fremantle/ovi/
Dist: ./

Archive Folder:

In order to save space on the root partition, create a download directory for the downloaded packages. Instructions here

Installation

For installation, all you need is the application’s package name. The apt-cache command can be used to find it. The following command will search and list all packages with the word ‘offscr’ in it:

# apt-cache search offscr

This will display the 31 nifty apps by Offscr currently available. This also searches descriptions.

Next, install the desired package using apt-get (as root of course):

# apt-get -o dir::cache=/home/user/MyDocs/apt-archive-cache install  offscr-discs  offscr-backgammon  offscr-watch

This will start the installation process for all 3 apps which will take about the same time it takes for one install from the website. Enjoy!

Latest Mobile Phones 2010

Hi folks a major firmware update for Nokia N900 is out. The Update is called PR  1.1 Release1.2009.42.11 to PR1.1 release 2.2009.51. Maemo 5 PR1.1 is being released on January 14, 2010. Starting in Finland at 7am local time and following a staggering process country by country through the different time zones.

This update can be installed over the air by users with the PR1.0.1 already installed. Images for flashing will be available later today as well.

The Maemo 5 SDK and tools are being updated as well in order to match the OS content. The update will be available later today.

Tons of Changelogs after the break!

New features

• Hutchison SIM cards are supported.
• MS Exchange 2003 support.

Maemo Update

• Bootloader (Nolo) can be updated over Maemo Update.
• Cellular software can be updated over Maemo Update.
• Icon cache removed to allow more memory space for Maemo Update.
• Application Manager: Available space check moved to apt-worker for more accurate results.

Reliability

• Improvements in SGX performance and reliability.

Use-time and power consumption

• API for status area applets to detect if they are invisible/absent.
• Fixes to Pulseaudio timer increasing power saving when starting/closing apps.
• Browser: Removed unnecessary serial logging.
• Reduction of wake-ups in Desktop, Connectivity, Conversations, RSS Feed Reader,
• Backup handles correctly directories containing pairs of symlinks.
• Less CPU load caused during video recording.
• Support disabling Virtual Keyboard in input field.
• Performance improvements in Browser.
• Lock: “swipe to unlock” will not stay on.
• CPU idle latencies and thresholds updated.
• Fixing eMMC data lines while sleeping.
• CellMO power consumption reduced.

Usability

• Volume button operation in call flipped based on audio routing (no more on screen orientation).
• Browser: Downloading & rendering of page content runs promptly.
• Helping to avoid capacity limits of rootfs when installing apps (make Docpurge aware of /opt).
• Stability and usability fixes to the Profiles applet. Selection, usage and restoring of ringtones.
• Fast call from home shortcuts.
• Fast SMS rejection of incoming call.
• Avoid false alarms in pocket.
• Silence ringing by flipping face down.
• Fix to Camera photo orientation problem: correct orientation is now written to EXIF.

Performance

• X: performance of GLES apps improved.
• Lower RAM consumption while capturing video.
• Phone-UI & Msg-UI always ready to appear.
• Application Manager UI speed improvements.
• Email faster with large mailboxes.
• Large file copy (SD->MMC) doesn’t degrade system performance.

OVI Maps

• Route calculation and search performance improved.

Connectivity

• BT Secure Simple Pairing fixed for Windows Vista.
• BT transfer progress indicated.
• Improving WLAN connection stability.
• Improved WLAN negotiation when going out of reach of access point.

Phonecalls

• Add voicemail shortcut support.
• Showing call forwarding correctly when busy forwarding is not set.
• Call log improved.

Audio & Video

• Audio volume control works with +/- keys in full-screen playback of flash.
• Handling corrupted ring tone files better.
• HW volume keys always have same orientation.
• Media Player UI now provides feedback when tapping control buttons in video playback.
• MIC input not clipped when loud voice in VoIP call.
• Pulseaudio: Ringtone is heard from the loudspeaker if BT connected.
• Ringtone played both to headset (BT or wired) and to internal HF speakers.
• AV sync fix for recorded videos.

Camera

• ISO EXIF value for images saved when automatic sensitivity in use.
• Vignetting test of 2nd camera fixed, VGA sensor stability.

Battery and Charging

• Improved charging in case of low charging power (PC USB charging).

USB

• Fixing the USB detection and card mounting issue related to quickly attaching/detaching the cable.
• Able to format corrupted eMMC properly.
• Hang fixed in case of WLAN disconnection while copying files.

Synchronization

• Activesync supports now MS Exchange 2003.
• Activesync – fixes the forwarding of attachments showing incorrect sizes (Exchange server 2003).
• Content copier of PC Suite enabled. Whole content backup (including Notes) can now be restored from PCSuite.

3rd party applications

• Policy-settings: Fixes rotation transition in for 3rd party applications.
• Policy-settings: By default, 3rd party apps should have the same limits as our applications.

Calendar

• Public API for color picker. Home widget is now translucent.
• Set/get alarms API.
• Syncing of task alarms supported.

Image Viewer

• Thumbnailing faster.

Application Manager

• Rename Maemo Extras to maemo.org and enable by default.
• Grid view applied for the categories in download view. Added API for filtering packages.

Development Platform

• SDK content and tools updated.
• SDK GUI installer updated.
• New sharing-dialog-dev package added to enable Bluetooth and email sending.
• New wappushd-dev package documenting MMS interfaces available.

Community reports fixed

Browser

* “”About Flash Player”" contextual menu item treated as unrequested pop-up
* Focus not set to location bar after Ctrl-L shortcut is used
* Spacebar scrolls more than 1 page
* microb doesn’t trigger onchange
* Page is not rerendered when JavaScript actions increase page length
* Complete Browsing History on the N900 sometimes displays “”None”"
* The menu item “”copy”" in the browser menu does not work
* OK button remains disabled in dialog for Integer settings in about:config
* Browser window checkerboards and repaints when navigated to from multi-task view
* Sometimes the browser window goes black for over a second after clicking the fullscreen/restore button

Calendar

* Start and end times are changing when daylight saving time ends (begins)
* Incorrect entries in the Birthday Smart Calendar
* Changing to next week is very slow
* Smart birthday-widget doesn’t show up any birthdays or shows one on random

Chat & Call & SMS

* Phone app crashed as call ending
* Dialer does not accept SS (3GPP TS 22.030) dial strings
* Unclear how to open a contact (sender/receiver) of a conversation
* High latency between UI and SIP events being sent
* clicking on notification window fails for 2 or more messages when in Dashboard
* Skype does not allow entering DTMF tones
* skype: Call does not support DTMF tones
* Can’t send sms/chat to known contact from the Call list
* libnice violates Debian packaging policy for description of package “”libnice0″”
* Volume buttons should be swapped when using the phone in portrait mode.
* Call Log only displays contact name that called, not phone number
* Show wrong Contact for a SMS after a couple of days
* scrollbar instead of kinetic scrolling
* Chat window for jabber / xmpp is not always updated with new incoming messages

Connectivity

* Bluetooth DBUS UI dialogs – wrong args in the example code
* Button style in Bluetooth file receive applet is wrong
* Inconsistent keyboard behaviour when configuring a static ip address
* Drops WLAN connection to Linksys WRT610N after 10-15 minutes
* after failed pairing to bluetooth car kit bluetooth can’t be turned on
* Wrong settings for Orange (France) gprs
* udhcpc overriding default routes

Contacts

* address book cannot import vcards from benq/siemens phones properly
* Contacts re-appear in list after disableing and re-enableing accounts
* No hint that it is impossible to paste an strings containing non-numeric characters into a phone number field
* Skype Support>Report problem leads to an error page

Core

* N900 sometimes ignores USB data cable

Desktop platform

* Publish sources of alarm framework
* Failed to build libosso-2.19 from Fremantle repo (ggc 4.3.2)
* wdgt_va_full_12h_time, wdgt_va_12h_hours should be replaced by wdgt_va_full_12h_time_am/wdgt_va_full_12h_time_pm and wdgt_va_12h_hours_am/wdgt_va_12h_hours_pm
* Easy to enter ~ ^ ‘ ` “” symbols with 3rd row of special character view
* “”More…”" applications launcher does’t allow scrolling
* Can’t easily align desktop widgets (snap to position) on home screens
* Allow keyboard input to jump to an entry in a list (“”type ahead”")
* No rubber-banding effect in the Main “”More…”" menu (task launcher)
* WiFi password shows up in auto-completion
* When applying a different theme, not all colors change in application manager
* libsdl: Task switcher area can be a dead area
* FN-lock and Ctrl+Backspace breaks input for used application
* Application Manager moves to background after start when quickly clicking
* Typing in newly opened window brings up contact search
* Race condition with hardware shift key
* Home view blurs on triple-tapping the launcher grid icon
* Hanging application menu requires system reboot
* Rotation in 42-11 is not as smooth as in 41-10 for some third party apps
* “”More…”" view is not sorted at all
* Add a (short shown) scroll bar in the status area window to indicate that there are more elements inside as actually shown
* Updating software removes desktop shortcuts

Desktop Widgets

* AP News Widget causes Excessive CPU wakeups
* Contact widgets move to active desktop after merge
* Media Player widget suddenly starts music after Phone call ends

Development Platform

* Link to C code not working (not a link in fact) on Fremantle camera api dev page
* Package downloads should be retried when the http connection time-outs
* Link for osso_wlan documentation broken
* Video indexing failed in SDK (Tracker issue?)
* xkbdata: Inconsistency between installed packages in SDK and FW
* example source code not available in “Writing a new maemo application”
* e2fsprogs derivative packages not available?
* HildonTouchSelector example has wrong parameters in callback function
* URL for sharing plugin template missing

Email

* Does not always mark e-mails as read (dovecot/cyrus/google IMAP server)
* Modest reports email username / password incorrect when it is correct
* Performance is unusable on IMAP accounts with a large number of messages in one or more folders (e.g. INBOX)
* When an IMAP account is selected, only refresh that account’s folders
* Locales not working correctly
* Deleting email should be more evident…
* Fix modest compilation warning
* Remove HildonDialog deprecated symbol
* Import conic support only if It’s available
* Remove Hildon 0.x conditional code
* Remove Hildon 1.x conditional code in Hildon2 version of modest
* Modest doesn’t take care of preferences for automatic update
* New email notification leads to blank email instead of email itself
* Double-tapping “”Inbox”" sometimes opens ‘empty’ Inbox
* nokia messaging doesn’t synchronize selected imap folders
* Long delays when opening emails – viewer window shows “”Updating”"

Images and Camera

* When ISO sensitivity is set to automatic, ISO EXIF value in resulting image is 0
* Vertical photos from other devices should fill more space when shown in portrait.
* User-facing camera produces a left side dark vertical band
* Audio does not sync with video (and is ultimately unsyncable)
* Improve zooming

Location

* Bluetooth GPS reconnect dialog refuses to go away after clicking “”No”"

Map

* USA localization displays distance in kilometers
* Can’t delete route waypoints in Map application
* Route Settings screen is not finger friendly

Media player

* Information on artist / track not updated in media player with internet radio
* Plays next radio station when current station cuts out / has playback issues
* flashing pixels around the lock button if media player is playing a video.
* Media player track search only matches the beginning of title/artist
* Viewing songs by “”Artists”" automatically scrolls to the end of the list

Multimedia

* N900 needs to be rebooted if media player fails to play video (h264dec)
* Volume in media player jumps when receiving emails, IM´s or sms´s
* Can’t change FM TX radio station name
* Xvid encoded videos unwatchable

Settings and Maintenance

* Streamlining user access to the Extras repository
* Should remember position in packages list after installing package
* Other Category appears twice
* Installing many packages at a time via App Manager exhausts rootfs space
* Artifacts (visual noise) when tapping screen in Screen Calibration
* docpurge is not aware of /opt
* Inconsistent layout on similar Sharing/VOIP applets
* Background image settings not restored

Sharing

* Evernote uses to much space in root partition, should use /opt

Statusbar Widgets

* Volume slider doesn’t notice when you plug in headphones
* Currently active connection should be first in Connections list

Synchronization

* First Synchronization between N900 and Exchange 2003 Server always fails
* MfE spams screen with error messages when it cannot connect to the server
* MfE wont keep Exchange account updated
* Changing password on Exchange 2007 makes MfE go crazy
* Company Directory not present
* MfE is missing some CA cert symlinks on some devices (NuevaSync)
* Initial sync fails with exchange 2007

System Analysis

* getbootstate bricks the device after 17 reboots if there are no normal boots in between them

System software

* Shaking device switches between landscape and portrait modes
* Charger not recognized when plugged in when in Touch & Key lock
* Low power/battery beep does not sound if you’re on a call
* Pin / lock code entry dialog reveals digits on backspace
* Alarm clock does not wake me up when battery has died.

Telephony

* 3 Mobile SIM card rejected
* Call forwarding settings not being saved
* No pause before sending DTMF tones

Translations

* Change ‘TV uit’ (TV out) to ‘TV-uitgang’
* “Ładowanie” used without distinction between “”charging”" and “”loading”"
* addr_va_lastname has a comma that it shouldn’t have
* IP address field in WiFi advanced settings partially hidden (“”Recuperar automáticamente dirección IP”" string too long)
* Some sentences in the User Guide don’t make sense
* Wrong profile names in the User Guide
* Delete dialog text missing a space
* Polish string too long in UPnP browsing menu bar
* Wrong PO Box translation for CZ language

Utilities

* Re-enable reset and/or reset-and-clear in osso-xterm
* “”Already at minimum / maximum font size.”" not translated
* File manager fails to show folder sizes beyond 999,9 MB
* Clock alarm status icon is sometimes shown as dash (-)”

We all know N900 doesn’t yet feature a MMS sending capability. mkMMS is an application developed by Mohammed Sameer

The application is not yet finished. It’s in alpha stage but it’s working good. It lacks GUI and very limited in features.This application allows you to create a MMS and send your photo to another phone number via Nokia N900. With the current version you can attach only ONE, which can be jpg, png, gif or text file (txt). And at this point it’s still under development so we can get a full featured version very soon!. You can use it like this

./mkmms /home/temp/photo.jpg m-send-req.mms subject

You can get a Copy of mkMMS here : mkMMS

If you connect the N900 to a computer via USB frequently, you will sooner or later encounter this error where the N900 will refuse to be used as external media.

This is because a program (or programs) is accessing files in the /home/user/MyDocs folder. To fix the problem, the program(s) in question needs to be found and stopped. To find the program(s), open a root terminal and type

 lsof | grep MyDocs

This will display the programs accessing the MyDocs folder something similar to this:

Nokia-N900-42-11:~# lsof | grep MyDocs
sh        3474       user  cwd    DIR      179,1    65536       4326 /home/user/MyDocs/tmp

The second column displays the process-ID of the program (in RED above). Now, terminate the program with this command (repeat for multiple programs):

kill 3474

Now, run the lsof command again (press UP arrow to go back) and make sure the program is not displayed. If it is still running, execute this:

kill -9 3474

Reconnect the USB cable and you should now be able to use the N900 as external media.

This tutorial will show you how to add an icon to the topx shortcut in Part 1.

1. Find/create a PNG image of dimension 48×48. (google this)
2. Name the file topx.png
3. Save file to /usr/share/icons/hicolor/48×48/hildon/ (you will need root access)
4. Modify the topx.desktop file to include the following line. The right side should be the name of file without the .png

Icon=topx

The topx.desktop now looks like this:
[Desktop Entry]
Encoding=UTF-8
Version=0.1
Type=Application
Terminal=true
Name=topx
Exec=/usr/bin/osso-xterm top
Icon=topx
X-Osso-Type=application/x-executable

Save topx.desktop and reboot to see the icon for the shortcut in the Application Menu. If the icon does not show up, install a couple of apps from the Application Manager. This should update the icon-cache and display it.

Dell Pre Order Nightmare

Picture this scene. It is a Saturday afternoon of one of the busiest holidays in the country. The week before, you found some coupons for a very nice discount at your family’s favorite restaurant. Since you know that it is going to be difficult to get a table in such a busy holiday, you decide to get there earlier than usual. You gather your kids and your wife and arrive to the restaurant nice and early.

Unfortunately, in spite of your foresight, the place is already full when you get there. The hostess informs you that there is a waiting list and she asks if you would like to be put on it. You are told that the wait is expected to be about forty five minutes. You decide to agree and proceed to wait. After some thirty five minutes have passed, you observe that some newly arrived clients are taken immediately to a table instead of being put on the waiting list. Then, you observe this happen a few more times. You approach some of these clients to ask them if maybe they had reserved over the phone, but they tell you that they didn’t. They simply arrived as usual and were taken to their tables without any trouble. You go to the hostess to ask for an explanation and you are simply told that they are sorry but all the tables are being used. You ask, “well how much longer do we have to wait?” She says, “well, it looks like its going to take at least another forty five minutes.” By now all the other restaurants are packed. If you leave, the wait somewhere else will likely be even worst. How would you feel then?

Well, a similar nightmare scenario has happened to many customers of Dell. On November 5th, Dell issued a coupon that could be used in the purchase of the highly anticipated Nokia N900 mobile device. The word on the internet got out and it didn’t take long before Dell had to remove the item from the website. Everyone that managed to place an order felt very fortunate. The item was expected to ship in a little over a month, but everyone decided that it was worth the wait. Besides, every one thought that the device would likely end up shipping before then, as it often happens.

Sure enough, around November 21st , word began spreading about some orders starting to ship. Of course, everyone got very excited. Like when they announce that you plane is starting to board. People who received their devices began posting their experiences, and everyone else waited excitedly for theirs to arrive. Unfortunately, the days began to pass without their orders being shipped.

And then, some customers began reporting that orders they had just placed where actually shipping too. That is right, orders that were being placed weeks after the original customers had pre-ordered, started to get their devices shipped! You can imagine the confusion that arose. People began to call Dell to ask them what was going on. They simply answered that the device was not in stock. Customers began consulting with one another to try to figure out what was really going on.

That is right, orders that were being placed weeks after the original customers had pre-ordered, started to get their devices shipped!

Several of the customers that got their devices without having pre-ordered them were happy to help the rest. They provided their order dates and delivered dates, and some customers were even able to get a few of the late ordering order numbers so that they could be verified. When Dell representatives were presented with this evidence they simply said that they would have to “investigate” the matter and that they would get back in touch soon. They also tried to pass the blame saying that they simply send orders automatically to Nokia for fulfillment as soon as the purchase takes place. According to them, it was Nokia that was holding back deliveries to those that had pre-ordered from Dell. When asked if there was a way for the customers to contact Nokia in order to get to the bottom of this failure to honor order dates, the answer was that unfortunately that was not possible. Then, all of the sudden, everyone that had ordered on November 5th saw a change in their online order page. The expected delivery date was moved to January 20th, 2010.

I personally was one of those customers. It was at that time that I decided to do something about this. I contacted Dell and asked for an explanation. I received the same canned response, they would have to “investigate” the matter, but nothing could be done. Outraged, I sent an email to Dell telling them that I was considering placing a complaint with the Better Business Bureau. This was their response:

Monday, December 14, 2009, 6:03 PM

Sir,

All efforts has been made to have the item shipped out but due to highly constrained backlog and a very limited inventory into the distribution centers the distribution centers will ship to the customers within their respective regions only.

As much as we wanted to ship the item out soon but we really cannot guarantee you since it will depend on the availability of the item. Since you are in a hurry to get this item, the only option here is to cancel order and you can just buy one from a local store. Thank you.

Regards,

[***********]
Dell Inc. | Americas Customer Care
Work Days: Mon – Thurs
Work Hours: 08:00a.m.-7:00p.m.CST

To that, I replied:

Monday, December 14, 2009 7:25 PM

Dear Ms *********,

Thank you for your response. I do not want to cancel my order. You see, the issue is not that I am in a hurry to get the phone. What is upsetting is the fact so many people who ordered much latter than me got their phone. Look at this two orders for example:

OrderNumber	OrderDate	Status
999999999	11/19/2009	Shipped
999999999	11/25/2009	Shipped

I will wait as long as I have to wait, but I am not happy about the situation. There is obviously something very wrong about the way the orders are being processed. My desire is for this situation to be rectified so that in the future other customers do not have to deal with this sort of issues. I thank you for continuing to try to resolve this situation and to rectify what caused it in the first place.

Sincerely,

[rm42]

Several days went by with no word from Dell. By now, I had put my self in contact with some of the customers that were in the same situation that I was and offered them to place a join-complain to the Better Business Bureau, thinking that maybe that way it would be taken more seriously (since then I have been informed that it is actually better to have each individual file his own complaint). Several customers agreed and gave me their information. I also contacted some of the users that claimed to have had their devices shipped without having to pre-order, and they too were willing to share their order numbers, order dates, and delivery dates with me. Armed with that, I wrote another email to Dell.

Wednesday, December 16, 2009 11:50 PM
Dear Ms E*********,

I take it that you have no news regarding the shipment of the N900 since I have not heard from you yet. That is OK. I am resigned to wait it out. However, would you not agree that I am entitled to some form of compensation for all the trouble and frustration that Dell’s mismanagement of my order has caused me?

Think of it this way. Imagine that you go out with your family to a restaurant for dinner. Upon arriving you are told that there is a waiting list and you are asked if you would like to be put on it. You are told that the wait is expected to be about half an hour. You decide to agree and proceed to wait. After 20 minutes have passed, you observe that some newly arrived clients are taken immediately to a table instead of being put on the waiting list. You observe this happen a few more times. You approach some of this clients to ask them if they had maybe reserved over the phone, but they tell you that they simply arrived and were taken to their tables without any trouble. You go to the receptionist to ask for an explanation and you are simply told that they are sorry but all the tables are being used. How would you feel then?

Well isn’t that what is happening in my and many others cases? Here is a list of people that are in the same situation that I am:

Name	OrderNumber	OrderDate
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009
**** *****	999999999	11/5/2009

And here are just some of the orders that were fulfilled with devices that should really have been shipped to one of us instead.

OrderNumber	OrderDate	Status (by 12/8/09)
999999999	11/26/09	Shipped
999999999	11/25/09	Shipped
999999999	11/19/09	Shipped

So, tell me, how is Dell going to try to repair our relationship as customers?

Sincerely,

[rm42]

As I write these words, I have not yet received any response from Dell. Interestingly, one customer was able to get through to Nokia to have this matter addressed. This is the email he received from Nokia:

Thank you for e-mailing the Nokia Care Contact Center.

With regard to your inquiry about the delivery date, basically it is between you and Dell, since you placed the pre order with Dell and not with Nokia. We deliver the units to Dell and Dell delivers it in return to their customers. We will have no business delivering it to their customers, since it is not our customers. We will not know who placed the pre order with them, that is basically internal process with Dell. We suggest that you contact Dell, however it is evident that they point it to Nokia to avoid blame from customers, they might have preferred customers.

If you have any additional questions, please don’t hesitate to contact us again. To ensure proper handling of your case, kindly continue using the current subject line.

Thank you very much for your email. Have a great day!

Kind regards,
Rosalie L.
E-mail Specialist
Nokia Inc.

So now I ask you, what do you think is going to be Dell’s next move, if any? What do you think their next move should be? What would you do in our situation?

This is part two of the Python for Newbies tutorial . Part One can be found here. The content of this tutorial is provided under the Creative Commons Attribution-Share Alike 3.0 license:

http://creativecommons.org/licenses/by-sa/3.0/

http://creativecommons.org/licenses/by-sa/3.0/legalcode

Functions

Functions are simply a set of commands or statements grouped together as a unit with a name that can be called on by other parts of the program (or even by other programs) to accomplish a certain task. Since the statements inside a function do not have to be rewritten every time the steps they perform are needed, our programs are smaller and easier to maintain. We have already used several functions that are built in to the Python core. For example, we have used the del function to delete items from Python lists and dictionaries, the tuple function to convert a string into a tuple, several math functions, and others. However, we are now going to learn how to create our own functions. Functions are simple, but there are a few new associated concepts that you will have to understand.

Defining a function

Here is a brief example that we can examine:

>>> def average(num1, num2):

...     avrg = (num1 + num2) / 2

...     return avrg

This is a small little function that calculates the average between two numbers and returns the result Notice that, as all the compound statements that we have seen, a function definition has a header that ends with a colon. The header begins with the def statement, followed by the name of the function to be. After that, we have something that you should be able to recognize, a tuple, nothing else, nothing more. That tuple is used to contain the parameters of your function. What are parameters? Well, parameters are values that can be passed to your function (and that your function will expect when called) for it to do something with them. In Python, those parameters can be anything you want: a number, a string, a list, a dictionary, a file, etc. Parameters can have default values too. For example, we could define a function with a header like this:

def personal_info(name, phone, country = 'USA'):

The third parameter of this function has a default value, the string ‘USA’. That means that when calling this function the third parameter is optional. We could call the function like this:

personal_info(Joe, 1234-5678)

The function would accept the call and use ‘USA’ as the value for the third parameter. Of course, we would also have the option of using a different third parameter, like this:

personal_info(Bob, 987-6543, 'UK')

So, defaults can come in very handy.

Notice that on the first function we defined above (average) the result was returned to the calling program with a specific statement, the return statement. Why is that? Why couldn’t we just be satisfied with having the variable avrg as the container of the result and use it in other parts of the program? In one word: namespaces.

Namespaces and Scope

Python, as most programming languages, stores names defined inside a function in a separate place from where it stores other names. This different spaces are called, appropriately so, namespaces or scopes. You can think of namespaces as Dictionaries that contain names and its values as key-value pairs. Whenever a function is defined an associated namespace is created. For reasons beyond the scope of this tutorial (pun intended), in Python, names are only accessible to your code if they are defined in one of the following four scopes:

• The first one is called the Built-in scope. This scope is where all the core functions and constants of Python are defined. It is always available to you from anywhere in your code.
• The second one is the Global scope. This is the namespace at the top level of a Python module. (You can see the Modules section if you want, or, for now, think of a module as a file with Python code.) In other words, any name defined outside a function or a class (we will cover classes latter as well) is in the Global scope. Names defined in this scope, like those in the built-in scope, are always available from anywhere in the module that contains it.
• The third one is the local namespace. This is where names defined in a function reside. As mentioned before, names defined inside a function are only accessible from within that function. They are automatically destroyed once the function stops running.
• The last namespace is called the nested scope. This namespace is defined as the namespace of the enclosing scope in which it was defined. That is, if inside a function you make reference to a name that Python does not find in the local namespace, it will then look to see if the name is defined in the enclosing namespace – the nested namespace.

Here is an example of how the nested namespace would work:

operation = 1     # Variable defined in the Global namespace. Always accessible.

>>> def some_function(operation, num1, num2):

…     if operation == 1:

…         x=num1     #Variables defined in some_function’s local namespace.

…         y=num2

…         def multiply():

…             print x * y      # x and y are not in the local namespace of multiply.

…         multiply()

Without nested scopes, this function would report an error, because x and y would not be in the local namespace of multiply, or in the global namespace, or in the built-in namespace. Of course, one could pass the value of x and y as parameters to the multiply function, but certain styles of programming (most specifically functional style programming) are much happier with access to nested scopes. (In other words you may never need to use nested scopes, but at least you now know they are there).

Since variable assignment inside a function takes place in the local namespace, one cannot reassign (change) the value of a Global variable inside a function. Let’s look at an example.

>>> value= 1

>>> def change_value():

…     value = 2

…     print value

…

>>> change_value()

2

>>> print value

1

As you can see, when we assigned 2 as the value of value inside the change_value function, the assignment took place only in the local namespace of the function. The Global variable value remained unchanged. There is, however, a dirty little workaround that should probably be avoided as much as possible in truly efficient and well designed code. Some claim that global variables should only be changed by direct assignment at the global level, whether through direct assignment, or by the value returned from a function. (For example: value=change_value()) In any case the workaround is the use of the global statement. Let’s try it.

>>> var = 1

>>> def func(val):

…     global var

…     var =val*2

…

>>> func(3)   

>>> print var   

6

So, thanks to the use of the global statement, our function successfully changed the value of a variable defined in the Global namespace. If var did not exist before the function call, the function would simply create it.

To clarify the scope order, know that Python will look for names according the LNGB rule. It will first look for the name definition in the local namespace, if not found, it will then look for it in the nested scope, then in the global scope, and finally in the built-in scope. If not found, it will return an error.

Modules

We mentioned modules in the previous section. Basically, Python modules are files with Python code. Modules are the natural way to group related code. So far, all of the built-in Python functions we have seen are included as part of the core Python functionality. However, there are a lot more functions and capabilities included in a Python distribution. Most of them are included as separate modules that one has to “import” in order to use. Let’s look at an example:

>>> import os

>>> os.getcwd()

'/home/me'

The first line, above, uses the import statement to gain access to all the classes, functions and variables defined in a module called os. (As you can imagine the os module contains code related to the use of the operating system.) Notice that to access the getcwd function (get current working directory), all we had to do was type the name of the module, add a period, and type the name of the function. Let’s look at another function in this module:

>>> os.chdir('/home/me/MyDocs')

>>> os.getcwd()

'/home/me/MyDocs'

Here we used the chdir function to change our current working directory to ‘/home/me/MyDocs’. There are a couple of things to pay attention to here. First, notice that the chdir function expects a string as a parameter. That is why we used quotes to surround the path. Notice too that we used a forward slash rather that the backslash commonly used in windows. The reason for this is that in Python the backslash is a character with a special meaning – it is the ‘escape’ character. Besides, in Linux, the OS of the N900, the forward slash is the standard path separator. (If you want your code to be portable between your N900 and Windows use os.sep instead of /.)

To remove a module that we have imported we again can use the handy del function:

>>> del(os)

We could also import one or more specific items from a module. This is how we would do that:

>>> from os import listdir, getcwd

>>> listdir(getcwd())

['somefile.txt', 'Dir', 'Dir2', 'File', 'File.txt']

The listdir function is imported directly into the local scope. This means that we can use it directly without reference to the module it was originally in. This can be convenient sometimes, but is not considered a ‘best practice’ way of doing things. Nevertheless, there are some modules designed specifically to be imported into the local space. For example some Graphical User Interface (GUI) related modules are like that.

Here is another example, one we made reference to earlier.

>>> from __future__ import division

>>> 7/2

3.5

Here you see how to make the N900’s version of Python handle division as Python 3.x does.

There are dozens of modules included in a Python distribution. This collection of modules is called Python’s Standard Library. It is a very good idea to become familiar with their names and what they are for, at least it is good to know what are the most commonly used ones. Probably the best way to do this is by looking at the documentation that is installed with Python. In particular, looking at the “Global Module Index” can be very useful. It contains links to detail explanations for each module of the Standard Python Library. There are also lots of third party developed modules and packages, such as the Windows extension modules that give access to all the win32 API, and to several Windows specific features. Others are the PyQt package and the PyGTK packages. These are the packages used for building GUI interfaces on the N900. One more that I you look at is the py2exe package. This one allows you to distribute your Python programs as executable files to users that do not have Python installed. Of course, you shouldn’t need that for your N900 programs.

Naturally, we can make our own modules simply by creating a file with Python code in it. When we import that module, all its code is executed, whether it is code that defines a function, or simple Python expressions. For example add the following commands into a regular text file, and name the file test.py:

def greet(name):

    print "Hello there, %s" %(name)

greet('John')

Now, in the Python interpreter, import your test module. Note that, since your module is likely not in the Python path, you may have to change your current working directory to the folder where you saved test.py so that Python can find it (The Python path is where Python searches, in addition to the current working directory, when trying to import a module.):

>>> import test

Hello there, John

Two things happened when we imported our module: The greet function was defined, and the greet('John') function call executed. Now, we can continue to use the greet function with other function calls. For example:

>>> test.greet('Marla')

Hello there, Marla

>>> test.greet('Michael')

Hello there, Michael

Now, open a Terminal session and go to the directory that contains your module. Then, try running test.py as a script. For example:

/home/m/MyDocs/Test> python test.py

Hello there, John

The same two things happened. But, of course, since Python terminates when it is finished running the script, we can not continue using it to call the greet function.

We can also make our scripts accept command line parameters so that it uses them at run time. For example, save this as test.py:

import sys

    for item in sys.argv:

        print item

We could then run this script with a call like this:

/home/m/MyDocs/Test>python test.py First "Second" "And third"

test.py

First

Second

And third

The parameters we give to our scripts when calling them are stored in a list called argv accessible through the sys module. The first parameter (argv[0]) is the name of the script itself. So, in our example above, argv[1] would be the parameter “First”.

Generally, the conceptual purpose of a module is to store variables, function definitions and classes for use in other Python programs when needed. But, as you can see, there is no real difference between a module and a regular Python script. You can import any of your Python programs as a module and you can then use the functions and classes defined in them on any program where you need them. However, there is a right way to organize your code inside a module for this to be effective. To illustrate this, lets take a look at another sample Python file, lets call it unames.py.

import sys

def full_name(first, second):
    full = first + " " + second
    return full

def greet(name):
    print "Hello there, %s" %(name)

fname = full_name(sys.argv[1], sys.argv[2])

greet(fname)

What we have here is a couple function definitions, a function call that results in variable assignment, and another function call. Now, say that you are creating a new program and want to use those two functions. You could simply import unames and access them. However, you would then have a new fname variable and the greet(fname) function call executed, and that may not be what you want. So, in order to make sure our Python modules are reusable, we need to have a way of keeping our function and class definitions separate from the calls and we need to have a way of avoiding those calls from executing when the module is imported. Fortunately, there is a very easy way to do this. Just reorganize the code like this:

def full_name(first, second):
    full = first + " " + second
    return full

def greet(name):
    print "Hello there, %s" %(name)

if __name__ =='__main__':
    import sys

    fname = full_name(sys.argv[1], sys.argv[2])

    greet(fname)

Notice that the import statement and the two function calls are only executed when a special condition is met – that the file is being run as a script. This allows you to place all your function and class definitions at the top of your modules and at the very end you can place any code that is to run when the file is run as a script, and that is not to run when the file is simply imported as a module.

One last thing to remember about modules is that if you are using a module and make changes to the code while you are using them in an interactive Python session, you will only be able to use the changes if you reload the module. To do this you have to either delete the module from Python’s memory (using the del function) and import it again, or use the reload function like this:

>>> reload(test)

Now that we are talking about files, why don’t we take a look at how we work with files from Python code.

Working with files

Working with files implies being able to open, read, and write files. Python has everything needed to do that and be able to process them with ease. In Python, files are a built in object type (like lists, dictionaries, etc). We create file objects using the open function. Depending on how we do this, we can either open an existing file or create a new one. Let’s first create a new file:

>>> f = open('MyFile.txt', 'w')

At this point the variable f represents a new file object that has been created in the file system at the current working directory. Notice that the open function expects two parameters. The first parameter is the path and file name, provided as a string. The second parameter is also a string. It can be either 'w', for write, or 'r', for read. Let’s now write something into our file:

>>> f.write('This is a line inside the file.\nThis is another line.\n')

>>> f.write('This is the third line.')

>>> f.close()

Now, if with a text editor we take a look at the file we created, the file should look like this:

This is a line inside the file.

This is another line.

This is the third line.

As you have probably figured out already, the '\n' combination represents the ‘new line’ character. The write method of the file object allows us to add strings to our files. And the close method simply closes it. Easy, right? Now what if you wanted to change something in the file we just created? Well, here is an example:

>>> f = open('MyFile.txt', 'r')

>>> file_contents = f.readlines()     #The readlines method returns a list of lines.

>>> f.close()

>>> file_contents     #Just to show you the contents of file_contents.

['This is a line inside the file.\012', 'This is another line.\012', 'This is the third line.']

>>> f = open('MyFile.txt', 'w')     #Now we open it again to write our changes.

>>> for line in file_contents:

...     new_line = line.replace("line", "set of words")

...     f.write(new_line)

...

>>> f.close()

As you can see, to edit a file we first have to read its contents, close the file, and open it again to write. If we open an existing file with write mode, we really are just over-writing it with a new blank file of the same name. So, after executing the commands above, we have new file, in the same location, with the same name, and almost the same contents. The only difference is that we replaced the occurrences of “line” with “set of words”.

Those are the basics of file manipulation, and that is all we are going to cover. Now, through this tutorial you may have notice that we referred several times to something called classes and objects. Let’s take a very brief look at this subject.

Classes and Objects

There are several theories of what is the best way to program. One method of programming is called Object Oriented Programming (OOP). Python was designed from the ground up, with OOP concepts in mind. Yet, Python doesn’t force us to program this way. OOP in Python is optional. Stil, it may be a good thing to give you a glimpse of how this works.

We have already seen how we can save statements variables and functions inside a module, and then access them in our code by importing the module. Another way to do this is by using the class statement. Let’s look at an example:

>>> class Address:

...     def setStreet(self, value):
...         self.Street = value

...     def setCity(self, value):
...         self.City = value

...     def display(self):
...         print "The address is:"
...         print self.Street
...         print self.City

As you can see we have defined the class Address. In it we have defined three methods (method is how a function inside a class is generally called). You probably notice that the first parameter for each of the methods is the word “self”. Why? Well, to understand that, you have to understand what classes are for. A class is defined so that we can produce objects based on them. You can think of the class definition as the DNA of its objects. We can create as many objects as we want from a class, and they will all be like little clones of each other. Each object we create is referred to as an instance object. Once an instance is created, it can start to have its own particular characteristics, different values, etc. Each object is now an independent ’self’. So, the self we use when defining the methods inside a class refer to the particular instance the actions we are defining should apply to. If this is “all too wonderful” for you, don’t worry. Just remember that you have to use self as the first parameter of your method definitions. If you don’t, Python will kindly remind you with an error message when you try to use the method.

Let’s now create an instance (object) from our class:

>>> address = Address()

That is all there is to it. At this point address is an instance object based on the clsAddress class. It can now start accepting its own personal data. Let’s give it some now:

>>> address.setStreet('157 Royal Road')

>>> address.setCity('NY')

Notice that we have access to the methods defined in our class. Let’s display the contents of our object now:

>>> address.display()

The address is:

157 Royal Road

NY

You may remember, from our earlier analysis of scopes, that functions have their own local scope. Variables inside a function are destroyed as soon as the function stops running. The same is true of methods (since they are simply functions too). That is why when assigning a value to a variable inside a method, if we want it to be available latter, we qualify the variable with, again, the word self. This is as if we told Python to store the value of the variable in the global scope of our object. That’s right, objects have their own internal global namespaces. The value of variables defined this way can be retrieved by making direct reference to the particular object namespace like this:

>>> address.Street

'157 Royal Road'

>>> address.City

'NY'

Of course, we have been using this feature all along in this tutorial, but now you should have a better idea of why. Here is another way to look at the contents of an object:

>>> dir(address)

['Street', 'City']

The dir function returns a list of all the names defined in the object. Finally, here is another little trick to help inspect objects:

>>> address.__dict__

{'Street':'157 Royal Road', 'City':'NY'}

Every object has to have a built-in location to store its instance names and values. That place is the __dict__ dictionary. And, yes, it is just a regular dictionary object itself.

So, just remember, in Python, everything is an object. Even class definitions are objects:

>>> Address.__dict__

{'display': , 'setStreet': , '__doc__': None, 'setCity': , '__module__': '__main__'}

There is much more we could talk about in this subject, but this is all we are going to cover. Time is precious, and we still have a few more things to cover. For example, in this section we made reference to the fact that Python has the capacity of displaying errors. Errors are simply unavoidable in programming. So, let’s take a quick look at them now.

Errors and Error Handling

What we commonly refer to as ‘errors’ in programming are the accidental mistakes we make in our code that yield either the wrong result, or no result at all. Some programming languages leave it at that. They make no attempt at trying to explain why the program did not do what you expected. That is why people have developed special programs called ‘debuggers’ to provide some help in finding where those errors occur. Thankfully, Python is very helpful in this regard. When you commit an error in programming that would result in a break of the flow of execution, Python displays messages to help you try to identify the type and location of the error. For example:

>>> print something

Traceback (most recent call last):

File "", line 1, in ?

NameError: There is no variable named 'something'

The error message, in this case, consists of three lines:

1. The first line simply tells you the way the error message is organized (most recent call last). This is because some errors occur, for example, when your program makes a function call, that itself calls another function, that calls another certain function (where the error resides). Python will trace back the error, letting you know what the original call was, what the next call was, and what the final call (where the error occurred) was.
2. The second line tells you the file and line number of where the error was found. In this case, since we are using the Interactive Command Prompt, it refers to the file as stdin (standard input – right now, the keyboard input).
3. Finally, the last line tells us the type of error (NameError), and what the error was.

So, as you can see, it is very easy to track down your errors, most of the time. Of course, if the error in your program is found in its logic, rather than in its semantics, there is very little Python can do to help you. There are some other packages designed for that. For example, there is a module called unittest that allows one to do something called “Unit Testing”. This is a very popular to check for errors in Python programmnig. But, that is beyond the scope of this tutorial.

The errors that Python catches and displays, as we saw above, are really a subcategory of the larger category called exceptions. Some of the most common standard exceptions in Python are the following (there is a complete list in the manual):

In Python exceptions can be intercepted quite easily. The way this is done is by the try/except/else construct. For example:

>>> try:

...     print something

... except NameError:

...     print "You should have defined it first!"

...

You should have defined it first!

As you can see, we were able to trap the error and tell Python what to do about it. We could exit the program at this time, but in this case we just printed a message. The flow of execution would continue outside of the try statement.

When we add an else block to a try construct, the code inside the else block is executed only if no exception is generated by the try construct. Here is an example:

>>> try:

...     numb1 = int(raw_input("Type a number"))

... except ValueError:

...     print "You should have typed a number."

... else:

...     print "Good job %i is a number." %(numb1)

The first line in the try statement tries to convert the input from the raw_input function into an integer number. It will only work if the input received is in the form of a number. Anything else will generate a ValueError, which we can dutifully intercept. If no error is found the else block is executed and the flow of the program continues outside the try statement.

A variation of the previous statement is the try/finally statement (no else allowed on this one). It consists of one try block followed by a finally block. The finally block always executes no matter what happens. So, this construct is useful when there is something that you want to make sure happens before the program exits. For example, you may want to make sure that some files are closed, or that some data is saved. If an exception is raised during the execution of the try statement, the flow of execution jumps to the finally block, and then it is returned the normal exception handling mechanism. For example, if we had something like this:

try:

    try:

        <statements>

    finally:

        <statements>

except:

    <statements>

In this example, if an exception is found in the try/finally statement, once the finally block is executed, the exception would be propagated to the try/except statement for it to be handled. If not trapped by the except statement, it would be propagated further up until it finally is handled by the Python’s standard exception handling mechanism, thus ending the program.

There is a lot more we could learn about errors or exceptions, but this at least gives you a glimpse into the basics. Let’s now try to gather a few miscellaneous tidbits that will be useful to you as write your own programs.

Other common built-in functions

In this section we are going to cover a few functions that we did not cover before. These are some of the most commonly used built-in functions from the Python core.

Note:
To see a list of all the built-in functions in the Python core use this command: dir(__builtins__)

Let’s first look at the len function. Its purpose is to tell us the length of a sequence. In other words, how many items are in it. This is how it works:

>>> L = [1, 2, 3, 4]

>>> len(L)

4

So, as you can imagine, the len function is very useful when dealing with sequences. For example, we could use it like this in a script:

#Script to process a Social Security Number

ssn = ""

while not ssn:     #Empty strings evaluate to false.

    ssn = raw_input("Enter your Social Security Number: ")

    ssn = ssn.replace("-", "") #Eliminate the dashes, if present.

    if len(ssn) != 9:     #Checks the number of digits.

        print "This is an invalid number."

        print "Try again please."

        ssn = ""     #Set ssn to false

print "Your Social Security Number is: " + ssn

On this example, we created a while loop that continues to loop until a Social Security Number of nine digits is entered.

Another common function is the range function. This function is used to create a list of successively higher numbers. It’s most common use is in conjunction with for loops, allowing us to repeat a block of statements a certain number of times. It can take up to three parameters. Here is what it does:

>>> range(5)     #One parameter, returns list of numbers from 0 to n-1.

[0, 1, 2, 3, 4]

>>> range(2, 5)     #First parameter is lower bound.

[2, 3, 4]

>>> range(0, 10, 2)     #Third parameter provides a step.

[0, 2, 4, 6, 8]

To use this in a for loop you can do something like:

def doit():

    print "Done it."

num=int(raw_input("How many times do you want to do this? "))

for i in range(num):

    doit()

This little script will simply execute the doit function however many times the user requests. So, if we execute it from the command line, it will look something like:

/home/me/MyDocs> python test.py

How many times do you want to do this? 4

Done it.

Done it.

Done it.

Done it.

As we have seen already there are times in which Python will complain if a certain input it receives is not of the correct type. For example, the range function accepts only integers as input. The raw_input function returns its input as a string, that is why we use the int function to try to convert its output into an integer.

The last function we are going to look at is the type function. All it does is return the type of its input. For example:
>>> type(5)
<type 'int'>


>>> type('5')
<type 'string'>


So we could use it, for example when we want to make sure that a certain object we are about to do something to is of the correct type. For example, let’s say that we wanted to write a function that displays the methods available to a certain object. Let’s first create a class with one variable and one method:

>>> class Obj:

...     def __init__(self):     #This is a special method that runs when instances are created.

...         self.data = 1     #In this case it just initializes a variable to 1

...     def add(self, num):     #This is a method that will be available to our instances.

...          self.data = self.data + num

Now, let’s create an instance object based on this class:

>>> ob = Obj()

>>> ob.data

1

>>> ob.add(2)

>>> ob.data

3

>>> dir(ob)

['data']

>>> ob.__dict__

{'data': 3}

As you can see, objects that we create ourselves, as opposed to the built-in objects, do not automatically display the methods they have at their disposal. (There is a not so hard way to make them do that, but we are not going to get into that.) So, now let’s create a function that lets us know what methods are available to our homemade objects.

import types

def find_methods(instance):

    clss = instance.__class__   #We find the class object of the instance

    methods = []

    for name in dir(clss):     #Get the named items from the class object

        attribute = clss.__dict__[name] #Get the value of items from the __dict__

        if type(attribute) == types.FunctionType:     #is it a function

            methods.append(attribute)

    return methods

Now, we can use this function to find the methods in our little object:

>>> find_methods(ob)

[<function __init__ at 007CCD7C> , <function add at 007CC87C>]

Note:
In Python, classes can inherit methods and variables from one or more classes too. This is called multiple inheritance. Our function would have to be a little different to be able to read functions inherited from other classes.

Well as we said before, time is precious. So, why don’t we finish this part of the tutorial looking at the time module.

Time

Computers perform time calculations in reference to an “epoch” (like a pivot date). In the Unix family of operating systems the “epoch” is January 1, 1970, 0 hours, 0 seconds, UTC. Python follows that same method of handling time. The time module has several functions that we can use to handle time related tasks. In its most basic form, Python expresses the current time as the number of seconds since the “epoch”. Here is how you do it:

>>> import time

>>> time.time()

1006015080.406

Not very easy to read. However, other functions allow us to manipulate this output with ease. For example the localtime function.

>>> time.localtime(time.time())

(2001, 11, 17, 11, 40, 37, 5, 321, 0)

The localtime function returns a tuple representing: Year, month, day, hour, minute, second, weekday (0-6), Julian day (1-366), and the daylight savings time flag (-1 (force disable), 0 (default), or 1 (force enable)). There are also many other functions in this module that you should become familiar with. But, even with just this two functions we can do something useful. Let’s create a little timer class that we can use to check the time when a certain event in a program takes place and to time how long it takes our program to do its tasks. (Remember that you have to include an import time statement somewhere for this to work).

class Timer:

    def __init__(self):
        self.start_time = time.time()

    def cur_time(self):
        now = time.time()
        tt=time.localtime(now)
        if tt[3] > 12:
            hr = int(tt[3]) - 12
            ampm = 'p.m.'
        else:
            hr = int(tt[3])
            ampm = 'a.m.'
        ct = "%s:%s:%s %s %s/%s/%s" %(str(hr), tt[4], tt[5], ampm, tt[1], tt[2], tt[0])
        return ct

    def elapsed(self):
        now = time.time()
        minutes =(now - self.start_time) / 60
        secs = (now - self.start_time) % 60     #The remainder of the division
        return 'Elapsed: %s min %s sec' % (int(minutes), int(secs))

If we save that into a file called timer.py we can then import it into any of our programs. Let’s import it into the Python Command Line to play with it a little.

>>> import timer

>>> mytimer = timer.Timer()

As soon as the instance is created it records the time in the start_time variable. We can verify that like this:

>>> mytimer.start_time

1006016982.671

Now let’s check the current time.

>>> mytimer.cur_time()

'12:10:49 a.m. 11/17/2001'

And finally, check how much time has elapsed since the instance was created.

>>> mytimer.elapsed()

'Elapsed: 1 min 38 sec'

Well, that is it for this section. It didn’t take too much time now did it?

We are going to wrap up this part of the tutorial here. The remaining parts of the tutorial will be quite interesting. Hopefully it won’t be too long before they are completed. Come back and check in a little while. And remember that if you would like to contribute your help to this tutorial you are very welcome. Just leave us a note and tell us how to contact you. Happy coding to all.

This is a Python tutorial that tries to touch on most areas of the Python language, but attempts to be very simple so that people who have never done any sort of programming can grasp it. Special attention will be given to its use as a Maemo OS development platform. The content of this tutorial is provided under the Creative Commons Attribution-Share Alike 3.0 license:

http://creativecommons.org/licenses/by-sa/3.0/

http://creativecommons.org/licenses/by-sa/3.0/legalcode

The versions of Python and other libraries targeted by the tutorial will be initially the ones available on Maemo 5 at the time of the N900 release. That means Python 2.5.4. As Maemo starts moving to more recent versions of Python we will attempt to keep this tutorial in sync.

If you have any other comments or suggestions please let me know. We have a Google Wave available for those that would like to contribute to the content.

Due to its length, we have divided the tutorial in two parts (maybe three by the time we are done). There are a few sections still missing at the end of the tutorial. We hope to add them in the near future. But, again, if someone would like to help, let us know.

Table of Contents

Part One

• What is Python?
• Why Python?
• Installing Python
• How Python works
• The building blocks of a Python program
  • Variables
  • Expressions
  • Numbers
  • Strings
  • Lists
  • Tuples
  • Dictionaries
• How to program in Python
  • “for” loops
  • “truth” tests
  • “while” Loops
  • “if” statements

Part Two

• Functions
  • Defining a function
  • Namespaces and Scope
• Modules
• Working with files
• Classes and Objects
• Errors and Error Handling
• Other common built-in functions
• Time

Part Three

• GUI – Qt development
• GUI – GTK development
• Maemo/N900 specific modules
• Bibliography (attributions)

What is Python?

Python is a computer programming language created initially by Guido Van Rossum, who released it to the world as an “Open Source” “Free”program. It has since then been progressively improved by the contributions of hundreds of computer programmers around the world. The Python package can be downloaded gratis from the internet for every major computing platform in existence. It can be used and even modified for just about any purpose.

Why Python?

There are many computer programming languages in existence. They all have different advantages and disadvantages. The brain of a computer is its processor. No processor understands English. The processor needs to receive input in a format that it understands. Most processors are made to understand commands formatted as a series of zeros “0” and ones “1”. This format is called binary. It is possible to write programs by hand using this format of zeros and ones, but it is very difficult, time consuming, and error prone. That is why computer programming languages have been invented.

Programming languages are frequently categorized as “low level” or “high level”. Low level languages were the first ones to appear. They simplified the process of writing instructions to the computer by allowing the use of normal words to be used in writing the program. A translator program, a “compiler”, translates the program’s instructions into a binary file that can then be understood by the processor. However, low level programming languages are still quite difficult to master. They force the programmer to understand the way the computer works internally. The programmer has to give instructions for every step that the computer must take to handle a certain task, which can easily lead to errors and serious problems. On the other hand, low level programs tend to be quite fast and efficient (if done correctly).

High level languages are designed to make it easier to program on. The instructions look more like normal language. And, a lot of the details are handled by the compiler. This makes for much shorter development time, but can also mean that the program is not as fast and efficient as a program would be if done in a lower level programming language.

Python is a very high level programming language. Many consider it the easiest programming language to learn and to program on. Many common tasks that would normally have to be programmed by the programmer are already built in to the language. Python is very useful as an easy and quick way to program anything from small little scripts to large scale client/server systems. This is especially true with today’s ultra fast computers that make up for the speed disadvantage inherent to high level programming languages. Programmers tend to like Python because of its clean and logical syntax, which shortens development cycles tremendously. It also forces programmers to use code indentation correctly. At first, some programmers see this as a challenge and unnecessary restriction. However, not long after beginning to use it, most programmers realize that it is easy to adjust to it and that it results in very clean code which is easily maintained (even if the code was written by someone else).

Installing Python

To install Python on the N900, just install an aplication that uses Python. For example, pyGTKeditor and/or (any one knows of a good PyQt app for Maemo?).

If you are using Linux, Python should already be installed. On Windows, just go to www.python.org/download/ and get yourself a download of Python 2.6.4, not the latest 3.x, since Python 3.x code is not compatible with the one on the N900. (It is really not too different, but different enough to break things.)

How Python works

Python programs run with the aid of an “interpreter”. The interpreter is a program that converts the code into the binary instructions needed by the processor, at run time. There is an interpreter for each different platform where Python runs. This allows Python code written in a Windows machine, to run unchanged, in a Linux machine, a Macintosh machine, or even a smart phone. Of course, Python also has a lot of “platform specific” features that are optimized for the platform for which they are written. (Avoid these if you don’t want to tie your program down to a specific platform.) The interpreter must, either be installed on the computer that needs to run the Python program, or the Python program must be packaged in conjunction with the interpreter so that it can be run by computers without Python.

The interpreter can be run directly in what is called the “Interactive Command Line”. Python commands can be typed directly into this session and they are processed immediately showing the results of the command. This unique feature allows for quick and easy testing of ideas and code.

Most Python programs, however, are written with some type of text editor, saved as plain text files with a .py extension, and run as an independent process. Since there is no need to “compile” a Python program before running it, a programmer can test its changes to the code immediately after saving them.

The building blocks of a Python program

First of all, what is a “program”? Well, “a program is a sequence of instructions that specifies how to perform a computation.” *i

Enter Python’s interactive mode ( On the N900, open the Terminal application and enter the following command: python), and let’s do our first program as it is traditionally done:

>>> print "Hello World"

Hello World

Here, the word “print” is a built in command or “statement” that sends the given argument to the screen. The second part of the program, what follows the print statement, is the argument itself, in this case, the string “Hello World”. The quote marks tell Python to treat the words inside of them as a string, rather than as a command or a variable. (A “string” is a sequence of characters, like a word, a sentence, etc. They are further explained latter in this section.)

Note:
Typically, in Python manuals and tutorials, when showing python code entered in an interactive session the >>> represents the Python Command Line prompt. When a compound statement is being defined (one that takes more than one line), Python switches to ‘…’ as a prompt.

Note:
Text typed after a # is referred to as a comment, and is ignored by the Python interpreter.

Variables

What is a variable? A variable is a name (a word) that refers to a certain value. We can use almost any word and assign a value to it. For example:

>>> hi = "Hello World"

The word hi is now the name of a variable who’s value is the string "Hello World". Let’s use the print statement to send the value of hi to the screen:

>>> print hi

Hello World

In Python, variables are very flexible. You don’t have to declare them first, like in other languages. You can assign any value to them, even if they already have a value of a different type. For example, let’s change the value of hi to 3.0:

>>> hi = 3.0

>>> print hi

3.0

We can also assign a variable as the value of a variable. For example:

>>> num = hi

>>> print num

3.0

Another neat feature of Python’s interactive shell is that you don’t even have to use the print statement to see the values of variables and other objects. You can simply type their name and Python will display it.

>>> num

3.0

Expressions

At the interactive command prompt one can type expressions and see their result interactively. “An expression is a combination of variables, operators and values that represents a single result value”i. For example:

>>> num + 2

5.0

>>> ((5 – 1) + num) * 2

14.0

We can assign the value of an expression to a variable. Such as:

>>> numb = ((5 – 1) + num) * 2

>>> numb

14.0

Numbers

Notice on this last example that the number returned by Python is a number with a decimal point. In computer terminology this is called a floating point number. Since the expression included a floating point number (3.0), the expression’s value was automatically converted into a floating point number. The reason for the distinction in number types is beyond the scope of this tutorial. In most computer programming languages, one has to be careful to use the right type of number for each application. In Python, it is good to know that there are different types of numbers, but Python will usually deal with the details quite well. The only caveat to currently watch out for is division. Notice this:

>>> 7 / 2

3

Since both numbers in the division are integers (a type of number without decimal places) Python performs an integer division. This may not be what someone new to programming expects. Currently, to work around this one can do things like this:

>>> 7.0 / 2     # or float(7) / 2

3.5

In more recent versions of Python (version 3.x), Python’s designers have decided to change the way this works so that it does what new users would expect. With the current version of Python in Maemo 5 one can already import this behavior from the “__future__” module. We will see more about ‘importing’ latter.

Some common operators associated with numbers are:

There are also many math functions in Python for doing just about any operation needed. Here is a small sample (see the documentation for more). To access them you need to first import them from the math module, like this for example:

from math import acos

A handy tip is that in the Interactive Command Prompt you can recall the last printed expression with the underscore character “_”. So for example, you can use Python as a handy calculator this way:

>>> 2 + 2

4

>>> _ + 6

10

There is also a special Python extension called Numerical Python (NumPy) which allows it to become a tool for higher math functions such as linear algebra and matrices. But, enough of numbers for now.

Strings

We already saw an example of a string in the “Hello World” example. “A string is an ordered collection of characters, used to store and represent text-based information”. Python strings can be enclosed in double, single, or even triple (for multi-line strings) quotes. For example:

>>> 'Hello World'

'Hello World'

>>> "Hello 'Hello World'"

"Hello 'Hello World'"

>>> '''This is a longer string that spans

… several lines, doesn’t say anything

… meaningful, and ends here'''

The fact that strings are “ordered” means that we can access their components by position. Each character in a string has an index position before it. For example the string “Python” has the following indexes:

String Indexes

Notice that the first character “P” is located at index 0, as in programming languages like C, not 1 as in languages like Basic. However, unlike C, with Python you can also use negative indexes, which start counting from the end of the string.

To get the characters located at certain indexes we can use their index number inside brackets. Let’s look at some examples.

To get the character located at the beginning of the string we can use:

>>> "Python"[0]

'P'

Or if we are using a variable:

>>> hw = "Hello World"

>>> hw[0]

'H'

>>> hw[1]

'e'

>>> hw[-1]

'd'

We can also get “slices” of a string by specifying the first and last index of the slice separated by a colon.

>>> hw[1:7]

'ello W'

>>> hw[4:-2]

‘o Wor’

The left or right bounds of the string can be specified in a slice by leaving the index blank. For example:

>>> hw[:5]

'Hello'

>>> hw[6:]

'World'

>>> hw[:]

'Hello World'

Strings are very smart “objects”. They know how to behave correctly in many situations such as:

When adding a string to a string

>>> hw + " Today"

'Hello World Today'

>>> hw[:5] + " You"

'Hello You'

Multiplication

>>> hw[:6] * 5

'Hello Hello Hello Hello Hello '

Notice that in all the operations we have done so far with strings, the operation returns a result but the original string remains unchanged. That is how strings work. A string is what is called an “immutable sequence”. What this means is that to change a string we actually have to create a new string. For example:

Trying to change the value of a string character in place

>>> hw[0] = "M"

Raises an error!

However, since variables are so flexible we can simply assign a new value to it:

>>> hw= "M" + hw[1:]

>>> hw

'Mello World'

This works because the hw[1:] expression is calculated first, then “M” is added to it, and finally the result is assigned as the value of the variable hw.

Another way to join strings with variables is by means of string formatting. For example, what if you had a program that greets the user by name according to the time of day. For example, it could say something like: “Hi Joe. How are you this morning?”. In this case the program could gather the name of the user somehow and place it in a variable called “name”. It could also fetch the time of the day by looking at the computers clock, determine if it is morning, afternoon, or evening, and place the result in a variable called “time_of_day”. You could then have the following line in your program to merge them into a string:

>>> Greeting = "Hi %s. How are you this %s" % (name, time_of_day)

Python replaces the occurrences %s with the respective variable in the tuple after the % character. (A “tuple” is a sequence of items inside a parentheses. Tuples are further explained latter in this book.) Here is another example:

>>> dessert = "Pecan Pie"

>>> max_per_person = 1

>>> answer = "The dessert of the day is %s. You can only take %i per person" % (dessert, max_per_person)

>>> answer

"The dessert of the day is Pecan Pie. You can only take 1 per person"

In this example we added a string variable and an integer variable into the answer string. Strings and integers have different formatting codes (%s, %i). See Python’s documentation for other formatting codes.

Strings also have built-in methods such as the following:

>>> "hello".capitalize()

'Hello'

>>> "HELLO".lower()

'hello'

>>> 'hello'.upper()

'HELLO'

>>> 'Hello World'.replace(" ", "-")     #Replace occurrences of first parameter with second

'Hello-World'

>>> ' Hello World '.lstrip()     #To strip the whitespace at the left of string

'Hello World '

>>> ' Hello World '.rstrip()     #To strip the whitespace at the right of string

' Hello World'

>>> ' Hello World '.strip()     #To strip the whitespace at the left and right

'Hello World'

>>> "This is a longer string".split()

['This', 'is', 'a', 'longer', 'string']

On the last example we see how the split method returns a list of strings. It separates the original string by some given delimiter. When none is given, the default, whitespace, is used. But, what is a list?

Lists

Like strings, lists are ordered sequences. So, they share many of the same functionality. However, lists are mutable sequences, that is we can change them in place. Also, unlike strings, lists can contain any type of object: numbers, strings, even other lists. Much of the simplicity, power, and popularity of Python comes from this built in object type.

To define a list, we simply have to enclose it in square brackets using commas as item delimiters:

>>> L = [1, 2,'three', 4]

The L variable is now a list object. We can use indexes and slices to access its members:

>>> L[0]

'1'

>>> L[2:]

['three', 4]

And, as mentioned before, we can change them in place:

>>> L[2] = 3

>>> L

[1, 2, 3, 4]

>>> L[0] = ['one', 'two', 'three']

>>> L

[['one', 'two', 'three'], 2, 3, 4]

We can also concatenate lists (add them together):

>>> L + [8, 9]

[['one', 'two', 'three'], 2, 3, 4, 8, 9]

And repeat or multiply:

>>> [1, 2, 3] * 3

[1, 2, 3, 1, 2, 3, 1, 2, 3]

We can delete items from lists using the del function:

>>> L = [['one', 'two', 'three'], 2, 3, 4]

del L[1]

L

[['one', 'two', 'three'], 3, 4]

Or even:

del L[0][1]     #Deletes item at index 1 of L[0]

L

[['one', 'three'], 3, 4]

Lists can be sorted and reverse sorted:

>>> L = ['c', 'b', 'a', 1]

>>> L.sort()

>>> L

[1, 'a', 'b', 'c']

>>> L.reverse()

>>> L

['c', 'b', 'a', 1]

Notice that the sort and reverse methods do not return a new sorted list as a result. They simply change the list in place and return a special value called None. To see the results of the sort we have to print the list.

Another little peculiarity to watch out for when using lists is the following:

>>> L1 = [1, 2, 3]

>>> L2 = L1

>>> L2

[1, 2, 3]

>>> L2[0] = 8

>>> L2

[8, 2, 3]

>>> L1

[8, 2, 3]

Notice that changing an item in L2 also changed it in L1. The reason for this is that when we assign L1 as the value of L2 what Python actually does is assign a pointer to L1 as the value of L2. In other words, they are linked. If this is not the desired result, you can avoid it by doing the following:

L2 = L1[:]

Because slices return new lists, assigning a slice of all the items of L1 as the value of L2 results in L2 being a new, independent list, a clone of L1.

So as you can see lists are very easy and friendly to use. In Python lists have a very close relative. Let’s take a look at it now.

Tuples

Tuples are very similar to lists. The difference (and the reason for their existence) is that tuples are immutable. In other words, they can not be changed in place. Other than that everything we saw about lists also applies to tuples.

Tuples are defined by parentheses:

>>> t = (1, 2, 3)

>>> t[1]

2

>>> t[1:]

(2, 3)

Earlier we saw that strings know how to convert themselves to lists using their ’split’ method. We can also convert a string into a tuple with a function called tuple. It works like this:

>>> tuple('some string')

('s', 'o', 'm', 'e', ' ', 's', 't', 'r', 'i', 'n', 'g')

You may wonder when will you ever use tuples, since lists do everything tuples can do and more. Well, among other reasons, since tuples are immutable, they are handy whenever you want to make sure that they do not accidentally get changed by some call. Some built in operations require tuples. And last but not least, tuples make for excellent dictionary keys.

Dictionaries

Dictionaries allow us to collect all kinds of objects just as lists and tuples do. However, rather than fetching them back through the use of index or offset location, dictionaries allow us to fetch their items by keys. So, for each item in a dictionary, there is an accompanying key. Here is a dictionary example:

>>> d = {'key1': 'dog', 2: 'cat', ('key', 'number', 'three'): 'mouse'}

As you can see, dictionaries are enclosed in curly brackets ‘{}’, and each key-value pair is separated by a colon ‘:’. Notice that we can use strings ('key1'), numbers (2), and tuples (('key', 'number', 'three')) as dictionary keys. All of these are immutable type objects. Values can be anything we want: strings, lists, …, and even other dictionaries, which contain other dictionaries, that contain other…. Like lists, dictionaries can be modified in place. However, they are not ordered sequences so, as we said before, we can not use indexes or slices to retrieve their items. It is important to remember that the order in which dictionary items appear is not to be relied upon. Nevertheless, Python offers very simple ways to work with dictionaries. Let’s look at some examples.

Retrieving a value:

>>> d['key1']

'dog'

>>> d[2]

'cat'

Changing the value of a key:

>>> d['key1'] = ['milk', 'cake']

>>> d

{('key', 'number', 'three'): 'mouse', 2: 'cat', 'key1': ['milk', 'cake']}

Notice that on the last example the order of the dictionary items is printed differently than how we entered it. Now let’s add a new entry:

>>> d['new'] = 1.5

>>> d

{('key', 'number', 'three'): 'mouse', 2: 'cat', 'key1': ['milk', 'cake'], 'new': 1.5}

As with lists, to delete an item we can use the del function:

>>> del(d[('key', 'number', 'three')])

>>> d

{2: 'cat', 'key1': ['milk', 'cake'], 'new': 1.5}

Two very important operations that are frequently needed is the ability to retrieve all the keys or all the values contained in a dictionary. Python does this easily:

>>> d.keys()

[2, 'key1', 'new']

>>> d.values()

['cat', ['milk', 'cake'], 1.5]

Notice that in both instances Python returns a list of the items we requested. This is handy because we can then use any of the functions and methods associated with lists, such as sort and reverse, to arrange them in the order that we want. We could then iterate through each item in the right order, in spite of the fact that dictionaries are unordered collections. You may now wonder, what is to iterate? This brings us to our next major subject.

How to program in Python

In this section we are going to see how we can use the different data and object types that we have already covered, as well as a few others, to put together full scale programs.

Up to now all we have done is review some of the main object types available in Python using quick little one line expressions that do a single operation. However, the real power of computer programming is its ability to have the computer do multiple things for us with one simple command on our part. The concept of iteration is a good example of this.

Iteration is “the process of repeating a set of instructions a specified number of times or until a specific result is achieved. For example if we had a list with five items and we wanted to print each one of them, we could manually type five lines of code that would print each item. But what if we did not know how many items the list contained at any particular time, or what if the list contained hundreds of items? Well, actually the solution is very simple. This is how we would do it in Python:

“for” Loops

As we have seen already, lists can be of any length we desire. Lets see what we can do with a little list of 5 items.

>>> L = [1, 2, 3, 4, 5]

>>> for i in L:

…     print i

1

2

3

4

5

What we are doing is iterating through the list L, assigning a temporary variable named i (can be whatever you want) for each item in L, and printing it. Here is another example:

>>> students = ['John', 'Peter', 'Jeremy', 'Carly']

>>> for student in students:

…     print "You are a very good student, %s. " %(student)

…

You are a very good student, John.

You are a very good student, Peter.

You are a very good student, Jeremy.

You are a very good student, Carly.

This construct is called a for loop. It is the first compound statement that we look at. Notice that the first line, the header, of the loop terminates in a colon. Notice also that the second line of each of the two examples above, are indented. This is very important, as we will see later. The body of a for loop doesn’t have to be limited to one line. It can contain as many lines of commands as desired. It will execute all the commands of the body for each iteration, unless otherwise told in the code.

It is important to understand that the for loop is a sequence iterator. It can iterate through ordered sequence items, such as strings, lists, tuples, etc. This will carry you a long way in your programming needs. However, there is another way to iterate or repeat a series of commands. But before we see it, you need to understand another important concept.

“truth” Tests

In computer programming, certain expressions evaluate, to either truth or false. For example, we know that it is true that 5 is greater than 4. Python knows that too, and this is how Python expresses that:

>>> 5 > 4

1

As you can see, the expression 5 > 4 returned a value of 1. In programming, when evaluating the truthfulness of an expression, 1 is the common value for true and 0 is the common value for false. For example:

>>> 4 == 5

0

On this example you can see that to evaluate the equality of two values we used two equal signs rather than one. This is because, as we saw earlier, one equal sign is the assignment operator. So remember to use two equal signs when evaluating equality.

Besides math operations, Python recognizes other expressions as either true or false. For example, empty data types, like an empty string, list, etc, evaluate to false. There are also many operators that can be used inside a truth test expression. See the Python documentation for these if you are interested.

You will understand truth tests better by seeing them in action. So, let’s dive into our second method of iteration.

“while” Loops

A while loop repeats a set of commands until some terminating condition is met. They may never execute the body of the loop if the terminating condition is false to start with. Here is a basic example:

>>> x = 1

>>> while x < 10:

…     print x,

…     x = x + 1

1 2 3 4 5 6 7 8 9

Here you can see that the condition that we test for is whether x is less than 10. This little loop will continue repeating itself until that condition is false. You may also notice that by adding a comma at the end of a print statement it does not print a new line character after each print. So, all the numbers are printed in the same line.

One important lesson to remember with while loops is that, unless you want the loop to run forever, you should be sure that the condition will eventually be false. Let’s just look at another simple example to solidify your understanding:

>>> s = 'Something'

>>> while s:

…     print s,

…     s = s[1:]     # Removes the first character of the string

'Something' 'omething' 'mething' 'ething' 'thing' 'hing', 'ing', 'ng', 'g'

In this case, once the string is empty, the while loop stops because s evaluates to false.

So, as we can see, without truth tests while loops would not be possible. However, there is an even more basic programming feature where truth tests play a key role. With it we will be able to start adding real intelligence to our programs.

“if” Statements

The if statement allows our programs to select a course of action depending on whether or not a certain condition exists. The if statement is the third multi-line or compound statement that we look at. Let’s look at an example:

>>> if 5 > 4:

…     print "Life is good"

As in the previous compound statements, if statements have a header. The header begins with the if word itself followed by the expression that is to be evaluated, and ends with a colon. Again the body of the statement is indented.

Let’s look at a more realistic example:

>>> first_name = 'Bob'

>>> last_name = ''

>>> Greeting = 'Hello %s %s' % (first_name, last_name)

>>> if first_name and last_name:

…     print Greeting

In this example we can see that the Greeting would only be printed if both first_name and last_name evaluate to true. Since, in this case, last_name is an empty string it will evaluate to false, and the Greeting will not be printed. Python will simply continue to its next command outside of the body of the if statement. Let’s look at another example:

age = int(raw_input("How old are you? "))     #The int function returns its input as integer.

gender = raw_input("Are you male or female? ")

if age >= 13 and age <= 19:

    if gender.capitalize() == "Male":

        print "You are a teenage boy."

    else:

        print "You are a teenage girl."

The raw_input function allows us to get input from the user. If we type those commands in a file named test.py and ran it as a script from the Command Prompt (e.g.: ~\somedirectory>python test.py) we would get the following output:

How old are you? 15

Are you male or female? Male

You are a teenage boy.

Here we can see that if statements can be nested inside other if statements. The same is true for any other compound statement. You can nest compound statements as deep as you like. In this example we also see that an else statement can be used in conjunction with an if statement. An if/else combination allows the program to decide between two courses of action. Only one of the two will be executed. A similar construct is the elif statement (which stands for “else if”) which allows the program to choose from any number of ways to proceed depending on which condition is found to match first. For example:

>>> if day == "Saturday":

…     print "Happy day"

… elif day == "Sunday":

…     print "Weekend is almost over."

… elif month != "August":

…     print "Today is not an August weekend"

… elif hour > 22:

…     print "Time to go to bed"

… else:

…     print "Today is not a weekend, it is August and I still have time to do something"

With if statements we can give our programs many options to select from. It will check each one in order and select the first one that returns a true evaluation. Notice that the “not equal” operator (!=) returns a true evaluation if the Month variable is anything other than “August”. Something to watch out for in this kind of construct is that the “Time to go to bed” string will not get printed even if it is past 10:00 p.m., unless all the previous options were false. And finally, notice that we ended the sequence of statements with an else block. This one will get executed for sure once all the previous options proved false.

So, as you can see, truth tests in conjunction with if/elif/else statements can be very powerful in helping you express the logic of your program. The if statement is very often found inside while and for loops to change the flow of operation of the loop or to exit the loop if a certain condition is found. Let’s look at an example:

>>> L = ["mouse","", "cat", "dog", "parrot"]

>>> for animal in L:

…     if animal == "dog":

…         print "Dogs are not allowed"

…         break

…     elif animal == "":

…         pass

…     else:

…         print "What a nice %s you have" %(animal)

…

What a nice mouse you have

What a nice cat you have

Dogs are not allowed

The break statement is used to exit the current loop. If the loop of this example had been inside another loop, the break statement would have simply continued to the next iteration of the outer loop. The pass keyword simply tells Python to do nothing. Again, notice the all important use of indentation to correctly identify the end of nested statements.

What we have covered so far is enough for you to be able to write very rich and powerful programs. However, we have just touched the most basic elements of computer programming. There are a few more concepts to learn in order to take full advantage of what can be done in Python. We will look at them in Python for Newbies – Part 2.

On the N900, it is possible to run a terminal program like ‘top’ directly from the Desktop/Shortcut. The following example creates a shortcut to launch the system monitior program ‘top’.

1. Use a text-editor like vi or Leafpad to create a file with the following text:

[Desktop Entry]
Encoding=UTF-8
Version=0.1
Type=Application
Terminal=true
Name=topx
Exec=/usr/bin/osso-xterm top
Icon=
X-Window-Icon=
X-HildonDesk-ShowInToolbar=true
X-Osso-Type=application/x-executable

2. Save the file as topx.desktop.

3. As root, copy the file to the ‘/usr/share/applications/hildon/’ directory. This will create an ugly blue application icon in the Application list called ‘topx’.

Launching ‘topx’ will execute ‘top’ directly in xterm. You may now put a shortcut on the desktop for quick access. The not-so-great part of this desktop-shortcut is that it displays the default icon.

Now we have some interesting news for you all

Here are the pictures showing N900 can be used in portrait mode too, So it seems like they have already implemented and now taking their time to make it work flawless on accelerometer

It just matter of weeks to get the portrait mode working.

Here is the video

http://share.ovi.com/media/Guyver95.PortraitMode/Guyver95.10009?sort=0

Source