差分

このページの2つのバージョン間の差分を表示します。

--- python:emmett [2024/06/21 17:59] – 作成ともやん
+++ python:emmett [2024/06/24 08:03] (現在) – [参考文献] ともやん
@@ 行 1: / 行 1: @@
 ====== Emmett - 非同期 Web アプリケーション フレームワーク ======
+<WRAP zoomimg w400 x1_3 minfont_10>
+{{ :python:dr._emmett_brown_doc.webp |Dr. Emmett Brown}}\\
+[[https://greatcharacters.miraheze.org/wiki/Dr._Emmett_Brown|Dr. Emmett Brown - Incredible Characters Wiki]]\\
+[[https://greatcharacters.miraheze.org/wiki/File:Doc_-_BackTTFuture_067Pyxurz.jpg|File:Doc - BackTTFuture 067Pyxurz.jpg - Incredible Characters Wiki]] より\\
+</WRAP>
 本家: [[https://emmett.sh|Emmett - the web framework for inventors]]\\
 ソースコード: [[git>emmett-framework/emmett|emmett-framework/emmett: The web framework for inventors]]\\
+===== Emmett チュートリアル =====
+公式: [[https://emmett.sh/docs/2.5.x/tutorial|Tutorial | Emmett framework]]\\
+<WRAP color_term>
+<WRAP color_command><html><pre>
+<font color="#0087FF"><b>$</b></font> <font color="#26A269">git</font> clone <font color="#A347BA">--depth</font> 1 https://github.com/emmett-framework/emmett.git
+</pre></html></WRAP>
+<WRAP color_result><html><pre>
+Cloning into &apos;emmett&apos;...
+remote: Enumerating objects: 231, done.
+remote: Counting objects: 100% (231/231), done.
+remote: Compressing objects: 100% (217/217), done.
+remote: Total 231 (delta 7), reused 112 (delta 4), pack-reused 0
+Receiving objects: 100% (231/231), 690.73 KiB | 5.48 MiB/s, done.
+Resolving deltas: 100% (7/7), done.
+</pre></html></WRAP>
+</WRAP>
+<WRAP color_term>
+<WRAP color_command><html><pre>
+<font color="#0087FF"><b>$</b></font> <font color="#26A269">cd</font> <u style="text-decoration-style:solid">emmett/examples/bloggy</u>
+<font color="#0087FF"><b>$</b></font> <font color="#26A269">python</font><font color="#999999"> </font><font color="#A347BA">-m</font><font color="#999999"> venv .venv </font><font color="#12488B"><b>&amp;&amp;</b></font><font color="#999999"> </font><font color="#26A269">.</font><font color="#999999"> .venv/bin/activate </font><font color="#12488B"><b>&amp;&amp;</b></font><font color="#999999"> </font><font color="#26A269">pip</font><font color="#999999"> install </font><font color="#A347BA">-U</font><font color="#999999"> pip</font>
+</pre></html></WRAP>
+<WRAP color_result><html><pre>
+Requirement already satisfied: pip in ./.venv/lib64/python3.12/site-packages (23.3.2)
+Collecting pip
+  Downloading pip-24.1-py3-none-any.whl.metadata (3.6 kB)
+Downloading pip-24.1-py3-none-any.whl (1.8 MB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">1.8/1.8 MB</font> <font color="#C01C28">9.0 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Installing collected packages: pip
+  Attempting uninstall: pip
+    Found existing installation: pip 23.3.2
+    Uninstalling pip-23.3.2:
+      Successfully uninstalled pip-23.3.2
+Successfully installed pip-24.1
+</pre></html></WRAP>
+<WRAP color_command><html><pre>
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">pip</font> install emmett
+</pre></html></WRAP>
+<WRAP color_result_long><html><pre>
+Collecting emmett
+  Downloading emmett-2.5.11-py3-none-any.whl.metadata (4.8 kB)
+Collecting click&gt;=6.0 (from emmett)
+  Downloading click-8.1.7-py3-none-any.whl.metadata (3.0 kB)
+Collecting emmett-crypto&lt;0.7,&gt;=0.6 (from emmett)
+  Downloading emmett_crypto-0.6.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (1.9 kB)
+Collecting granian&lt;1.5.0,&gt;=1.4.1 (from emmett)
+  Downloading granian-1.4.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (15 kB)
+Collecting pendulum&lt;3.1.0,&gt;=3.0.0 (from emmett)
+  Downloading pendulum-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (6.9 kB)
+Collecting pyDAL==17.3 (from emmett)
+  Downloading pyDAL-17.3-py2.py3-none-any.whl.metadata (1.4 kB)
+Collecting python-rapidjson&lt;2.0,&gt;=1.14 (from emmett)
+  Downloading python_rapidjson-1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (21 kB)
+Collecting pyyaml&lt;7.0,&gt;=6.0 (from emmett)
+  Downloading PyYAML-6.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (2.1 kB)
+Collecting renoir&lt;2.0,&gt;=1.6 (from emmett)
+  Downloading renoir-1.7.1-py3-none-any.whl.metadata (2.0 kB)
+Collecting severus&lt;2.0,&gt;=1.1 (from emmett)
+  Downloading severus-1.3.0-py3-none-any.whl.metadata (1.9 kB)
+Collecting uvloop&gt;=0.18.0 (from granian&lt;1.5.0,&gt;=1.4.1-&gt;emmett)
+  Downloading uvloop-0.19.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.9 kB)
+Collecting python-dateutil&gt;=2.6 (from pendulum&lt;3.1.0,&gt;=3.0.0-&gt;emmett)
+  Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl.metadata (8.4 kB)
+Collecting tzdata&gt;=2020.1 (from pendulum&lt;3.1.0,&gt;=3.0.0-&gt;emmett)
+  Downloading tzdata-2024.1-py2.py3-none-any.whl.metadata (1.4 kB)
+Collecting time-machine&gt;=2.6.0 (from pendulum&lt;3.1.0,&gt;=3.0.0-&gt;emmett)
+  Downloading time_machine-2.14.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (21 kB)
+Collecting six&gt;=1.5 (from python-dateutil&gt;=2.6-&gt;pendulum&lt;3.1.0,&gt;=3.0.0-&gt;emmett)
+  Downloading six-1.16.0-py2.py3-none-any.whl.metadata (1.8 kB)
+Downloading emmett-2.5.11-py3-none-any.whl (450 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">450.5/450.5 kB</font> <font color="#C01C28">6.7 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading pyDAL-17.3-py2.py3-none-any.whl (169 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">169.6/169.6 kB</font> <font color="#C01C28">9.3 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading click-8.1.7-py3-none-any.whl (97 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">97.9/97.9 kB</font> <font color="#C01C28">8.6 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading emmett_crypto-0.6.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (219 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">219.0/219.0 kB</font> <font color="#C01C28">11.7 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading granian-1.4.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.4 MB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">3.4/3.4 MB</font> <font color="#C01C28">10.9 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading pendulum-3.0.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (384 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">384.9/384.9 kB</font> <font color="#C01C28">10.5 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading python_rapidjson-1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">1.7/1.7 MB</font> <font color="#C01C28">11.1 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading PyYAML-6.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (724 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">725.0/725.0 kB</font> <font color="#C01C28">11.1 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading renoir-1.7.1-py3-none-any.whl (30 kB)
+Downloading severus-1.3.0-py3-none-any.whl (12 kB)
+Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl (229 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">229.9/229.9 kB</font> <font color="#C01C28">10.6 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading time_machine-2.14.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (33 kB)
+Downloading tzdata-2024.1-py2.py3-none-any.whl (345 kB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">345.4/345.4 kB</font> <font color="#C01C28">11.4 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading uvloop-0.19.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.2 MB)
+   <font color="#5FAF00">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">4.2/4.2 MB</font> <font color="#C01C28">11.3 MB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+Downloading six-1.16.0-py2.py3-none-any.whl (11 kB)
+Installing collected packages: pyDAL, uvloop, tzdata, six, renoir, pyyaml, python-rapidjson, emmett-crypto, click, severus, python-dateutil, granian, time-machine, pendulum, emmett
+Successfully installed click-8.1.7 emmett-2.5.11 emmett-crypto-0.6.0 granian-1.4.4 pendulum-3.0.0 pyDAL-17.3 python-dateutil-2.9.0.post0 python-rapidjson-1.17 pyyaml-6.0.1 renoir-1.7.1 severus-1.3.0 six-1.16.0 time-machine-2.14.1 tzdata-2024.1 uvloop-0.19.0
+</pre></html></WRAP>
+</WRAP>
+<WRAP color_term>
+<WRAP color_command><html><pre>
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">mkdir</font> <font color="#A347BA">-p</font> databases
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">emmett</font> <u style="text-decoration-style:solid">migrations</u> up
+</pre></html></WRAP>
+<WRAP color_result><html><pre>
+&gt; Performing upgrades against <b>sqlite://dummy.db</b>
+&gt; Performing upgrade: <font color="#2AA1B3"><b>&lt;base&gt; -&gt; 9d6518b3cdc2 (head), First migration</b></font>
+&gt; Adding revision <font color="#2AA1B3"><b>9d6518b3cdc2</b></font> to schema
+<font color="#26A269">&gt; Succesfully upgraded to revision </font><font color="#2AA1B3"><b>9d6518b3cdc2</b></font><font color="#26A269">: First migration</font>
+</pre></html></WRAP>
+<WRAP color_command><html><pre>
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">emmett</font> setup
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">emmett</font> develop
+</pre></html></WRAP>
+<WRAP color_result><html><pre>
+&gt; Starting Emmett development server on app <font color="#2AA1B3"><b>app</b></font>
+<font color="#26A269">&gt; Emmett application</font> <font color="#2AA1B3"><b>app</b></font> <font color="#26A269">running on</font> <font color="#2AA1B3">http://127.0.0.1:8000</font> <font color="#26A269">(press CTRL+C to quit)</font>
+<font color="#A2734C">&gt; Restarting (stat mode)</font>
+&gt; WARNING in ext [/home/tomoyan/my_projects/emmett/examples/bloggy/.venv/lib64/python3.12/site-packages/emmett/tools/auth/ext.py:175]:
+No mailer seems to be configured. The auth features requiring mailer won&apos;t work.
+[INFO] Starting granian (main PID: 108684)
+[INFO] Listening at: http://127.0.0.1:8000
+[INFO] Spawning worker-1 with pid: 108685
+[INFO] Started worker-1
+[INFO] Started worker-1 runtime-1
+</pre></html></WRAP>
+</WRAP>
+[[http://localhost:8000|]] にアクセスする🤔\\
+<WRAP zoomimg w400 x1_3 photo_area_long>
+{{:python:python_emmett_bloggy_001.png|Python Emmett Bloggy 001}}
+{{:python:python_emmett_bloggy_002.png|Python Emmett Bloggy 002}}
+{{:python:python_emmett_bloggy_003.png|Python Emmett Bloggy 003}}
+{{:python:python_emmett_bloggy_004.png|Python Emmett Bloggy 004}}
+{{:python:python_emmett_bloggy_005.png|Python Emmett Bloggy 005}}
+{{:python:python_emmett_bloggy_006.png|Python Emmett Bloggy 006}}
+</WRAP>
 ===== プロジェクトの作成 =====
@@ 行 7: / 行 152: @@
 <WRAP color_command><html><pre>
 <font color="#0087FF"><b>$</b></font> <font color="#26A269">mkdir</font> <font color="#A347BA">-p</font> emmett_proj <font color="#12488B"><b>&amp;&amp;</b></font> <font color="#26A269">cd</font> emmett_proj
-<font color="#0087FF"><b>$</b></font> <font color="#26A269">python</font><font color="#FF9999"> </font><font color="#A347BA">-m</font><font color="#FF9999"> venv .venv </font><font color="#12488B"><b>&amp;&amp;</b></font><font color="#FF9999"> </font><font color="#26A269">.</font><font color="#FF9999"> .venv/bin/activate </font><font color="#12488B"><b>&amp;&amp;</b></font><font color="#FF9999"> </font><font color="#26A269">pip</font><font color="#FF9999"> install </font><font color="#A347BA">-U</font><font color="#FF9999"> pip</font>
+<font color="#0087FF"><b>$</b></font> <font color="#26A269">python</font> <font color="#A347BA">-m</font> venv .venv <font color="#12488B"><b>&amp;&amp;</b></font> <font color="#26A269">.</font> .venv/bin/activate <font color="#12488B"><b>&amp;&amp;</b></font> <font color="#26A269">pip</font> install <font color="#A347BA">-U</font> pip
 </pre></html></WRAP>
 <WRAP color_result><html><pre>
@@ 行 25: / 行 170: @@
 (.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">pip</font> install emmett
 </pre></html></WRAP>
-<WRAP color_result_long><html><pre>
+<WRAP color_result_hlong><html><pre>
 Collecting emmett
   Downloading emmett-2.5.11-py3-none-any.whl.metadata (4.8 kB)
@@ 行 86: / 行 231: @@
 </pre></html></WRAP>
 </WRAP>
+===== 技術情報 =====
+==== Emmett は ASGI ではなく RSGI で動作する...🤔 ====
+Granian HTTPサーバーはASGI 代替プロトコルRSGI(Rust Server Gateway Interface)を実装してて、Emmett 2.5 で使用されるデフォルトのプロトコル、uvicorn への依存は削除されてる🤔\\
+コードを変更することなく、Webアプリケーションのパフォーマンスが約 50%  向上してる😍\\
+[[https://emmett.sh/docs/2.5.x/upgrading|Upgrading to newer releases | Emmett framework]]\\
+[[https://github.com/emmett-framework/granian/blob/master/docs/spec/RSGI.md|RSGI Specification - granian/docs/spec/RSGI.md at master · emmett-framework/granian]]\\
+==== データベース URL に指定可能な文字列の例...🤔 ====
+公式: [[https://pydal.readthedocs.io/en/latest/|Welcome to pyDAL’s API documentation! — pyDAL 17.11 documentation]]\\
+Emmett は内部で [[http://www.web2py.com/|web2py]] Web フレームワーク 由来の pyDAL を利用するので、そのドキュメントに記載がある😉\\
+<WRAP color_term>
+<WRAP color_mincode><code python>
+'sqlite://test.db'
+'spatialite://test.db'
+'sqlite:memory'
+'spatialite:memory'
+'jdbc:sqlite://test.db'
+'mysql://root:none@localhost/test'
+'postgres://mdipierro:password@localhost/test'
+'postgres:psycopg2://mdipierro:password@localhost/test'
+'postgres:pg8000://mdipierro:password@localhost/test'
+'jdbc:postgres://mdipierro:none@localhost/test'
+'mssql://web2py:none@A64X2/web2py_test'
+'mssql2://web2py:none@A64X2/web2py_test' # alternate mappings
+'mssql3://web2py:none@A64X2/web2py_test' # better pagination (requires >= 2005)
+'mssql4://web2py:none@A64X2/web2py_test' # best pagination (requires >= 2012)
+'oracle://username:password@database'
+'firebird://user:password@server:3050/database'
+'db2:ibm_db_dbi://DSN=dsn;UID=user;PWD=pass'
+'db2:pyodbc://driver=DB2;hostname=host;database=database;uid=user;pwd=password;port=port'
+'firebird://username:password@hostname/database'
+'firebird_embedded://username:password@c://path'
+'informix://user:password@server:3050/database'
+'informixu://user:password@server:3050/database' # unicode informix
+'ingres://database'  # or use an ODBC connection string, e.g. 'ingres://dsn=dsn_name'
+'google:datastore' # for google app engine datastore (uses ndb by default)
+'google:sql' # for google app engine with sql (mysql compatible)
+'teradata://DSN=dsn;UID=user;PWD=pass; DATABASE=database' # experimental
+'imap://user:password@server:port' # experimental
+'mongodb://user:password@server:port/database' # experimental
+</code></WRAP>
+</WRAP>
+===== トラブルシューティング =====
+==== RuntimeError: No driver of supported ones ('psycopg2', 'pg8000') is available ====
+PostgreSQL に接続する際に以下の内容のようなエラーが発生する...😱\\
+<WRAP color_term>
+<WRAP color_result><html><pre>
+  File &quot;/home/tomoyan/my_projects/emmett_proj/.venv/lib64/python3.12/site-packages/pydal/adapters/base.py&quot;, line 367, in __init__
+    super(SQLAdapter, self).__init__(*args, **kwargs)
+  File &quot;/home/tomoyan/my_projects/emmett_proj/.venv/lib64/python3.12/site-packages/pydal/adapters/base.py&quot;, line 49, in __init__
+    self.find_driver()
+  File &quot;/home/tomoyan/my_projects/emmett_proj/.venv/lib64/python3.12/site-packages/pydal/adapters/base.py&quot;, line 98, in find_driver
+    raise RuntimeError(
+RuntimeError: No driver of supported ones (&apos;psycopg2&apos;, &apos;pg8000&apos;) is available
+</pre></html></WRAP>
+</WRAP>
+PostgreSQL ドライバをインストールする必要がある🤔\\
+<WRAP color_term>
+<WRAP color_command><html><pre>
+(.venv) <font color="#0087FF"><b>$</b></font> <font color="#26A269">pip</font> install psycopg2
+</pre></html></WRAP>
+<WRAP color_result><html><pre>
+Collecting psycopg2
+  Downloading psycopg2-2.9.9.tar.gz (384 kB)
+     <font color="#729C1F">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</font> <font color="#26A269">384.9/384.9 kB</font> <font color="#C01C28">27.4 kB/s</font> eta <font color="#2AA1B3">0:00:00</font>
+  Installing build dependencies ... done
+  Getting requirements to build wheel ... done
+  Preparing metadata (pyproject.toml) ... done
+Building wheels for collected packages: psycopg2
+  Building wheel for psycopg2 (pyproject.toml) ... done
+  Created wheel for psycopg2: filename=psycopg2-2.9.9-cp312-cp312-linux_x86_64.whl size=170256 sha256=2e90e7bb4e1ff74e850d424bfbc9bf7c017ffbb1c37b42d79b550d13f29af782
+  Stored in directory: /home/tomoyan/.cache/pip/wheels/ff/ac/80/7ccec163e3d05ae2112311b895132409b9abfd7e0c1c6b5183
+Successfully built psycopg2
+Installing collected packages: psycopg2
+Successfully installed psycopg2-2.9.9
+</pre></html></WRAP>
+</WRAP>
+===== 参考文献 =====
+[[https://towardsdatascience.com/elegant-web-development-with-emmett-in-python-612ed898a71e|Elegant Web Development With Emmett In Python | by Emma Boudreau | Towards Data Science]]\\
+[[https://medium.com/@pangea.ai/the-ultimate-guide-to-python-development-frameworks-2021-d5f3daad75c6|The Ultimate Guide to Python Development Frameworks 2021 | by Pangea.ai | Medium]]\\
+[[https://medium.com/@carlosmarcano2704/seven-alternatives-to-fastapi-to-explore-and-contribute-python-47bcd394bf31|Seven Alternatives To FastAPI To Explore and Contribute To | Python | by Carlos Armando Marcano Vargas | Medium]]\\
+==== 付録 ====
+[[tw>tomoyan596sp/status/1804386410151223725|誰のホームページを作ってるんでしょうね...🤔 Dr. Emmett Brown 博士😅 ドッグが由来らしいPythonのEmmettフレームワーク🤔 真の非同期 Web アプリケーション フレームワークだから...😊 ASGIサーバーはRustで実装されてるGranian、weppyをforkしたEmmettは、Flaskに似てるがDjangoくらい高機能です😋]]\\