Μαθήματα Python - Μετάφραση Διδασκόμενης Ύλης

[dimosfire]

@chris
αυτό που αναφέρεις είναι το κεφάλαιο 17 (Περισσότερα) εγώ έχω αναλάβει το κεφάλαιο 16 (Πρότυπη βιβλιοθήκη).Εάν δεν μπορείς να συνεχίσεις λόγω υποχρεώσεων, μπορείς να το αναφέρεις στο forum για να το αναλάβει κάποιος άλλος. Ο Μάριος Ζηντίλης που συντονίζει την παρούσα μετάφραση πιστεύω μπορεί να το ρυθμίσει. Εγώ ούτε τις γνώσεις έχω, ούτε είμαι αρμόδιος, απλά μια μετάφραση κάνω στον ελεύθερο χρόνο μου για να βοηθήσω όσο μπορώ, επειδή από την πρώτη μέρα που συμμετείχα στο forum με βοήθησαν τα παιδιά και έτσι έμαθα πολλά πράγματα.

[atermon]

Ολοκληρώθηκε και είναι διαθέσιμο online προς επιμέλεια το 13ο κεφάλαιο.

[atermon]

Να δεσμεύσω και κάτι εύκολο; Το Παράρτημα ΕΛΛΑΚ, κεφάλαιο 20;

[atermon]

Και μια πρόταση προς τη μεταφραστική ομάδα:
Ζήτησα από το Μάριο να αφαιρέσει το nick μου και στη θέση του να προσθέσει το ονοματεπώνυμό μου. Θα θέλανε και οι υπόλοιποι να "μνημονευτούν" επίσης επώνυμα; Είναι σημαντική η αναφορά στους δημιουργούς και τους μεταφραστές (Creative Commons: attribution), ώστε ο κόπος αυτός να είναι ενυπόγραφος.
Τι λέτε;

[atermon]

Ολοκληρώθηκε και είναι διαθέσιμο προς επιμέλεια το κεφάλαιο 20. Καλή ανάγνωση!

[dimosfire]

Καλησπέρα παιδιά υποβάλω το κεφάλαιο 16:

Κώδικας: Επιλογή όλων

Introduction

The Python Standard Library contains a huge number of useful modules and is part of every standard Python installation. It is important to become familiar with the Python Standard Library since many problems can be solved quickly if you are familiar with the range of things that these libraries can do.

We will explore some of the commonly used modules in this library. You can find complete details for all of the modules in the Python Standard Library in the 'Library Reference' section of the documentation that comes with your Python installation.

Let us explore a few useful modules.

Note
If you find the topics in this chapter too advanced, you may skip this chapter. However, I highly recommend coming back to this chapter when you are more comfortable with programming using Python.

sys module

The sys module contains system-specific functionality. We have already seen that the sys.argv list contains the command-line arguments.

Suppose we want to check the version of the Python command being used so that, say, we want to ensure that we are using at least version 3. The sys module gives us such functionality.

>>> import sys
>>> sys.version_info
(3, 0, 0, 'beta', 2)
>>> sys.version_info[0] >= 3
True

How It Works:

The sys module has a version_info tuple that gives us the version information. The first entry is the major version. We can check this to, for example, ensure the program runs only under Python 3.0:

#!/usr/bin/python
# Filename: versioncheck.py
import sys, warnings
if sys.version_info[0] < 3:
warnings.warn("Need Python 3.0 for this program to run",
RuntimeWarning)
else:
print('Proceed as normal')

Output:

$ python2.5 versioncheck.py
versioncheck.py:6: RuntimeWarning: Need Python 3.0 for this program to run
RuntimeWarning)

$ python3 versioncheck.py
Proceed as normal

How It Works:

We use another module from the standard library called warnings that is used to display warnings to the end-user. If the Python version number is not at least 3, we display a corresponding warning.
logging module

