【python-docx】プログラムは動くが、処理内容が分からない

Question

実現したいこと

wordのフッターを消すプログラムを作成しました。
動くのですが、なぜこれで動くのかがわかりません。
コードの解説をお願いしたいです。

前提

pythonで、wordのフッターを消すプログラムを実装しています。
python-docxで提供されているメソッドには目的にピンポイントに合うメソッドが無いようでしたので、インターネットでフッターを消すためのコードを調べました。
ソースコード上の、#↓このあたりの処理がわからない で書かれている箇所です。
これで確かに動くのですが、以下のことが理解できず困っています。
①paragraph._element 、paragraph._p とは何なのか
②paragraph._p = paragraph._element = None　は何のために必要なのか
（この一行が無くても、フッターは消えます）
③なぜparagraph._p = paragraph._element = Noneだけではフッターが消えないのか。
paragraph._p = paragraph._element = Noneを実行することで、それぞれの要素の参照先アドレスが更新され、中身はnoneになることを確認しました。
であれば、このparagraph._p = paragraph._element = Noneだけ実装すればフッターは消えそうですが、このコードだけではフッターは消えません。

参照先アドレスは、print(id(paragraph._p))で、中身はprint(paragraph._p)でコンソールに出して調べました。

発生している問題・エラーメッセージ

ソースは動くが、仕組みが分からない。

該当のソースコード

import os
import docx
from docx import Document
import inspect

#フッター削除対象フォルダ
ROOT_PATH = 'XXXXXXXXXXXXXXXXXXXXXXXXXXX'

def removeFooter(file_path):
    
    document = docx.Document(file_path)
    sections = document.sections

    for section in sections:
        sections_footer = section.footer

        paragraphs = sections_footer.paragraphs
       
        for paragraph in paragraphs:

            #↓このあたりの処理がわからない
            element = paragraph._element           
            element.getparent().remove(element)
            paragraph._p = paragraph._element = None
             #↑このあたりの処理がわからない
    
    document.save(file_path)
    
def process(path):
    for pathname, dirnames, filenames in os.walk(path):
        for filename in filenames:
            if isDocx(filename):
                removeFooter(os.path.join(pathname,filename))
        
def isDocx(filename):
    return filename.endswith('.docx')

def delete_paragraph(paragraph):
    p = paragraph._element
    p.getparent().remove(p)
    paragraph._p = paragraph._element = None

process(ROOT_PATH)

### 試したこと
各処理の前後で、参照しているアドレスとその中身を確認してみました。
参照先アドレスは、print(id(paragraph._p))で、中身はprint(paragraph._p)でコンソールに出して調べました。

------remove前------
------id------
element:　　　　　　2143599308512
paragraph._element:2143599308512
paragraph._p:　　　2143599308512
------中身------
element:　　　　　　<CT_P '<w:p>' at 0x1f31879aee0>
paragraph._element:<CT_P '<w:p>' at 0x1f31879aee0>
paragraph._p:　　　　<CT_P '<w:p>' at 0x1f31879aee0>

------remove後------
------id------（remove前と変化なし)
element:　　　　　　　2143599308512
paragraph._element:　2143599308512
paragraph._p:             2143599308512
------中身------（remove前と変化なし)
element:                   <CT_P '<w:p>' at 0x1f31879aee0>
paragraph._element:  <CT_P '<w:p>' at 0x1f31879aee0>
paragraph._p:            <CT_P '<w:p>' at 0x1f31879aee0>

------paragraph._p = paragraph._element = None後------(アドレスと中身が変わる)
------id------
element:                    2143599308512
paragraph._element:  140711526034632
paragraph._p:            140711526034632
------中身------
element:                    <CT_P '<w:p>' at 0x1f31879aee0>
paragraph._element:   None
paragraph._p:             None

### 補足情報（FW/ツールのバージョンなど）

なし

Comments

[meg_]

モジュールのドキュメントに説明は在りませんでしたか？

[chiaki0011]

公式ドキュメントを参照し、getparent、_element、paragraph._pなどで検索をかけましたが、めぼしいものは出てきませんでした。getparentメソッドはヒットせず、残りはコンストラクタやメソッドなどから呼ばれているのはわかりましたが、その定義については探せませんでした。

[meg_]

内部プロパティについてはドキュメントのリンクからソースを確認するしかないかと思います。

[chiaki0011]

なるほど。先ほどGitHubにソース自体が公開されていることを知りました。
ただ、Pythonはおろか他の言語についてもほぼ知識がないので、私には読解が難しそうです。
パブリックメソッドで処理を追うのがやっとなので、もっと内部的なものになるとサッパリです。
知らないうちに初心者には難しい領域に手を出していたようですね。

ただ、わからないのにコピペしてツール動かすって気持ち悪いですよね。今後にも活かせないし。

宙ぶらりんにするのも気持ち悪いですが、一旦は諦めた方がいいのかもしれませんね。

Answer 1

本来直接操作すべきではないライブラリの内部を直接操作するようなコードであり、やはりコード自体があまりよろしくないということでクローズします。
本来は_elementや_pを直接コーディングしないし、その中身を意識しないのが正解。