vol2: xrefs para outros vols (WIP)

Author: ramalho

online/cap08.adoc

@@ -1408,7 +1408,7 @@ https://fpy.li/pep585[PEP 585—Type Hinting Generics In Standard Collections] (
 
 Para encerrar nossa discussão de ABCs em dicas de tipo, precisamos falar sobre as ABCs `numbers`.
 
-[[numeric_tower_warning]]
+[[numeric_tower_warning_sec]]
 ===== A queda da torre numérica
 
 O((("numbers package")))((("numeric tower"))) pacote https://fpy.li/4d[`numbers`] define a assim chamada _torre numérica_ (_numeric tower_) descrita na https://fpy.li/pep3141[PEP 3141—A Type Hierarchy for Numbers] (EN).

online/cap09.adoc

@@ -1198,7 +1198,7 @@ o Mypy 0.770 reclama quando vê múltiplas funções com o mesmo nome.]
 <4> Registra uma nova função para cada tipo que precisa de tratamento especial,
 com uma dica de tipo correspondente no primeiro parâmetro.
 <5> As ABCs em `numbers` são úteis para uso em conjunto com
-`singledispatch`.footnote:[Apesar do alerta em <<numeric_tower_warning>>,
+`singledispatch`.footnote:[Apesar do alerta em <<numeric_tower_warning_sec>>,
 as ABCs de `numbers` não foram descontinuadas, e você as encontra em código de Python 3.]
 <6> `bool` é um _subtipo-de_ `numbers.Integral`,
 mas a lógica de `singledispatch` busca a implementação com o tipo correspondente mais específico,

online/cap13.adoc

@@ -2299,7 +2299,7 @@ substituição por protocolos numéricos.
 Como((("static protocols", "numbers ABCS and numeric protocols",
 id="SPnumbers13")))((("numbers ABCs", id="number13")))((("numeric protocols",
 id="numpro13")))((("protocols", "numeric", id="Pnum13"))) vimos em
-<<numeric_tower_warning>>, as ABCs no pacote `numbers` da biblioteca padrão
+<<numeric_tower_warning_sec>>, as ABCs no pacote `numbers` da biblioteca padrão
 funcionam bem para checagem de tipos durante a execução.
 
 Se você precisa checar um inteiro, pode usar `isinstance(x, numbers.Integral)`

print/xrefs/xref-other-vols.ipynb

@@ -2,18 +2,10 @@
  "cells": [
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": null,
    "id": "9e0ff8c8-2e08-4144-bb1c-31ae032ad693",
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "../../vol2/cap09.adoc\n"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
     "from pathlib import Path\n",
     "\n",
@@ -37,36 +29,10 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 15,
+   "execution_count": null,
    "id": "7c21a3dd-ed66-4587-aa51-a443365d346d",
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "{'ch_data_model': (1, 1),\n",
-       " 'ch_sequences': (1, 2),\n",
-       " 'ch_dicts_sets': (1, 3),\n",
-       " 'ch_str_bytes': (1, 4),\n",
-       " 'ch_dataclass': (1, 5),\n",
-       " 'ch_refs_mut_mem': (1, 6),\n",
-       " 'ch_func_objects': (1, 7),\n",
-       " 'ch_type_hints_def': (1, 8),\n",
-       " 'ch_generators': (3, 17),\n",
-       " 'ch_with_match': (3, 18),\n",
-       " 'ch_concurrency_models': (3, 19),\n",
-       " 'ch_executors': (3, 20),\n",
-       " 'ch_async': (3, 21),\n",
-       " 'ch_dynamic_attrs': (3, 22),\n",
-       " 'ch_descriptors': (3, 23),\n",
-       " 'ch_class_metaprog': (3, 24)}"
-      ]
-     },
-     "execution_count": 15,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "other_vols = {}\n",
     "\n",
@@ -83,7 +49,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 21,
+   "execution_count": null,
    "id": "546fd140-6977-469a-8e32-c7497f09dc27",
    "metadata": {},
    "outputs": [],
@@ -104,17 +70,51 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 1,
    "id": "87de0cb0-4e90-43af-9eb0-f72874f2cc2a",
    "metadata": {},
    "outputs": [],