What if you wanted to have some debugging messages or important messages to be stored somewhere so that you can check whether your program has been running as you would expect it? How do you "store somewhere" these messages? This can be achieved using the logging module.

#!/usr/bin/python
# Filename: use_logging.py
import os, platform, logging

if platform.platform().startswith('Windows'):
logging_file = os.path.join(os.getenv('HOMEDRIVE'), os.getenv('HOMEPATH'), 'test.log')
else:
logging_file = os.path.join(os.getenv('HOME'), 'test.log')

print("Logging to", logging_file)

logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s : %(levelname)s : %(message)s',
filename = logging_file,
filemode = 'w',
)

logging.debug("Start of the program")
logging.info("Doing something")
logging.warning("Dying now")

Output:

$python use_logging.py
Logging to C:\Users\swaroop\test.log

If we check the contents of test.log, it will look something like this:

2008-09-03 13:18:16,233 : DEBUG : Start of the program
2008-09-03 13:18:16,233 : INFO : Doing something
2008-09-03 13:18:16,233 : WARNING : Dying now

How It Works:

We use three modules from the standard library - the os module for interacting with the operating system, the platform module for information about the platform i.e. the operating system and the logging module to log information.

First, we check which operating system we are using by checking the string returned by platform.platform() (for more information, see import platform; help(platform)). If it is Windows, we figure out the home drive, the home folder and the filename where we want to store the information. Putting these three parts together, we get the full location of the file. For other platforms, we need to know just the home folder of the user and we get the full location of the file.

We use the os.path.join() function to put these three parts of the location together. The reason to use a special function rather than just adding the strings together is because this function will ensure the full location matches the format expected by the operating system.

We configure the logging module to write all the messages in a particular format to the file we have specified.

Finally, we can put messages that are either meant for debugging, information, warning or even critical messages. Once the program has run, we can check this file and we will know what happened in the program, even though no information was displayed to the user running the program.
urllib and json modules

How much fun would it be if we could write our own program that will get search results from the web? Let us explore that now.

This can be achieved using a few modules. First is the urllib module that we can use to fetch any webpage from the internet. We will make use of Yahoo! Search to get the search results and luckily they can give us the results in a format called JSON which is easy for us to parse because of the built-in json module in the standard library.

TODO
This program doesn't work yet which seems to be a bug in Python 3.0 beta 2.

#!/usr/bin/python
# Filename: yahoo_search.py

import sys
if sys.version_info[0] != 3:
sys.exit('This program needs Python 3.0')

import json
import urllib, urllib.parse, urllib.request, urllib.response

# Get your own APP ID at http://developer.yahoo.com/wsregapp/
YAHOO_APP_ID = 'jl22psvV34HELWhdfUJbfDQzlJ2B57KFS_qs4I8D0Wz5U5_yCI1Awv8.lBSfPhwr'
SEARCH_BASE = 'http://search.yahooapis.com/WebSearchService/V1/webSearch'

class YahooSearchError(Exception):
pass

# Taken from http://developer.yahoo.com/python/python-json.html
def search(query, results=20, start=1, **kwargs):
kwargs.update({
'appid': YAHOO_APP_ID,
'query': query,
'results': results,
'start': start,
'output': 'json'
})
url = SEARCH_BASE + '?' + urllib.parse.urlencode(kwargs)
result = json.load(urllib.request.urlopen(url))
if 'Error' in result:
raise YahooSearchError(result['Error'])
return result['ResultSet']

query = input('What do you want to search for? ')
for result in search(query)['Result']:
print("{0} : {1}".format(result['Title'], result['Url']))

Output:

TODO

How It Works:

We can get the search results from a particular website by giving the text we are searching for in a particular format. We have to specify many options which we combine using key1=value1&key2=value2 format which is handled by the urllib.parse.urlencode() function.

So for example, open this link in your web browser and you will see 20 results, starting from the first result, for the words "byte of python", and we are asking for the output in JSON format.

