該当ファイルのコミット日付が2016-09-27なので、setuptoolsの最新のドキュメントを見ても相応しい情報は乏しいものと思われます。
reddit/r2/setup.py
Latest commit 24d71d7 on 27 Sep 2016
リリースされて直ぐに使うはずはないですが、上記に一番近いsetuptoolsはこの版数です。
v28.0.0
27 Sep 2016
現在は5年経ってこの版数なのでかなり版数が進んで変更も大きくなっていると思われます。
setuptools 58.2.0 documentation
以下に最近のやり方はこれという解説している記事があり、質問のソースとは大違いですね。
PythonスクリプトをパッケージングしてPyPIに公開するまでのあれこれ
setup.pyと関連ファイル
setup.py はパッケージングに使うスクリプトだけど、もろもろの設定はこのファイルには書かないのが最近の作法らしい。だから中身はこれだけ:
import setuptools
setuptools.setup()
じゃあ、設定はどこに書くのかというと setup.cfg というファイルに書く。書式も ini ファイル風。
2016年9月当時のsetuptoolsのドキュメントが見つかるようなら何か分かりやすい説明があるかもしれません。
ただし、別のファイルに書くようになったとは言っても、使うキーワードとか書式は似たようなものになると思われるので、最新版のドキュメントの記述でも参考程度にはなると思われます。
Keywords
Configuring setup() using setup.cfg files
New and Changed setup() Keywords
実際に知識・経験があるわけでは無いのですが、参照先ソースコードや資料からさらにたどると以下のようなものになると思われます。
- paste.app_factoryとは何で、どのような機能があるのか?
- r2とは何か?
- make_appとは何か?
- この1区切りのコード全体で何を意味しているのか?
この辺はその一つ前の110行にentry_points="""
という記述が有り、関連するキーワードや情報をたどっていくと以下になります。
Keywords
のentry_poins
A dictionary mapping entry point group names to strings or lists of strings defining the entry points. Entry points are used to support dynamic discovery of services or plugins provided by a project.
エントリポイントグループ名を、エントリポイントを定義する文字列または文字列のリストにマッピングする辞書。エントリポイントは、プロジェクトによって提供されるサービスまたはプラグインの動的な検出をサポートするために使用されます。
Entry points and automatic script creation
Entry Points
The syntax for entry points is specified as follows:
エントリポイントの構文は次のように指定されます。
<name> = [<package>.[<subpackage>.]]<module>[:<object>.<object>]
where name is the name for the script you want to create, the left hand side of : is the module that contains your function and the right hand side is the object you want to invoke (e.g. a function).
ここで、nameは、作成するスクリプトの名前です。 :の左側は関数を含むモジュールであり、右側は呼び出したいオブジェクト(関数など)です。
Advertising Behavior
Entry points more generally allow a packager to advertise behavior for discovery by other libraries and applications. This feature enables “plug-in”-like functionality, where one library solicits entry points and any number of other libraries provide those entry points.
より一般的には、エントリポイントを使用すると、パッケージャは他のライブラリやアプリケーションによる検出のために動作をアドバタイズできます。
この機能により、「プラグイン」のような機能が有効になります。この機能では、1つのライブラリがエントリポイントを要求し、他の任意の数のライブラリがそれらのエントリポイントを提供します。
Each EntryPoint contains the name, group, and value. It also supplies a .load() method to import and load that entry point (module or object).
各EntryPointには、名前、グループ、および値が含まれています。 また、そのエントリポイント(モジュールまたはオブジェクト)をインポートしてロードするための.load()メソッドも提供します。
[options.entry_points]
my.plugins =
hello-world = timmins:hello_world
Then, a different project wishing to load ‘my.plugins’ plugins could run the following routine to load (and invoke) such plugins:
次に、「my.plugins」プラグインをロードしたい別のプロジェクトは、次のルーチンを実行して、そのようなプラグインをロード(および呼び出す)できます。
>>> from importlib import metadata
>>> eps = metadata.entry_points()['my.plugins']
>>> for ep in eps:
... plugin = ep.load()
... plugin()
ここまでで話は変わって、参照しているリポジトリはreddit
というWeb上のソーシャルニュース/掲示板サイトのソースですが、これはPylons
というWeb Frameworkで作られているそうです。
日本語 Reddit - Wikipedia
英語 Reddit - Wikipedia
Underlying code
As of November 10, 2009, Reddit used Pylons as its web framework.
そしてPylonsとその後継であるPyramidというFrameworkのドキュメントに、質問に該当するentry_poins
の説明がありました。
The Pyramid Cookbook v0.1 (翻訳) » Pyramid Cookbook
The Pyramid Cookbook v0.1 (翻訳) » Pylons ユーザのための Pyramid » アプリケーションの起動
また “main” はエントリポイントです。 ランチャは Setuptools の pkg_resources.require("akhet_demo#main") を 呼び、 Setuptools が Python オブジェクトを返します。エントリポイントは ディストリビューションの setup.py に定義されています。また、インストーラ はエントリポイント・ファイルにそれらを書きます。 これは akhet_demo.egg-info/entry_points.txt ファイルです:
[paste.app_factory]
main = akhet_demo:main
“paste.app_factory” は、エントリポイント・グループです (互換性を保ちたい すべてのアプリケーションのためにPasteDeploy ドキュメント中で公表されている 名前)。 “main” (等号の左側) はエントリポイントです。 “akhet_demo:main” は、 akhet_demo パッケージをインポートして “main” 属性をロードするように言います。これは akhet_demo/init.py で 定義された main() 関数です。 “[app:main]” セクションの他のオプション は、この callable へのキーワード引数になります。これらのオプションは、 Pyramid では “settings” 、Pylons では “config variables” と呼ばれます。 (“[DEFAULT]” セクション中のオプションも、デフォルト値として渡されます。) 両方のフレームワークは、アプリケーションコード中でこれらの変数にアクセス する方法を提供します。 Pyramid では request.registry.settings 辞書の 中に、Pylons では pylons.config 特殊グローバル変数の中にあります。
ランチャーは、 “[server:main] セクションを使って同じ方法でサーバーを ロードします。
The Pyramid Cookbook v0.1 (翻訳) » Pylons ユーザのための Pyramid » main 関数
Pyramid と Pylons の両方に WSGI アプリケーションを返すトップレベルの 関数があります。 Pyramid の関数は pyramidapp/init.py の中の main です。Pylons の関数は pylonsapp/config/middleware.py の中の make_app です。以下は Pyramid の ‘starter’ scaffold によって生成さ れた main 関数です:
ちなみにpaste
というのはまた別のプロジェクトらしく、以下のドキュメントサイトがあります。
ここらでpaste.app_factory
, paste.filter_app_factory
, paste.paster_command
の記述があります。
Paste Deployment
Paste Script: Development
ここまでの情報で質問に対する回答をまとめると以下になるでしょう。
paste.app_factoryとは何で、どのような機能があるのか?
→Pylons(or Pyramid) Web Framework上で動作するreddit
アプリケーションサイトのエントリポイントを区別して定義するためのグループ名
でしょう。
r2とは何か?
→main
関数として呼び出そうとしているメソッドが所属しているパッケージ
でしょう。
make_appとは何か?
→main
関数として呼び出そうとしているr2
パッケージのメソッド
でしょう。
具体的にはこちらでしょうね。
reddit/r2/r2/__init__.py#L39
直ぐに以下を呼び出しているので、処理の実態はこちらでしょう。
reddit/r2/r2/config/middleware.py#L247
この1区切りのコード全体で何を意味しているのか?
→おそらくWSGIで呼び出されるreddit
アプリケーションサイトのmain
関数エントリポイントを定義し、それがパッケージ内の何処にあるかを示していると考えられます。
- その他の
[r2.provider.xxxx]
→おそらく上記同様にWSGI等で呼び出される際の関数エントリポイントをWebサイトアプリケーションの機能的なグループ毎に定義しているものと思われます。