python 之使用模塊
Python本身就內置了很多非常有用的模塊,只要安裝完畢,這些模塊就可以立刻使用。
我們以內建的sys
模塊為例,編寫一個hello
的模塊:
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
‘ a test module ‘
__author__ = ‘Michael Liao‘
import sys
def test():
args = sys.argv
if len(args)==1:
print(‘Hello, world!‘)
elif len(args)==2:
print(‘Hello, %s!‘ % args[1])
else:
print(‘Too many arguments!‘)
if __name__==‘__main__‘:
test()
第1行和第2行是標準註釋,第1行註釋可以讓這個hello.py
文件直接在Unix/Linux/Mac上運行,第2行註釋表示.py文件本身使用標準UTF-8編碼;
第4行是一個字符串,表示模塊的文檔註釋,任何模塊代碼的第一個字符串都被視為模塊的文檔註釋;
第6行使用__author__
變量把作者寫進去,這樣當你公開源代碼後別人就可以瞻仰你的大名;
以上就是Python模塊的標準文件模板,當然也可以全部刪掉不寫,但是,按標準辦事肯定沒錯。
後面開始就是真正的代碼部分。
你可能註意到了,使用sys
模塊的第一步,就是導入該模塊:
import sys
導入sys
模塊後,我們就有了變量sys
指向該模塊,利用sys
sys
模塊的所有功能。
sys
模塊有一個argv
變量,用list存儲了命令行的所有參數。argv
至少有一個元素,因為第一個參數永遠是該.py文件的名稱,例如:
運行python3 hello.py
獲得的sys.argv
就是[‘hello.py‘]
;
運行python3 hello.py Michael
獲得的sys.argv
就是[‘hello.py‘, ‘Michael]
。
最後,註意到這兩行代碼:
if __name__==‘__main__‘:
test()
當我們在命令行運行hello
模塊文件時,Python解釋器把一個特殊變量__name__
置為__main__
hello
模塊時,if
判斷將失敗,因此,這種if
測試可以讓一個模塊通過命令行運行時執行一些額外的代碼,最常見的就是運行測試。
我們可以用命令行運行hello.py
看看效果:
$ python3 hello.py
Hello, world!
$ python hello.py Michael
Hello, Michael!
如果啟動Python交互環境,再導入hello
模塊:
$ python3
Python 3.4.3 (v3.4.3:9b73f1c3e601, Feb 23 2015, 02:52:03)
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import hello
>>>
導入時,沒有打印Hello, word!
,因為沒有執行test()
函數。
調用hello.test()
時,才能打印出Hello, word!
:
>>> hello.test()
Hello, world!
作用域
在一個模塊中,我們可能會定義很多函數和變量,但有的函數和變量我們希望給別人使用,有的函數和變量我們希望僅僅在模塊內部使用。在Python中,是通過_
前綴來實現的。
正常的函數和變量名是公開的(public),可以被直接引用,比如:abc
,x123
,PI
等;
類似__xxx__
這樣的變量是特殊變量,可以被直接引用,但是有特殊用途,比如上面的__author__
,__name__
就是特殊變量,hello
模塊定義的文檔註釋也可以用特殊變量__doc__
訪問,我們自己的變量一般不要用這種變量名;
類似_xxx
和__xxx
這樣的函數或變量就是非公開的(private),不應該被直接引用,比如_abc
,__abc
等;
之所以我們說,private函數和變量“不應該”被直接引用,而不是“不能”被直接引用,是因為Python並沒有一種方法可以完全限制訪問private函數或變量,但是,從編程習慣上不應該引用private函數或變量。
private函數或變量不應該被別人引用,那它們有什麽用呢?請看例子:
def _private_1(name):
return ‘Hello, %s‘ % name
def _private_2(name):
return ‘Hi, %s‘ % name
def greeting(name):
if len(name) > 3:
return _private_1(name)
else:
return _private_2(name)
我們在模塊裏公開greeting()
函數,而把內部邏輯用private函數隱藏起來了,這樣,調用greeting()
函數不用關心內部的private函數細節,這也是一種非常有用的代碼封裝和抽象的方法,即:
外部不需要引用的函數全部定義成private,只有外部需要引用的函數才定義為public。
python 之使用模塊