We make a connection to this URL using the urllib.request.urlopen() function and pass that file handle to json.load() which will read the content and simultaneously convert it to a Python object. We then loop through these results and display it to the end-user.
[edit] Module of the Week Series

There is much more to be explored in the standard library such as debugging, handling command line options, regular expressions and so on.

The best way to further explore the standard library is to read Doug Hellmann's excellent Python Module of the Week series.
Summary

We have explored some of the functionality of many modules in the Python Standard Library. It is highly recommended to browse through the Python Standard Library documentation to get an idea of all the modules that are available.

Next, we will cover various aspects of Python that will make our tour of Python more complete.

και η μετάφρασήτου:

Κώδικας: Επιλογή όλων

Πρότυπη βιβλιοθήκη

Εισαγωγή
Η πρότυπη βιβλιοθήκη της Python περιέχει έναν τεράστιο αριθμό χρήσιμων αρθρωμάτων και είναι μέρος κάθε πρότυπης εγκατάστασης Python. Είναι σημαντικό να εξοικειωθείτε με την πρότυπη βιβλιοθήκη, επειδή πολλά προβλήματα μπορούν να λυθούν γρήγορα εάν είστε εξοικειωμένοι με το εύρος των πραγμάτων που μπορούν να κάνουν οι βιβλιοθήκες.
Θα εξερευνήσουμε μερικά από τα πιο συνηθισμένα αρθρώματα σε αυτή τη βιβλιοθήκη. Μπορείτε να βρείτε ολοκληρωμένες λεπτομέρειες για όλα τα αρθρώματα της πρότυπης βιβλιοθήκης, στο 'Library Reference' section της τεκμηρίωσης (documentation) που συνοδεύει κάθε εγκατάσταση της Python.
Aς εξερευνήσουμε μερικά χρήσιμα αρθρώματα.

Σημείωση
Εάν βρείτε τα θέματα σε αυτό το κεφάλαιο πολύ προχωρημένα (advanced) μπορείτε να παραλείψετε αυτό το κεφάλαιο. Πάντως, εγώ σας συνιστώ να επιστρέψετε σε αυτό το κεφάλαιο, όταν νιώθετε πιο άνετα προγραμματίζοντας με Python.

Το άρθρωμα sys
To άρθρωμα sys περιέχει σύστημα ειδικών λειτουργιών (system-specific functionality). Έχουμε ήδη δει ότι η λίστα sys.argv περιέχει τα ορίσματα της γραμμής εντολών.
Υποθέτουμε ότι θέλουμε να ελέγξουμε την έκδοση της Python που χρησιμοποιεί το σύστημά μας, έτσι ώστε να επιβεβαιώσουμε ότι χρησιμοποιούμε τουλάχιστον την έκδοση 3. Το άρθρωμα sys μας δίνει αυτή τη λειτουργία.

>>> import sys
>>> sys.version_info
(3, 0, 0, 'beta', 2)
>>> sys.version_info[0] >= 3
True
Πως δουλεύει:
Tο άρθρωμα sys έχει την πλειάδα version_info που μας δίνει την πληροφορία για την έκδοση. Η πρώτη είσοδος είναι η κύρια έκδοση. Αυτό μπορούμε να το ελέγξουμε, για παράδειγμα, για να επιβεβαιώσουμε ότι το πρόγραμμα τρέχει μόνο υπό την Python 3.0:


#!/usr/bin/python
# Filename: versioncheck.py
import sys, warnings
if sys.version_info[0] < 3:
warnings.warn("Need Python 3.0 for this program to run",
RuntimeWarning)
else:
print('Proceed as normal')
Έξοδος:
$ python2.5 versioncheck.py
versioncheck.py:6: RuntimeWarning: Need Python 3.0 for this program to run
RuntimeWarning)

