07. Модули

2 април 2014

Модули 101

Всяко нещо в Python е част от някой модул
Дори нещата, които пишем в интерактивната конзола, са в модул
Всеки файл с разширение .py е модул. Името на модула е името на файла (без .py)
Всяка директория може да бъде модул
Файлът, от който е стартирана програмата, е с име __main__

.pyc

.pyc са прекомпилирани версии на .py файловете ни
В Python 3 стоят в директорията __pycache__
В Python 2 стоят до .py файловете
Можем да ги дезактивираме генерално
Не мислим за тях
(освен при version control)

import

Всеки модул се импортва само по веднъж
При импортването му се изпълнява целият файл

В този ред на мисли, показвали ли сме ви това:

import __hello__

Модули

from module import a, b, c
a()

Модули

from module import a, b, c
a()

from module import a as b
b()

Модули

from module import a, b, c
a()

from module import a as b
b()

from django.contrib.auth.models import User
my_user = User()

Модули

from django.db import models
my_model = models.Model()

Модули

import datetime
now = datetime.datetime.now()

if name == "main":

Така можете да сте сигурни, че текущият файл е изпълнен, а не импортнат

Search Path

"вградените модули"
текущата директория
sys.path

Search Path

import sys
print(sys.path)

dir()

Връща списък със всички имена в модул

import sys
dir(sys)
['__displayhook__', '__doc__', '__excepthook__', '__interactivehook__',
'__loader__', '__name__', '__package__', '__spec__', '__stderr__',
'__stdin__', '__stdout__', '_clear_type_cache', '_current_frames',
'_debugmallocstats', '_getframe', '_home', '_mercurial', '_xoptions',
'abiflags', 'api_version', 'argv', 'base_exec_prefix', 'base_prefix',
'builtin_module_names', 'byteorder', 'call_tracing', 'callstats',
'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',
'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',
'float_repr_style', 'getallocatedblocks', 'getcheckinterval',
'getdefaultencoding', 'getdlopenflags', 'getfilesystemencoding',
'getprofile', 'getrecursionlimit', 'getrefcount', 'getsizeof',
'getswitchinterval', 'gettrace', 'hash_info', 'hexversion',
'implementation', 'int_info', 'intern', 'maxsize', 'maxunicode',
'meta_path', 'modules', 'path', 'path_hooks', 'path_importer_cache',
'platform', 'prefix', 'ps1', 'ps2', 'setcheckinterval', 'setdlopenflags',
'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace',
'stderr', 'stdin', 'stdout', 'thread_info', 'version', 'version_info',
'warnoptions']

Пакети

Модули, изградени само от файлове е твърде плоско решение
Можем да групираме няколко файла (модули) в един свръх-модул
За да направим една директория модул, трябва да създадем __init__.py файл вътре
Това е инициализатора на модула и се изпълнява преди всичко останало

panda/
    __init__.py
    head.py
    body.py
    belly.py
    eyes.py
    tail.py
    # ...

Импортване на всичко от даден модул

from panda import *

По този начин всичко от модула panda ще бъде "изсипано" в текущия скоуп
Нямате добра причина да правите това извън интерактивна конзола
А ние имаме няколко такива да ви отнемаме точки, ако го правите

all

Има смисъл в __init__.py да дефинираме списък от стрингове __all__
Само имената в него ще бъдат импортнати, ако се използва *

Релативни пътища

Можем да пропуснем търсенето в sys.path и директно да импортнем нещо от текущата директория

from . import panda

Можем да търсим и в "горния" възел

from .. import panda

Или:

from ..panda import tail

Инсталиране на пакети

Long story short

pip install package-name-goes-here

От къде ги тегли?

PyPI - the Python Package Index

Как да качим пакет там?

Имаме нужда от модула distutils
setup.py файл в основата директория на проекта
И изпълнение на distutils.core.setup() в него

Пример

from distutils.core import setup

setup(name='Distutils',
  version='1.0',
  description='Python Distribution Utilities',
  author='Greg Ward',
  author_email='gward@python.net',
  url='http://www.python.org/sigs/distutils-sig/',
  packages=['distutils', 'distutils.command'],
)

Distutils addition meta-data

Classifiers

setup(...,
    classifiers=[
      'Development Status :: 4 - Beta',
      'Environment :: Console',
      'Environment :: Web Environment',
      'Intended Audience :: End Users/Desktop',
      'Intended Audience :: Developers',
      'Intended Audience :: System Administrators',
      'License :: OSI Approved :: Python Software Foundation License',
      'Operating System :: MacOS :: MacOS X',
      'Operating System :: Microsoft :: Windows',
      'Operating System :: POSIX',
      'Programming Language :: Python',
      'Topic :: Communications :: Email',
      'Topic :: Office/Business',
      'Topic :: Software Development :: Bug Tracking',
    ],
)

List trove classifiers

Добре, имаме го и сега какво?

python setup.py install - Инсталира
python setup.py sdist - Създава архив, който лесно може да бъде инсталиран
python setup.py bdist_wininstsdist - Създава инсталатор за уиндолс
...

Терминология

module
pure python module
extension module
package
root package

07. Модули

2 април 2014

Модули 101

.pyc

import

В този ред на мисли, показвали ли сме ви това:

Модули

Модули

Модули

Модули

Модули

if __name__ == "__main__":

Search Path

Search Path

dir()

Пакети

Импортване на всичко от даден модул

__all__

Релативни пътища

Инсталиране на пакети

От къде ги тегли?

Как да качим пакет там?

Пример

Classifiers

Добре, имаме го и сега какво?

Терминология

Въпроси?

if name == "main":

all