Files
Chronos/src/Chronos.Core/Metadata/SpanReader.cs
T
Alby96andClaude Opus 5.5 f2b58522b9
CI / Build and test (push) Successful in 8m14s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 7s
Release / Build, test and publish (push) Successful in 13m19s
CI / PostgreSQL 16 integration (push) Successful in 4m49s
CI / PostgreSQL 17 integration (push) Successful in 5m28s
CI / Docker image (push) Successful in 53s
Release / Server image (push) Failing after 10s
refactor!: rename Titano to Chronos and move CI and releases to Gitea (#6)
The owner renamed the product and moved the repository to the self-hosted
Gitea (https://gitea.encke-hake.ts.net/BalboSoft/Chronos) for more control,
and asked for Actions and a first automatic release with the server package
and the Windows exe (docs/requests/2026-10-23-chronos-gitea.md).

- Chronos everywhere: a byte-exact rename of contents and paths, then a
  per-language review of the forms the old name's ending had dictated.
- Gitea instead of GitHub: the update check, licence, issue and support
  links read ChronosReleasesUrl; the update check takes the highest stable
  version, offers a pre-release build its final release and reports a
  repository it cannot see as a failed check. EULA, security policy and
  Gitea issue forms live at the repository root.
- Gitea Actions for the Linux act_runner (.gitea/workflows): CI, release,
  nightly image and performance gates in the .NET SDK container with git
  checkout and the system SQLite. The release cross-compiles the Windows
  programs, checks their icon, version and DPI manifest, packs installers
  and zips, publishes the Gitea release and pushes the server image
  (REGISTRY_TOKEN). Windows-only tests run in an opt-in job on a Windows
  runner (WINDOWS_RUNNER).
- New Chronos.Tools commands: zip, gitea-release, postgres-ci (replaces the
  docker-exec script, which Gitea's service containers do not allow; the
  throw-away server runs without durability) and pe-check.
- Timed tests take their budget from TestTiming (CHRONOS_TEST_TIME_FACTOR,
  3 on the shared runner; the weekly performance gates keep theirs).

BREAKING CHANGE: programs, settings, data folders, file types, environment
variables and the Docker image use the new name; nothing is migrated from
Titano, which never had a release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
2026-10-23 12:45:18 +02:00

89 lines
2.6 KiB
C#

using System.Buffers.Binary;
using System.Text;
namespace Chronos.Core.Metadata;
/// <summary>
/// Forward-only reader over bytes already in memory. Reading past the end returns zeros and clears <see cref="Ok"/>,
/// so a parser can read a whole structure and validate once.
/// </summary>
internal ref struct SpanReader
{
private readonly ReadOnlySpan<byte> _data;
private readonly bool _bigEndian;
private int _position;
public SpanReader(ReadOnlySpan<byte> data, bool bigEndian = true)
{
_data = data;
_bigEndian = bigEndian;
Ok = true;
}
public bool Ok { get; private set; }
public readonly int Position => _position;
public readonly int Remaining => _data.Length - _position;
public byte U8() => Take(1) is [var b] ? b : (byte)0;
public ushort U16()
{
var s = Take(2);
return s.Length < 2 ? (ushort)0 : _bigEndian ? BinaryPrimitives.ReadUInt16BigEndian(s) : BinaryPrimitives.ReadUInt16LittleEndian(s);
}
public uint U32()
{
var s = Take(4);
return s.Length < 4 ? 0 : _bigEndian ? BinaryPrimitives.ReadUInt32BigEndian(s) : BinaryPrimitives.ReadUInt32LittleEndian(s);
}
public ulong U64()
{
var s = Take(8);
return s.Length < 8 ? 0 : _bigEndian ? BinaryPrimitives.ReadUInt64BigEndian(s) : BinaryPrimitives.ReadUInt64LittleEndian(s);
}
/// <summary>Unsigned integer stored in 0, 4 or 8 bytes (ISO-BMFF <c>iloc</c> field sizes); other sizes fail.</summary>
public ulong Sized(int bytes)
{
switch (bytes)
{
case 0: return 0;
case 4: return U32();
case 8: return U64();
default:
Ok = false;
return 0;
}
}
public void Skip(int count) => Take(count);
/// <summary>The next <paramref name="count"/> bytes; empty (and <see cref="Ok"/> cleared) when fewer remain.</summary>
public ReadOnlySpan<byte> Take(int count)
{
if (count < 0 || count > Remaining)
{
Ok = false;
_position = _data.Length;
return default;
}
var s = _data.Slice(_position, count);
_position += count;
return s;
}
/// <summary>NUL-terminated UTF-8 string (the terminator is consumed); the rest of the data when unterminated.</summary>
public string CString()
{
var rest = _data[_position..];
var end = rest.IndexOf((byte)0);
var length = end < 0 ? rest.Length : end;
_position += end < 0 ? length : length + 1;
return Encoding.UTF8.GetString(rest[..length]);
}
}