$ python3 versioncheck.py
Proceed as normal
Πως δουλεύει:
Χρησιμοποιούμε ένα άλλο άρθρωμα από την πρότυπη βιβλιοθήκη που ονομάζεται warnings, που χρησιμοποιείται για να εμφανίσει προειδοποιήσεις στον τελικό χρήστη. Εάν το νούμερο της έκδοσης Python δεν είναι τουλάχιστον 3, εμφανίζουμε την αντίστοιχη προειδοποίηση.

Το άρθρωμα logging
Tι θα κάνατε εάν θέλατε να έχετε μερικά μηνύματα εκσφαλμάτωσης ή να αποθηκεύσετε κάπου σημαντικά μηνύματα, έτσι ώστε να μπορείτε να ελέγξετε εάν το πρόγραμμά σας έχει τρέξει όπως θα περιμένατε; Πως “αποθηκεύετε κάπου” αυτά τα μηνύματα; Αυτό μπορεί να επιτευχθεί χρησιμοποιώντας το άρθρωμα logging:


#!/usr/bin/python
# Filename: use_logging.py
import os, platform, logging
 
if platform.platform().startswith('Windows'):
logging_file = os.path.join(os.getenv('HOMEDRIVE'), os.getenv('HOMEPATH'), 'test.log')
else:
logging_file = os.path.join(os.getenv('HOME'), 'test.log')
 
print("Logging to", logging_file)
 
logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s : %(levelname)s : %(message)s',
filename = logging_file,
filemode = 'w',
)
 
logging.debug("Start of the program")
logging.info("Doing something")
logging.warning("Dying now")
Έξοδος:
$python use_logging.py
Logging to C:\Users\swaroop\test.log
Εάν ελέγξουμε τα περιεχόμενα του test.log, θα φαίνεται κάπως έτσι:
2008-09-03 13:18:16,233 : DEBUG : Start of the program
2008-09-03 13:18:16,233 : INFO : Doing something
2008-09-03 13:18:16,233 : WARNING : Dying now
Πως δουλεύει:
Χρησιμοποιούμε τρία αρθρώματα από την πρότυπη βιβλιοθήκη- το άρθρωμα os για αλληλεπίδραση με το λειτουργικό σύστημα, το άρθρωμα platform για πληροφορίες σχετικά με την πλατφόρμα (platform) δηλ. το λειτουργικό σύστημα και το άρθρωμα logging για τις πληροφορίες ημερολογίου (log).
Αρχικά, ελέγχουμε ποιο λειτουργικό σύστημα χρησιμοποιούμε, ελέγχοντας τη συμβολοσειρά που επιστρέφει από την platform.platform() (για περισσότερες πληροφορίες, δείτε την import platform;help(platform)). Εάν είναι Windows εμφανίζουμε τον home drive, το φάκελο home και το όνομα του αρχείου (filename) όπου θέλουμε να αποθηκεύσουμε τις πληροφορίες. Τοποθετώντας αυτά τα τρία μέρη μαζί, παίρνουμε την ολοκληρωμένη θέση του αρχείου. Για άλλες πλατφόρμες, απαιτείται να ξέρουμε μόνο το φάκελο home του χρήστη και παίρνουμε την πλήρη θέση του αρχείου. Χρησιμοποιούμε τη συνάρτηση os.path.join() για να τοποθετήσουμε αυτά τα τρία μέρη της θέσης του αρχείου μαζί. Ο λόγος για τον οποίο χρησιμοποιούμε μια ειδική συνάρτηση, αντί να προσθέσουμε απλά τις συμβολοσειρές μαζί, είναι διότι αυτή η συνάρτηση θα επιβεβαιώσει ότι η πλήρης θέση ταιριάζει με το μορφότυπο (format) που αναμένεται από το λειτουργικό σύστημα. Ρυθμίζουμε το άρθρωμα logging για να γράψουμε όλα τα μηνύματα σε ένα ιδιαίτερο μορφότυπο στο αρχείο που έχουμε καθορίσει.
Τελικά, μπορούμε να βάλουμε μηνύματα που είτε σημαίνουν εκσφαλμάτωση, πληροφορία, προειδοποίηση, είτε κρίσιμα μηνύματα. Άπαξ και το πρόγραμμα έχει τρέξει, μπορούμε να ελέγξουμε αυτό το αρχείο και θα γνωρίζουμε τι συνέβει στο πρόγραμμα, ακόμα κι αν καμμία πληροφορία δεν εμφανίστηκε στον χρήστη (user) που τρέχει το πρόγραμμα.

