Елементарен проблем

world.py:

""" A module for playing with the world. """
def destroy():
    """Destroys the world."""
    print "The world was destroyed!"

def save(kind):
    """Saves a kind."""
    print "All the", kind, "were saved."

Искаме да ползваме горните функции в много програми, а не искаме да копираме кода във всяка от тях.

Области от имена (1)

• Всяка програма е модул сама по себе си и всички глобални имена, са негови атрибути
• savepoohs.py:

• import world
  def savePoohs():
      world.save('Poohs')
  insane = True
  print dir()

• Ще отпечата: [<системни атрибути> 'world', 'savePoohs', 'insane']

Области от имена (2)

• В различни модули можем да имаме едни и същи имена
• Всеки модул си има различен набор от имена

• import pooh
  import piglet
  def breakfast():
      print "Is it already eleven?"
  pooh.breakfast()
  piglet.breakfast()
  breakfast()

Ако използваме модули няма нужда да се притесняваме, че в няколко програми сме използвали едни и същи имена.

Модули и обхвати

• Глобалните променливи са на практика модулни променливи. Те са глобални само в рамките на модула, в който се намират.
• mod.py:

• bottles = 1
  def addBottle():
      global bottles
      bottles += 1

• bottler.py:

• import mod
  bottles = 5
  mod.addBottle()
  print bottles, mod.bottles

Търсене на файла

import mod

Търси се в:

1. текущата директория
2. променливата на средата PYTHONPATH
3. системни директории с модули
4. директории, описани в .pth файлове

Всички по реда на претърсване: списъка sys.path

Модул vs. Програма

• И в двата случая кодът ни се изпълнява
• Искаме ако кодът ни е бил изпълнен директно да тестваме модула си
• Искаме ако кодът ни е бил включен с import само да дефинираме фукнциите си
• eater.py:

• def eat(what):
      print what, "was eaten."
      
  if __name__ == '__main__':
      eat('The world as we know it')

• $ python eater.py
The world as we know it was eaten.
• >>> import eater

Пакети от модули

Представете си, че имаме две отделни системи, в които има модул на име game

system1/
	game.py
	<други модули>
system2/
	game.py
	<други модули>

Сега напишете система, която използва модулите game и от двете други:

Тук вече имаме малък проблем.

Пакети от модули (2)

Би било много удобно ако можехме да разделим двата модула game в отделни пакети:

import system1.game
import system2.game
system1.game.play()
system2.game.play()

Това е възможно при няколко условия:

• директориите system1 и system2 са някъде из пътя за търсене на python
• във всяка от тях има файл с име __init__.py

При import на по-сложно име се извършва следното:

• намира се поредната компонента от пътя (разделени с точки)
• ако има съответстващ файл — включва се
• ако е директория — изпълнява се __init__.py в нея

Пакети от модули (3)

С пакети от модули можем с едни замах да import-нем много модули:

forest/pooh.py:

forest/piglet.py:

forest/__init__.py:

import pooh
import piglet

import forest
print forest.pooh.name
print forest.piglet.name

import

• import mod — намира се модула и обектът му се присвоява на името mod

• sys = '/usr/src/sys'
  import os
  def listByExt(path, ext):
  	return [d for d in os.listdir(path) if d.endswith('.'+ext)]
  
  # искаме да отпечатаме sys.path
  import sys
  print sys.path
  
  # сега да видим всички питонски файлове в /usr/src/sys
  print listByExt(sys, 'py')
  # опс:
  TypeError: coercing to Unicode: need string or buffer, module found