github/shuffle-json-data

O que shuffle-json-data faz?

Embaralhe objetos JSON repetitivos com segurança, validando a consistência do esquema antes de randomizar as entradas.

Visão Geral

Esta skill recebe um array de objetos JSON, verifica se todos os objetos têm exatamente o mesmo conjunto de chaves (esquema), e então embaralha a ordem dos objetos aleatoriamente. Se a validação do esquema falhar, a skill retorna um erro, evitando a corrupção dos dados.

Como Usar

Forneça um array JSON como entrada. O script irá:

1. Analisar o JSON de entrada.
2. Validar que todos os objetos no array compartilham o mesmo esquema.
3. Se válido, embaralhar o array usando um algoritmo criptograficamente seguro.
4. Retornar o novo array embaralhado como JSON.

Exemplo

Entrada:

[
  {"id": 1, "nome": "Alice"},
  {"id": 2, "nome": "Bob"},
  {"id": 3, "nome": "Carol"}
]

Saída (exemplo):

[
  {"id": 2, "nome": "Bob"},
  {"id": 3, "nome": "Carol"},
  {"id": 1, "nome": "Alice"}
]

Requisitos

• Node.js (versão 16 ou superior) ou Python 3.8+
• Módulo crypto (Node.js) ou random (Python) para embaralhamento seguro

Instalação (para uso local)

npm install -g shuffle-json-data
# ou
pip install shuffle-json-data

API

shuffle(data: Array<object>): Array<object>

• data: Array de objetos JSON para embaralhar.
• Retorna: Um novo array com os mesmos objetos em ordem aleatória.
• Lança um erro se os objetos não compartilharem o mesmo esquema.

Notas Adicionais

• A validação do esquema é feita comparando as chaves de cada objeto. Objetos aninhados são tratados recursivamente.
• O algoritmo de embaralhamento usa o algoritmo Fisher-Yates com semente criptográfica.
• Esta skill não modifica o array original; retorna uma cópia embaralhada.