Τα αρθρώματα urllib και json
Πόσο αστείο θα ήταν εάν μπορούσαμε να γράψουμε το δικό μας πρόγραμμα που θα έψαχνε για αποτελέσματα στο διαδίκτυο; Ας το εξερευνήσουμε τώρα.
Αυτό μπορεί να επιτευχθεί χρησιμοποιώντας μερικά αρθρώματα. Αρχικά είναι το άρθρωμα urllib, το οποίο μπορούμε να χρησιμοποιήσουμε για να “πιάσουμε” οποιαδήποτε σελίδα (webpage) από το διαδίκτυο. Θα χρησιμοποιήσουμε το Yahho! Search για να πάρουμε τα αποτελέσματα της αναζήτησης και ευτυχώς μπορούν να μας δώσουν τα αποτελέσματα σε ένα μορφότυπο που ονομάζεται JSON, ο οποίος είναι εύκολο για εμάς να αναλύσουμε, επειδή υπάρχει το ενσωματωμένο άρθρωμα json στην πρότυπη βιβλιοθήκη.

TODO
Αυτό το πρόγραμμα δεν δουλεύει ακόμα και φαίνεται ότι είναι σφάλμα (bug) στην Python 3.0 beta 2.
#!/user/bin/python
# Filename: yahoo_search.py
 
import sys
if sys.version_info[0] != 3:
sys.exit('This program needs Python 3.0')
 
import json
import urllib, urllib.parse, urllib.request, urllib.response
 
# Get your own APP ID at http://developer.yahoo.com/wsregapp/
YAHOO_APP_ID = 'jl22psvV34HELWhdfUJbfDQzlJ2B57KFS_qs4I8D0Wz5U5_yCI1Awv8.lBSfPhwr'
SEARCH_BASE = 'http://search.yahooapis.com/WebSearchService/V1/webSearch'
 
class YahooSearchError(Exception):
pass
# Taken from http://developer.yahoo.com/python/python-json.html
def search(query, results=20, start=1, **kwargs):
kwargs.update({
'appid': YAHOO_APP_ID,
'query': query,
'results': results,
'start': start,
'output': 'json'
})
url = SEARCH_BASE + '?' + urllib.parse.urlencode(kwargs)
result = json.load(urllib.request.urlopen(url))
if 'Error' in result:
raise YahooSearchError(result['Error'])
return result['ResultSet']
 
query = input('What do you want to search for? ')
for result in search(query)['Result']:
print("{0} : {1}".format(result['Title'], result['Url']))
Έξοδος:
TODO

Πως δουλεύει:
Μπορούμε να πάρουμε τα αποτελέσματα της αναζήτησης από ένα ιδιαίτερο δικτυακό τόπο (website), δίνοντας το κείμενο που ψάχνουμε σε ένα ιδιαίτερο μορφότυπο. Πρέπει να καθορίσουμε πολλές επιλογές, που συνδυάζουμε χρησιμοποιώντας το μορφότυπο key1=value1 & key2=value2, ο οποίος χειρίζεται από τη συνάρτηση urllib.parse.urlencode( ).
Έτσι για παράδειγμα, ανοίξτε αυτό το σύνδεσμο (link) στο φυλλομετρητή σας (web browser) και θα δείτε 20 αποτελέσματα, αρχίζοντας από το πρώτο αποτέλεσμα, για τις λέξεις “byte of python”, και ζητάμε την έξοδο στο μορφότυπο JSON. Kάνουμε σύνδεση σε αυτή τη διεύθυνση (URL) χρησιμοποιώντας τη συνάρτηση urllib.request.urlopen( ) και περνούμε αυτό το αρχείο να χειριστεί με το json.load( ), το οποίο θα διαβάσει το περιεχόμενο και ταυτόχρονα θα το μετατρέψει σε αντικείμενο της Python. Τότε κάνουμε βρόχο μέσω αυτών των αποτελεσμάτων και το παρουσιάζουμε στον τελικό χρήστη.

