python cheatsheet
1.0.0
下載文字檔案、購買 PDF、在 GitHub 上分叉我或查看常見問題。
1. 收藏： List 、 Dictionary 、 Set 、 Tuple 、 Range 、 Enumerate 、 Iterator 、 Generator 。
2. 種類： Type 、 String 、 Regular_Exp 、 Format 、 Numbers 、 Combinatorics 、 Datetime 。
3.語法： Args 、 Inline 、 Import 、 Decorator 、 Class 、 Duck_Types 、 Enum 、 Exception 。
4、系統： Exit 、 Print 、 Input 、 Command_Line_Arguments 、 Open 、 Path 、 OS_Commands 。
5. 數據： JSON 、 Pickle 、 CSV 、 SQLite 、 Bytes 、 Struct 、 Array 、 Memory_View 、 Deque 。
6. 高級： Operator 、 Match_Stmt 、 Logging 、 Introspection 、 Threading 、 Coroutines 。
7. 圖書館： Progress_Bar 、 Plot 、 Table 、 Console_App 、 GUI 、 Scraping 、 Web 、 Profile 。
8.多媒體： NumPy 、 Image 、 Animation 、 Audio 、 Synthesizer 、 Pygame 、 Pandas 、 Plotly 。
if __name__ == '__main__' : # Skips next line if file was imported.
main () # Runs `def main(): ...` function. < list > = [ < el_1 > , < el_2 > , ...] # Creates new list. Also list(<collection>). < el > = < list > [ index ] # First index is 0. Last -1. Allows assignments.
< list > = < list > [ < slice > ] # Also <list>[from_inclusive : to_exclusive : ±step]. < list > . append ( < el > ) # Appends element to the end. Also <list> += [<el>].
< list > . extend ( < collection > ) # Appends elements to the end. Also <list> += <coll>. < list > . sort () # Sorts elements in ascending order.
< list > . reverse () # Reverses the list in-place.
< list > = sorted ( < collection > ) # Returns new list with sorted elements.
< iter > = reversed ( < list > ) # Returns reversed iterator of elements. < el > = max ( < collection > ) # Returns largest element. Also min(<el_1>, ...).
< num > = sum ( < collection > ) # Returns sum of elements. Also math.prod(<coll>). elementwise_sum = [ sum ( pair ) for pair in zip ( list_a , list_b )]
sorted_by_second = sorted ( < collection > , key = lambda el : el [ 1 ])
sorted_by_both = sorted ( < collection > , key = lambda el : ( el [ 1 ], el [ 0 ]))
flatter_list = list ( itertools . chain . from_iterable ( < list > )) < int > = len ( < list > ) # Returns number of items. Also works on dict, set and string.
< int > = < list > . count ( < el > ) # Returns number of occurrences. Also `if <el> in <coll>: ...`.
< int > = < list > . index ( < el > ) # Returns index of the first occurrence or raises ValueError.
< el > = < list > . pop () # Removes and returns item from the end or at index if passed.
< list > . insert ( < int > , < el > ) # Inserts item at index and moves the rest to the right.
< list > . remove ( < el > ) # Removes first occurrence of the item or raises ValueError.
< list > . clear () # Removes all items. Also works on dictionary and set. < dict > = { key_1 : val_1 , key_2 : val_2 , ...} # Use `<dict>[key]` to get or set the value. < view > = < dict > . keys () # Collection of keys that reflects changes.
< view > = < dict > . values () # Collection of values that reflects changes.
< view > = < dict > . items () # Coll. of key-value tuples that reflects chgs. value = < dict > . get ( key , default = None ) # Returns default if key is missing.
value = < dict > . setdefault ( key , default = None ) # Returns and writes default if key is missing.
< dict > = collections . defaultdict ( < type > ) # Returns a dict with default value `<type>()`.
< dict > = collections . defaultdict ( lambda : 1 ) # Returns a dict with default value 1. < dict > = dict ( < collection > ) # Creates a dict from coll. of key-value pairs.
< dict > = dict ( zip ( keys , values )) # Creates a dict from two collections.
< dict > = dict . fromkeys ( keys [, value ]) # Creates a dict from collection of keys. < dict > . update ( < dict > ) # Adds items. Replaces ones with matching keys.
value = < dict > . pop ( key ) # Removes item or raises KeyError if missing.
{ k for k , v in < dict > . items () if v == value } # Returns set of keys that point to the value.
{ k : v for k , v in < dict > . items () if k in keys } # Filters the dictionary by keys. > >> from collections import Counter
> >> counter = Counter ([ 'blue' , 'blue' , 'blue' , 'red' , 'red' ])
> >> counter [ 'yellow' ] += 1
> >> print ( counter . most_common ())
[( 'blue' , 3 ), ( 'red' , 2 ), ( 'yellow' , 1 )] < set > = { < el_1 > , < el_2 > , ...} # Use `set()` for empty set. < set > . add ( < el > ) # Or: <set> |= {<el>}
< set > . update ( < collection > [, ...]) # Or: <set> |= <set> < set > = < set > . union ( < coll . > ) # Or: <set> | <set>
< set > = < set > . intersection ( < coll . > ) # Or: <set> & <set>
< set > = < set > . difference ( < coll . > ) # Or: <set> - <set>
< set > = < set > . symmetric_difference ( < coll . > ) # Or: <set> ^ <set>
< bool > = < set > . issubset ( < coll . > ) # Or: <set> <= <set>
< bool > = < set > . issuperset ( < coll . > ) # Or: <set> >= <set> < el > = < set > . pop () # Raises KeyError if empty.
< set > . remove ( < el > ) # Raises KeyError if missing.
< set > . discard ( < el > ) # Doesn't raise an error. < frozenset > = frozenset ( < collection > )元組是一個不可變且可雜湊的清單。
< tuple > = () # Empty tuple.
< tuple > = ( < el > ,) # Or: <el>,
< tuple > = ( < el_1 > , < el_2 > [, ...]) # Or: <el_1>, <el_2> [, ...]Tuple 的子類別具有命名元素。
> >> from collections import namedtuple
> >> Point = namedtuple ( 'Point' , 'x y' )
> >> p = Point ( 1 , y = 2 ); p
Point ( x = 1 , y = 2 )
> >> p [ 0 ]
1
> >> p . x
1
> >> getattr ( p , 'y' )
2 不可變且可散列的整數序列。
< range > = range ( stop ) # range(to_exclusive)
< range > = range ( start , stop ) # range(from_inclusive, to_exclusive)
< range > = range ( start , stop , ± step ) # range(from_inclusive, to_exclusive, ±step_size) > >> [ i for i in range ( 3 )]
[ 0 , 1 , 2 ] for i , el in enumerate ( < coll > , start = 0 ): # Returns next element and its index on each pass.
... < iter > = iter ( < collection > ) # `iter(<iter>)` returns unmodified iterator.
< iter > = iter ( < function > , to_exclusive ) # A sequence of return values until 'to_exclusive'.
< el > = next ( < iter > [, default ]) # Raises StopIteration or returns 'default' on end.
< list > = list ( < iter > ) # Returns a list of iterator's remaining elements. import itertools as it < iter > = it . count ( start = 0 , step = 1 ) # Returns updated value endlessly. Accepts floats.
< iter > = it . repeat ( < el > [, times ]) # Returns element endlessly or 'times' times.
< iter > = it . cycle ( < collection > ) # Repeats the sequence endlessly. < iter > = it . chain ( < coll > , < coll > [, ...]) # Empties collections in order (figuratively).
< iter > = it . chain . from_iterable ( < coll > ) # Empties collections inside a collection in order. < iter > = it . islice ( < coll > , to_exclusive ) # Only returns first 'to_exclusive' elements.
< iter > = it . islice ( < coll > , from_inc , …) # `to_exclusive, +step_size`. Indices can be None. def count ( start , step ):
while True :
yield start
start += step > >> counter = count ( 10 , 2 )
> >> next ( counter ), next ( counter ), next ( counter )
( 10 , 12 , 14 ) < type > = type ( < el > ) # Or: <el>.__class__
< bool > = isinstance ( < el > , < type > ) # Or: issubclass(type(<el>), <type>) > >> type ( 'a' ), 'a' . __class__ , str
( < class 'str' > , < class 'str' > , < class 'str' > ) from types import FunctionType , MethodType , LambdaType , GeneratorType , ModuleType每個抽象基底類別指定一組虛擬子類別。然後，這些類別被 isinstance() 和 issubclass() 識別為 ABC 的子類，儘管它們實際上不是。 ABC 還可以手動決定特定類別是否是其虛擬子類，通常基於該類別實作了哪些方法。例如，Iterable ABC 尋找方法 iter()，而 Collection ABC 會尋找 iter()、contains() 和 len()。
> >> from collections . abc import Iterable , Collection , Sequence
> >> isinstance ([ 1 , 2 , 3 ], Iterable )
True +------------------+------------+------------+------------+
| | Iterable | Collection | Sequence |
+------------------+------------+------------+------------+
| list, range, str | yes | yes | yes |
| dict, set | yes | yes | |
| iter | yes | | |
+------------------+------------+------------+------------+
> >> from numbers import Number , Complex , Real , Rational , Integral
> >> isinstance ( 123 , Number )
True +--------------------+----------+----------+----------+----------+----------+
| | Number | Complex | Real | Rational | Integral |
+--------------------+----------+----------+----------+----------+----------+
| int | yes | yes | yes | yes | yes |
| fractions.Fraction | yes | yes | yes | yes | |
| float | yes | yes | yes | | |
| complex | yes | yes | | | |
| decimal.Decimal | yes | | | | |
+--------------------+----------+----------+----------+----------+----------+
不可變的字元序列。
< str > = < str > . strip () # Strips all whitespace characters from both ends.
< str > = < str > . strip ( '<chars>' ) # Strips passed characters. Also lstrip/rstrip(). < list > = < str > . split () # Splits on one or more whitespace characters.
< list > = < str > . split ( sep = None , maxsplit = - 1 ) # Splits on 'sep' str at most 'maxsplit' times.
< list > = < str > . splitlines ( keepends = False ) # On [nrfvx1c-x1ex85u2028u2029] and rn.
< str > = < str > . join ( < coll_of_strings > ) # Joins elements using string as a separator. < bool > = < sub_str > in < str > # Checks if string contains the substring.
< bool > = < str > . startswith ( < sub_str > ) # Pass tuple of strings for multiple options.
< int > = < str > . find ( < sub_str > ) # Returns start index of the first match or -1.
< int > = < str > . index ( < sub_str > ) # Same, but raises ValueError if there's no match. < str > = < str > . lower () # Changes the case. Also upper/capitalize/title().
< str > = < str > . replace ( old , new [, count ]) # Replaces 'old' with 'new' at most 'count' times.
< str > = < str > . translate ( < table > ) # Use `str.maketrans(<dict>)` to generate table. < str > = chr ( < int > ) # Converts int to Unicode character.
< int > = ord ( < str > ) # Converts Unicode character to int.'Motörhead'等字串與其他字串進行比較之前，請先對它們使用'unicodedata.normalize("NFC", <str>)' ，因為'ö'可以儲存為一個或兩個字元。'NFC'將此類字符轉換為單個字符，而'NFD'將它們轉換為兩個字符。 < bool > = < str > . isdecimal () # Checks for [0-9]. Also [०-९] and [٠-٩].
< bool > = < str > . isdigit () # Checks for [²³¹…] and isdecimal().
< bool > = < str > . isnumeric () # Checks for [¼½¾…], [零〇一…] and isdigit().
< bool > = < str > . isalnum () # Checks for [a-zA-Z…] and isnumeric().
< bool > = < str > . isprintable () # Checks for [ !#$%…] and isalnum().
< bool > = < str > . isspace () # Checks for [ tnrfvx1c-x1fx85xa0…]. 正規表示式匹配的函數。
import re
< str > = re . sub ( r'<regex>' , new , text , count = 0 ) # Substitutes all occurrences with 'new'.
< list > = re . findall ( r'<regex>' , text ) # Returns all occurrences as strings.
< list > = re . split ( r'<regex>' , text , maxsplit = 0 ) # Add brackets around regex to keep matches.
< Match > = re . search ( r'<regex>' , text ) # First occurrence of the pattern or None.
< Match > = re . match ( r'<regex>' , text ) # Searches only at the beginning of the text.
< iter > = re . finditer ( r'<regex>' , text ) # Returns all occurrences as Match objects.'flags=re.IGNORECASE'可與所有函數一起使用。'flags=re.MULTILINE'使'^'和'$'符合每行的開頭/結尾。'flags=re.DOTALL'產生'.'也接受'n' 。're.compile(<regex>)'傳回一個有方法 sub()、findall() 等的 Pattern 對象 < str > = < Match > . group () # Returns the whole match. Also group(0).
< str > = < Match > . group ( 1 ) # Returns part inside the first brackets.
< tuple > = < Match > . groups () # Returns all bracketed parts.
< int > = < Match > . start () # Returns start index of the match.
< int > = < Match > . end () # Returns exclusive end index of the match. 'd' == '[0-9]' # Also [०-९…]. Matches a decimal character.
'w' == '[a-zA-Z0-9_]' # Also [ª²³…]. Matches an alphanumeric or _.
's' == '[ t n r f v ]' # Also [x1c-x1f…]. Matches a whitespace.'flags=re.ASCII' ，否則所有字母表中的十進位字元和字母數字都會匹配。它將特殊序列匹配限制為前 128 個 Unicode 字符，並且還阻止's'接受'x1c' 、 'x1d' 、 'x1e'和'x1f' （將文本劃分為文件的不可打印字符，分別為表格、行和欄位）。<str> = f ' {<el_1>}, {<el_2>} ' # Curly brackets can also contain expressions.
<str> = ' {}, {} ' .format(<el_1>, <el_2>) # Or: '{0}, {a}'.format(<el_1>, a=<el_2>)
<str> = ' %s, %s ' % (<el_1>, <el_2>) # Redundant and inferior C-style formatting. > >> Person = collections . namedtuple ( 'Person' , 'name height' )
> >> person = Person ( 'Jean-Luc' , 187 )
> >> f' { person . name } is { person . height / 100 } meters tall.'
'Jean-Luc is 1.87 meters tall.'{ < el > : < 10 } # '<el> '
{ < el > : ^ 10 } # ' <el> '
{ < el > : > 10 } # ' <el>'
{ < el > :. < 10 } # '<el>......'
{ < el > : 0 } # '<el>''format(<el>, "<options>")'呈現。f'{<el>:{<str/int>}[…]}' 。'='加到表達式會將其加到輸出前面： f'{1+1=}'返回'1+1=2' 。'!r'加入表達式中可透過呼叫其 repr() 方法將物件轉換為字串。{ 'abcde' : 10 } # 'abcde '
{ 'abcde' : 10.3 } # 'abc '
{ 'abcde' : .3 } # 'abc'
{ 'abcde' !r: 10 } # "'abcde' "{ 123456 : 10 } # ' 123456'
{ 123456 : 10 ,} # ' 123,456'
{ 123456 : 10_ } # ' 123_456'
{ 123456 : + 10 } # ' +123456'
{ 123456 : = + 10 } # '+ 123456'
{ 123456 : } # ' 123456'
{ - 123456 : } # '-123456'{ 1.23456 : 10.3 } # ' 1.23'
{ 1.23456 : 10.3 f } # ' 1.235'
{ 1.23456 : 10.3 e } # ' 1.235e+00'
{ 1.23456 : 10.3 % } # ' 123.456%' +--------------+----------------+----------------+----------------+----------------+
| | {<float>} | {<float>:f} | {<float>:e} | {<float>:%} |
+--------------+----------------+----------------+----------------+----------------+
| 0.000056789 | '5.6789e-05' | '0.000057' | '5.678900e-05' | '0.005679%' |
| 0.00056789 | '0.00056789' | '0.000568' | '5.678900e-04' | '0.056789%' |
| 0.0056789 | '0.0056789' | '0.005679' | '5.678900e-03' | '0.567890%' |
| 0.056789 | '0.056789' | '0.056789' | '5.678900e-02' | '5.678900%' |
| 0.56789 | '0.56789' | '0.567890' | '5.678900e-01' | '56.789000%' |
| 5.6789 | '5.6789' | '5.678900' | '5.678900e+00' | '567.890000%' |
| 56.789 | '56.789' | '56.789000' | '5.678900e+01' | '5678.900000%' |
+--------------+----------------+----------------+----------------+----------------+
+--------------+----------------+----------------+----------------+----------------+
| | {<float>:.2} | {<float>:.2f} | {<float>:.2e} | {<float>:.2%} |
+--------------+----------------+----------------+----------------+----------------+
| 0.000056789 | '5.7e-05' | '0.00' | '5.68e-05' | '0.01%' |
| 0.00056789 | '0.00057' | '0.00' | '5.68e-04' | '0.06%' |
| 0.0056789 | '0.0057' | '0.01' | '5.68e-03' | '0.57%' |
| 0.056789 | '0.057' | '0.06' | '5.68e-02' | '5.68%' |
| 0.56789 | '0.57' | '0.57' | '5.68e-01' | '56.79%' |
| 5.6789 | '5.7' | '5.68' | '5.68e+00' | '567.89%' |
| 56.789 | '5.7e+01' | '56.79' | '5.68e+01' | '5678.90%' |
+--------------+----------------+----------------+----------------+----------------+
'{<float>:g}'是'{<float>:.6}'去掉了零，指數從'1e+06'開始。'{6.5:.0f}'成為'6'和'{7.5:.0f}'成為'8' 。.5 、 .25 、...）。{ 90 : c } # 'Z'. Unicode character with value 90.
{ 90 : b } # '1011010'. Number 90 in binary.
{ 90 : X } # '5A'. Number 90 in uppercase hexadecimal. < int > = int ( < float / str / bool > ) # Or: math.trunc(<float>)
< float > = float ( < int / str / bool > ) # Or: <int/float>e±<int>
< complex > = complex ( real = 0 , imag = 0 ) # Or: <int/float> ± <int/float>j
< Fraction > = fractions . Fraction ( 0 , 1 ) # Or: Fraction(numerator=0, denominator=1)
< Decimal > = decimal . Decimal ( < str / int > ) # Or: Decimal((sign, digits, exponent))'int(<str>)'和'float(<str>)'在格式錯誤的字串上引發 ValueError。'1.1 + 2.2 != 3.3'不同。'math.isclose(<float>, <float>)'進行比較。'decimal.getcontext().prec = <int>' 。 < num > = pow ( < num > , < num > ) # Or: <number> ** <number>
< num > = abs ( < num > ) # <float> = abs(<complex>)
< num > = round ( < num > [, ± ndigits ]) # `round(126, -1) == 130` from math import e , pi , inf , nan , isinf , isnan # `<el> == nan` is always False.
from math import sin , cos , tan , asin , acos , atan # Also: degrees, radians.
from math import log , log10 , log2 # Log can accept base as second arg. from statistics import mean , median , variance # Also: stdev, quantiles, groupby. from random import random , randint , choice # Also: shuffle, gauss, triangular, seed.
< float > = random () # A float inside [0, 1).
< int > = randint ( from_inc , to_inc ) # An int inside [from_inc, to_inc].
< el > = choice ( < sequence > ) # Keeps the sequence intact. < int > = ± 0 b < bin > # Or: ±0x<hex>
< int > = int ( '±<bin>' , 2 ) # Or: int('±<hex>', 16)
< int > = int ( '±0b<bin>' , 0 ) # Or: int('±0x<hex>', 0)
< str > = bin ( < int > ) # Returns '[-]0b<bin>'. Also hex(). < int > = < int > & < int > # And (0b1100 & 0b1010 == 0b1000).
< int > = < int > | < int > # Or (0b1100 | 0b1010 == 0b1110).
< int > = < int > ^ < int > # Xor (0b1100 ^ 0b1010 == 0b0110).
< int > = < int > < < n_bits # Left shift. Use >> for right.
< int > = ~ < int > # Not. Also -<int> - 1. import itertools as it > >> list ( it . product ([ 0 , 1 ], repeat = 3 ))
[( 0 , 0 , 0 ), ( 0 , 0 , 1 ), ( 0 , 1 , 0 ), ( 0 , 1 , 1 ),
( 1 , 0 , 0 ), ( 1 , 0 , 1 ), ( 1 , 1 , 0 ), ( 1 , 1 , 1 )] > >> list ( it . product ( 'abc' , 'abc' )) # a b c
[( 'a' , 'a' ), ( 'a' , 'b' ), ( 'a' , 'c' ), # a x x x
( 'b' , 'a' ), ( 'b' , 'b' ), ( 'b' , 'c' ), # b x x x
( 'c' , 'a' ), ( 'c' , 'b' ), ( 'c' , 'c' )] # c x x x > >> list ( it . combinations ( 'abc' , 2 )) # a b c
[( 'a' , 'b' ), ( 'a' , 'c' ), # a . x x
( 'b' , 'c' )] # b . . x > >> list ( it . combinations_with_replacement ( 'abc' , 2 )) # a b c
[( 'a' , 'a' ), ( 'a' , 'b' ), ( 'a' , 'c' ), # a x x x
( 'b' , 'b' ), ( 'b' , 'c' ), # b . x x
( 'c' , 'c' )] # c . . x > >> list ( it . permutations ( 'abc' , 2 )) # a b c
[( 'a' , 'b' ), ( 'a' , 'c' ), # a . x x
( 'b' , 'a' ), ( 'b' , 'c' ), # b x . x
( 'c' , 'a' ), ( 'c' , 'b' )] # c x x . 提供「日期」、「時間」、「日期時間」和「時間增量」類。一切都是不可變和可散列的。
# $ pip3 install python-dateutil
from datetime import date , time , datetime , timedelta , timezone
import zoneinfo , dateutil . tz < D > = date ( year , month , day ) # Only accepts valid dates from 1 to 9999 AD.
< T > = time ( hour = 0 , minute = 0 , second = 0 ) # Also: `microsecond=0, tzinfo=None, fold=0`.
< DT > = datetime ( year , month , day , hour = 0 ) # Also: `minute=0, second=0, microsecond=0, …`.
< TD > = timedelta ( weeks = 0 , days = 0 , hours = 0 ) # Also: `minutes=0, seconds=0, microseconds=0`.'fold=1'表示時間回跳一小時時的第二遍。'[±D, ]H:MM:SS[.…]' ，total_seconds() 是所有秒數的浮點數。'<D/DT>.weekday()'取得整數形式的星期幾，其中星期一為 0。 < D / DTn > = D / DT . today () # Current local date or naive DT. Also DT.now().
< DTa > = DT . now ( < tzinfo > ) # Aware DT from current time in passed timezone.'<DTn>.time()' 、 '<DTa>.time()'或'<DTa>.timetz()' 。 < tzinfo > = timezone . utc # London without daylight saving time (DST).
< tzinfo > = timezone ( < timedelta > ) # Timezone with fixed offset from UTC.
< tzinfo > = dateutil . tz . tzlocal () # Local timezone with dynamic offset from UTC.
< tzinfo > = zoneinfo . ZoneInfo ( '<iana_key>' ) # 'Continent/City_Name' zone with dynamic offset.
< DTa > = < DT > . astimezone ([ < tzinfo > ]) # Converts DT to the passed or local fixed zone.
< Ta / DTa > = < T / DT > . replace ( tzinfo = < tzinfo > ) # Changes object's timezone without conversion.'> pip3 install tzdata' 。 < D / T / DT > = D / T / DT . fromisoformat ( < str > ) # Object from ISO string. Raises ValueError.
< DT > = DT . strptime ( < str > , '<format>' ) # Datetime from str, according to format.
< D / DTn > = D / DT . fromordinal ( < int > ) # D/DT from days since the Gregorian NYE 1.
< DTn > = DT . fromtimestamp ( < float > ) # Local naive DT from seconds since the Epoch.
< DTa > = DT . fromtimestamp ( < float > , < tz > ) # Aware datetime from seconds since the Epoch.'YYYY-MM-DD' 、 'HH:MM:SS.mmmuuu[±HH:MM]'或兩者皆由任何字元分隔。小時後的所有部分都是可選的。'1970-01-01 00:00 UTC' , '1970-01-01 01:00 CET' , ... < str > = < D / T / DT > . isoformat ( sep = 'T' ) # Also `timespec='auto/hours/minutes/seconds/…'`.
< str > = < D / T / DT > . strftime ( '<format>' ) # Custom string representation of the object.
< int > = < D / DT > . toordinal () # Days since Gregorian NYE 1, ignoring time and tz.
< float > = < DTn > . timestamp () # Seconds since the Epoch, from local naive DT.
< float > = < DTa > . timestamp () # Seconds since the Epoch, from aware datetime. > >> dt = datetime . strptime ( '2025-08-14 23:39:00.00 +0200' , '%Y-%m-%d %H:%M:%S.%f %z' )
> >> dt . strftime ( "%dth of %B '%y (%a), %I:%M %p %Z" )
"14th of August '25 (Thu), 11:39 PM UTC+02:00"'%z'接受'±HH[:]MM'並傳回'±HHMM'或空字串（如果日期時間很簡單）。'%Z'接受'UTC/GMT'和本地時區的代碼，並傳回時區的名稱，如果時區無名，則傳回'UTC[±HH:MM]'如果日期時間很幼稚，則傳回空字串。 < bool > = < D / T / DTn > > < D / T / DTn > # Ignores time jumps (fold attribute). Also ==.
< bool > = < DTa > > < DTa > # Ignores jumps if they share tz object. Broken ==.
< TD > = < D / DTn > - < D / DTn > # Ignores jumps. Convert to UTC for actual delta.
< TD > = < DTa > - < DTa > # Ignores jumps if they share tzinfo object.
< D / DT > = < D / DT > ± < TD > # Returned datetime can fall into missing hour.
< TD > = < TD > * < float > # Also: <TD> = abs(<TD>) and <TD> = <TD> ±% <TD>.
< float > = < TD > / < TD > # E.g. how many hours are in TD. Also //, divmod(). func ( < positional_args > ) # func(0, 0)
func ( < keyword_args > ) # func(x=0, y=0)
func ( < positional_args > , < keyword_args > ) # func(0, y=0) def func ( < nondefault_args > ): ... # def func(x, y): ...
def func ( < default_args > ): ... # def func(x=0, y=0): ...
def func ( < nondefault_args > , < default_args > ): ... # def func(x, y=0): ...Splat 將集合擴展為位置參數，而 splatty-splat 將字典擴展為關鍵字參數。
args = ( 1 , 2 )
kwargs = { 'x' : 3 , 'y' : 4 , 'z' : 5 }
func ( * args , ** kwargs ) func ( 1 , 2 , x = 3 , y = 4 , z = 5 )Splat 將零個或多個位置參數組合到一個元組中，而 splatty-splat 將零個或多個關鍵字參數組合到一個字典中。
def add ( * a ):
return sum ( a ) > >> add ( 1 , 2 , 3 )
6 def f ( * args ): ... # f(1, 2, 3)
def f ( x , * args ): ... # f(1, 2, 3)
def f ( * args , z ): ... # f(1, 2, z=3) def f ( ** kwargs ): ... # f(x=1, y=2, z=3)
def f ( x , ** kwargs ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3) def f ( * args , ** kwargs ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3) | f(1, 2, z=3) | f(1, 2, 3)
def f ( x , * args , ** kwargs ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3) | f(1, 2, z=3) | f(1, 2, 3)
def f ( * args , y , ** kwargs ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3) def f ( * , x , y , z ): ... # f(x=1, y=2, z=3)
def f ( x , * , y , z ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3)
def f ( x , y , * , z ): ... # f(x=1, y=2, z=3) | f(1, y=2, z=3) | f(1, 2, z=3) < list > = [ * < coll . > [, ...]] # Or: list(<collection>) [+ ...]
< tuple > = ( * < coll . > , [...]) # Or: tuple(<collection>) [+ ...]
< set > = { * < coll . > [, ...]} # Or: set(<collection>) [| ...]
< dict > = { ** < dict > [, ...]} # Or: <dict> | ... head , * body , tail = < coll . > # Head or tail can be omitted. < func > = lambda : < return_value > # A single statement function.
< func > = lambda < arg_1 > , < arg_2 > : < return_value > # Also allows default arguments. < list > = [ i + 1 for i in range ( 10 )] # Or: [1, 2, ..., 10]
< iter > = ( i for i in range ( 10 ) if i > 5 ) # Or: iter([6, 7, 8, 9])
< set > = { i + 5 for i in range ( 10 )} # Or: {5, 6, ..., 14}
< dict > = { i : i * 2 for i in range ( 10 )} # Or: {0: 0, 1: 2, ..., 9: 18} > >> [ l + r for l in 'abc' for r in 'abc' ] # Inner loop is on the right side.
[ 'aa' , 'ab' , 'ac' , ..., 'cc' ] from functools import reduce < iter > = map ( lambda x : x + 1 , range ( 10 )) # Or: iter([1, 2, ..., 10])
< iter > = filter ( lambda x : x > 5 , range ( 10 )) # Or: iter([6, 7, 8, 9])
< obj > = reduce ( lambda out , x : out + x , range ( 10 )) # Or: 45 < bool > = any ( < collection > ) # Is `bool(<el>)` True for any el?
< bool > = all ( < collection > ) # True for all? Also True if empty. < obj > = < exp > if < condition > else < exp > # Only one expression is evaluated. > >> [ a if a else 'zero' for a in ( 0 , 1 , 2 , 3 )] # `any([0, '', [], None]) == False`
[ 'zero' , 1 , 2 , 3 ] from collections import namedtuple
Point = namedtuple ( 'Point' , 'x y' ) # Creates a tuple's subclass.
point = Point ( 0 , 0 ) # Returns its instance. from enum import Enum
Direction = Enum ( 'Direction' , 'N E S W' ) # Creates an enum.
direction = Direction . N # Returns its member. from dataclasses import make_dataclass
Player = make_dataclass ( 'Player' , [ 'loc' , 'dir' ]) # Creates a class.
player = Player ( point , direction ) # Returns its instance. 使一個文件中的程式碼可供另一文件使用的機制。
import < module > # Imports a built-in or '<module>.py'.
import < package > # Imports a built-in or '<package>/__init__.py'.
import < package > . < module > # Imports a built-in or '<package>/<module>.py'.'import <package>'不會自動提供對包模組的訪問，除非它們在其初始化腳本中明確導入。'from .[…][<pkg/module>[.…]] import <obj>' 。 當巢狀函數引用其封閉函數的值，然後封閉函數傳回巢狀函數時，我們在 Python 中擁有/獲得閉包。
def get_multiplier ( a ):
def out ( b ):
return a * b
return out > >> multiply_by_3 = get_multiplier ( 3 )
> >> multiply_by_3 ( 10 )
30 from functools import partial
< function > = partial ( < function > [, < arg_1 > [, ...]]) > >> def multiply ( a , b ):
... return a * b
> >> multiply_by_3 = partial ( multiply , 3 )
> >> multiply_by_3 ( 10 )
30'defaultdict(<func>)' 、 'iter(<func>, to_exc)'和 dataclass 的'field(default_factory=<func>)' 。如果變數被指派給作用域中的任何位置，則它被視為局部變量，除非它被宣告為「全域」或「非局部」。
def get_counter ():
i = 0
def out ():
nonlocal i
i += 1
return i
return out > >> counter = get_counter ()
> >> counter (), counter (), counter ()
( 1 , 2 , 3 ) @ decorator_name
def function_that_gets_passed_to_decorator ():
...每次呼叫函數時列印函數名稱的裝飾器。
from functools import wraps
def debug ( func ):
@ wraps ( func )
def out ( * args , ** kwargs ):
print ( func . __name__ )
return func ( * args , ** kwargs )
return out
@ debug
def add ( x , y ):
return x + y'add.__name__'將返回'out' 。快取函數傳回值的裝飾器。所有函數的參數都必須是可散列的。
from functools import cache
@ cache
def fib ( n ):
return n if n < 2 else fib ( n - 2 ) + fib ( n - 1 )'fib.cache_clear()' ，或使用'@lru_cache(maxsize=<int>)'裝飾器。'sys.setrecursionlimit(<int>)' 。接受參數並傳回接受函數的普通裝飾器的裝飾器。
from functools import wraps
def debug ( print_result = False ):
def decorator ( func ):
@ wraps ( func )
def out ( * args , ** kwargs ):
result = func ( * args , ** kwargs )
print ( func . __name__ , result if print_result else '' )
return result
return out
return decorator
@ debug ( print_result = True )
def add ( x , y ):
return x + y'@debug'來裝飾 add() 函數在這裡不起作用，因為 debug 將接收 add() 函數作為“print_result”參數。然而，裝飾器可以手動檢查他們收到的參數是否是一個函數並採取相應的行動。 用於建立使用者定義物件的範本。
class MyClass :
def __init__ ( self , a ):
self . a = a
def __str__ ( self ):
return str ( self . a )
def __repr__ ( self ):
class_name = self . __class__ . __name__
return f' { class_name } ( { self . a !r } )'
@ classmethod
def get_class_name ( cls ):
return cls . __name__ > >> obj = MyClass ( 1 )
> >> obj . a , str ( obj ), repr ( obj )
( 1 , '1' , 'MyClass(1)' )'@staticmethod'修飾的方法不會接收“self”或“cls”作為其第一個參數。 print ( < obj > )
f' { < obj > } '
logging . warning ( < obj > )
csv . writer ( < file > ). writerow ([ < obj > ])
raise Exception ( < obj > ) print / str / repr ([ < obj > ])
print / str / repr ({ < obj > : < obj > })
f' { < obj > !r } '
Z = dataclasses . make_dataclass ( 'Z' , [ 'a' ]); print / str / repr ( Z ( < obj > ))
> >> < obj > class Person :
def __init__ ( self , name ):
self . name = name
class Employee ( Person ):
def __init__ ( self , name , staff_num ):
super (). __init__ ( name )
self . staff_num = staff_num class A : pass
class B : pass
class C ( A , B ): passMRO決定了搜尋方法或屬性時遍歷父類別的順序：
> >> C . mro ()
[ < class 'C' > , < class 'A' > , < class 'B' > , < class 'object' > ]'def f() -> <type>:' ）。 from collections import abc
< name > : < type > [ | ...] [ = < obj > ] # `|` since 3.10.
< name > : list / set / abc . Iterable / abc . Sequence [ < type > ] [ = < obj > ] # Since 3.9.
< name > : dict / tuple [ < type > , ...] [ = < obj > ] # Since 3.9.使用類別變數產生 init()、repr() 和 eq() 特殊方法的裝飾器。
from dataclasses import dataclass , field , make_dataclass
@ dataclass ( order = False , frozen = False )
class < class_name > :
< attr_name > : < type >
< attr_name > : < type > = < default_value >
< attr_name > : list / dict / set = field ( default_factory = list / dict / set )'order=True'使物件可排序，並使用'frozen=True'使物件不可變。'<attr_name>: list = []'將建立在所有實例之間共用的清單。它的“default_factory”參數可以是任何可呼叫的。'typing.Any' 。 Point = make_dataclass ( 'Point' , [ 'x' , 'y' ])
Point = make_dataclass ( 'Point' , [( 'x' , float ), ( 'y' , float )])
Point = make_dataclass ( 'Point' , [( 'x' , float , 0 ), ( 'y' , float , 0 )])實作 getter 和 setter 的 Pythonic 方式。
class Person :
@ property
def name ( self ):
return ' ' . join ( self . _name )
@ name . setter
def name ( self , value ):
self . _name = value . split () > >> person = Person ()
> >> person . name = ' t Guido van Rossum n '
> >> person . name
'Guido van Rossum'將物件限制為「槽」中列出的屬性的機制，減少了它們的記憶體佔用。
class MyClassWithSlots :
__slots__ = [ 'a' ]
def __init__ ( self ):
self . a = 1 from copy import copy , deepcopy
< object > = copy / deepcopy ( < object > )鴨子類型是一種隱式類型，它規定了一組特殊方法。定義了這些方法的任何物件都被視為該鴨子類型的成員。
'id(self) == id(other)' ，這與'self is other'相同。 class MyComparable :
def __init__ ( self , a ):
self . a = a
def __eq__ ( self , other ):
if isinstance ( other , type ( self )):
return self . a == other . a
return NotImplemented'id(self)'的預設 hash() 不起作用。 class MyHashable :
def __init__ ( self , a ):
self . _a = a
@ property
def a ( self ):
return self . _a
def __eq__ ( self , other ):
if isinstance ( other , type ( self )):
return self . a == other . a
return NotImplemented
def __hash__ ( self ):
return hash ( self . a )'locale.setlocale(locale.LC_COLLATE, "en_US.UTF-8")'後將'key=locale.strxfrm'傳遞給排序() 。 from functools import total_ordering
@ total_ordering
class MySortable :
def __init__ ( self , a ):
self . a = a
def __eq__ ( self , other ):
if isinstance ( other , type ( self )):
return self . a == other . a
return NotImplemented
def __lt__ ( self , other ):
if isinstance ( other , type ( self )):
return self . a < other . a
return NotImplemented class Counter :
def __init__ ( self ):
self . i = 0
def __next__ ( self ):
self . i += 1
return self . i
def __iter__ ( self ):
return self > >> counter = Counter ()
> >> next ( counter ), next ( counter ), next ( counter )
( 1 , 2 , 3 )'callable(<obj>)'或'isinstance(<obj>, collections.abc.Callable)'檢查物件是否可呼叫。'<function>'作為參數時，它意味著'<callable>' 。 class Counter :
def __init__ ( self ):
self . i = 0
def __call__ ( self ):
self . i += 1
return self . i > >> counter = Counter ()
> >> counter (), counter (), counter ()
( 1 , 2 , 3 ) class MyOpen :
def __init__ ( self , filename ):
self . filename = filename
def __enter__ ( self ):
self . file = open ( self . filename )
return self . file
def __exit__ ( self , exc_type , exception , traceback ):
self . file . close () > >> with open ( 'test.txt' , 'w' ) as file :
... file . write ( 'Hello World!' )
> >> with MyOpen ( 'test.txt' ) as file :
... print ( file . read ())
Hello World ! class MyIterable :
def __init__ ( self , a ):
self . a = a
def __iter__ ( self ):
return iter ( self . a )
def __contains__ ( self , el ):
return el in self . a > >> obj = MyIterable ([ 1 , 2 , 3 ])
> >> [ el for el in obj ]
[ 1 , 2 , 3 ]
> >> 1 in obj
True'<collection>'時，它實際上意味著'<iterable>' 。 class MyCollection :
def __init__ ( self , a ):
self . a = a
def __iter__ ( self ):
return iter ( self . a )
def __contains__ ( self , el ):
return el in self . a
def __len__ ( self ):
return len ( self . a ) class MySequence :
def __init__ ( self , a ):
self . a = a
def __iter__ ( self ):
return iter ( self . a )
def __contains__ ( self , el ):
return el in self . a
def __len__ ( self ):
return len ( self . a )
def __getitem__ ( self , i ):
return self . a [ i ]
def __reversed__ ( self ):
return reversed ( self . a )'abc.Iterable'和'abc.Collection'不同，它不是鴨子類型。這就是為什麼即使 MySequence 定義了所有方法'issubclass(MySequence, abc.Sequence)'也會傳回 False。然而，它可以識別列表、元組、範圍、str、位元組、位元組數組、數組、記憶體視圖和雙端隊列，因為它們被註冊為 Sequence 的虛擬子類。 from collections import abc
class MyAbcSequence ( abc . Sequence ):
def __init__ ( self , a ):
self . a = a
def __len__ ( self ):
return len ( self . a )
def __getitem__ ( self , i ):
return self . a [ i ] +------------+------------+------------+------------+--------------+
| | Iterable | Collection | Sequence | abc.Sequence |
+------------+------------+------------+------------+--------------+
| iter() | REQ | REQ | Yes | Yes |
| contains() | Yes | Yes | Yes | Yes |
| len() | | REQ | REQ | REQ |
| getitem() | | | REQ | REQ |
| reversed() | | | Yes | Yes |
| index() | | | | Yes |
| count() | | | | Yes |
+------------+------------+------------+------------+--------------+
'isinstance(<obj>, abc.Iterable)'需要方法 iter() 才能傳回 True，但是任何具有 getitem() 的物件都可以與任何需要可迭代的程式碼一起使用。'<abc>.__abstractmethods__'取得所需方法的名稱。 稱為成員的命名常數的類別。
from enum import Enum , auto class < enum_name > ( Enum ):
< member_name > = auto () # Increment of the last numeric value or 1.
< member_name > = < value > # Values don't have to be hashable.
< member_name > = < el_1 > , < el_2 > # Values can be collections (this is a tuple). < member > = < enum > . < member_name > # Returns a member. Raises AttributeError.
< member > = < enum > [ '<member_name>' ] # Returns a member. Raises KeyError.
< member > = < enum > ( < value > ) # Returns a member. Raises ValueError.
< str > = < member > . name # Returns member's name.
< obj > = < member > . value # Returns member's value. < list > = list ( < enum > ) # Returns enum's members.
< list > = [ a . name for a in < enum > ] # Returns enum's member names.
< list > = [ a . value for a in < enum > ] # Returns enum's member values. < enum > = type ( < member > ) # Returns member's enum.
< iter > = itertools . cycle ( < enum > ) # Returns endless iterator of members.
< member > = random . choice ( list ( < enum > )) # Returns a random member. Cutlery = Enum ( 'Cutlery' , 'FORK KNIFE SPOON' )
Cutlery = Enum ( 'Cutlery' , [ 'FORK' , 'KNIFE' , 'SPOON' ])
Cutlery = Enum ( 'Cutlery' , { 'FORK' : 1 , 'KNIFE' : 2 , 'SPOON' : 3 }) from functools import partial
LogicOp = Enum ( 'LogicOp' , { 'AND' : partial ( lambda l , r : l and r ),
'OR' : partial ( lambda l , r : l or r )}) try :
< code >
except < exception > :
< code > try :
< code_1 >
except < exception_a > :
< code_2_a >
except < exception_b > :
< code_2_b >
else :
< code_2_c >
finally :
< code_3 >'try'區塊沒有異常時才會執行'else'區塊內的程式碼。'finally'區塊內的程式碼將始終被執行（除非收到訊號）。'signal.signal(signal_number, <func>)' 。 except < exception > : ...
except < exception > as < name > : ...
except ( < exception > , [...]): ...
except ( < exception > , [...]) as < name > : ...'traceback.print_exc()'將完整的錯誤訊息列印到 stderr。'print(<name>)'僅列印異常的原因（其參數）。'logging.exception(<str>)'記錄傳遞的訊息，後面跟著捕獲的異常的完整錯誤訊息。有關詳細信息，請參閱日誌記錄。'sys.exc_info()'取得異常類型、物件和擷取的異常的回溯。 raise < exception >
raise < exception > ()
raise < exception > ( < obj > [, ...]) except < exception > [ as < name > ]:
...
raise arguments = < name > . args
exc_type = < name > . __class__
filename = < name > . __traceback__ . tb_frame . f_code . co_filename
func_name = < name > . __traceback__ . tb_frame . f_code . co_name
line = linecache . getline ( filename , < name > . __traceback__ . tb_lineno )
trace_str = '' . join ( traceback . format_tb ( < name > . __traceback__ ))
error_msg = '' . join ( traceback . format_exception ( type ( < name > ), < name > , < name > . __traceback__ )) BaseException
+-- SystemExit # Raised by the sys.exit() function.
+-- KeyboardInterrupt # Raised when the user hits the interrupt key (ctrl-c).
+-- Exception # User-defined exceptions should be derived from this class.
+-- ArithmeticError # Base class for arithmetic errors such as ZeroDivisionError.
+-- AssertionError # Raised by `assert <exp>` if expression returns false value.
+-- AttributeError # Raised when object doesn't have requested attribute/method.
+-- EOFError # Raised by input() when it hits an end-of-file condition.
+-- LookupError # Base class for errors when a collection can't find an item.
| +-- IndexError # Raised when a sequence index is out of range.
| +-- KeyError # Raised when a dictionary key or set element is missing.
+-- MemoryError # Out of memory. May be too late to start deleting variables.
+-- NameError # Raised when nonexistent name (variable/func/class) is used.
| +-- UnboundLocalError # Raised when local name is used before it's being defined.
+-- OSError # Errors such as FileExistsError/TimeoutError (see #Open).
| +-- ConnectionError # Errors such as BrokenPipeError/ConnectionAbortedError.
+-- RuntimeError # Raised by errors that don't fall into other categories.
| +-- NotImplementedEr… # Can be raised by abstract methods or by unfinished code.
| +-- RecursionError # Raised when the maximum recursion depth is exceeded.
+-- StopIteration # Raised when an empty iterator is passed to next().
+-- TypeError # When an argument of the wrong type is passed to function.
+-- ValueError # When argument has the right type but inappropriate value.
+-----------+------------+------------+------------+
| | List | Set | Dict |
+-----------+------------+------------+------------+
| getitem() | IndexError | | KeyError |
| pop() | IndexError | KeyError | KeyError |
| remove() | ValueError | KeyError | |
| index() | ValueError | | |
+-----------+------------+------------+------------+
raise TypeError ( 'Argument is of the wrong type!' )
raise ValueError ( 'Argument has the right type but an inappropriate value!' )
raise RuntimeError ( 'I am too lazy to define my own exception!' ) class MyError ( Exception ): pass
class MyInputError ( MyError ): pass 透過引發 SystemExit 異常退出解譯器。
import sys
sys . exit () # Exits with exit code 0 (success).
sys . exit ( < int > ) # Exits with the passed exit code.
sys . exit ( < obj > ) # Prints to stderr and exits with 1. print ( < el_1 > , ..., sep = ' ' , end = ' n ' , file = sys . stdout , flush = False )'file=sys.stderr'來取得有關錯誤的訊息。'flush=True'或程式退出。 from pprint import pprint
pprint ( < collection > , width = 80 , depth = None , compact = False , sort_dicts = True ) < str > = input ( prompt = None ) import sys
scripts_path = sys . argv [ 0 ]
arguments = sys . argv [ 1 :] from argparse import ArgumentParser , FileType
p = ArgumentParser ( description = < str > ) # Returns a parser.
p . add_argument ( '-<short_name>' , '--<name>' , action = 'store_true' ) # Flag (defaults to False).
p . add_argument ( '-<short_name>' , '--<name>' , type = < type > ) # Option (defaults to None).
p . add_argument ( '<name>' , type = < type > , nargs = 1 ) # Mandatory first argument.
p . add_argument ( '<name>' , type = < type > , nargs = '+' ) # Mandatory remaining args.
p . add_argument ( '<name>' , type = < type > , nargs = '?/*' ) # Optional argument/s.
args = p . parse_args () # Exits on parsing error.
< obj > = args . < name > # Returns `<type>(<arg>)`.'help=<str>'設定將在說明訊息中顯示的參數描述。'default=<obj>'設定選項或可選參數的預設值。'type=FileType(<mode>)' 。接受“編碼”，但“換行符”為“無”。 開啟文件並返回相應的文件對象。
< file > = open ( < path > , mode = 'r' , encoding = None , newline = None )'encoding=None'表示使用預設編碼，這取決於平台。最佳實踐是盡可能使用'encoding="utf-8"' 。'newline=None'表示所有不同的行尾組合在讀取時都會轉換為 'n'，而在寫入時所有 'n' 字元都轉換為系統的預設行分隔符號。'newline=""'表示不會發生任何轉換，但輸入仍然會被 readline() 和 readlines() 在每個 'n'、'r' 和 'rn' 上分成區塊。'r'閱讀。預設使用。'w' - 寫。刪除現有內容。'x' - 如果檔案已存在則寫入或失敗。'a' - 追加。如果不存在則建立新檔案。'w+' - 讀寫。刪除現有內容。'r+' - 從頭開始讀取和寫入。'a+' - 從末尾讀取和寫入。'b' - 二進位模式（ 'rb' 、 'wb' 、 'xb'等）。'r'或'r+'讀取時可能會引發'FileNotFoundError' 。'x'寫入時可能會引發'FileExistsError' 。'IsADirectoryError'和'PermissionError'可以由任何錯誤引發。'OSError'是所有列出的異常的父類別。 < file > . seek ( 0 ) # Moves to the start of the file.
< file > . seek ( offset ) # Moves 'offset' chars/bytes from the start.
< file > . seek ( 0 , 2 ) # Moves to the end of the file.
< bin_file > . seek (± offset , origin ) # Origin: 0 start, 1 current position, 2 end. < str / bytes > = < file > . read ( size = - 1 ) # Reads 'size' chars/bytes or until EOF.
< str / bytes > = < file > . readline () # Returns a line or empty string/bytes on EOF.
< list > = < file > . readlines () # Returns a list of remaining lines.
< str / bytes > = next ( < file > ) # Returns a line using buffer. Do not mix. < file > . write ( < str / bytes > ) # Writes a string or bytes object.
< file > . writelines ( < collection > ) # Writes a coll. of strings or bytes objects.
< file > . flush () # Flushes write buffer. Runs every 4096/8192 B.
< file > . close () # Closes the file after flushing write buffer. def read_file ( filename ):
with open ( filename , encoding = 'utf-8' ) as file :
return file . readlines () def write_to_file ( filename , text ):
with open ( filename , 'w' , encoding = 'utf-8' ) as file :
file . write ( text ) import os , glob
from pathlib import Path < str > = os . getcwd () # Returns working dir. Starts as shell's $PWD.
< str > = os . path . join ( < path > , ...) # Joins two or more pathname components.
< str > = os . path . realpath ( < path > ) # Resolves symlinks and calls path.abspath(). < str > = os . path . basename ( < path > ) # Returns final component of the path.
< str > = os . path . dirname ( < path > ) # Returns path without the final component.
< tup . > = os . path . splitext ( < path > ) # Splits on last period of the final component. < list > = os . listdir ( path = '.' ) # Returns filenames located at the path.
< list > = glob . glob ( '<pattern>' ) # Returns paths matching the wildcard pattern. < bool > = os . path . exists ( < path > ) # Or: <Path>.exists()
< bool > = os . path . isfile ( < path > ) # Or: <DirEntry/Path>.is_file()
< bool > = os . path . isdir ( < path > ) # Or: <DirEntry/Path>.is_dir() < stat > = os . stat ( < path > ) # Or: <DirEntry/Path>.stat()
< num > = < stat > . st_mtime / st_size / … # Modification time, size in bytes, etc.與 listdir() 不同，scandir() 會傳回 DirEntry 對象，該物件快取 isfile、isdir，在 Windows 上也快取 stat 訊息，從而顯著提高需要它的程式碼的效能。
< iter > = os . scandir ( path = '.' ) # Returns DirEntry objects located at the path.
< str > = < DirEntry > . path # Returns the whole path as a string.
< str > = < DirEntry > . name # Returns final component as a string.
< file > = open ( < DirEntry > ) # Opens the file and returns a file object. < Path > = Path ( < path > [, ...]) # Accepts strings, Paths, and DirEntry objects.
< Path > = < path > / < path > [ / ...] # First or second path must be a Path object.
< Path > = < Path > . resolve () # Returns absolute path with resolved symlinks. < Path > = Path () # Returns relative CWD. Also Path('.').
< Path > = Path . cwd () # Returns absolute CWD. Also Path().resolve().
< Path > = Path . home () # Returns user's home directory (absolute).
< Path > = Path ( __file__ ). resolve () # Returns script's path if CWD wasn't changed. < Path > = < Path > . parent # Returns Path without the final component.
< str > = < Path > . name # Returns final component as a string.
< str > = < Path > . stem # Returns final component without extension.
< str > = < Path > . suffix # Returns final component's extension.
< tup . > = < Path > . parts # Returns all components as strings. < iter > = < Path > . iterdir () # Returns directory contents as Path objects.
< iter > = < Path > . glob ( '<pattern>' ) # Returns Paths matching the wildcard pattern. < str > = str ( < Path > ) # Returns path as a string.
< file > = open ( < Path > ) # Also <Path>.read/write_text/bytes(<args>). import os , shutil , subprocess os . chdir ( < path > ) # Changes the current working directory.
os . mkdir ( < path > , mode = 0o777 ) # Creates a directory. Permissions are in octal.
os . makedirs ( < path > , mode = 0o777 ) # Creates all path's dirs. Also `exist_ok=False`. shutil . copy ( from , to ) # Copies the file. 'to' can exist or be a dir.
shutil . copy2 ( from , to ) # Also copies creation and modification time.
shutil . copytree ( from , to ) # Copies the directory. 'to' must not exist. os . rename ( from , to ) # Renames/moves the file or directory.
os . replace ( from , to ) # Same, but overwrites file 'to' even on Windows.
shutil . move ( from , to ) # Rename() that moves into 'to' if it's a dir. os . remove ( < path > ) # Deletes the file.
os . rmdir ( < path > ) # Deletes the empty directory.
shutil . rmtree ( < path > ) # Deletes the directory. < pipe > = os . popen ( '<commands>' ) # Executes commands in sh/cmd. Returns combined stdout.
< str > = < pipe > . read ( size = - 1 ) # Reads 'size' chars or until EOF. Also readline/s().
< int > = < pipe > . close () # Returns None if last command exited with returncode 0. > >> subprocess . run ( 'bc' , input = '1 + 1 n ' , capture_output = True , text = True )
CompletedProcess ( args = 'bc' , returncode = 0 , stdout = '2 n ' , stderr = '' ) > >> from shlex import split
> >> os . popen ( 'echo 1 + 1 > test.in' )
> >> subprocess . run ( split ( 'bc -s' ), stdin = open ( 'test.in' ), stdout = open ( 'test.out' , 'w' ))
CompletedProcess ( args = [ 'bc' , '-s' ], returncode = 0 )
> >> open ( 'test.out' ). read ()
'2 n ' 用於儲存字串和數字集合的文字檔案格式。
import json
< str > = json . dumps ( < list / dict > ) # Converts collection to JSON string.
< coll > = json . loads ( < str > ) # Converts JSON string to collection. def read_json_file ( filename ):
with open ( filename , encoding = 'utf-8' ) as file :
return json . load ( file ) def write_to_json_file ( filename , list_or_dict ):
with open ( filename , 'w' , encoding = 'utf-8' ) as file :
json . dump ( list_or_dict , file , ensure_ascii = False , indent = 2 )用於儲存 Python 物件的二進位檔案格式。
import pickle
< bytes > = pickle . dumps ( < object > ) # Converts object to bytes object.
< object > = pickle . loads ( < bytes > ) # Converts bytes object to object. def read_pickle_file ( filename ):
with open ( filename , 'rb' ) as file :
return pickle . load ( file ) def write_to_pickle_file ( filename , an_object ):
with open ( filename , 'wb' ) as file :
pickle . dump ( an_object , file )用於儲存電子表格的文字檔案格式。
import csv < reader > = csv . reader ( < file > ) # Also: `dialect='excel', delimiter=','`.
< list > = next ( < reader > ) # Returns next row as a list of strings.
< list > = list ( < reader > ) # Returns a list of remaining rows.'newline=""'參數打開，否則嵌入在引用字段中的換行符將無法正確解釋！ < writer > = csv . writer ( < file > ) # Also: `dialect='excel', delimiter=','`.
< writer > . writerow ( < collection > ) # Encodes objects using `str(<el>)`.
< writer > . writerows ( < coll_of_coll > ) # Appends multiple rows.'newline=""'參數打開，否則在使用 'rn' 行結尾的平台上，將在每個 'n' 前面加上 'r'！'mode="a"'附加到它或使用'mode="w"'覆蓋它。'dialect' - 設定預設值的主參數。字串或“csv.Dialect”物件。'delimiter' - 用於分隔欄位的單字元字串。'lineterminator' - writer 如何終止行。 Reader 被硬編碼為 'n'、'r'、'rn'。'quotechar' - 用於引用包含特殊字元的欄位的字元。'escapechar' - 用於轉義引號的字元。'doublequote' - 欄位內的引號字元是否加倍或轉義。'quoting' - 0：根據需要，1：全部，2：除了讀為浮點數的數字之外的所有內容，3：無。'skipinitialspace' - 欄位開頭的空格字元被讀取器刪除。 +------------------+--------------+--------------+--------------+
| | excel | excel-tab | unix |
+------------------+--------------+--------------+--------------+
| delimiter | ',' | 't' | ',' |
| lineterminator | 'rn' | 'rn' | 'n' |
| quotechar | '"' | '"' | '"' |
| escapechar | None | None | None |
| doublequote | True | True | True |
| quoting | 0 | 0 | 1 |
| skipinitialspace | False | False | False |
+------------------+--------------+--------------+--------------+
def read_csv_file ( filename , ** csv_params ):
with open ( filename , encoding = 'utf-8' , newline = '' ) as file :
return list ( csv . reader ( file , ** csv_params )) def write_to_csv_file ( filename , rows , mode = 'w' , ** csv_params ):
with open ( filename , mode , encoding = 'utf-8' , newline = '' ) as file :
writer = csv . writer ( file , ** csv_params )
writer . writerows ( rows )將每個資料庫儲存到自己的檔案中的無伺服器資料庫引擎。
import sqlite3
< conn > = sqlite3 . connect ( < path > ) # Opens existing or new file. Also ':memory:'.
< conn > . close () # Closes connection. Discards uncommitted data. < cursor > = < conn > . execute ( '<query>' ) # Can raise a subclass of sqlite3.Error.
< tuple > = < cursor > . fetchone () # Returns next row. Also next(<cursor>).
< list > = < cursor > . fetchall () # Returns remaining rows. Also list(<cursor>). < conn > . execute ( '<query>' ) # Can raise a subclass of sqlite3.Error.
< conn > . commit () # Saves all changes since the last commit.
< conn > . rollback () # Discards all changes since the last commit. with < conn > : # Exits the block with commit() or rollback(),
< conn > . execute ( '<query>' ) # depending on whether any exception occurred. < conn > . execute ( '<query>' , < list / tuple > ) # Replaces '?'s in query with values.
< conn > . execute ( '<query>' , < dict / namedtuple > ) # Replaces ':<key>'s with values.
< conn > . executemany ( '<query>' , < coll_of_coll > ) # Runs execute() multiple times.此範例中實際上並未儲存值，因為省略了'conn.commit()' ！
> >> conn = sqlite3 . connect ( 'test.db' )
> >> conn . execute ( 'CREATE TABLE person (person_id INTEGER PRIMARY KEY, name, height)' )
> >> conn . execute ( 'INSERT INTO person VALUES (NULL, ?, ?)' , ( 'Jean-Luc' , 187 )). lastrowid
1
> >> conn . execute ( 'SELECT * FROM person' ). fetchall ()
[( 1 , 'Jean-Luc' , 187 )]用於透過 SQL、方法鍊或 ORM 與各種資料庫系統互動的函式庫。
# $ pip3 install sqlalchemy
from sqlalchemy import create_engine , text
< engine > = create_engine ( '<url>' ) # Url: 'dialect://user:password@host/dbname'.
< conn > = < engine > . connect () # Creates a connection. Also <conn>.close().
< cursor > = < conn > . execute ( text ( '<query>' ), …) # `<dict>`. Replaces ':<key>'s with values.
with < conn > . begin (): ... # Exits the block with commit or rollback. +-----------------+--------------+----------------------------------+
| Dialect | pip3 install | Dependencies |
+-----------------+--------------+----------------------------------+
| mysql | mysqlclient | www.pypi.org/project/mysqlclient |
| postgresql | psycopg2 | www.pypi.org/project/psycopg2 |
| mssql | pyodbc | www.pypi.org/project/pyodbc |
| oracle+oracledb | oracledb | www.pypi.org/project/oracledb |
+-----------------+--------------+----------------------------------+
位元組物件是不可變的單字節序列。可變版本稱為位元組數組。
< bytes > = b'<str>' # Only accepts ASCII characters and x00-xff.
< int > = < bytes > [ index ] # Returns an int in range from 0 to 255.
< bytes > = < bytes > [ < slice > ] # Returns bytes even if it has only one element.
< bytes > = < bytes > . join ( < coll_of_bytes > ) # Joins elements using bytes as a separator. < bytes > = bytes ( < coll_of_ints > ) # Ints must be in range from 0 to 255.
< bytes > = bytes ( < str > , 'utf-8' ) # Encodes the string. Also <str>.encode().
< bytes > = bytes . fromhex ( '<hex>' ) # Hex pairs can be separated by whitespaces.
< bytes > = < int > . to_bytes ( n_bytes , …) # `byteorder='big/little', signed=False`. < list > = list ( < bytes > ) # Returns ints in range from 0 to 255.
< str > = str ( < bytes > , 'utf-8' ) # Returns a string. Also <bytes>.decode().
< str > = < bytes > . hex () # Returns hex pairs. Accepts `sep=<str>`.
< int > = int . from_bytes ( < bytes > , …) # `byteorder='big/little', signed=False`. def read_bytes ( filename ):
with open ( filename , 'rb' ) as file :
return file . read () def write_bytes ( filename , bytes_obj ):
with open ( filename , 'wb' ) as file :
file . write ( bytes_obj ) from struct import pack , unpack
< bytes > = pack ( '<format>' , < el_1 > [, ...]) # Packs objects according to format string.
< tuple > = unpack ( '<format>' , < bytes > ) # Use iter_unpack() to get iterator of tuples. > >> pack ( '>hhl' , 1 , 2 , 3 )
b' x00 x01 x00 x02 x00 x00 x00 x03 '
> >> unpack ( '>hhl' , b' x00 x01 x00 x02 x00 x00 x00 x03 ' )
( 1 , 2 , 3 )'=' - 系統的位元組順序（通常是小端）。'<' - Little-endian（即最低有效位元組在前）。'>' - 大端字節序（也稱為'!' ）。 'c' - 具有單一元素的位元組物件。對於填充字節，請使用'x' 。'<n>s' - 具有 n 個元素的位元組物件（不受位元組順序影響）。 'b' - 字元 (1/1)'h' - 短 (2/2)'i' - 整數 (2/4)'l' - 長 (4/4)'q' - 長長 (8/8) 'f' - 浮點數 (4/4)'d' - 雙 (8/8) 只能儲存預先定義類型的數字的清單。上面列出了可用類型及其最小大小（以位元組為單位）。類型大小和位元組順序始終由系統決定，但是每個元素的位元組可以使用 byteswap() 方法反轉。
from array import array < array > = array ( '<typecode>' , < coll_of_nums > ) # Creates array from collection of numbers.
< array > = array ( '<typecode>' , < bytes > ) # Writes passed bytes to array's memory.
< array > = array ( '<typecode>' , < array > ) # Treats passed array as a sequence of numbers.
< array > . fromfile ( < file > , n_items ) # Appends file's contents to array's memory. < bytes > = bytes ( < array > ) # Returns a copy of array's memory.
< file > . write ( < array > ) # Writes array's memory to the binary file. 一個序列對象，指向另一個類似位元組的對象的記憶體。每個元素可以引用單個或多個連續字節，具體取決於格式。元素的順序和數量可以透過切片來更改。
< mview > = memoryview ( < bytes / bytearray / array > ) # Immutable if bytes is passed, else mutable.
< obj > = < mview > [ index ] # Returns int or float. Bytes if format is 'c'.
< mview > = < mview > [ < slice > ] # Returns memoryview with rearranged elements.
< mview > = < mview > . cast ( '<typecode>' ) # Only works between B/b/c and other types.
< mview > . release () # Releases memory buffer of the base object. < bytes > = bytes ( < mview > ) # Returns a new bytes object. Also bytearray().
< bytes > = < bytes > . join ( < coll_of_mviews > ) # Joins memoryviews using bytes as a separator.
< array > = array ( '<typecode>' , < mview > ) # Treats memoryview as a sequence of numbers.
< file > . write ( < mview > ) # Writes `bytes(<mview>)` to the binary file. < list > = list ( < mview > ) # Returns a list of ints, floats, or bytes.
< str > = str ( < mview > , 'utf-8' ) # Treats memoryview as a bytes object.
< str > = < mview > . hex () # Returns hex pairs. Accepts `sep=<str>`. 清單具有從兩側高效追加和彈出的功能。發音為“甲板”。
from collections import deque < deque > = deque ( < collection > ) # Use `maxlen=<int>` to set size limit.
< deque > . appendleft ( < el > ) # Opposite element is dropped if full.
< deque > . extendleft ( < collection > ) # Passed collection gets reversed.
< deque > . rotate ( n = 1 ) # Last element becomes first.
< el > = < deque > . popleft () # Raises IndexError if deque is empty. 提供運算符功能的函數模組。函數按運算子優先權（從最少到最多綁定）排序和分組。第 1、3 和 5 行中的邏輯和算術運算子在群組內也按優先順序排序。
import operator as op < bool > = op . not_ ( < obj > ) # or, and, not (or/and missing)
< bool > = op . eq / ne / lt / ge / is_ / is_not / contains ( < obj > , < obj > ) # ==, !=, <, >=, is, is not, in
< obj > = op . or_ / xor / and_ ( < int / set > , < int / set > ) # |, ^, &
< int > = op . lshift / rshift ( < int > , < int > ) # <<, >>
< obj > = op . add / sub / mul / truediv / floordiv / mod ( < obj > , < obj > ) # +, -, *, /, //, %
< num > = op . neg / invert ( < num > ) # -, ~
< num > = op . pow ( < num > , < num > ) # **
< func > = op . itemgetter / attrgetter / methodcaller ( < obj > [, ...]) # [index/key], .name, .name([…]) elementwise_sum = map ( op . add , list_a , list_b )
sorted_by_second = sorted ( < coll > , key = op . itemgetter ( 1 ))
sorted_by_both = sorted ( < coll > , key = op . itemgetter ( 1 , 0 ))
first_element = op . methodcaller ( 'pop' , 0 )( < list > )'x < y < z'轉換為'(x < y) and (y < z) ”。 執行具有匹配模式的第一個區塊。 Python 3.10 中新增。
match < object / expression > :
case < pattern > [ if < condition > ]:
< code >
... < value_pattern > = 1 / 'abc' / True / None / math . pi # Matches the literal or a dotted name.
< class_pattern > = < type > () # Matches any object of that type (or ABC).
< wildcard_patt > = _ # Matches any object. Useful in last case.
< capture_patt > = < name > # Matches any object and binds it to name.
< as_pattern > = < pattern > as < name > # Binds match to name. Also <type>(<name>).
< or_pattern > = < pattern > | < pattern > [ | ...] # Matches any of the patterns.
< sequence_patt > = [ < pattern > , ...] # Matches sequence with matching items.
< mapping_patt > = { < value_pattern > : < patt > , ...} # Matches dictionary with matching items.
< class_pattern > = < type > ( < attr_name >= < patt > , ...) # Matches object with matching attributes.'*<name>'和'**<name>'來綁定其餘項目。'|' > 'as' > ',' ）。 > >> from pathlib import Path
> >> match Path ( '/home/gto/python-cheatsheet/README.md' ):
... case Path (
... parts = [ '/' , 'home' , user , * _ ]
... ) as p if p . name . lower (). startswith ( 'readme' ) and p . is_file ():
... print ( f' { p . name } is a readme file that belongs to user { user } .' )
'README.md is a readme file that belongs to user gto.' import logging as log log . basicConfig ( filename = < path > , level = 'DEBUG' ) # Configures the root logger (see Setup).
log . debug / info / warning / error / critical ( < str > ) # Sends message to the root logger.
< Logger > = log . getLogger ( __name__ ) # Returns logger named after the module.
< Logger > . < level > ( < str > ) # Sends message to the logger.
< Logger > . exception ( < str > ) # Error() that appends caught exception. log . basicConfig (
filename = None , # Logs to stderr or appends to file.
format = '%(levelname)s:%(name)s:%(message)s' , # Add '%(asctime)s' for local datetime.
level = log . WARNING , # Drops messages with lower priority.
handlers = [ log . StreamHandler ( sys . stderr )] # Uses FileHandler if filename is set.
) < Formatter > = log . Formatter ( '<format>' ) # Creates a Formatter.
< Handler > = log . FileHandler ( < path > , mode = 'a' ) # Creates a Handler. Also `encoding=None`.
< Handler > . setFormatter ( < Formatter > ) # Adds Formatter to the Handler.
< Handler > . setLevel ( < int / str > ) # Processes all messages by default.
< Logger > . addHandler ( < Handler > ) # Adds Handler to the Logger.
< Logger > . setLevel ( < int / str > ) # What is sent to its/ancestors' handlers.
< Logger > . propagate = < bool > # Cuts off ancestors' handlers if False.'<parent>.<name>'來指定父記錄器。'filter(<LogRecord>)'方法（或方法本身）的物件可以透過 addFilter() 新增至記錄器和處理程序。如果 filter() 傳回 false 值，則訊息將被丟棄。 > >> logger = log . getLogger ( 'my_module' )
> >> handler = log . FileHandler ( 'test.log' , encoding = 'utf-8' )
> >> handler . setFormatter ( log . Formatter ( '%(asctime)s %(levelname)s:%(name)s:%(message)s' ))
> >> logger . addHandler ( handler )
> >> logger . setLevel ( 'DEBUG' )
> >> log . basicConfig ()
> >> log . root . handlers [ 0 ]. setLevel ( 'WARNING' )
> >> logger . critical ( 'Running out of disk space.' )
CRITICAL : my_module : Running out of disk space .
> >> print ( open ( 'test.log' ). read ())
2023 - 02 - 07 23 : 21 : 01 , 430 CRITICAL : my_module : Running out of disk space . < list > = dir () # List of local names (variables, funcs, classes, modules).
< dict > = vars () # Dict of local names and their objects. Also locals().
< dict > = globals () # Dict of global names and their objects, e.g. __builtin__. < list > = dir ( < obj > ) # Returns names of object's attributes (including methods).
< dict > = vars ( < obj > ) # Returns dict of writable attributes. Also <obj>.__dict__.
< bool > = hasattr ( < obj > , '<name>' ) # Checks if object possesses attribute with passed name.
value = getattr ( < obj > , '<name>' ) # Returns object's attribute or raises AttributeError.
setattr ( < obj > , '<name>' , value ) # Sets attribute. Only works on objects with __dict__ attr.
delattr ( < obj > , '<name>' ) # Deletes attribute from __dict__. Also `del <obj>.<name>`. < Sig > = inspect . signature ( < func > ) # Returns a Signature object of the passed function.
< dict > = < Sig > . parameters # Returns dict of Parameters. Also <Sig>.return_annotation.
< memb > = < Param > . kind # Returns ParameterKind member (Parameter.KEYWORD_ONLY, …).
< type > = < Param > . annotation # Returns Parameter.empty if missing. Also <Param>.default. CPython 解譯器一次只能執行一個執行緒。使用多個執行緒不會導致執行速度加快，除非至少有一個執行緒包含 I/O 操作。
from threading import Thread , Lock , RLock , Semaphore , Event , Barrier
from concurrent . futures import ThreadPoolExecutor , as_completed < Thread > = Thread ( target = < function > ) # Use `args=<collection>` to set the arguments.
< Thread > . start () # Starts the thread. Also <Thread>.is_alive().
< Thread > . join () # Waits for the thread to finish.'kwargs=<dict>'將關鍵字參數傳遞給函數。'daemon=True' ，否則當執行緒處於活動狀態時程式將無法退出。 < lock > = Lock / RLock () # RLock can only be released by acquirer.
< lock > . acquire () # Waits for the lock to be available.
< lock > . release () # Makes the lock available again. with < lock > : # Enters the block by calling acquire() and
... # exits it with release(), even on error. < Semaphore > = Semaphore ( value = 1 ) # Lock that can be acquired by 'value' threads.
< Event > = Event () # Method wait() blocks until set() is called.
< Barrier > = Barrier ( n_times ) # Wait() blocks until it's called n times. < Queue > = queue . Queue ( maxsize = 0 ) # A thread-safe first-in-first-out queue.
< Queue > . put ( < el > ) # Blocks until queue stops being full.
< Queue > . put_nowait ( < el > ) # Raises queue.Full exception if full.
< el > = < Queue > . get () # Blocks until queue stops being empty.
< el > = < Queue > . get_nowait () # Raises queue.Empty exception if empty. < Exec > = ThreadPoolExecutor ( max_workers = None ) # Or: `with ThreadPoolExecutor() as <name>: ...`
< iter > = < Exec > . map ( < func > , < args_1 > , ...) # Multithreaded and non-lazy map(). Keeps order.
< Futr > = < Exec > . submit ( < func > , < arg_1 > , ...) # Creates a thread and returns its Future obj.
< Exec > . shutdown () # Blocks until all threads finish executing. < bool > = < Future > . done () # Checks if the thread has finished executing.
< obj > = < Future > . result ( timeout = None ) # Waits for thread to finish and returns result.
< bool > = < Future > . cancel () # Cancels or returns False if running/finished.
< iter > = as_completed ( < coll_of_Futures > ) # `next(<iter>)` returns next completed Future.'if __name__ == "__main__": ...' 。 'async'開頭，其呼叫以'await'開頭。'asyncio.run(<coroutine>)'啟動第一個/主協程。 import asyncio as aio < coro > = < async_function > ( < args > ) # Creates a coroutine by calling async def function.
< obj > = await < coroutine > # Starts the coroutine and returns its result.
< task > = aio . create_task ( < coroutine > ) # Schedules the coroutine for execution.
< obj > = await < task > # Returns coroutine's result. Also <task>.cancel(). < coro > = aio . gather ( < coro / task > , ...) # Schedules coros. Returns list of results on await.
< coro > = aio . wait ( < tasks > , …) # `aio.ALL/FIRST_COMPLETED`. Returns (done, pending).
< iter > = aio . as_completed ( < coros / tasks > ) # Iterator of coros. All return next result on await. import asyncio , collections , curses , curses . textpad , enum , random
P = collections . namedtuple ( 'P' , 'x y' ) # Position
D = enum . Enum ( 'D' , 'n e s w' ) # Direction
W , H = 15 , 7 # Width, Height
def main ( screen ):
curses . curs_set ( 0 ) # Makes cursor invisible.
screen . nodelay ( True ) # Makes getch() non-blocking.
asyncio . run ( main_coroutine ( screen )) # Starts running asyncio code.
async def main_coroutine ( screen ):
moves = asyncio . Queue ()
state = { '*' : P ( 0 , 0 )} | { id_ : P ( W // 2 , H // 2 ) for id_ in range ( 10 )}
ai = [ random_controller ( id_ , moves ) for id_ in range ( 10 )]
mvc = [ human_controller ( screen , moves ), model ( moves , state ), view ( state , screen )]
tasks = [ asyncio . create_task ( coro ) for coro in ai + mvc ]
await asyncio . wait ( tasks , return_when = asyncio . FIRST_COMPLETED )
async def random_controller ( id_ , moves ):
while True :
d = random . choice ( list ( D ))
moves . put_nowait (( id_ , d ))
await asyncio . sleep ( random . triangular ( 0.01 , 0.65 ))
async def human_controller ( screen , moves ):
while True :
key_mappings = { 258 : D . s , 259 : D . n , 260 : D . w , 261 : D . e }
if d := key_mappings . get ( screen . getch ()):
moves . put_nowait (( '*' , d ))
await asyncio . sleep ( 0.005 )
async def model ( moves , state ):
while state [ '*' ] not in ( state [ id_ ] for id_ in range ( 10 )):
id_ , d = await moves . get ()
deltas = { D . n : P ( 0 , - 1 ), D . e : P ( 1 , 0 ), D . s : P ( 0 , 1 ), D . w : P ( - 1 , 0 )}
state [ id_ ] = P (( state [ id_ ]. x + deltas [ d ]. x ) % W , ( state [ id_ ]. y + deltas [ d ]. y ) % H )
async def view ( state , screen ):
offset = P ( curses . COLS // 2 - W // 2 , curses . LINES // 2 - H // 2 )
while True :
screen . erase ()
curses . textpad . rectangle ( screen , offset . y - 1 , offset . x - 1 , offset . y + H , offset . x + W )
for id_ , p in state . items ():
screen . addstr ( offset . y + ( p . y - state [ '*' ]. y + H // 2 ) % H ,
offset . x + ( p . x - state [ '*' ]. x + W // 2 ) % W , str ( id_ ))
screen . refresh ()
await asyncio . sleep ( 0.005 )
if __name__ == '__main__' :
curses . wrapper ( main ) # $ pip3 install tqdm
> >> import tqdm , time
> >> for el in tqdm . tqdm ([ 1 , 2 , 3 ], desc = 'Processing' ):
... time . sleep ( 1 )
Processing : 100 % | ████████████████████ | 3 / 3 [ 00 : 03 < 00 : 00 , 1.00 s / it ] # $ pip3 install matplotlib
import matplotlib . pyplot as plt
plt . plot / bar / scatter ( x_data , y_data [, label = < str > ]) # Also plt.plot(y_data).
plt . legend () # Adds a legend.
plt . title / xlabel / ylabel ( < str > ) # Adds a title or label.
plt . savefig ( < path > ) # Saves the plot.
plt . show () # Displays the plot.
plt . clf () # Clears the plot. # $ pip3 install tabulate
import csv , tabulate
with open ( 'test.csv' , encoding = 'utf-8' , newline = '' ) as file :
rows = list ( csv . reader ( file ))
print ( tabulate . tabulate ( rows , headers = 'firstrow' )) # $ pip3 install windows-curses
import curses , os
from curses import A_REVERSE , KEY_DOWN , KEY_UP , KEY_LEFT , KEY_RIGHT , KEY_ENTER
def main ( screen ):
ch , first , selected , paths = 0 , 0 , 0 , os . listdir ()
while ch != ord ( 'q' ):
height , width = screen . getmaxyx ()
screen . erase ()
for y , filename in enumerate ( paths [ first : first + height ]):
color = A_REVERSE if filename == paths [ selected ] else 0
screen . addnstr ( y , 0 , filename , width - 1 , color )
ch = screen . getch ()
selected += ( ch == KEY_DOWN ) - ( ch == KEY_UP )
selected = max ( 0 , min ( len ( paths ) - 1 , selected ))
first += ( selected >= first + height ) - ( selected < first )
if ch in [ KEY_LEFT , KEY_RIGHT , KEY_ENTER , ord ( ' n ' ), ord ( ' r ' )]:
new_dir = '..' if ch == KEY_LEFT else paths [ selected ]
if os . path . isdir ( new_dir ):
os . chdir ( new_dir )
first , selected , paths = 0 , 0 , os . listdir ()
if __name__ == '__main__' :
curses . wrapper ( main ) # $ pip3 install PySimpleGUI
import PySimpleGUI as sg
text_box = sg . Input ( default_text = '100' , enable_events = True , key = '-QUANTITY-' )
dropdown = sg . InputCombo ([ 'g' , 'kg' , 't' ], 'kg' , readonly = True , enable_events = True , k = '-UNIT-' )
label = sg . Text ( '100 kg is 220.462 lbs.' , key = '-OUTPUT-' )
button = sg . Button ( 'Close' )
window = sg . Window ( 'Weight Converter' , [[ text_box , dropdown ], [ label ], [ button ]])
while True :
event , values = window . read ()
if event in [ sg . WIN_CLOSED , 'Close' ]:
break
try :
quantity = float ( values [ '-QUANTITY-' ])
except ValueError :
continue
unit = values [ '-UNIT-' ]
factors = { 'g' : 0.001 , 'kg' : 1 , 't' : 1000 }
lbs = quantity * factors [ unit ] / 0.45359237
window [ '-OUTPUT-' ]. update ( value = f' { quantity } { unit } is { lbs :g } lbs.' )
window . close () # $ pip3 install requests beautifulsoup4
import requests , bs4 , os
response = requests . get ( 'https://en.wikipedia.org/wiki/Python_(programming_language)' )
document = bs4 . BeautifulSoup ( response . text , 'html.parser' )
table = document . find ( 'table' , class_ = 'infobox vevent' )
python_url = table . find ( 'th' , text = 'Website' ). next_sibling . a [ 'href' ]
logo_url = table . find ( 'img' )[ 'src' ]
logo = requests . get ( f'https: { logo_url } ' ). content
filename = os . path . basename ( logo_url )
with open ( filename , 'wb' ) as file :
file . write ( logo )
print ( f' { python_url } , file:// { os . path . abspath ( filename ) } ' )用於抓取具有動態內容的網站的資料庫。
# $ pip3 install selenium
from selenium import webdriver
< WebDrv > = webdriver . Chrome / Firefox / Safari / Edge () # Opens a browser. Also <WebDrv>.quit().
< WebDrv > . get ( '<url>' ) # Also <WebDrv>.implicitly_wait(seconds).
< El > = < WebDrv / El > . find_element ( 'css selector' , …) # '<tag>#<id>.<class>[<attr>="<val>"]…'.
< list > = < WebDrv / El > . find_elements ( 'xpath' , …) # '//<tag>[@<attr>="<val>"]…'. See XPath.
< str > = < El > . get_attribute ( < str > ) # Property if exists. Also <El>.text.
< El > . click / clear () # Also <El>.send_keys(<str>). '$x("<xpath>")'在 lxml、Scrapy 和瀏覽器控制台中使用： < xpath > = // < element > [ / or // < element > ] # /<child>, //<descendant>, /../<sibling>
< xpath > = // < element > / following :: < element > # Next element. Also preceding/parent/…
< element > = < tag > < conditions > < index > # `<tag> = */a/…`, `<index> = [1/2/…]`.
< condition > = [ < sub_cond > [ and / or < sub_cond > ]] # For negation use `not(<sub_cond>)`.
< sub_cond > = @ < attr > [ = "<val>" ] # `text()=`, `.=` match (complete) text.
< sub_cond > = contains (@ < attr > , "<val>" ) # Is <val> a substring of attr's value?
< sub_cond > = [ // ] < element > # Has matching child? Descendant if //. Flask 是一個微型 Web 框架/伺服器。如果您只想在 Web 瀏覽器中開啟 html 文件，請使用'webbrowser.open(<path>)' 。
# $ pip3 install flask
import flask as fl app = fl . Flask ( __name__ ) # Returns the app object. Put at the top.
app . run ( host = None , port = None , debug = None ) # Or: $ flask --app FILE run [--ARG[=VAL]]…'http://localhost:5000'啟動應用程式。使用'host="0.0.0.0"'在外部運作。 @ app . route ( '/img/<path:filename>' )
def serve_file ( filename ):
return fl . send_from_directory ( 'dirname/' , filename ) @ app . route ( '/<sport>' )
def serve_html ( sport ):
return fl . render_template_string ( '<h1>{{title}}</h1>' , title = sport )'fl.render_template(filename, <kwargs>)'渲染位於 'templates' 目錄中的檔案。'fl.abort(<int>)'傳回錯誤碼， 'return fl.redirect(<url>)'重新導向。'fl.request.args[<str>]'從查詢字串傳回參數（'?' 右側的 URL）。'fl.session[<str>] = <obj>'儲存會話資料。它需要在啟動時使用'app.secret_key = <str>'設定金鑰。 @ app . post ( '/<sport>/odds' )
def serve_json ( sport ):
team = fl . request . form [ 'team' ]
return { 'team' : team , 'odds' : [ 2.09 , 3.74 , 3.68 ]} # $ pip3 install requests
> >> import threading , requests
> >> threading . Thread ( target = app . run , daemon = True ). start ()
> >> url = 'http://localhost:5000/football/odds'
> >> response = requests . post ( url , data = { 'team' : 'arsenal f.c.' })
> >> response . json ()
{ 'team' : 'arsenal f.c.' , 'odds' : [ 2.09 , 3.74 , 3.68 ]} from time import perf_counter
start_time = perf_counter ()
...
duration_in_seconds = perf_counter () - start_time > >> from timeit import timeit
> >> timeit ( 'list(range(10000))' , number = 1000 , globals = globals (), setup = 'pass' )
0.19373 $ pip3 install line_profiler
$ echo '@profile
def main():
a = list(range(10000))
b = set(range(10000))
main()' > test.py
$ kernprof -lv test.py
Line # Hits Time Per Hit % Time Line Contents
==============================================================
1 @profile
2 def main():
3 1 253.4 253.4 32.2 a = list(range(10000))
4 1 534.1 534.1 67.8 b = set(range(10000))
$ apt/brew install graphviz && pip3 install gprof2dot snakeviz # Or download installer.
$ tail --lines=+2 test.py > test.py # Removes first line.
$ python3 -m cProfile -o test.prof test.py # Runs built-in profiler.
$ gprof2dot --format=pstats test.prof | dot -T png -o test.png # Generates call graph.
$ xdg-open/open test.png # Displays call graph.
$ snakeviz test.prof # Displays flame graph. +--------------+------------+-------------------------------+-------+------+
| pip3 install | Target | How to run | Lines | Live |
+--------------+------------+-------------------------------+-------+------+
| pyinstrument | CPU | pyinstrument test.py | No | No |
| py-spy | CPU | py-spy top -- python3 test.py | No | Yes |
| scalene | CPU+Memory | scalene test.py | Yes | No |
| memray | Memory | memray run --live test.py | Yes | Yes |
+--------------+------------+-------------------------------+-------+------+
數組操作迷你語言。它的運行速度比同等的 Python 程式碼快一百倍。在 GPU 上運行的更快的替代方案稱為 CuPy。
# $ pip3 install numpy
import numpy as np < array > = np . array ( < list / list_of_lists / … > ) # Returns a 1d/2d/… NumPy array.
< array > = np . zeros / ones / empty ( < shape > ) # Also np.full(<shape>, <el>).
< array > = np . arange ( from_inc , to_exc , ± step ) # Also np.linspace(start, stop, len).
< array > = np . random . randint ( from_inc , to_exc , < shape > ) # Also np.random.random(<shape>). < view > = < array > . reshape ( < shape > ) # Also `<array>.shape = <shape>`.
< array > = < array > . flatten () # Also `<view> = <array>.ravel()`.
< view > = < array > . transpose () # Or: <array>.T < array > = np . copy / abs / sqrt / log / int64 ( < array > ) # Returns new array of the same shape.
< array > = < array > . sum / max / mean / argmax / all ( axis ) # Aggregates specified dimension.
< array > = np . apply_along_axis ( < func > , axis , < array > ) # Func can return a scalar or array. < array > = np . concatenate ( < list_of_arrays > , axis = 0 ) # Links arrays along first axis (rows).
< array > = np . vstack / column_stack ( < list_of_arrays > ) # Treats 1d arrays as rows or columns.
< array > = np . tile / repeat ( < array > , < int / list > [, axis ]) # Tiles array or repeats its elements.<el> = <2d>[row_index, col_index] # Or: <3d>[<int>, <int>, <int>]
<1d_view> = <2d>[row_index] # Or: <3d>[<int>, <int>, <slice>]
<1d_view> = <2d>[:, col_index] # Or: <3d>[<int>, <slice>, <int>]
<2d_view> = <2d>[from:to_row_i, from:to_col_i] # Or: <3d>[<int>, <slice>, <slice>] <1d_array> = <2d>[row_indices, col_indices] # Or: <3d>[<int/1d>, <1d>, <1d>]
<2d_array> = <2d>[row_indices] # Or: <3d>[<int/1d>, <1d>, <slice>]
<2d_array> = <2d>[:, col_indices] # Or: <3d>[<int/1d>, <slice>, <1d>]
<2d_array> = <2d>[np.ix_(row_indices, col_indices)] # Or: <3d>[<int/1d/2d>, <2d>, <2d>] <2d_bools> = <2d> > <el/1d/2d> # 1d object must have size of a row.
<1/2d_arr> = <2d>[<2d/1d_bools>] # 1d_bools must have size of a column.':'傳回所有維度索引的切片。省略的尺寸預設為':' 。'obj[i, j]'轉換為'obj[(i, j)]' ！'ix_([1, 2], [3, 4])'返回'[[1], [2]]'和'[[3, 4]]' 。由於廣播規則，這與使用'[[1, 1], [2, 2]]'和'[[3, 4], [3, 4]]'相同。NumPy 函數對不同形狀的陣列進行操作的一組規則。
left = [ 0.1 , 0.6 , 0.8 ] # Shape: (3,)
right = [[ 0.1 ], [ 0.6 ], [ 0.8 ]] # Shape: (3, 1) left = [[ 0.1 , 0.6 , 0.8 ]] # Shape: (1, 3) <- !
right = [[ 0.1 ], [ 0.6 ], [ 0.8 ]] # Shape: (3, 1) left = [[ 0.1 , 0.6 , 0.8 ], # Shape: (3, 3) <- !
[ 0.1 , 0.6 , 0.8 ],
[ 0.1 , 0.6 , 0.8 ]]
right = [[ 0.1 , 0.1 , 0.1 ], # Shape: (3, 3) <- !
[ 0.6 , 0.6 , 0.6 ],
[ 0.8 , 0.8 , 0.8 ]][0.1, 0.6, 0.8] => [1, 2, 1] ）： > >> points = np . array ([ 0.1 , 0.6 , 0.8 ])
[ 0.1 , 0.6 , 0.8 ]
> >> wrapped_points = points . reshape ( 3 , 1 )
[[ 0.1 ], [ 0.6 ], [ 0.8 ]]
> >> distances = points - wrapped_points
[[ 0. , 0.5 , 0.7 ],
[ - 0.5 , 0. , 0.2 ],
[ - 0.7 , - 0.2 , 0. ]]
> >> distances = np . abs ( distances )
[[ 0. , 0.5 , 0.7 ],
[ 0.5 , 0. , 0.2 ],
[ 0.7 , 0.2 , 0. ]]
> >> distances [ range ( 3 ), range ( 3 )] = np . inf
[[ inf , 0.5 , 0.7 ],
[ 0.5 , inf , 0.2 ],
[ 0.7 , 0.2 , inf ]]
> >> distances . argmin ( 1 )
[ 1 , 2 , 1 ] # $ pip3 install pillow
from PIL import Image < Image > = Image . new ( '<mode>' , ( width , height )) # Creates new image. Also `color=<int/tuple>`.
< Image > = Image . open ( < path > ) # Identifies format based on file's contents.
< Image > = < Image > . convert ( '<mode>' ) # Converts image to the new mode (see Modes).
< Image > . save ( < path > ) # Selects format based on extension (PNG/JPG…).
< Image > . show () # Displays image in default preview app. < int / tup > = < Image > . getpixel (( x , y )) # Returns pixel's value (its color).
< ImgCore > = < Image > . getdata () # Returns a flattened view of pixel values.
< Image > . putpixel (( x , y ), < int / tuple > ) # Updates pixel's value. Clips passed int/s.
< Image > . putdata ( < list / ImgCore > ) # Updates pixels with a copy of the sequence.
< Image > . paste ( < Image > , ( x , y )) # Draws passed image at the specified location. < Image > = < Image > . filter ( < Filter > ) # Use ImageFilter.<name>(<args>) for Filter.
< Image > = < Enhance > . enhance ( < float > ) # Use ImageEnhance.<name>(<Image>) for Enhance. < array > = np . array ( < Image > ) # Creates a 2d/3d NumPy array from the image.
< Image > = Image . fromarray ( np . uint8 ( < array > )) # Use <array>.clip(0, 255) to clip the values.'L' - 亮度（灰階影像）。每個像素都是 0 到 255 之間的整數。'RGB' - 紅、綠、藍（真彩色影像）。每個像素都是三個整數的元組。'RGBA' - 帶 Alpha 的 RGB。低 alpha（即 int）使像素更加透明。'HSV' - 色調、飽和度、明度。三個整數表示 HSV 色彩空間中的顏色。 WIDTH , HEIGHT = 100 , 100
n_pixels = WIDTH * HEIGHT
hues = ( 255 * i / n_pixels for i in range ( n_pixels ))
img = Image . new ( 'HSV' , ( WIDTH , HEIGHT ))
img . putdata ([( int ( h ), 255 , 255 ) for h in hues ])
img . convert ( 'RGB' ). save ( 'test.png' ) from random import randint
add_noise = lambda value : max ( 0 , min ( 255 , value + randint ( - 20 , 20 )))
img = Image . open ( 'test.png' ). convert ( 'HSV' )
img . putdata ([( add_noise ( h ), s , v ) for h , s , v in img . getdata ()])
img . show () from PIL import ImageDraw
< Draw > = ImageDraw . Draw ( < Image > ) # Object for adding 2D graphics to the image.
< Draw > . point (( x , y )) # Draws a point. Truncates floats into ints.
< Draw > . line (( x1 , y1 , x2 , y2 [, ...])) # To get anti-aliasing use Image's resize().
< Draw > . arc (( x1 , y1 , x2 , y2 ), deg1 , deg2 ) # Draws in clockwise dir. Also pieslice().
< Draw > . rectangle (( x1 , y1 , x2 , y2 )) # Also rounded_rectangle(), regular_polygon().
< Draw > . polygon (( x1 , y1 , x2 , y2 , ...)) # Last point gets connected to the first.
< Draw > . ellipse (( x1 , y1 , x2 , y2 )) # To rotate use Image's rotate() and paste().
< Draw > . text (( x , y ), < str > , font = < Font > ) # `<Font> = ImageFont.truetype(<path>, size)`.'fill=<color>'設定主色。'width=<int>'設定線條或輪廓的寬度。'outline=<color>'設定輪廓的顏色。'#rrggbb[aa]'字串或顏色名稱。 # $ pip3 install imageio
from PIL import Image , ImageDraw
import imageio
WIDTH , HEIGHT , R = 126 , 126 , 10
frames = []
for velocity in range ( 1 , 16 ):
y = sum ( range ( velocity ))
frame = Image . new ( 'L' , ( WIDTH , HEIGHT ))
draw = ImageDraw . Draw ( frame )
draw . ellipse (( WIDTH / 2 - R , y , WIDTH / 2 + R , y + R * 2 ), fill = 'white' )
frames . append ( frame )
frames += reversed ( frames [ 1 : - 1 ])
imageio . mimsave ( 'test.gif' , frames , duration = 0.03 ) import wave < Wave > = wave . open ( '<path>' ) # Opens the WAV file for reading.
< int > = < Wave > . getframerate () # Returns number of frames per second.
< int > = < Wave > . getnchannels () # Returns number of samples per frame.
< int > = < Wave > . getsampwidth () # Returns number of bytes per sample.
< tuple > = < Wave > . getparams () # Returns namedtuple of all parameters.
< bytes > = < Wave > . readframes ( nframes ) # Returns next n frames (-1 returns all). < Wave > = wave . open ( '<path>' , 'wb' ) # Creates/truncates a file for writing.
< Wave > . setframerate ( < int > ) # Pass 44100 for CD, 48000 for video.
< Wave > . setnchannels ( < int > ) # Pass 1 for mono, 2 for stereo.
< Wave > . setsampwidth ( < int > ) # Pass 2 for CD, 3 for hi-res sound.
< Wave > . setparams ( < tuple > ) # Tuple must contain all parameters.
< Wave > . writeframes ( < bytes > ) # Appends frames to the file. +-----------+-----------+------+-----------+
| sampwidth | min | zero | max |
+-----------+-----------+------+-----------+
| 1 | 0 | 128 | 255 |
| 2 | -32768 | 0 | 32767 |
| 3 | -8388608 | 0 | 8388607 |
+-----------+-----------+------+-----------+
def read_wav_file ( filename ):
def get_int ( bytes_obj ):
an_int = int . from_bytes ( bytes_obj , 'little' , signed = ( p . sampwidth != 1 ))
return an_int - 128 * ( p . sampwidth == 1 )
with wave . open ( filename ) as file :
p = file . getparams ()
frames = file . readframes ( - 1 )
bytes_samples = ( frames [ i : i + p . sampwidth ] for i in range ( 0 , len ( frames ), p . sampwidth ))
return [ get_int ( b ) / pow ( 2 , ( p . sampwidth * 8 ) - 1 ) for b in bytes_samples ], p def write_to_wav_file ( filename , samples_f , p = None , nchannels = 1 , sampwidth = 2 , framerate = 44100 ):
def get_bytes ( a_float ):
a_float = max ( - 1 , min ( 1 - 2e-16 , a_float ))
a_float += p . sampwidth == 1
a_float *= pow ( 2 , ( p . sampwidth * 8 ) - 1 )
return int ( a_float ). to_bytes ( p . sampwidth , 'little' , signed = ( p . sampwidth != 1 ))
if p is None :
p = wave . _wave_params ( nchannels , sampwidth , framerate , 0 , 'NONE' , 'not compressed' )
with wave . open ( filename , 'wb' ) as file :
file . setparams ( p )
file . writeframes ( b'' . join ( get_bytes ( f ) for f in samples_f )) from math import pi , sin
samples_f = ( sin ( i * 2 * pi * 440 / 44100 ) for i in range ( 100_000 ))
write_to_wav_file ( 'test.wav' , samples_f ) from random import uniform
samples_f , params = read_wav_file ( 'test.wav' )
samples_f = ( f + uniform ( - 0.05 , 0.05 ) for f in samples_f )
write_to_wav_file ( 'test.wav' , samples_f , params ) # $ pip3 install simpleaudio
from simpleaudio import play_buffer
with wave . open ( 'test.wav' ) as file :
p = file . getparams ()
frames = file . readframes ( - 1 )
play_buffer ( frames , p . nchannels , p . sampwidth , p . framerate ). wait_done () # $ pip3 install pyttsx3
import pyttsx3
engine = pyttsx3 . init ()
engine . say ( 'Sally sells seashells by the seashore.' )
engine . runAndWait () # $ pip3 install simpleaudio
import array , itertools as it , math , simpleaudio
F = 44100
P1 = '71♩,69♪,,71♩,66♪,,62♩,66♪,,59♩,,,71♩,69♪,,71♩,66♪,,62♩,66♪,,59♩,,,'
P2 = '71♩,73♪,,74♩,73♪,,74♪,,71♪,,73♩,71♪,,73♪,,69♪,,71♩,69♪,,71♪,,67♪,,71♩,,,'
get_pause = lambda seconds : it . repeat ( 0 , int ( seconds * F ))
sin_f = lambda i , hz : math . sin ( i * 2 * math . pi * hz / F )
get_wave = lambda hz , seconds : ( sin_f ( i , hz ) for i in range ( int ( seconds * F )))
get_hz = lambda note : 440 * 2 ** (( int ( note [: 2 ]) - 69 ) / 12 )
get_sec = lambda note : 1 / 4 if '♩' in note else 1 / 8
get_samples = lambda note : get_wave ( get_hz ( note ), get_sec ( note )) if note else get_pause ( 1 / 8 )
samples_f = it . chain . from_iterable ( get_samples ( n ) for n in ( P1 + P2 ). split ( ',' ))
samples_i = array . array ( 'h' , ( int ( f * 30000 ) for f in samples_f ))
simpleaudio . play_buffer ( samples_i , 1 , 2 , F ). wait_done () # $ pip3 install pygame
import pygame as pg
pg . init ()
screen = pg . display . set_mode (( 500 , 500 ))
rect = pg . Rect ( 240 , 240 , 20 , 20 )
while not pg . event . get ( pg . QUIT ):
deltas = { pg . K_UP : ( 0 , - 20 ), pg . K_RIGHT : ( 20 , 0 ), pg . K_DOWN : ( 0 , 20 ), pg . K_LEFT : ( - 20 , 0 )}
for event in pg . event . get ( pg . KEYDOWN ):
dx , dy = deltas . get ( event . key , ( 0 , 0 ))
rect = rect . move (( dx , dy ))
screen . fill ( pg . Color ( 'black' ))
pg . draw . rect ( screen , pg . Color ( 'white' ), rect )
pg . display . flip ()用於儲存直角座標的物件。
< Rect > = pg . Rect ( x , y , width , height ) # Creates Rect object. Truncates passed floats.
< int > = < Rect > . x / y / centerx / centery / … # Top, right, bottom, left. Allows assignments.
< tup . > = < Rect > . topleft / center / … # Topright, bottomright, bottomleft. Same.
< Rect > = < Rect > . move (( delta_x , delta_y )) # Use move_ip() to move in-place. < bool > = < Rect > . collidepoint (( x , y )) # Checks if rectangle contains the point.
< bool > = < Rect > . colliderect ( < Rect > ) # Checks if the two rectangles overlap.
< int > = < Rect > . collidelist ( < list_of_Rect > ) # Returns index of first colliding Rect or -1.
< list > = < Rect > . collidelistall ( < list_of_Rect > ) # Returns indices of all colliding rectangles.用於表示影像的物件。
< Surf > = pg . display . set_mode (( width , height )) # Opens new window and returns its surface.
< Surf > = pg . Surface (( width , height )) # New RGB surface. RGBA if `flags=pg.SRCALPHA`.
< Surf > = pg . image . load ( < path / file > ) # Loads the image. Format depends on source.
< Surf > = pg . surfarray . make_surface ( < np_array > ) # Also `<np_arr> = surfarray.pixels3d(<Surf>)`.
< Surf > = < Surf > . subsurface ( < Rect > ) # Creates a new surface from the cutout. < Surf > . fill ( color ) # Tuple, Color('#rrggbb[aa]') or Color(<name>).
< Surf > . set_at (( x , y ), color ) # Updates pixel. Also <Surf>.get_at((x, y)).
< Surf > . blit ( < Surf > , ( x , y )) # Draws passed surface at specified location. from pygame . transform import scale , ...
< Surf > = scale ( < Surf > , ( width , height )) # Returns scaled surface.
< Surf > = rotate ( < Surf > , anticlock_degrees ) # Returns rotated and scaled surface.
< Surf > = flip ( < Surf > , x_bool , y_bool ) # Returns flipped surface. from pygame . draw import line , ...
line ( < Surf > , color , ( x1 , y1 ), ( x2 , y2 ), width ) # Draws a line to the surface.
arc ( < Surf > , color , < Rect > , from_rad , to_rad ) # Also ellipse(<Surf>, color, <Rect>, width=0).
rect ( < Surf > , color , < Rect > , width = 0 ) # Also polygon(<Surf>, color, points, width=0). < Font > = pg . font . Font ( < path / file > , size ) # Loads TTF file. Pass None for default font.
< Surf > = < Font > . render ( text , antialias , color ) # Background color can be specified at the end. < Sound > = pg . mixer . Sound ( < path / file / bytes > ) # WAV file or bytes/array of signed shorts.
< Sound > . play / stop () # Also set_volume(<float>), fadeout(msec). import collections , dataclasses , enum , io , itertools as it , pygame as pg , urllib . request
from random import randint
P = collections . namedtuple ( 'P' , 'x y' ) # Position
D = enum . Enum ( 'D' , 'n e s w' ) # Direction
W , H , MAX_S = 50 , 50 , P ( 5 , 10 ) # Width, Height, Max speed
def main ():
def get_screen ():
pg . init ()
return pg . display . set_mode (( W * 16 , H * 16 ))
def get_images ():
url = 'https://gto76.github.io/python-cheatsheet/web/mario_bros.png'
img = pg . image . load ( io . BytesIO ( urllib . request . urlopen ( url ). read ()))
return [ img . subsurface ( get_rect ( x , 0 )) for x in range ( img . get_width () // 16 )]
def get_mario ():
Mario = dataclasses . make_dataclass ( 'Mario' , 'rect spd facing_left frame_cycle' . split ())
return Mario ( get_rect ( 1 , 1 ), P ( 0 , 0 ), False , it . cycle ( range ( 3 )))
def get_tiles ():
border = [( x , y ) for x in range ( W ) for y in range ( H ) if x in [ 0 , W - 1 ] or y in [ 0 , H - 1 ]]
platforms = [( randint ( 1 , W - 2 ), randint ( 2 , H - 2 )) for _ in range ( W * H // 10 )]
return [ get_rect ( x , y ) for x , y in border + platforms ]
def get_rect ( x , y ):
return pg . Rect ( x * 16 , y * 16 , 16 , 16 )
run ( get_screen (), get_images (), get_mario (), get_tiles ())
def run ( screen , images , mario , tiles ):
clock = pg . time . Clock ()
pressed = set ()
while not pg . event . get ( pg . QUIT ) and clock . tick ( 28 ):
keys = { pg . K_UP : D . n , pg . K_RIGHT : D . e , pg . K_DOWN : D . s , pg . K_LEFT : D . w }
pressed |= { keys . get ( e . key ) for e in pg . event . get ( pg . KEYDOWN )}
pressed -= { keys . get ( e . key ) for e in pg . event . get ( pg . KEYUP )}
update_speed ( mario , tiles , pressed )
update_position ( mario , tiles )
draw ( screen , images , mario , tiles )
def update_speed ( mario , tiles , pressed ):
x , y = mario . spd
x += 2 * (( D . e in pressed ) - ( D . w in pressed ))
x += ( x < 0 ) - ( x > 0 )
y += 1 if D . s not in get_boundaries ( mario . rect , tiles ) else ( D . n in pressed ) * - 10
mario . spd = P ( x = max ( - MAX_S . x , min ( MAX_S . x , x )), y = max ( - MAX_S . y , min ( MAX_S . y , y )))
def update_position ( mario , tiles ):
x , y = mario . rect . topleft
n_steps = max ( abs ( s ) for s in mario . spd )
for _ in range ( n_steps ):
mario . spd = stop_on_collision ( mario . spd , get_boundaries ( mario . rect , tiles ))
x , y = x + ( mario . spd . x / n_steps ), y + ( mario . spd . y / n_steps )
mario . rect . topleft = x , y
def get_boundaries ( rect , tiles ):
deltas = { D . n : P ( 0 , - 1 ), D . e : P ( 1 , 0 ), D . s : P ( 0 , 1 ), D . w : P ( - 1 , 0 )}
return { d for d , delta in deltas . items () if rect . move ( delta ). collidelist ( tiles ) != - 1 }
def stop_on_collision ( spd , bounds ):
return P ( x = 0 if ( D . w in bounds and spd . x < 0 ) or ( D . e in bounds and spd . x > 0 ) else spd . x ,
y = 0 if ( D . n in bounds and spd . y < 0 ) or ( D . s in bounds and spd . y > 0 ) else spd . y )
def draw ( screen , images , mario , tiles ):
screen . fill (( 85 , 168 , 255 ))
mario . facing_left = mario . spd . x < 0 if mario . spd . x else mario . facing_left
is_airborne = D . s not in get_boundaries ( mario . rect , tiles )
image_index = 4 if is_airborne else ( next ( mario . frame_cycle ) if mario . spd . x else 6 )
screen . blit ( images [ image_index + ( mario . facing_left * 9 )], mario . rect )
for t in tiles :
is_border = t . x in [ 0 , ( W - 1 ) * 16 ] or t . y in [ 0 , ( H - 1 ) * 16 ]
screen . blit ( images [ 18 if is_border else 19 ], t )
pg . display . flip ()
if __name__ == '__main__' :
main ()數據分析庫。範例請參考 Plotly。
# $ pip3 install pandas matplotlib
import pandas as pd , matplotlib . pyplot as plt帶名字的有序字典。
> >> s = pd . Series ([ 1 , 2 ], index = [ 'x' , 'y' ], name = 'a' ); s
x 1
y 2
Name : a , dtype : int64 < S > = pd . Series ( < list > ) # Uses list's indices for 'index'.
< S > = pd . Series ( < dict > ) # Uses dictionary's keys for 'index'. < el > = < S > . loc [ key ] # Or: <S>.iloc[i]
< S > = < S > . loc [ coll_of_keys ] # Or: <S>.iloc[coll_of_i]
< S > = < S > . loc [ from_key : to_key_inc ] # Or: <S>.iloc[from_i : to_i_exc] < el > = < S > [ key / i ] # Or: <S>.<key>
< S > = < S > [ coll_of_keys / coll_of_i ] # Or: <S>[key/i : key/i]
< S > = < S > [ bools ] # Or: <S>.loc/iloc[bools] < S > = < S > > < el / S > # Returns S of bools. Pairs items by keys.
< S > = < S > + < el / S > # Items with non-matching keys get value NaN. < S > = pd . concat ( < coll_of_S > ) # Concats multiple series into one long Series.
< S > = < S > . combine_first ( < S > ) # Adds items that are not yet present.
< S > . update ( < S > ) # Updates items that are already present. < S > . plot . line / area / bar / pie / hist () # Generates a plot. `plt.show()` displays it.'obj[x, y]'被轉換為'obj[(x, y)]' ！'np.int64' 。如果我們將 np.nan 分配給任何項目，系列將轉換為'float64' 。使用'<S>.astype(<str/type>)'取得轉換後的系列。'pd.Series([100], dtype="int8") + 100' Series 將悄悄溢出。 < el > = < S > . sum / max / mean / idxmax / all () # Or: <S>.agg(lambda <S>: <el>)
< S > = < S > . rank / diff / cumsum / ffill / interpol …() # Or: <S>.agg/transform(lambda <S>: <S>)
< S > = < S > . isna / fillna / isin ([ < el / coll > ]) # Or: <S>.agg/transform/map(lambda <el>: <el>) +--------------+-------------+-------------+---------------+
| | 'sum' | ['sum'] | {'s': 'sum'} |
+--------------+-------------+-------------+---------------+
| s.apply(…) | 3 | sum 3 | s 3 |
| s.agg(…) | | | |
+--------------+-------------+-------------+---------------+
+--------------+-------------+-------------+---------------+
| | 'rank' | ['rank'] | {'r': 'rank'} |
+--------------+-------------+-------------+---------------+
| s.apply(…) | | rank | |
| s.agg(…) | x 1.0 | x 1.0 | r x 1.0 |
| | y 2.0 | y 2.0 | y 2.0 |
+--------------+-------------+-------------+---------------+
'inplace=True' 。'<S>[key_1, key_2]'取得其值。帶有標記的行和列的表格。
> >> df = pd . DataFrame ([[ 1 , 2 ], [ 3 , 4 ]], index = [ 'a' , 'b' ], columns = [ 'x' , 'y' ]); df
x y
a 1 2
b 3 4 < DF > = pd . DataFrame ( < list_of_rows > ) # Rows can be either lists, dicts or series.
< DF > = pd . DataFrame ( < dict_of_columns > ) # Columns can be either lists, dicts or series. < el > = < DF > . loc [ row_key , col_key ] # Or: <DF>.iloc[row_i, col_i]
< S / DF > = < DF > . loc [ row_key / s ] # Or: <DF>.iloc[row_i/s]
< S / DF > = < DF > . loc [:, col_key / s ] # Or: <DF>.iloc[:, col_i/s]
< DF > = < DF > . loc [ row_bools , col_bools ] # Or: <DF>.iloc[row_bools, col_bools] < S / DF > = < DF > [ col_key / s ] # Or: <DF>.<col_key>
< DF > = < DF > [ < S_of_bools > ] # Filters rows. For example `df[df.x > 1]`.
< DF > = < DF > [ < DF_of_bools > ] # Assigns NaN to items that are False in bools. < DF > = < DF > > < el / S / DF > # Returns DF of bools. S is treated as a row.
< DF > = < DF > + < el / S / DF > # Items with non-matching keys get value NaN. < DF > = < DF > . set_index ( col_key ) # Replaces row keys with column's values.
< DF > = < DF > . reset_index ( drop = False ) # Drops or moves row keys to column named index.
< DF > = < DF > . sort_index ( ascending = True ) # Sorts rows by row keys. Use `axis=1` for cols.
< DF > = < DF > . sort_values ( col_key / s ) # Sorts rows by passed column/s. Also `axis=1`. < DF > = < DF > . head / tail / sample ( < int > ) # Returns first, last, or random n rows.
< DF > = < DF > . describe () # Describes columns. Also info(), corr(), shape.
< DF > = < DF > . query ( '<query>' ) # Filters rows. For example `df.query('x > 1')`. < DF > . plot . line / area / bar / scatter ( x = col_key , …) # `y=col_key/s`. Also hist/box(by=col_key).
plt . show () # Displays the plot. Also plt.savefig(<path>). > >> df_2 = pd . DataFrame ([[ 4 , 5 ], [ 6 , 7 ]], index = [ 'b' , 'c' ], columns = [ 'y' , 'z' ]); df_2
y z
b 4 5
c 6 7 +-----------------------+---------------+------------+------------+---------------------------+
| | 'outer' | 'inner' | 'left' | Description |
+-----------------------+---------------+------------+------------+---------------------------+
| df.merge(df_2, | x y z | x y z | x y z | Merges on column if 'on' |
| on='y', | 0 1 2 . | 3 4 5 | 1 2 . | or 'left_on/right_on' are |
| how=…) | 1 3 4 5 | | 3 4 5 | set, else on shared cols. |
| | 2 . 6 7 | | | Uses 'inner' by default. |
+-----------------------+---------------+------------+------------+---------------------------+
| df.join(df_2, | x yl yr z | | x yl yr z | Merges on row keys. |
| lsuffix='l', | a 1 2 . . | x yl yr z | 1 2 . . | Uses 'left' by default. |
| rsuffix='r', | b 3 4 4 5 | 3 4 4 5 | 3 4 4 5 | If Series is passed, it |
| how=…) | c . . 6 7 | | | is treated as a column. |
+-----------------------+---------------+------------+------------+---------------------------+
| pd.concat([df, df_2], | x y z | y | | Adds rows at the bottom. |
| axis=0, | a 1 2 . | 2 | | Uses 'outer' by default. |
| join=…) | b 3 4 . | 4 | | A Series is treated as a |
| | b . 4 5 | 4 | | column. To add a row use |
| | c . 6 7 | 6 | | pd.concat([df, DF([s])]). |
+-----------------------+---------------+------------+------------+---------------------------+
| pd.concat([df, df_2], | x y y z | | | Adds columns at the |
| axis=1, | a 1 2 . . | x y y z | | right end. Uses 'outer' |
| join=…) | b 3 4 4 5 | 3 4 4 5 | | by default. A Series is |
| | c . . 6 7 | | | treated as a column. |
+-----------------------+---------------+------------+------------+---------------------------+
< S > = < DF > . sum / max / mean / idxmax / all () # Or: <DF>.apply/agg(lambda <S>: <el>)
< DF > = < DF > . rank / diff / cumsum / ffill / interpo …() # Or: <DF>.apply/agg/transform(lambda <S>: <S>)
< DF > = < DF > . isna / fillna / isin ([ < el / coll > ]) # Or: <DF>.applymap(lambda <el>: <el>) +-----------------+---------------+---------------+---------------+
| | 'sum' | ['sum'] | {'x': 'sum'} |
+-----------------+---------------+---------------+---------------+
| df.apply(…) | x 4 | x y | x 4 |
| df.agg(…) | y 6 | sum 4 6 | |
+-----------------+---------------+---------------+---------------+
+-----------------+---------------+---------------+---------------+
| | 'rank' | ['rank'] | {'x': 'rank'} |
+-----------------+---------------+---------------+---------------+
| df.apply(…) | | x y | |
| df.agg(…) | x y | rank rank | x |
| df.transform(…) | a 1.0 1.0 | a 1.0 1.0 | a 1.0 |
| | b 2.0 2.0 | b 2.0 2.0 | b 2.0 |
+-----------------+---------------+---------------+---------------+
'axis=1'來處理行。'<DF>.loc[row_key, (col_key_1, col_key_2)]' 。 < DF > = < DF > . xs ( row_key , level = < int > ) # Rows with key on passed level of multi-index.
< DF > = < DF > . xs ( row_keys , level = < ints > ) # Rows that have first key on first level, etc.
< DF > = < DF > . set_index ( col_keys ) # Combines multiple columns into a multi-index.
< S / DF > = < DF > . stack / unstack ( level = - 1 ) # Combines col keys with row keys or vice versa.
< DF > = < DF > . pivot_table ( index = col_key / s ) # `columns=key/s, values=key/s, aggfunc='mean'`. < DF > = pd . read_json / html ( '<str/path/url>' ) # Run `$ pip3 install beautifulsoup4 lxml`.
< DF > = pd . read_csv ( '<path/url>' ) # `header/index_col/dtype/usecols/…=<obj>`.
< DF > = pd . read_pickle / excel ( '<path/url>' ) # Use `sheet_name=None` to get all Excel sheets.
< DF > = pd . read_sql ( '<table/query>' , < conn . > ) # SQLite3/SQLAlchemy connection (see #SQLite). < dict > = < DF > . to_dict ( 'd/l/s/…' ) # Returns columns as dicts, lists or series.
< str > = < DF > . to_json / html / csv / latex () # Saves output to a file if path is passed.
< DF > . to_pickle / excel ( < path > ) # Run `$ pip3 install "pandas[excel]" odfpy`.
< DF > . to_sql ( '<table_name>' , < connection > ) # Also `if_exists='fail/replace/append'`.'<S> = pd.to_datetime(<S>, errors="coerce")'不同。'<S>.dt.year/date/…' 。根據傳遞的列的值將資料幀的行分組在一起的物件。
< GB > = < DF > . groupby ( col_key / s ) # Splits DF into groups based on passed column.
< DF > = < GB > . apply ( < func > ) # Maps each group. Func can return DF, S or el.
< DF > = < GB > . filter ( < func > ) # Drops a group if function returns False.
< DF > = < GB > . get_group ( < el > ) # Selects a group by grouping column's value.
< S > = < GB > . size () # S of group sizes. Same keys as get_group().
< GB > = < GB > [ col_key ] # Single column GB. All operations return S. < DF > = < GB > . sum / max / mean / idxmax / all () # Or: <GB>.agg(lambda <S>: <el>)
< DF > = < GB > . rank / diff / cumsum / ffill () # Or: <GB>.transform(lambda <S>: <S>)
< DF > = < GB > . fillna ( < el > ) # Or: <GB>.transform(lambda <S>: <S>) 'z' ： > >> df = pd . DataFrame ([[ 1 , 2 , 3 ], [ 4 , 5 , 6 ], [ 7 , 8 , 6 ]], list ( 'abc' ), list ( 'xyz' ))
> >> gb = df . groupby ( 'z' ); gb . apply ( print )
x y z
a 1 2 3
x y z
b 4 5 6
c 7 8 6
>> > gb . sum ()
x y
z
3 1 2
6 11 13用於捲動視窗計算的物件。
< RS / RDF / RGB > = < S / DF / GB > . rolling ( win_size ) # Also: `min_periods=None, center=False`.
< RS / RDF / RGB > = < RDF / RGB > [ col_key / s ] # Or: <RDF/RGB>.col_key
< S / DF > = < R > . mean / sum / max () # Or: <R>.apply/agg(<agg_func/str>) # $ pip3 install plotly kaleido pandas
import plotly . express as px , pandas as pd < Fig > = px . line ( < DF > , x = col_key , y = col_key ) # Or: px.line(x=<list>, y=<list>)
< Fig > . update_layout ( margin = dict ( t = 0 , r = 0 , b = 0 , l = 0 )) # Also `paper_bgcolor='rgb(0, 0, 0)'`.
< Fig > . write_html / json / image ( '<path>' ) # <Fig>.show() displays the plot. < Fig > = px . area / bar / box ( < DF > , x = col_key , y = col_key ) # Also `color=col_key`.
< Fig > = px . scatter ( < DF > , x = col_key , y = col_key ) # Also `color/size/symbol=col_key`.
< Fig > = px . scatter_3d ( < DF > , x = col_key , y = col_key , …) # `z=col_key`. Also color/size/symbol.
< Fig > = px . histogram ( < DF > , x = col_key [, nbins = < int > ]) # Number of bins depends on DF size. 
covid = pd . read_csv ( 'https://raw.githubusercontent.com/owid/covid-19-data/8dde8ca49b'
'6e648c17dd420b2726ca0779402651/public/data/owid-covid-data.csv' ,
usecols = [ 'iso_code' , 'date' , 'total_deaths' , 'population' ])
continents = pd . read_csv ( 'https://gto76.github.io/python-cheatsheet/web/continents.csv' ,
usecols = [ 'Three_Letter_Country_Code' , 'Continent_Name' ])
df = pd . merge ( covid , continents , left_on = 'iso_code' , right_on = 'Three_Letter_Country_Code' )
df = df . groupby ([ 'Continent_Name' , 'date' ]). sum (). reset_index ()
df [ 'Total Deaths per Million' ] = df . total_deaths * 1e6 / df . population
df = df [ df . date > '2020-03-14' ]
df = df . rename ({ 'date' : 'Date' , 'Continent_Name' : 'Continent' }, axis = 'columns' )
px . line ( df , x = 'Date' , y = 'Total Deaths per Million' , color = 'Continent' ). show ()
import pandas as pd , plotly . graph_objects as go
def main ():
covid , bitcoin , gold , dow = scrape_data ()
df = wrangle_data ( covid , bitcoin , gold , dow )
display_data ( df )
def scrape_data ():
def get_covid_cases ():
url = 'https://covid.ourworldindata.org/data/owid-covid-data.csv'
df = pd . read_csv ( url , usecols = [ 'location' , 'date' , 'total_cases' ])
df = df [ df . location == 'World' ]
return df . set_index ( 'date' ). total_cases
def get_ticker ( symbol ):
url = ( f'https://query1.finance.yahoo.com/v7/finance/download/ { symbol } ?'
'period1=1579651200&period2=9999999999&interval=1d&events=history' )
df = pd . read_csv ( url , usecols = [ 'Date' , 'Close' ])
return df . set_index ( 'Date' ). Close
out = get_covid_cases (), get_ticker ( 'BTC-USD' ), get_ticker ( 'GC=F' ), get_ticker ( '^DJI' )
names = [ 'Total Cases' , 'Bitcoin' , 'Gold' , 'Dow Jones' ]
return map ( pd . Series . rename , out , names )
def wrangle_data ( covid , bitcoin , gold , dow ):
df = pd . concat ([ bitcoin , gold , dow ], axis = 1 ) # Creates table by joining columns on dates.
df = df . sort_index (). interpolate () # Sorts rows by date and interpolates NaN-s.
df = df . loc [ '2020-02-23' :] # Discards rows before '2020-02-23'.
df = ( df / df . iloc [ 0 ]) * 100 # Calculates percentages relative to day 1.
df = df . join ( covid ) # Adds column with covid cases.
return df . sort_values ( df . index [ - 1 ], axis = 1 ) # Sorts columns by last day's value.
def display_data ( df ):
figure = go . Figure ()
for col_name in reversed ( df . columns ):
yaxis = 'y1' if col_name == 'Total Cases' else 'y2'
trace = go . Scatter ( x = df . index , y = df [ col_name ], name = col_name , yaxis = yaxis )
figure . add_trace ( trace )
figure . update_layout (
yaxis1 = dict ( title = 'Total Cases' , rangemode = 'tozero' ),
yaxis2 = dict ( title = '%' , rangemode = 'tozero' , overlaying = 'y' , side = 'right' ),
legend = dict ( x = 1.08 ),
width = 944 ,
height = 423
)
figure . show ()
if __name__ == '__main__' :
main ()將類似 Python 的程式碼編譯為 C 的函式庫。
# $ pip3 install cython
import pyximport ; pyximport . install () # Module that runs imported Cython scripts.
import < cython_script > # Script needs a '.pyx' extension.
< cython_script > . main () # Main() isn't automatically executed. 'cdef'定義都是可選的，但它們有助於加速。'*'和'&'支持 C 指針、結構、聯合和枚舉。 cdef < ctype / type > < var_name > [ = < obj > ]
cdef < ctype > [ n_elements ] < var_name > [ = < coll_of_nums > ]
cdef < ctype / type / void > < func_name > ( < ctype / type > < arg_name > ): ... cdef class < class_name > :
cdef public < ctype / type > < attr_name >
def __init__ ( self , < ctype / type > < arg_name > ):
self . < attr_name > = < arg_name >用於將庫直接安裝到專案目錄中的系統。
$ python3 -m venv NAME # Creates virtual environment in current directory.
$ source NAME/bin/activate # Activates env. On Windows run `NAMEScriptsactivate`.
$ pip3 install LIBRARY # Installs the library into active environment.
$ python3 FILE # Runs the script in active environment. Also `./FILE`.
$ deactivate # Deactivates the active virtual environment.使用'$ python3 FILE'或'$ chmod u+x FILE; ./FILE'要在發生未捕獲的異常時自動啟動調試器，請運行'$ python3 -m pdb -cc FILE' 。
#!/usr/bin/env python3
#
# Usage: .py
#
from sys import argv , exit
from collections import defaultdict , namedtuple
from dataclasses import make_dataclass
from enum import Enum
import functools as ft , itertools as it , operator as op , re
def main ():
pass
###
## UTIL
#
def read_file ( filename ):
with open ( filename , encoding = 'utf-8' ) as file :
return file . readlines ()
if __name__ == '__main__' :
main ()'#<title>'會將搜尋限制為標題。'?'取得其部分的連結。