-   "source": []
+   "source": [
+    "from xvol_xrefs import replace_xrefs_to_vols"
+   ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 2,
    "id": "552c2fa0-ff72-404b-a7b1-868273c38cb9",
    "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "<<prop_validation_sec>> https://pythonfluente.com/2/#prop_validation_sec[«Seção 22.4»] (vol.3)\n",
+      "<<numeric_tower_warning_sec>> https://pythonfluente.com/2/#numeric_tower_warning_sec[«Seção 8.5.7.1»] (vol.1)\n",
+      "<<methods_are_descriptors_sec>> https://pythonfluente.com/2/#methods_are_descriptors_sec[«Seção 23.4»] (vol.3)\n"
+     ]
+    },
+    {
+     "ename": "ValueError",
+     "evalue": "unexpected xref: 'ex_vector2d'",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[31m---------------------------------------------------------------------------\u001b[39m",
+      "\u001b[31mValueError\u001b[39m                                Traceback (most recent call last)",
+      "\u001b[36mCell\u001b[39m\u001b[36m \u001b[39m\u001b[32mIn[2]\u001b[39m\u001b[32m, line 1\u001b[39m\n\u001b[32m----> \u001b[39m\u001b[32m1\u001b[39m \u001b[43mreplace_xrefs_to_vols\u001b[49m\u001b[43m(\u001b[49m\u001b[43m)\u001b[49m\n",
+      "\u001b[36mFile \u001b[39m\u001b[32m~/flupy/pythonfluente2e/print/xrefs/xvol_xrefs.py:165\u001b[39m, in \u001b[36mreplace_xrefs_to_vols\u001b[39m\u001b[34m()\u001b[39m\n\u001b[32m    163\u001b[39m     text = \u001b[33mf\u001b[39m\u001b[33m'\u001b[39m\u001b[33mSeção \u001b[39m\u001b[38;5;132;01m{\u001b[39;00mnumber_str\u001b[38;5;132;01m}\u001b[39;00m\u001b[33m'\u001b[39m\n\u001b[32m    164\u001b[39m \u001b[38;5;28;01melse\u001b[39;00m:\n\u001b[32m--> \u001b[39m\u001b[32m165\u001b[39m     \u001b[38;5;28;01mraise\u001b[39;00m \u001b[38;5;167;01mValueError\u001b[39;00m(\u001b[33mf\u001b[39m\u001b[33m'\u001b[39m\u001b[33munexpected xref: \u001b[39m\u001b[38;5;132;01m{\u001b[39;00mxref\u001b[38;5;132;01m!r}\u001b[39;00m\u001b[33m'\u001b[39m)\n\u001b[32m    166\u001b[39m link = BASE_URL + \u001b[33m'\u001b[39m\u001b[33m#\u001b[39m\u001b[33m'\u001b[39m + xref\n\u001b[32m    167\u001b[39m \u001b[38;5;66;03m#print(f'<<{xref}>>', f'{text} &#91;vol.{volume}, fpy.li{SHORT_URLS[link]}&#93;')\u001b[39;00m\n\u001b[32m    168\u001b[39m \u001b[38;5;66;03m# https://fpy.li/24[«Capítulo 24»] (vol.3)\u001b[39;00m\n",
+      "\u001b[31mValueError\u001b[39m: unexpected xref: 'ex_vector2d'"
+     ]
+    }
+   ],
+   "source": [
+    "replace_xrefs_to_vols()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bd8f090f-e95d-4005-96ce-160387d3db63",
+   "metadata": {},
    "outputs": [],
    "source": []
   }

print/xrefs/xvol_xrefs.py

@@ -47,7 +47,7 @@ def find_git_root():
 
 
 def list_invalid_xrefs() -> list[str]:
-    adoc = find_git_root() / 'vol1/vol1.adoc'
+    adoc = find_git_root() / 'vol2/vol2-cor.adoc'
     cmd = f'''asciidoctor -v {adoc} -o lixo'''
     result = subprocess.run(cmd, shell=True, stderr=subprocess.PIPE, text=True)
     seen = set()
@@ -161,10 +161,14 @@ def replace_xrefs_to_vols():
             chapter = numbers[0]
             volume = (chapter - 1) // 8 + 1
             text = f'Seção {number_str}'
+        elif xref.startswith('ex_'):
+            
         else:
             raise ValueError(f'unexpected xref: {xref!r}')
         link = BASE_URL + '#' + xref
-        print(f'<<{xref}>>', f'{text} &#91;vol.{volume}, fpy.li{SHORT_URLS[link]}&#93;')
+        #print(f'<<{xref}>>', f'{text} &#91;vol.{volume}, fpy.li{SHORT_URLS[link]}&#93;')
+        # https://fpy.li/24[«Capítulo 24»] (vol.3)
+        print(f'<<{xref}>>', f'{link}[«{text}»] (vol.{volume})')
 
 
 if __name__ == '__main__':

vol1/cap08.adoc

@@ -1417,7 +1417,7 @@ A lista completa de classes que se tornaram genéricas aparece na seção «_Imp
 Para encerrar nossa discussão de ABCs em dicas de tipo, precisamos falar sobre as ABCs numéricas.
 
 <<<
-[[numeric_tower_warning]]
+[[numeric_tower_warning_sec]]
 ===== A queda da torre numérica
 
 O((("numbers package")))((("numeric tower"))) pacote

vol2/cap09.adoc

@@ -1198,7 +1198,7 @@ o Mypy 0.770 reclama quando vê múltiplas funções com o mesmo nome.]
 <4> Registra uma nova função para cada tipo que precisa de tratamento especial,
 com uma dica de tipo correspondente no primeiro parâmetro.
 <5> As ABCs em `numbers` são úteis para uso em conjunto com
-`singledispatch`.footnote:[Apesar do alerta em <<numeric_tower_warning>>,
+`singledispatch`.footnote:[Apesar do alerta em <<numeric_tower_warning_sec>>,
 as ABCs de `numbers` não foram descontinuadas, e você as encontra em código de Python 3.]
 <6> `bool` é um _subtipo-de_ `numbers.Integral`,
 mas a lógica de `singledispatch` busca a implementação com o tipo correspondente mais específico,

vol2/cap13.adoc

@@ -2299,7 +2299,7 @@ substituição por protocolos numéricos.
 Como((("static protocols", "numbers ABCS and numeric protocols",
 id="SPnumbers13")))((("numbers ABCs", id="number13")))((("numeric protocols",
 id="numpro13")))((("protocols", "numeric", id="Pnum13"))) vimos em
-<<numeric_tower_warning>>, as ABCs no pacote `numbers` da biblioteca padrão
+<<numeric_tower_warning_sec>>, as ABCs no pacote `numbers` da biblioteca padrão
 funcionam bem para checagem de tipos durante a execução.
 
 Se você precisa checar um inteiro, pode usar `isinstance(x, numbers.Integral)`