Skip to content

CLAUDE.md

Latest commit

 

History

History
62 lines (40 loc) · 2.25 KB

CLAUDE.md

File metadata and controls

62 lines (40 loc) · 2.25 KB
Raw

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Build & Test Commands

# Run all tests (preferred)
prove -l t/

# Run a single test
prove -l t/format.t

# Run a single test verbosely
prove -lv t/lang-data.t

# Dist::Zilla build (generates Makefile.PL, README.md)
dzil build --no-tgz

# Run author/release tests
dzil test --all

Architecture

TimeDate is a Perl distribution providing date parsing, formatting, and timezone handling. No external CPAN dependencies — core Perl only.

Module relationships

Date::Format          - exports time2str(), strftime(), ctime(), asctime()
  └─ delegates to Date::Format::Generic  - core formatting engine (format_* methods, _subs() template engine)

Date::Parse           - exports str2time(), strptime()
  └─ uses Time::Zone  - timezone name/offset lookups

Date::Language        - base class, inherits from Date::Format::Generic
  ├─ factory: new('German') → loads Date::Language::German
  ├─ AUTOLOAD generates strptime parsers lazily via Date::Parse::gen_parser()
  ├─ _build_lookups() builds %MoY/%DoW reverse-lookup hashes for all language modules
  └─ 35 language modules (lib/Date/Language/*.pm)

TimeDate.pm           - empty wrapper for PAUSE ownership; holds distribution-level POD

Language modules

Each language module declares @DoW, @MoY, @DoWs, @MoYs, @AMPM, @Dsuf arrays, calls Date::Language::_build_lookups(), and defines 6 format subs (format_a/A/b/B/h/p) that reference per-package variables. Some languages (Czech, Hungarian, Russian, Turkish) have additional overrides.

Versioning

  • [OurPkgVersion] injects $VERSION at build time — source files use # VERSION: generated comments
  • [Git::NextVersion] bumps version from git tags
  • [PodWeaver] processes # ABSTRACT: comments into POD

Encoding

Language modules use either use utf8 with native Unicode characters (German, French, Danish, etc.) or explicit byte escapes for legacy encodings (Russian KOI8-R, Chinese GB2312). Turkish uses use utf8. Do not mix approaches within a single file.

CI

GitHub Actions (.github/workflows/ci.yml) tests on Linux (Perl 5.8+), macOS, and Windows with author testing enabled.