Άρθρωμα της εβδομαδιαίας σειράς (Module of the Week Series)
Υπάρχουν πολλά περισσότερα για να εξερευνηθούν στην πρότυπη βιβλιοθήκη όπως η εκσφαλμάτωση , ο χειρισμός επιλογών της γραμμής εντολών, οι κανονικές εκφράσεις κ.τ.λ.
Ο καλύτερος τρόπος για να εξερευνήσετε περισσότερο την πρότυπη βιβλιοθήκη είναι, διαβάζοντας την υπέροχη σειρά του Doug Hellmann's, Python Module of the Week.

Σύνοψη
Έχουμε εξερευνήσει μερικές λειτουργίες από πολλά αρθρώματα της πρότυπης βιβλιοθήκης της Python. Συνιστάται να πλοηγηθείτε στην τεκμηρίωση της Python Standard Library, για να πάρετε μια ιδέα από όλα τα αρθρώματα που είναι διαθέσιμα.
Κατόπιν θα καλύψουμε διάφορες πτυχές της Python, που θα κάνουν το ταξίδι μας στην Python πιο ολοκληρωμένο.

[dimosfire]

Επειδή δεν το σκέφτηκα από την αρχή το άφησα για το τέλος. Τώρα που έχουν τελειώσει όλα τα κεφάλαια θα ανεβάσω όσες λέξεις κρίνω ότι πρέπει να μπουν στο γλωσσάρι, από τα κεφάλαια που έχω μεταφράσει, για να τις μεταφέρετε εκεί. Καλή συνέχεια σε όλους.

[logari81]

http://www.swaroopch.com/notes/Python_e ... F%83%CE%B7

εδω περα θα ήθελα να αλλαξω το "δε χρειάζεται" σε "δεν χρειάζεται" αλλα δεν μπορώ να κανω edit την πρώτη παραγραφο, γιατί;

Επίσης κατι αλλο που θα ήθελα να συζητησω ειναι το

δυαδικά πακέτα

δεν θα ήταν ορθότερο ως "μεταγλωτισμενα πακέτα" ή κάτι ανάλογο;

[greatst]

http://www.swaroopch.com/notes/Python_el:%CE%95%CE%B3%CE%BA%CE%B1%CF%84%CE%AC%CF%83%CF%84%CE%B1%CF%83%CE%B7

εδω περα θα ήθελα να αλλαξω το "δε χρειάζεται" σε "δεν χρειάζεται" αλλα δεν μπορώ να κανω edit την πρώτη παραγραφο, γιατί;

Επίσης κατι αλλο που θα ήθελα να συζητησω ειναι το

δυαδικά πακέτα

δεν θα ήταν ορθότερο ως "μεταγλωτισμενα πακέτα" ή κάτι ανάλογο;

Εάν το αρχικό ήταν binary packages το δυαδικά πακέτα το βρίσκω μια χαρά!

[Μάριος Ζηντίλης]

Το "δε χρειάζεται" είναι σωστό. Όταν λες δε μπορείς να επεξεργαστείς την πρώτη παράγραφο τι εννοείς; Σου δίνει για επεξεργασία μόνο το υπόλοιπο κείμενο; Αυτό μπορεί να συμβαίνει γιατί πατάς κάποιο σύνδεσμο Edit μέσα στο κείμενο αντί από την αριστερή στήλη.