listagens coloridas

Author: ramalho

calango/pyproject.toml

@@ -13,6 +13,7 @@ dependencies = [
 
 [project.scripts]
 calango = "calango:main"
+farxrefs = "calango:xrefs"
 
 [build-system]
 requires = ["hatchling"]

online/cap01.adoc

@@ -134,7 +134,7 @@ simples, mas demonstra as possibilidades que se abrem com a implementação de a
 [[ex_pythonic_deck]]
 .Um baralho como uma sequência de cartas
 ====
-[source, python3]
+[source, python]
 ----
 include::../code/01-data-model/frenchdeck.py[]
 ----
@@ -147,7 +147,7 @@ sem métodos próprios, como um registro de banco de dados.
 Neste exemplo, a utilizamos para fornecer uma boa representação textual para as cartas em um baralho,
 como mostra a sessão no console:
 
-[source, pycon]
+[source, python]
 ----
 >>> beer_card = Card('7', 'diamonds')
 >>> beer_card
@@ -161,7 +161,7 @@ uma instância de `FrenchDeck` responde à
 função((("len() function")))((("functions", "len() function"))) `len()`,
 devolvendo o número de cartas naquele baralho:
 
-[source, pycon]
+[source, python]
 ----
 >>> deck = FrenchDeck()
 >>> len(deck)
@@ -171,7 +171,7 @@ devolvendo o número de cartas naquele baralho:
 Ler cartas específicas do baralho é fácil, graças ao método `+__getitem__+`.
 Por exemplo, a primeira e a última carta:
 
-[source, pycon]
+[source, python]
 ----
 >>> deck[0]
 Card(rank='2', suit='spades')
@@ -183,7 +183,7 @@ Deveríamos criar um método para obter uma carta aleatória? Não é necessári
 Python((("random.choice function"))) já tem uma função que devolve um item aleatório de uma sequência: `random.choice`.
 Podemos usá-la em uma instância de `FrenchDeck`:
 
-[source, pycon]
+[source, python]
 ----
 >>> from random import choice
 >>> choice(deck)
@@ -211,7 +211,7 @@ nosso baralho suporta fatiamento automaticamente.
 Podemos olhar as três primeiras cartas no topo de um baralho,
 e depois pegar só os ases, iniciando com o índice 12 e pulando 13 cartas por vez:
 
-[source, pycon]
+[source, python]
 ----
 >>> deck[:3]
 [Card(rank='2', suit='spades'), Card(rank='3', suit='spades'),
@@ -224,7 +224,7 @@ Card(rank='A', suit='clubs'), Card(rank='A', suit='hearts')]
 E como já temos o método especial `+__getitem__+`, nosso baralho é um objeto iterável,
 ou seja, pode ser percorrido em um laço `for`:
 
-[source, pycon]
+[source, python]
 ----
 >>> for card in deck:  # doctest: +ELLIPSIS
 ...   print(card)
@@ -236,7 +236,7 @@ Card(rank='4', suit='spades')
 
 Também podemos iterar sobre o baralho na ordem inversa:
 
-[source, pycon]
+[source, python]
 ----
 >>> for card in reversed(deck):  # doctest: +ELLIPSIS
 ...   print(card)
@@ -268,7 +268,7 @@ o operador `in` realiza uma busca sequencial.
 No nosso caso, `in` funciona com nossa classe `FrenchDeck` porque ela é iterável.
 Veja a seguir:
 
-[source, pycon]
+[source, python]
 ----
 >>> Card('Q', 'hearts') in deck
 True
@@ -282,7 +282,7 @@ na ordem espadas (o mais alto), copas, ouros e paus (o mais baixo).
 Aqui está uma função que ordena as cartas com essa regra,
 devolvendo `0` para o 2 de paus e `51` para o Ás de espadas.
 
-[source, python3]
+[source, python]
 ----
 suit_values = dict(spades=3, hearts=2, diamonds=1, clubs=0)
 
@@ -293,7 +293,7 @@ def spades_high(card):
 
 Podemos agora listar nosso baralho em ordem crescente de usando `spades_high` como critério de ordenação:
 
-[source, pycon]
+[source, python]
 ----
 >>> for card in sorted(deck, key=spades_high):  # doctest: +ELLIPSIS
 ...      print(card)
@@ -402,7 +402,7 @@ Vamos começar a projetar a API para essa classe escrevendo uma sessão de conso
 que depois podemos usar como um doctest.
 O trecho a seguir testa a adição de vetores ilustrada na <<vectors_fig>>:
 
-[source, pycon]
+[source, python]
 ----
 >>> v1 = Vector(2, 4)
 >>> v2 = Vector(2, 1)
@@ -416,7 +416,7 @@ A((("abs built-in function")))((("functions", "abs built-in function"))) funçã
 devolve o valor absoluto de números inteiros e de ponto flutuante, e a magnitude de números `complex`.
 Então, por consistência, nossa API também usa `abs` para calcular a magnitude de um vetor:
 
-[source, pycon]
+[source, python]
 ----
 >>> v = Vector(3, 4)
 >>> abs(v)
@@ -427,7 +427,7 @@ Podemos((("&#x002A; (star) operator")))((("multiplication, scalar")))((("star (&
 também implementar o operador `*`, para realizar multiplicação escalar
 (isto é, multiplicar um vetor por um número para obter um novo vetor de mesma direção e magnitude multiplicada):
 
-[source, pycon]
+[source, python]
 ----
 >>> v * 3
 Vector(9, 12)
@@ -556,7 +556,7 @@ da documentação da _Biblioteca Padrão de Python_.
 ====
 Essa é uma implementação mais rápida de `+Vector.__bool__+`:
 
-[source, python3]
+[source, python]
 ----
     def __bool__(self):
         return bool(self.x or self.y)