欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

Python優(yōu)秀開源項目Rich源碼解析的流程分析

 更新時間:2020年07月06日 11:32:16   作者:渡碼  
這篇文章主要介紹了Python優(yōu)秀開源項目Rich源碼解析,本文通過實例圖文相結(jié)合給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下

這篇文章對優(yōu)秀的開源項目Rich的源碼進行解析,OMG,盤他。為什么建議閱讀源碼,有兩個原因,第一,單純學語言很難在實踐中靈活應(yīng)用,通過閱讀源碼可以看到每個知識點的運用場景,印象會更深,以后寫代碼的時候就能應(yīng)用起來;第二,通過閱讀優(yōu)秀的開源代碼,可以學習比人的代碼規(guī)范、設(shè)計思路;第三,參與到開源社區(qū),獲得更廣闊的的發(fā)展前景;第四,面試加分項。所以,有時間的話還是建議大家多讀讀優(yōu)秀開源項目的源碼。

下面進入今天的主題,這個開源項目的名字叫Rich,地址:https://github.com/willmcgugan/rich 。這個項目是個英國老鐵開發(fā)的,比較友好的是有中文文檔。它的作用是可以在控制臺輸出富文本和精美的可視化格式(如:表格、進度條和markdown)。截圖感受一下

各種格式

進度條

效果看起來很酷炫,我忍不住看了一些代碼,發(fā)現(xiàn)作者用的是Python 3.8版本實現(xiàn)的,好多新特性我也不了解,所以在看源碼過程中還補了一下語法基礎(chǔ)。下面以一個例子來簡單看看Rich的源碼,源碼的講解我盡量言簡意賅,重點講解源碼中涉及的一些關(guān)鍵的知識點。

先撿個軟柿子捏,如下:

from rich import print

print('Hello, [bold yellow]World[/bold yellow]!')

 

輸出效果:

可以看到對單詞World顯示為粗體、紅顏色。

先通過一張圖來看看大致流程

簡單來說就是將文本的格式轉(zhuǎn)化成標準輸出能夠識別的格式,然后輸出即可。下面來講解源碼,當我們調(diào)用print函數(shù)時,最終程序會跳轉(zhuǎn)到console.py文件的print函數(shù)中,執(zhí)行以下代碼

調(diào)用self._collect_renderables函數(shù)處理輸入的字符串,將需要格式化的部分標出來,返回的renderables變量是一個Text列表,因為輸入只有1個字符串,所以列表的大小為1,變量結(jié)果如下

Span(7, 12, 'bold red')便是框出來需要格式化的內(nèi)容。

上述代碼還有一個with self,它的作用我們一會兒再說。接著print函數(shù)往下看

這里會遍歷剛剛提到的renderables變量,先調(diào)用render函數(shù)渲染輸入的文本,然后調(diào)用extend函數(shù)將render返回的結(jié)果添加到self._buffer列表里。這里有幾個知識點簡單說一下

  • self._buffer是函數(shù)調(diào)用,由于它加了@property注解,所以調(diào)用是可以不用加小括號,它返回的是self._thread_locals.buffer變量,該變量是List[Segment]類型的
  • self._thread_locals.buffer變量用到dataclasses模塊的field函數(shù)初始化,初始化代碼為buffer: List[Segment] = field(default_factory=list),dataclassesPython 3.7 版本的新引入的模塊,field函數(shù)可提供更加靈活的初始化方式,并且該模塊中的@dataclass注解可以為類自動添加__init__等方法,比較方便
  • extend = self._buffer.extend這種寫法將listextent函數(shù)存到了臨時變量里,后續(xù)直接通過extend調(diào)用該函數(shù),比對象名.extend的方式更簡潔。

下面我們來看render(renderable, render_options)函數(shù)的渲染邏輯,該函數(shù)里會調(diào)用下面的代碼

render_iterable = renderable.__rich_console__(self, options)

在函數(shù)聲明里renderable對象是RenderableType類型的,但實際上Text類型的,并且這兩種類型沒有繼承關(guān)系,這里沒太想明白作者為什么這樣搞。所以,這里的__rich_console__函數(shù)我們要到text.py文件中去找。__rich_console__函數(shù)最終會調(diào)用Text對象的render函數(shù),核心代碼如下:

def render(self, console: "Console", end: str = "") -> Iterable["Segment"]:
 style_map = {index: get_style(span.style) for index, span in enumerated_spans}

 _Segment = Segment

 for (offset, leaving, style_id), (next_offset, _, _) in zip(spans, spans[1:]):
 yield _Segment(text[offset:next_offset], get_current_style())

調(diào)用get_style函數(shù),將格式轉(zhuǎn)為Style對象,如:'bold red'轉(zhuǎn)成Style對象,然后按照不同的顯示格式進行‘分片',每個‘片段'構(gòu)造一個Segment對象存儲文本及其對應(yīng)的格式。

get_style函數(shù)會調(diào)用Style.parse(name)生成Style對象,核心代碼如下

@lru_cache(maxsize=1024)
def parse(cls, style_definition: str) -> "Style":
 words = iter(style_definition.split())
 for original_word in words:
 word = original_word.lower()
 if word == "on":
 # ...省略
 elif word in style_attributes:
 attributes[style_attributes[word]] = True
 else:
 color = word
 style = Style(color=color, bgcolor=bgcolor, link=link, **attributes)
 return style

參數(shù)style_definition取值為bold red,分割后生成['bold', 'red']列表,當word變量等于'bold'時,會執(zhí)行attributes[style_attributes[word]] = True語句,執(zhí)行后attributes等于{'bold': true},它是一個字典。當word變量等于red時,執(zhí)行color=word語句。最終調(diào)用導(dǎo)數(shù)第二行構(gòu)造Style對象,Style對象最核心的兩個數(shù)據(jù)形式_attributes_color, 前者是int類型,在我們例子中取值是1,代表'bold',即:粗體。后者代表顏色,即:'red',它是Color類型的,該類中有個屬性number也是我們后續(xù)要用到的。

下面來看下__rich_console__函數(shù)返回了哪些Segment對象

可以看到有4個,每一個都有文本及其Style對象。

回到render(renderable, render_options)函數(shù),剛剛介紹了__rich_console__部分,下面還有返回的代碼, 一起來看看

iter_render = iter(render_iterable)
for render_output in iter_render:
 if isinstance(render_output, Segment):
 yield render_output

render_iterable變量是__rich_console__的返回值,即:4個Segment對象。遍歷后通過yield方式返回。該關(guān)鍵字用來返回一個迭代器,也可以理解為一個列表。并且yield返回有個特點,函數(shù)返回值只有真正被使用的時候才會執(zhí)行調(diào)用函數(shù)。

這樣,render(renderable, render_options)函數(shù)就講解完了,返回上一層extend(render(renderable, render_options)),通過extend函數(shù)將4個Segment對象保存到buffer中,結(jié)果如下

然后print方法就執(zhí)行完了??雌饋硪呀?jīng)結(jié)束了,然而控制臺打印的代碼貌似沒有看到。答案就在剛剛的with self中,with關(guān)鍵字使得執(zhí)行完代碼體后,會自動調(diào)用self__exit__函數(shù)。__exit__函數(shù)中調(diào)用_render_buffer函數(shù)進行最終的輸出,核心代碼如下

output: List[str] = []
append = output.append
for line in Segment.split_and_crop_lines(buffer, self.width, pad=False):
 for text, style, is_control in line:
 if style and not is_control:
  append(
  style.render(
   text,
   color_system=color_system,
   legacy_windows=legacy_windows,
  )
  )
rendered = "".join(output)

return rendered

split_and_crop_lines函數(shù)是為了適應(yīng)控制臺的寬度,暫時忽略它。line變量仍然是剛剛提到的4個Segment對象,通過for text, style, is_control in line直接將每個Segment對象的屬性解出來并賦給text, style, is_control變量,最終每個style對象都會調(diào)用render方法完成最后的渲染。

render方法核心代碼如下

attrs = self._make_ansi_codes(color_system)
rendered = f"\x1b[{attrs}m{text}\x1b[0m" if attrs else text

_make_ansi_codes函數(shù)就不展開了, 其實就是利用上面提到的_attributesnumber屬性生成標準輸出的能夠識別的格式,返回值attrs的結(jié)果為1;31,1取自_attributes代表粗體,31中的1取自number代表顏色,其他顏色取值是不同的,比如黃色是33,紫色是35。最后通過f-string格式(新特性)生成rendered變量,取值為World它就是標準輸出流能夠識別的格式。

回到_render_buffer函數(shù)中,調(diào)用rendered = "".join(output)將4個渲染后的片段拼在一起,返回。返回后執(zhí)行的代碼如下:

text = self._render_buffer()
if text:
 self.file.write(text)

self.file變量的賦值語句為self.file = file or sys.stdout,由于我們沒有定義file變量,所以self.file取值為sys.stdout。最終的輸出為sys.stdout.write(text),至此整個流程就講解完了。如果你理解了上述邏輯,應(yīng)該可以通過下面代碼輸出同樣的效果

sys.stdout.write('Hello, \033[1;31mWorld\033[0m!')

所以Rich做的就是把文字格式準成標準輸出流能識別的格式。

Rich里用到的代碼確實挺新的,能學到很多東西,比直接看書來的快,有興趣的朋友可以自行閱讀。

源碼:https://github.com/willmcgugan/rich

總結(jié)

到此這篇關(guān)于Python優(yōu)秀開源項目Rich源碼解析的文章就介紹到這了,更多相關(guān)Python優(yōu)秀開源項目內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!

相關(guān)文章

  • 深入探究Python Numba庫編譯優(yōu)化利器

    深入探究Python Numba庫編譯優(yōu)化利器

    這篇文章主要為大家介紹了Python Numba庫編譯優(yōu)化利器深入探究,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2024-01-01
  • Python多版本安裝與Jupyter Lab使用方式

    Python多版本安裝與Jupyter Lab使用方式

    這篇文章主要介紹了Python多版本安裝與Jupyter Lab使用方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
    2024-01-01
  • python開發(fā)的自動化運維工具ansible詳解

    python開發(fā)的自動化運維工具ansible詳解

    ansible是新出現(xiàn)的自動化運維工具,基于Python開發(fā),集合了眾多運維工具(puppet、chef、func、fabric)的優(yōu)點,實現(xiàn)了批量系統(tǒng)配置、批量程序部署、批量運行命令等功能,這篇文章主要介紹了python開發(fā)的自動化運維工具ansible詳解,需要的朋友可以參考下
    2021-08-08
  • 100?個?Python?小例子(練習題四)

    100?個?Python?小例子(練習題四)

    這篇文章主要給大家分享100?個?Python?小例子,前文分享了一二三,本文的四十最后一篇了,這篇就把100道python小練習全分享完了,感興趣的小伙伴也可以去練習前幾期內(nèi)容,洗碗給這幾篇文章給你的學習帶來幫助
    2022-01-01
  • python 5個頂級異步框架推薦

    python 5個頂級異步框架推薦

    這篇文章主要介紹了python5個頂級的異步框架,幫助大家更好的利用python進行web開發(fā),感興趣的朋友可以了解下
    2020-09-09
  • 使用Python實現(xiàn)在Word中添加或刪除超鏈接

    使用Python實現(xiàn)在Word中添加或刪除超鏈接

    在Word文檔中,超鏈接是一種將文本或圖像連接到其他文檔、網(wǎng)頁或同一文檔中不同部分的功能,本文將為大家介紹一下Python如何實現(xiàn)在Word中添加或刪除超鏈接,需要的可以參考下
    2025-01-01
  • 如何基于python實現(xiàn)單目三維重建詳解

    如何基于python實現(xiàn)單目三維重建詳解

    單目三維重建是根據(jù)單個攝像頭的運動模擬雙目視覺獲得物體在空間中的三維視覺信息,下面這篇文章主要給大家介紹了關(guān)于如何基于python實現(xiàn)單目三維重建的相關(guān)資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下
    2022-06-06
  • Python代碼模擬CPU工作原理

    Python代碼模擬CPU工作原理

    Python代碼來實現(xiàn)一個最簡單的CPU。用代碼模擬大的部件,使大家從原理上理解CPU工作。使它可編程,支持加減法運算、讀寫內(nèi)存、無條件跳轉(zhuǎn)、條件跳轉(zhuǎn)的功能。
    2023-01-01
  • Django對數(shù)據(jù)庫進行添加與更新的例子

    Django對數(shù)據(jù)庫進行添加與更新的例子

    今天小編就為大家分享一篇Django對數(shù)據(jù)庫進行添加與更新的例子,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2019-07-07
  • python使用opencv驅(qū)動攝像頭的方法

    python使用opencv驅(qū)動攝像頭的方法

    今天小編就為大家分享一篇python使用opencv驅(qū)動攝像頭的方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2018-08-08

最新評論