The Oracle — Python Assignment

01 — What is the Oracle?

Pretend there is a black box. You can ask it any question, and it will return a response in a particular form. However, you are only allowed to ask types of questions.

A question type is a clearly defined query that accepts one or more objects as input. Each class (object specification) must be defined with typed fields before you can use it.

The rule

Every question type takes objects as input. Every response is also a structured object. You define both.

02 — Example: A Stock Oracle

Here is an example. The oracle answers questions about stocks. First, define your questions:

How will STOCK perform?
I have STOCK_PURCHASE what should I do with it?

Then define your input classes and response classes:

from pydantic import BaseModel
from typing import Optional
from enum import Enum


# The objects (inputs)

class Stock(BaseModel):
    symbol: str
    market: str

class StockPurchase(BaseModel):
    stock: Stock
    quantity: float
    price: float


# The response (output)

class Status(Enum):
    SELL = "SELL"
    HOLD = "HOLD"
    BUY  = "BUY"

class Response(BaseModel):
    status: Optional[Status]
    by: Optional[float]  # percentage/amount
    reason: str

03 — Your Assignment

Design your law oracle.

What to create

Write what questions you want the oracle to answer
Define at least 2 objects with typed fields (one should reference the other)
Define Response objects for each question

You do not need to write the specifications in Python. I got AI to do that for me from natural language.

04 — Object Diagram

Here is how the objects relate to each other and to the oracle:

01 — ¿Qué es el Oráculo?

Imagina que exista una caja negra. Puedes preguntarle cualquier cosa y te devolverá una respuesta en una forma particular. Sin embargo, el oráculo solo puede entender tipos de preguntas.

Un tipo de pregunta es una consulta claramente definida que acepta uno o más objetos como entrada. Cada objeto debe definirse en una clase con variables tipados.

La regla

Cada tipo de pregunta recibe objetos como entrada. Cada respuesta también es un objeto estructurado. Tú defines ambos.

02 — Ejemplo: Un Oráculo de Acciones

Aquí hay un ejemplo. El oráculo responde preguntas sobre acciones bursátiles. Primero, define tus preguntas:

¿Cómo le irá a ACCION?
Tengo COMPRA_DE_ACCION, ¿qué debo hacer con ella?

Luego define tus clases de entrada y de respuesta:

from pydantic import BaseModel
from typing import Optional
from enum import Enum


# Los objetos (entradas)

class Accion(BaseModel):
    simbolo: str
    mercado: str

class CompraDeAccion(BaseModel):
    accion: Accion
    cantidad: float
    precio: float


# La respuesta (salida)

class Estado(Enum):
    VENDER = "VENDER"
    MANTENER = "MANTENER"
    COMPRAR = "COMPRAR"

class Respuesta(BaseModel):
    estado: Optional[Estado]
    por: Optional[float]  # porcentaje/cantidad
    razon: str

03 — Tu Tarea

Diseña tu oráculo de leyes.

Qué hacer

Escribe qué preguntas quieres que el oráculo responda
Define al menos 2 objetos con variables tipados (uno debe referenciar al otro)
Define objetos Respuesta para cada pregunta

No necesitas escribir las especificaciones en Python. Yo usé IA para hacerlo desde lenguaje natural.

04 — Diagrama de Objetos

Así es como los objetos se relacionan entre ellos y con el oráculo: