Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Theta preamble diagnostic misreports historical single-item images

Fechada Para iniciantes
#773 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
78/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
java
Domínio
data

Direção de pesquisa

Comece em theta.PreambleUtil.preambleToString() e inspecione como CurrentCount é derivado para imagens com o comprimento de um único preâmbulo. Use a serialização compacta proposta de sketch de item único, limpe apenas o sinalizador de item único e verifique se o diagnóstico informa CurrentCount: 1, preservando SINGLE_ITEM: false; confirme também que uma imagem vazia informa CurrentCount: 0.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Problem

theta.PreambleUtil.preambleToString() derives CurrentCount for one-preamble-long images from SINGLEITEM_FLAG_MASK.

Historical C++ single-item images may omit that flag. Java accepts those images because the theta parser deliberately does not depend on the flag, but the diagnostic output reports CurrentCount: 0 even though the image contains one retained item.

This was identified while resolving the cross-language differences tracked in apache/datasketches-cpp#460. Current C++ now writes the flag, but older valid images still expose the diagnostic mismatch.

Expected behavior

For a one-preamble-long theta image, derive the diagnostic count from the empty flag:

  • empty image: CurrentCount: 0
  • non-empty image: CurrentCount: 1

The printed SINGLE_ITEM field should continue to reflect the serialized flag itself.

Proposed test

Serialize a single-item compact sketch, clear only the single-item flag to model a historical C++ image, and verify that preambleToString() reports CurrentCount: 1 while preserving SINGLE_ITEM: false.

Linguagem predominante
Java
Estrelas
957
Forks
226
Merge médio
1d 6min
PRs com merge (30d)
8

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de apache/datasketches-java

Todas as issues de apache/datasketches-java

Issues semelhantes

Mais issues de Java

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.