From e7800b29c9ff6f1413490382944bad600c8fc2fd Mon Sep 17 00:00:00 2001 From: Leo Galambos Date: Wed, 22 Jul 2026 23:33:28 +0200 Subject: [PATCH] feat!: modularize stemmer models and release infrastructure Move bundled stemmer dictionaries from the core artifact into independently versioned model modules. Add model discovery and explicit model-loading APIs, a standard model aggregate, a model BOM, and dedicated model and catalog release workflows. Add full PoliMorf integration, model provenance and licensing validation, streaming model-input verification, strict dependency verification, consumer resolution tests, Configuration Cache compatibility, and expanded JMH, quality, documentation, and release checks. Upgrade the CycloneDX and JMH Gradle plugins and remove Gradle 10 and Java compiler deprecations. BREAKING CHANGE: The core Radixor artifact no longer contains bundled stemmer dictionaries. Applications must add the required model artifacts, the standard model aggregate, or model dependencies managed through the Radixor model BOM. --- .gitattributes | 2 +- .github/workflows/benchmarks.yml | 2 + .github/workflows/build.yml | 26 +- .github/workflows/catalog-release.yml | 37 ++ .github/workflows/model-release.yml | 147 +++++ .github/workflows/pages.yml | 18 +- .gitignore | 14 +- README.md | 61 +- build-logic/build.gradle | 25 + build-logic/settings.gradle | 8 + .../MockitoAgentArgumentProvider.groovy | 21 + .../PrepareModelConsumerRepositoryTask.groovy | 105 ++++ .../radixor/PrepareModelResourcesTask.groovy | 108 ++++ .../radixor/RadixorBuildSupportPlugin.groovy | 16 + .../radixor/RadixorModelExtension.groovy | 73 +++ .../egothor/radixor/RadixorModelPlugin.groovy | 505 ++++++++++++++++ .../radixor/ValidateModelInputTask.groovy | 57 ++ .../radixor/RadixorModelPluginTest.groovy | 205 +++++++ build.gradle | 542 +++++++++++++++++- docs/architecture-and-reduction.md | 6 + docs/architecture.md | 92 ++- docs/benchmarking.md | 5 + .../reference/linguistic-quality.md | 4 +- docs/benchmarks/reference/methodology.md | 5 +- docs/benchmarks/reference/reproducibility.md | 26 +- docs/benchmarks/reference/tested-stemmers.md | 5 +- docs/built-in-languages.md | 299 +++------- docs/cli-compilation.md | 10 + docs/compatibility-and-guarantees.md | 14 +- docs/contributing-dictionaries.md | 16 +- docs/dictionary-format.md | 29 +- docs/fast-track.md | 38 +- docs/index.md | 16 +- docs/integration-deep-dive.md | 56 +- docs/migration-and-backward-compatibility.md | 145 ++++- docs/model-selection-and-loading.md | 277 +++++++++ docs/programmatic-loading-and-building.md | 14 +- docs/programmatic-usage.md | 177 ++++-- docs/quick-start.md | 25 +- docs/reports.md | 2 + docs/stemmer-models.md | 192 +++++++ docs/stemming-quality.md | 9 +- gradle/java-license-header.txt | 30 + gradle/maven-pom.gradle | 7 - gradle/paicehusk-benchmarks.gradle | 5 + gradle/verification-metadata.xml | 176 ++++++ mkdocs.yml | 4 + models/bom/build.gradle | 101 ++++ models/catalog-version.txt | 1 + models/cs-cz-default/build.gradle | 23 + models/cs-cz-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../cs-cz-default/src/modelInput}/stemmer.gz | Bin models/da-dk-default/build.gradle | 23 + models/da-dk-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../da-dk-default/src/modelInput}/stemmer.gz | Bin models/de-de-default/build.gradle | 23 + models/de-de-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../de-de-default/src/modelInput}/stemmer.gz | Bin models/es-es-default/build.gradle | 23 + models/es-es-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../es-es-default/src/modelInput}/stemmer.gz | Bin models/fa-ir-default/build.gradle | 23 + models/fa-ir-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../fa-ir-default/src/modelInput}/stemmer.gz | Bin models/fi-fi-default/build.gradle | 23 + models/fi-fi-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../fi-fi-default/src/modelInput}/stemmer.gz | Bin models/fr-fr-default/build.gradle | 23 + models/fr-fr-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../fr-fr-default/src/modelInput}/stemmer.gz | Bin models/he-il-default/build.gradle | 23 + models/he-il-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../he-il-default/src/modelInput}/stemmer.gz | Bin models/hu-hu-default/build.gradle | 23 + models/hu-hu-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../hu-hu-default/src/modelInput}/stemmer.gz | Bin models/it-it-default/build.gradle | 23 + models/it-it-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../it-it-default/src/modelInput}/stemmer.gz | Bin models/model-projects.properties | 22 + models/nb-no-default/build.gradle | 23 + models/nb-no-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../nb-no-default/src/modelInput}/stemmer.gz | Bin models/nl-nl-default/build.gradle | 23 + models/nl-nl-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../nl-nl-default/src/modelInput}/stemmer.gz | Bin models/nn-no-default/build.gradle | 23 + models/nn-no-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../nn-no-default/src/modelInput}/stemmer.gz | Bin models/pl-pl-polimorf/build.gradle | 27 + models/pl-pl-polimorf/model-version.txt | 1 + .../src/modelInput/LICENSE-BSD-2-Clause.txt | 38 ++ .../pl-pl-polimorf/src/modelInput/stemmer.gz | Bin 0 -> 12624997 bytes models/pl-pl-unimorph/build.gradle | 23 + models/pl-pl-unimorph/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../pl-pl-unimorph/src/modelInput}/stemmer.gz | Bin models/pt-pt-default/build.gradle | 23 + models/pt-pt-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../pt-pt-default/src/modelInput}/stemmer.gz | Bin models/ru-ru-default/build.gradle | 23 + models/ru-ru-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../ru-ru-default/src/modelInput}/stemmer.gz | Bin models/standard/build.gradle | 117 ++++ models/sv-se-default/build.gradle | 23 + models/sv-se-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../sv-se-default/src/modelInput}/stemmer.gz | Bin models/uk-ua-default/build.gradle | 23 + models/uk-ua-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../uk-ua-default/src/modelInput}/stemmer.gz | Bin models/us-uk-default/build.gradle | 23 + models/us-uk-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../us-uk-default/src/modelInput}/stemmer.gz | Bin models/yi-default/build.gradle | 23 + models/yi-default/model-version.txt | 1 + .../src/modelInput/NOTICE-model-data.txt | 38 ++ .../yi-default/src/modelInput}/stemmer.gz | Bin settings.gradle | 15 + .../benchmark/BenchmarkCorpusSupport.java | 10 +- .../benchmark/BenchmarkTokenSequence.java | 10 +- .../benchmark/EnglishComparisonCorpus.java | 10 +- ...ishRadixorDictionaryCoverageBenchmark.java | 3 +- .../EnglishStemmerComparisonBenchmark.java | 10 +- .../EnglishStemmerComparisonTokenStream.java | 10 +- .../FrequencyTrieCompilationBenchmark.java | 10 +- .../FrequencyTrieLookupBenchmark.java | 10 +- .../benchmark/LanguageBenchmarkCorpus.java | 3 +- ...ltiLanguageStemmerComparisonBenchmark.java | 2 +- .../benchmark/QualityStemmerMatrix.java | 30 + .../benchmark/SnowballStemmerAdapter.java | 10 +- .../StemmerComparisonBenchmarkQuality.java | 1 + .../stemmer/benchmark/package-info.java | 10 +- src/main/java/module-info.java | 30 + .../egothor/stemmer/CaseProcessingMode.java | 10 +- .../java/org/egothor/stemmer/Compile.java | 10 +- .../stemmer/DiacriticProcessingMode.java | 10 +- .../egothor/stemmer/DiacriticStripper.java | 10 +- .../DuplicateStemmerModelException.java | 46 ++ .../org/egothor/stemmer/FrequencyTrie.java | 10 +- .../stemmer/FrequencyTrieBuilders.java | 10 +- .../egothor/stemmer/PatchCommandEncoder.java | 10 +- .../org/egothor/stemmer/ReductionMode.java | 10 +- .../egothor/stemmer/ReductionSettings.java | 12 +- .../stemmer/StemmerDictionaryParser.java | 10 +- .../stemmer/StemmerKnowledgeExperiment.java | 28 +- .../StemmerKnowledgeExperimentCli.java | 10 +- .../stemmer/StemmerModelDescriptor.java | 109 ++++ .../StemmerModelIntegrityException.java | 56 ++ .../StemmerModelNotFoundException.java | 46 ++ .../egothor/stemmer/StemmerModelRegistry.java | 228 ++++++++ .../stemmer/StemmerPatchTrieBinaryIO.java | 10 +- .../stemmer/StemmerPatchTrieLoader.java | 251 ++++++-- .../org/egothor/stemmer/TrieMetadata.java | 10 +- ...nsupportedStemmerModelFormatException.java | 46 ++ .../java/org/egothor/stemmer/ValueCount.java | 10 +- .../stemmer/WordTraversalDirection.java | 10 +- .../org/egothor/stemmer/package-info.java | 10 +- .../egothor/stemmer/trie/ChildDescriptor.java | 10 +- .../stemmer/trie/DominantLocalDescriptor.java | 10 +- .../stemmer/trie/LocalValueSummary.java | 10 +- .../org/egothor/stemmer/trie/MutableNode.java | 10 +- .../org/egothor/stemmer/trie/NodeData.java | 10 +- .../stemmer/trie/RankedLocalDescriptor.java | 10 +- .../org/egothor/stemmer/trie/ReducedNode.java | 10 +- .../stemmer/trie/ReductionContext.java | 10 +- .../stemmer/trie/ReductionSignature.java | 10 +- .../egothor/stemmer/trie/SortableValue.java | 10 +- .../trie/UnorderedLocalDescriptor.java | 10 +- .../egothor/stemmer/trie/package-info.java | 10 +- .../stemmer/CompileIntegrationTest.java | 18 +- .../java/org/egothor/stemmer/CompileTest.java | 10 +- .../CompiledTrieArtifactRegressionTest.java | 10 +- .../stemmer/DiacriticStripperTest.java | 10 +- .../stemmer/FrequencyTrieBuildersTest.java | 10 +- .../stemmer/FrequencyTrieProperties.java | 10 +- .../egothor/stemmer/FrequencyTrieTest.java | 10 +- .../FullRuntimeModelIntegrationTest.java | 137 +++++ .../FuzzStemmerAndTrieCompilationTest.java | 10 +- .../org/egothor/stemmer/FuzzTestSupport.java | 10 +- .../ModelDependencyResolutionTest.java | 195 +++++++ .../PatchCommandEncoderProperties.java | 10 +- .../stemmer/PatchCommandEncoderTest.java | 10 +- .../stemmer/PropertyBasedTestSupport.java | 10 +- .../stemmer/RegressionArtifactGenerator.java | 10 +- .../stemmer/RegressionArtifactSupport.java | 10 +- .../stemmer/StemmerDictionaryParserTest.java | 10 +- .../StemmerKnowledgeExperimentTest.java | 10 +- ...StemmerModelDocumentationExamplesTest.java | 174 ++++++ .../stemmer/StemmerModelRegistryTest.java | 82 +++ .../stemmer/StemmerPatchTrieBinaryIOTest.java | 10 +- .../stemmer/StemmerPatchTrieLoaderTest.java | 29 +- .../stemmer/StemmerPatchTrieProperties.java | 24 +- .../org/egothor/stemmer/TrieMetadataTest.java | 10 +- .../stemmer/WordTraversalDirectionTest.java | 10 +- .../benchmark/BenchmarkTokenSequenceTest.java | 10 +- ...glishStemmerComparisonTokenStreamTest.java | 10 +- .../PaiceHuskLancasterStemmerTest.java | 10 +- .../quality/BundledGoldStandardLoader.java | 35 +- .../quality/CandidateAwareEvaluator.java | 30 + .../quality/CandidateAwareEvaluatorTest.java | 30 + .../quality/CandidateQualityAudit.java | 30 + .../benchmark/quality/GoldStandardGroup.java | 30 + .../benchmark/quality/LanguageUniverse.java | 32 +- .../quality/LanguageUniverseTest.java | 42 +- .../quality/MetricCorrelationWriter.java | 30 + .../benchmark/quality/OutputPolicy.java | 30 + .../benchmark/quality/PairwiseMetrics.java | 30 + .../quality/PairwiseMetricsTest.java | 30 + .../benchmark/quality/PartitionMetrics.java | 30 + .../benchmark/quality/ProcessingMode.java | 30 + .../benchmark/quality/QualityAudit.java | 34 +- .../benchmark/quality/QualityEvaluator.java | 30 + .../quality/QualityEvaluatorTest.java | 30 + .../quality/QualityReportWriter.java | 30 + .../quality/QualityReportWriterTest.java | 30 + .../benchmark/quality/QualityResult.java | 30 + .../quality/QualityStemmerMatrixTest.java | 30 + .../benchmark/quality/StemmerFunction.java | 30 + .../quality/StemmingQualityApplication.java | 30 + ...StemmingQualityDocumentationPublisher.java | 30 + .../stemmer/trie/ChildDescriptorTest.java | 10 +- .../trie/CompiledNodeAndNodeDataTest.java | 10 +- .../trie/DominantLocalDescriptorTest.java | 10 +- .../stemmer/trie/LocalValueSummaryTest.java | 10 +- .../egothor/stemmer/trie/MutableNodeTest.java | 10 +- .../trie/RankedLocalDescriptorTest.java | 10 +- .../egothor/stemmer/trie/ReducedNodeTest.java | 10 +- .../stemmer/trie/ReductionContextTest.java | 10 +- .../stemmer/trie/ReductionSignatureTest.java | 10 +- .../trie/UnorderedLocalDescriptorTest.java | 10 +- tools/parse-model-release-tag.sh | 35 ++ tools/publish-central-bundle.sh | 16 + 250 files changed, 7297 insertions(+), 905 deletions(-) create mode 100644 .github/workflows/catalog-release.yml create mode 100644 .github/workflows/model-release.yml create mode 100644 build-logic/build.gradle create mode 100644 build-logic/settings.gradle create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/MockitoAgentArgumentProvider.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/PrepareModelConsumerRepositoryTask.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/PrepareModelResourcesTask.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/RadixorBuildSupportPlugin.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/RadixorModelExtension.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/RadixorModelPlugin.groovy create mode 100644 build-logic/src/main/groovy/org/egothor/radixor/ValidateModelInputTask.groovy create mode 100644 build-logic/src/test/groovy/org/egothor/radixor/RadixorModelPluginTest.groovy create mode 100644 docs/model-selection-and-loading.md create mode 100644 docs/stemmer-models.md create mode 100644 gradle/java-license-header.txt create mode 100644 models/bom/build.gradle create mode 100644 models/catalog-version.txt create mode 100644 models/cs-cz-default/build.gradle create mode 100644 models/cs-cz-default/model-version.txt create mode 100644 models/cs-cz-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/cs_cz => models/cs-cz-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/da-dk-default/build.gradle create mode 100644 models/da-dk-default/model-version.txt create mode 100644 models/da-dk-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/da_dk => models/da-dk-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/de-de-default/build.gradle create mode 100644 models/de-de-default/model-version.txt create mode 100644 models/de-de-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/de_de => models/de-de-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/es-es-default/build.gradle create mode 100644 models/es-es-default/model-version.txt create mode 100644 models/es-es-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/es_es => models/es-es-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/fa-ir-default/build.gradle create mode 100644 models/fa-ir-default/model-version.txt create mode 100644 models/fa-ir-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/fa_ir => models/fa-ir-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/fi-fi-default/build.gradle create mode 100644 models/fi-fi-default/model-version.txt create mode 100644 models/fi-fi-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/fi_fi => models/fi-fi-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/fr-fr-default/build.gradle create mode 100644 models/fr-fr-default/model-version.txt create mode 100644 models/fr-fr-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/fr_fr => models/fr-fr-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/he-il-default/build.gradle create mode 100644 models/he-il-default/model-version.txt create mode 100644 models/he-il-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/he_il => models/he-il-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/hu-hu-default/build.gradle create mode 100644 models/hu-hu-default/model-version.txt create mode 100644 models/hu-hu-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/hu_hu => models/hu-hu-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/it-it-default/build.gradle create mode 100644 models/it-it-default/model-version.txt create mode 100644 models/it-it-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/it_it => models/it-it-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/model-projects.properties create mode 100644 models/nb-no-default/build.gradle create mode 100644 models/nb-no-default/model-version.txt create mode 100644 models/nb-no-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/nb_no => models/nb-no-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/nl-nl-default/build.gradle create mode 100644 models/nl-nl-default/model-version.txt create mode 100644 models/nl-nl-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/nl_nl => models/nl-nl-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/nn-no-default/build.gradle create mode 100644 models/nn-no-default/model-version.txt create mode 100644 models/nn-no-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/nn_no => models/nn-no-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/pl-pl-polimorf/build.gradle create mode 100644 models/pl-pl-polimorf/model-version.txt create mode 100644 models/pl-pl-polimorf/src/modelInput/LICENSE-BSD-2-Clause.txt create mode 100644 models/pl-pl-polimorf/src/modelInput/stemmer.gz create mode 100644 models/pl-pl-unimorph/build.gradle create mode 100644 models/pl-pl-unimorph/model-version.txt create mode 100644 models/pl-pl-unimorph/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/pl_pl => models/pl-pl-unimorph/src/modelInput}/stemmer.gz (100%) create mode 100644 models/pt-pt-default/build.gradle create mode 100644 models/pt-pt-default/model-version.txt create mode 100644 models/pt-pt-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/pt_pt => models/pt-pt-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/ru-ru-default/build.gradle create mode 100644 models/ru-ru-default/model-version.txt create mode 100644 models/ru-ru-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/ru_ru => models/ru-ru-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/standard/build.gradle create mode 100644 models/sv-se-default/build.gradle create mode 100644 models/sv-se-default/model-version.txt create mode 100644 models/sv-se-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/sv_se => models/sv-se-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/uk-ua-default/build.gradle create mode 100644 models/uk-ua-default/model-version.txt create mode 100644 models/uk-ua-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/uk_ua => models/uk-ua-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/us-uk-default/build.gradle create mode 100644 models/us-uk-default/model-version.txt create mode 100644 models/us-uk-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/us_uk => models/us-uk-default/src/modelInput}/stemmer.gz (100%) create mode 100644 models/yi-default/build.gradle create mode 100644 models/yi-default/model-version.txt create mode 100644 models/yi-default/src/modelInput/NOTICE-model-data.txt rename {src/main/resources/yi => models/yi-default/src/modelInput}/stemmer.gz (100%) create mode 100644 src/main/java/org/egothor/stemmer/DuplicateStemmerModelException.java create mode 100644 src/main/java/org/egothor/stemmer/StemmerModelDescriptor.java create mode 100644 src/main/java/org/egothor/stemmer/StemmerModelIntegrityException.java create mode 100644 src/main/java/org/egothor/stemmer/StemmerModelNotFoundException.java create mode 100644 src/main/java/org/egothor/stemmer/StemmerModelRegistry.java create mode 100644 src/main/java/org/egothor/stemmer/UnsupportedStemmerModelFormatException.java create mode 100644 src/test/java/org/egothor/stemmer/FullRuntimeModelIntegrationTest.java create mode 100644 src/test/java/org/egothor/stemmer/ModelDependencyResolutionTest.java create mode 100644 src/test/java/org/egothor/stemmer/StemmerModelDocumentationExamplesTest.java create mode 100644 src/test/java/org/egothor/stemmer/StemmerModelRegistryTest.java create mode 100755 tools/parse-model-release-tag.sh create mode 100755 tools/publish-central-bundle.sh diff --git a/.gitattributes b/.gitattributes index f91f646..5c563d9 100644 --- a/.gitattributes +++ b/.gitattributes @@ -9,4 +9,4 @@ # Binary files should be left untouched *.jar binary - +*.gz binary diff --git a/.github/workflows/benchmarks.yml b/.github/workflows/benchmarks.yml index fdf18c2..2252957 100644 --- a/.github/workflows/benchmarks.yml +++ b/.github/workflows/benchmarks.yml @@ -10,6 +10,8 @@ on: paths: - 'src/main/**' - 'src/jmh/**' + - 'models/**' + - 'build-logic/**' - 'build.gradle' - 'gradle.properties' - 'gradle.lockfile' diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index eb5a5b6..c422995 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -51,7 +51,7 @@ jobs: test -f gradle/verification-metadata.xml - name: Execute build, tests, PMD, coverage, Javadoc, distribution packaging, and SBOM generation - run: ./gradlew --no-daemon clean ciRelease distZip pmdMain javadoc jacocoCiReleaseReport cyclonedxBom + run: ./gradlew --no-daemon clean ciRelease distZip pmdMain javadoc jacocoCiReleaseReport :cyclonedxDirectBom - name: Upload SBOM if: always() @@ -156,11 +156,14 @@ jobs: test -f gradle.properties test -f gradle/verification-metadata.xml + - name: Validate exact core release tag + run: ./tools/parse-model-release-tag.sh "${GITHUB_REF_NAME}" . + - name: Build release inputs, signed Maven bundle, and SBOM env: SIGNING_KEY: ${{ secrets.SIGNING_KEY }} SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }} - run: ./gradlew --no-daemon clean ciRelease distZip pmdMain javadoc jacocoCiReleaseReport cyclonedxBom centralBundle + run: ./gradlew --no-daemon clean ciRelease distZip pmdMain javadoc jacocoCiReleaseReport :cyclonedxDirectBom centralBundle - name: Generate release changelog shell: bash @@ -177,24 +180,7 @@ jobs: shell: bash env: CENTRAL_BEARER_TOKEN: ${{ secrets.CENTRAL_BEARER_TOKEN }} - run: | - set -euo pipefail - echo "::add-mask::$CENTRAL_BEARER_TOKEN" - - BUNDLE="$(ls build/central-bundle/*.zip)" - HEADER_FILE="$(mktemp)" - trap 'rm -f "$HEADER_FILE"' EXIT - printf 'Authorization: Bearer %s\n' "$CENTRAL_BEARER_TOKEN" > "$HEADER_FILE" - - curl \ - --fail \ - --silent \ - --show-error \ - --request POST \ - --header @"$HEADER_FILE" \ - --form "bundle=@${BUNDLE}" \ - --form "name=org.egothor:radixor:${GITHUB_REF_NAME#release@}" \ - "https://central.sonatype.com/api/v1/publisher/upload?publishingType=AUTOMATIC" + run: ./tools/publish-central-bundle.sh "$(ls build/central-bundle/*.zip)" "org.egothor:radixor:${GITHUB_REF_NAME#release@}" - name: Publish GitHub release assets uses: softprops/action-gh-release@v2 diff --git a/.github/workflows/catalog-release.yml b/.github/workflows/catalog-release.yml new file mode 100644 index 0000000..2028bc4 --- /dev/null +++ b/.github/workflows/catalog-release.yml @@ -0,0 +1,37 @@ +name: Model Catalog Release + +on: + push: + tags: + - 'models-catalog@*' + +permissions: + contents: read + +concurrency: + group: model-catalog-${{ github.ref_name }} + cancel-in-progress: false + +jobs: + catalog: + runs-on: ubuntu-latest + environment: maven-central + steps: + - uses: actions/checkout@v4 + - uses: gradle/actions/wrapper-validation@v4 + - uses: actions/setup-java@v4 + with: + distribution: temurin + java-version: '21' + - uses: gradle/actions/setup-gradle@v4 + - name: Validate catalog tag + run: ./tools/parse-model-release-tag.sh "${GITHUB_REF_NAME}" . + - name: Build only signed catalog metadata + env: + SIGNING_KEY: ${{ secrets.SIGNING_KEY }} + SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }} + run: ./gradlew --no-daemon verifyModelCatalogReleaseCandidate + - name: Publish only catalog metadata + env: + CENTRAL_BEARER_TOKEN: ${{ secrets.CENTRAL_BEARER_TOKEN }} + run: ./tools/publish-central-bundle.sh "build/model-catalog-release-candidate/radixor-models-catalog-${GITHUB_REF_NAME#models-catalog@}-central-bundle.zip" "org.egothor:radixor-models-catalog:${GITHUB_REF_NAME#models-catalog@}" diff --git a/.github/workflows/model-release.yml b/.github/workflows/model-release.yml new file mode 100644 index 0000000..7bfdf19 --- /dev/null +++ b/.github/workflows/model-release.yml @@ -0,0 +1,147 @@ +name: Model Release + +on: + push: + tags: + - 'model/*@*' + workflow_dispatch: + inputs: + tag: + description: Model tag to validate without publishing + required: true + type: string + +permissions: + contents: read + +concurrency: + group: model-release-${{ github.event_name == 'push' && github.ref_name || inputs.tag }} + cancel-in-progress: false + +jobs: + validate: + name: Validate selected model + runs-on: ubuntu-latest + outputs: + model_id: ${{ steps.release.outputs.MODEL_ID }} + model_version: ${{ steps.release.outputs.MODEL_VERSION }} + gradle_project: ${{ steps.release.outputs.GRADLE_PROJECT }} + + steps: + - name: Check out repository + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Validate Gradle wrapper + uses: gradle/actions/wrapper-validation@v4 + + - name: Set up Temurin JDK 21 + uses: actions/setup-java@v4 + with: + distribution: temurin + java-version: '21' + + - name: Set up Gradle caching and instrumentation + uses: gradle/actions/setup-gradle@v4 + + - name: Verify reproducibility inputs + shell: bash + run: | + set -euo pipefail + test -f gradle.lockfile + test -f gradle.properties + test -f gradle/verification-metadata.xml + + - name: Validate and select exactly one model + id: release + shell: bash + env: + REQUESTED_TAG: ${{ inputs.tag }} + run: | + set -euo pipefail + + if [[ "${GITHUB_EVENT_NAME}" == "push" ]]; then + tag="${GITHUB_REF_NAME}" + else + tag="${REQUESTED_TAG}" + fi + + ./tools/parse-model-release-tag.sh "${tag}" . >> "${GITHUB_OUTPUT}" + git merge-base --is-ancestor "${GITHUB_SHA}" origin/main + + - name: Validate one model + shell: bash + run: | + set -euo pipefail + + project="${{ steps.release.outputs.GRADLE_PROJECT }}" + version="${{ steps.release.outputs.MODEL_VERSION }}" + + ./gradlew --no-daemon "${project}:clean" + ./gradlew --no-daemon "${project}:check" + ./gradlew --no-daemon \ + "${project}:validateModelRelease" \ + -PmodelReleaseVersion="${version}" + + publish: + name: Publish selected model + if: github.event_name == 'push' + needs: validate + runs-on: ubuntu-latest + environment: maven-central + + steps: + - name: Check out repository + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Validate Gradle wrapper + uses: gradle/actions/wrapper-validation@v4 + + - name: Set up Temurin JDK 21 + uses: actions/setup-java@v4 + with: + distribution: temurin + java-version: '21' + + - name: Set up Gradle caching and instrumentation + uses: gradle/actions/setup-gradle@v4 + + - name: Verify reproducibility inputs + shell: bash + run: | + set -euo pipefail + test -f gradle.lockfile + test -f gradle.properties + test -f gradle/verification-metadata.xml + + - name: Build signed model release candidate + shell: bash + env: + SIGNING_KEY: ${{ secrets.SIGNING_KEY }} + SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }} + run: | + set -euo pipefail + + project="${{ needs.validate.outputs.gradle_project }}" + version="${{ needs.validate.outputs.model_version }}" + + ./gradlew --no-daemon \ + "${project}:packageModelReleaseCandidate" \ + -PmodelReleaseVersion="${version}" + + - name: Publish one model + shell: bash + env: + CENTRAL_BEARER_TOKEN: ${{ secrets.CENTRAL_BEARER_TOKEN }} + run: | + set -euo pipefail + + model_id="${{ needs.validate.outputs.model_id }}" + version="${{ needs.validate.outputs.model_version }}" + + ./tools/publish-central-bundle.sh \ + "models/${model_id}/build/model-release-candidate/central-bundle.zip" \ + "org.egothor:radixor-model-${model_id}:${version}" diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index ea67c07..51bd56e 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -10,6 +10,8 @@ on: - 'src/main/**' - 'src/test/**' - 'src/jmh/**' + - 'models/**' + - 'build-logic/**' - 'build.gradle' - 'gradle.properties' - 'gradle.lockfile' @@ -70,7 +72,7 @@ jobs: test -f gradle/verification-metadata.xml - name: Build reports for publication - run: ./gradlew --no-daemon clean ciRelease pmdMain javadoc jacocoCiReleaseReport pitest jmh -Pjmh.includes='.*EnglishStemmerComparisonBenchmark.*' cyclonedxBom + run: ./gradlew --no-daemon clean ciRelease pmdMain javadoc jacocoCiReleaseReport pitest jmh -Pjmh.includes='.*EnglishStemmerComparisonBenchmark.*' :cyclonedxDirectBom - name: Prepare gh-pages worktree shell: bash @@ -88,6 +90,9 @@ jobs: cd .. fi + - name: Prepare staged MkDocs source + run: ./gradlew --no-daemon prepareMkDocsSource verifyModelCatalogDocumentation + - name: Stage published reports shell: bash run: | @@ -246,7 +251,7 @@ jobs: cp "${RUN_DIR}/index.html" "${LATEST_DIR}/index.html" - cat > docs/reports.md < build/mkdocs-source/reports.md < docs/builds.md + } > build/mkdocs-source/builds.md - name: Build documentation site (MkDocs Material) shell: bash run: | set -euo pipefail - mkdocs build --strict --site-dir .mkdocs-site - rsync -a --delete --exclude '.git' --exclude '.git/' --exclude 'builds/' .mkdocs-site/ .gh-pages/ + mkdocs build --strict --config-file build/mkdocs/mkdocs.yml + rsync -a --delete --exclude '.git' --exclude '.git/' --exclude 'builds/' build/mkdocs-site/ .gh-pages/ mkdir -p .gh-pages/builds - cp .mkdocs-site/builds/index.html .gh-pages/builds/index.html + cp build/mkdocs-site/builds/index.html .gh-pages/builds/index.html cat > .gh-pages/.nojekyll <' + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' + // Or: runtimeOnly 'org.egothor:radixor-models-standard:' +} +``` + +```java +final FrequencyTrie polish = + StemmerPatchTrieLoader.loadCompiled( + StemmerPatchTrieLoader.Language.PL_PL, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +`Language.PL_PL` selects the documented default `pl-pl-unimorph`. The optional `pl-pl-polimorf` model requires its own runtime artifact and explicit selection; adding it does not change the default. See [Model Selection and Loading](docs/model-selection-and-loading.md) for complete executable examples and [Stemmer Models](docs/stemmer-models.md) for artifact concepts. + +`radixor-models-standard` is a POM-only runtime aggregate: it brings the 20 default model JARs transitively but publishes no empty aggregate JAR. `radixor-models-bom` is the separate POM-only Maven dependency BOM for version management; importing it alone adds no model. The root CycloneDX SBOM report is unrelated to that dependency BOM. + +```java +final FrequencyTrie polimorf = + StemmerPatchTrieLoader.loadCompiled( + "pl-pl-polimorf", + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +Complete PoliMorf construction is supported but unusually memory-intensive: the dedicated verification task uses a 6 GiB maximum heap. Applications should load and retain the resulting immutable trie during startup rather than rebuilding it per request. + ## Table of Contents - [Why Radixor](#why-radixor) @@ -138,7 +172,7 @@ Compared with the historical baseline, Radixor emphasizes: - Compressed binary persistence - Programmatic compilation and loading - CLI compilation tool -- Bundled language resources +- Independently versioned language-model resources - Support for extending compiled stemmer tables - Reproducible and auditable engineering posture @@ -149,16 +183,16 @@ The repository keeps the front page concise and places detailed documentation un ### Getting Started - [Fast Track](docs/fast-track.md) - The shortest path from adding the dependency to getting a first stem from a bundled dictionary. + The shortest path from adding core plus a model artifact to getting a first stem. - [Quick Start](docs/quick-start.md) A broader developer walkthrough covering loading options, querying, extension, persistence, and metadata. - [Integration Deep Dive](docs/integration-deep-dive.md) - Dependency setup, bundled dictionary selection, production lifecycle, search-pipeline guidance, and operational checklist. + Dependency setup, model selection, production lifecycle, search-pipeline guidance, and operational checklist. - [Built-in Languages](docs/built-in-languages.md) - Overview of bundled language resources such as `US_UK`. + Language enum values, default model IDs, artifacts, and optional variants. - [Dictionary Format](docs/dictionary-format.md) How to write and normalize stemming dictionaries. @@ -171,6 +205,9 @@ The repository keeps the front page concise and places detailed documentation un - [Programmatic Usage Overview](docs/programmatic-usage.md) Entry point to the Java API and the overall usage model. +- [Model Selection and Loading](docs/model-selection-and-loading.md) + Default, explicit, dual-model, ClassLoader, dependency, and troubleshooting examples. + - [Loading and Building Stemmers](docs/programmatic-loading-and-building.md) Loading bundled resources, textual dictionaries, binary artifacts, and direct builder usage. @@ -245,3 +282,19 @@ The goal is to keep the Egothor/Stempel lineage useful as a serious contemporary ## Historical note Egothor showed that stemming could be both algorithmic and compact. Stempel proved that the approach was practical enough to survive inside major search ecosystems. Radixor continues that tradition with a modernized implementation focused on production use, maintainability, and controlled evolution. +# Radixor 4 artifact architecture + +The established `org.egothor:radixor` artifact remains the algorithmic core and contains no language-model data. From version 4 onward, applications explicitly add individual `org.egothor:radixor-model-` runtime artifacts or the optional metadata-only `org.egothor:radixor-models-standard` aggregate. Polish defaults to `pl-pl-unimorph`; `pl-pl-polimorf` is opt-in. See [Stemmer Models](docs/stemmer-models.md) and [Migration and Backward Compatibility](docs/migration-and-backward-compatibility.md). + +Radixor Java software remains licensed under BSD-3-Clause. UniMorph-derived model data is +distributed under CC BY-SA 3.0, with upstream attribution, the canonical license URI, Radixor +transformations, and Leo Galambos's limited contribution notice carried by each model artifact. +PoliMorf model data retains its separate BSD-2-Clause license. There is no project-wide CC license +directory because the root artifact contains no model data. + +```groovy +dependencies { + implementation 'org.egothor:radixor:4.0.0' + runtimeOnly 'org.egothor:radixor-model-pl-pl-polimorf:1.0.0' +} +``` diff --git a/build-logic/build.gradle b/build-logic/build.gradle new file mode 100644 index 0000000..5bb158f --- /dev/null +++ b/build-logic/build.gradle @@ -0,0 +1,25 @@ +plugins { + id 'groovy-gradle-plugin' +} + +dependencies { + testImplementation 'org.junit.jupiter:junit-jupiter:5.14.3' + testRuntimeOnly 'org.junit.platform:junit-platform-launcher:1.14.3' +} + +tasks.named('test') { + useJUnitPlatform() +} + +gradlePlugin { + plugins { + radixorModel { + id = 'org.egothor.radixor.model' + implementationClass = 'org.egothor.radixor.RadixorModelPlugin' + } + radixorBuildSupport { + id = 'org.egothor.radixor.build-support' + implementationClass = 'org.egothor.radixor.RadixorBuildSupportPlugin' + } + } +} diff --git a/build-logic/settings.gradle b/build-logic/settings.gradle new file mode 100644 index 0000000..42b57b6 --- /dev/null +++ b/build-logic/settings.gradle @@ -0,0 +1,8 @@ +rootProject.name = 'radixor-build-logic' + +dependencyResolutionManagement { + repositories { + gradlePluginPortal() + mavenCentral() + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/MockitoAgentArgumentProvider.groovy b/build-logic/src/main/groovy/org/egothor/radixor/MockitoAgentArgumentProvider.groovy new file mode 100644 index 0000000..c453899 --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/MockitoAgentArgumentProvider.groovy @@ -0,0 +1,21 @@ +package org.egothor.radixor + +import org.gradle.api.file.ConfigurableFileCollection +import org.gradle.api.tasks.Classpath +import org.gradle.process.CommandLineArgumentProvider + +import javax.inject.Inject + +abstract class MockitoAgentArgumentProvider implements CommandLineArgumentProvider { + @Classpath + abstract ConfigurableFileCollection getAgentClasspath() + + @Inject + MockitoAgentArgumentProvider() { + } + + @Override + Iterable asArguments() { + return ["-javaagent:${agentClasspath.singleFile.absolutePath}"] + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelConsumerRepositoryTask.groovy b/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelConsumerRepositoryTask.groovy new file mode 100644 index 0000000..d8b62cb --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelConsumerRepositoryTask.groovy @@ -0,0 +1,105 @@ +package org.egothor.radixor + +import org.gradle.api.DefaultTask +import org.gradle.api.GradleException +import org.gradle.api.file.ConfigurableFileCollection +import org.gradle.api.file.DirectoryProperty +import org.gradle.api.file.RegularFileProperty +import org.gradle.api.provider.MapProperty +import org.gradle.api.provider.Property +import org.gradle.api.tasks.Input +import org.gradle.api.tasks.InputFile +import org.gradle.api.tasks.InputFiles +import org.gradle.api.tasks.OutputDirectory +import org.gradle.api.tasks.PathSensitive +import org.gradle.api.tasks.PathSensitivity +import org.gradle.api.tasks.TaskAction + +import java.nio.file.Files +import java.nio.file.Path +import java.nio.file.StandardCopyOption +import java.util.stream.Stream + +/** Builds the isolated Maven-layout repository used by consumer resolution tests. */ +abstract class PrepareModelConsumerRepositoryTask extends DefaultTask { + @Input abstract Property getCoreVersion() + @Input abstract Property getCatalogVersion() + @Input abstract MapProperty getModelVersions() + + @InputFile @PathSensitive(PathSensitivity.RELATIVE) + abstract RegularFileProperty getCorePom() + + @InputFile @PathSensitive(PathSensitivity.RELATIVE) + abstract RegularFileProperty getCoreJar() + + @InputFiles @PathSensitive(PathSensitivity.RELATIVE) + abstract ConfigurableFileCollection getModelPoms() + + @InputFiles @PathSensitive(PathSensitivity.RELATIVE) + abstract ConfigurableFileCollection getModelJars() + + @InputFile @PathSensitive(PathSensitivity.RELATIVE) + abstract RegularFileProperty getStandardPom() + + @InputFile @PathSensitive(PathSensitivity.RELATIVE) + abstract RegularFileProperty getBomPom() + + @OutputDirectory + abstract DirectoryProperty getRepositoryDirectory() + + /** Creates the repository using only declared task state and Java file APIs. */ + @TaskAction + void prepareRepository() { + final Path repository = repositoryDirectory.get().asFile.toPath() + deleteTree(repository) + Files.createDirectories(repository) + install(repository, 'radixor', coreVersion.get(), corePom.get().asFile.toPath(), coreJar.get().asFile.toPath()) + + final Map pomsByModel = indexModelFiles(modelPoms.files) + final Map jarsByModel = indexModelFiles(modelJars.files) + modelVersions.get().toSorted().each { String modelId, String modelVersion -> + final Path pom = pomsByModel.get(modelId) + final Path jar = jarsByModel.get(modelId) + if (pom == null || jar == null) { + throw new GradleException("Missing generated publication input for model ${modelId}.") + } + PrepareModelConsumerRepositoryTask.install( + repository, "radixor-model-${modelId}", modelVersion, pom, jar) + } + install(repository, 'radixor-models-standard', catalogVersion.get(), standardPom.get().asFile.toPath(), null) + install(repository, 'radixor-models-bom', catalogVersion.get(), bomPom.get().asFile.toPath(), null) + } + + private static Map indexModelFiles(final Set files) { + final Map indexed = [:] + files.each { File file -> + Path cursor = file.toPath().toAbsolutePath().parent + while (cursor != null && cursor.fileName.toString() != 'build') cursor = cursor.parent + if (cursor == null || cursor.parent == null) { + throw new GradleException("Cannot determine model ID from generated input ${file}.") + } + final String modelId = cursor.parent.fileName.toString() + if (indexed.put(modelId, file.toPath()) != null) { + throw new GradleException("Duplicate generated publication input for model ${modelId}.") + } + } + return indexed + } + + private static void install(final Path repository, final String artifactId, final String version, + final Path pom, final Path jar) { + final Path module = repository.resolve("org/egothor/${artifactId}/${version}") + Files.createDirectories(module) + Files.copy(pom, module.resolve("${artifactId}-${version}.pom"), StandardCopyOption.REPLACE_EXISTING) + if (jar != null) { + Files.copy(jar, module.resolve("${artifactId}-${version}.jar"), StandardCopyOption.REPLACE_EXISTING) + } + } + + private static void deleteTree(final Path directory) { + if (!Files.exists(directory)) return + Files.walk(directory).withCloseable { Stream paths -> + paths.sorted(Comparator.reverseOrder()).forEach(Files::delete) + } + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelResourcesTask.groovy b/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelResourcesTask.groovy new file mode 100644 index 0000000..05cd59b --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/PrepareModelResourcesTask.groovy @@ -0,0 +1,108 @@ +package org.egothor.radixor + +import org.gradle.api.DefaultTask +import org.gradle.api.file.DirectoryProperty +import org.gradle.api.file.RegularFileProperty +import org.gradle.api.provider.MapProperty +import org.gradle.api.provider.Property +import org.gradle.api.tasks.Input +import org.gradle.api.tasks.InputFile +import org.gradle.api.tasks.Optional +import org.gradle.api.tasks.OutputDirectory +import org.gradle.api.tasks.PathSensitive +import org.gradle.api.tasks.PathSensitivity +import org.gradle.api.tasks.TaskAction + +import java.nio.file.Files +import java.nio.file.Path +import java.nio.file.StandardCopyOption +import java.security.MessageDigest +import java.util.stream.Stream + +/** Generates one model's deterministic resource tree without retaining Project state. */ +abstract class PrepareModelResourcesTask extends DefaultTask { + @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getDictionaryFile() + @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getVersionFile() + @Optional @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getLicenseFile() + @Optional @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getNoticeFile() + @Input abstract Property getShareAlike() + @Input abstract MapProperty getDescriptorValues() + @OutputDirectory abstract DirectoryProperty getGeneratedDirectory() + + /** Copies bounded inputs and writes descriptor and index files. */ + @TaskAction + void prepareResources() { + final Path generated = generatedDirectory.get().asFile.toPath() + deleteTree(generated) + final Map values = descriptorValues.get() + final String id = values['model.id'] + final String resource = "org/egothor/stemmer/models/${id}/stemmer.gz" + final Path dictionaryTarget = generated.resolve(resource) + Files.createDirectories(dictionaryTarget.parent) + Files.copy(dictionaryFile.get().asFile.toPath(), dictionaryTarget, StandardCopyOption.REPLACE_EXISTING) + + final Path descriptor = generated.resolve("META-INF/radixor/models/${id}.properties") + Files.createDirectories(descriptor.parent) + Files.writeString(descriptor, descriptorText(values, + versionFile.get().asFile.getText('UTF-8').trim(), resource, sha256(dictionaryFile.get().asFile))) + final Path index = generated.resolve('META-INF/radixor/models.index') + Files.createDirectories(index.parent) + Files.writeString(index, "META-INF/radixor/models/${id}.properties\n") + + if (shareAlike.get()) { + final Path notice = generated.resolve("META-INF/NOTICE/${id}-data.txt") + Files.createDirectories(notice.parent) + Files.copy(noticeFile.get().asFile.toPath(), notice, StandardCopyOption.REPLACE_EXISTING) + } else { + final Path license = generated.resolve('META-INF/LICENSES/PoliMorf-BSD-2-Clause.txt') + Files.createDirectories(license.parent) + Files.copy(licenseFile.get().asFile.toPath(), license, StandardCopyOption.REPLACE_EXISTING) + } + } + + private static String descriptorText(final Map value, final String version, + final String resource, final String checksum) { + return """model.id=${value['model.id']} +model.version=${version} +model.language=${value['model.language']} +model.displayName=${value['model.displayName']} +model.resource=${resource} +model.default=${value['model.default']} +model.format=radixor-dictionary-tsv-gzip +model.formatVersion=1 +model.sha256=${checksum} +model.rightToLeft=${['FA_IR', 'HE_IL', 'YI'].contains(value['model.language'])} +model.caseProcessing=LOWERCASE_WITH_LOCALE_ROOT +model.diacriticProcessing=AS_IS +model.storeOriginal=true +source.name=${value['source.name']} +source.version=${value['source.version']} +source.project=${value['source.project']} +source.repository=${value['source.repository']} +source.dataset=${value['source.dataset']} +source.revision=${value['source.revision']} +source.revisionStatus=${value['source.revisionStatus']} +source.license=${value['source.license']} +source.licenseUri=${value['source.licenseUri']} +source.attribution=${value['source.attribution']} +source.verificationDate=${value['source.verificationDate']} +transformations.summary=${value['transformations.summary']} +compiler.radixorVersion=3.x +compiler.radixorCommit=unavailable +statistics.groups=unavailable +statistics.forms=unavailable +""" + } + + private static String sha256(final File file) { + return MessageDigest.getInstance('SHA-256').digest(file.bytes) + .collect { byte value -> String.format('%02x', value & 0xff) }.join() + } + + private static void deleteTree(final Path directory) { + if (!Files.exists(directory)) return + Files.walk(directory).withCloseable { Stream paths -> + paths.sorted(Comparator.reverseOrder()).forEach(Files::delete) + } + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/RadixorBuildSupportPlugin.groovy b/build-logic/src/main/groovy/org/egothor/radixor/RadixorBuildSupportPlugin.groovy new file mode 100644 index 0000000..78e1d00 --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/RadixorBuildSupportPlugin.groovy @@ -0,0 +1,16 @@ +package org.egothor.radixor + +import org.gradle.api.Plugin +import org.gradle.api.Project + +/** Exposes typed repository build-support tasks to the root build. */ +final class RadixorBuildSupportPlugin implements Plugin { + /** Registers build-support tasks without inspecting project state during execution. */ + @Override + void apply(final Project project) { + project.tasks.register('prepareModelConsumerTestRepository', PrepareModelConsumerRepositoryTask) { + group = 'verification' + description = 'Creates an isolated local Maven repository for model dependency-resolution integration tests.' + } + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelExtension.groovy b/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelExtension.groovy new file mode 100644 index 0000000..ce04f46 --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelExtension.groovy @@ -0,0 +1,73 @@ +package org.egothor.radixor + +import org.gradle.api.model.ObjectFactory +import org.gradle.api.provider.Property + +import javax.inject.Inject + +/** Declarative configuration for one independently published Radixor model. */ +abstract class RadixorModelExtension { + /** Stable model identifier. */ + abstract Property getModelId() + + /** Radixor language enum constant. */ + abstract Property getLanguage() + + /** Human-readable model name. */ + abstract Property getDisplayName() + + /** Whether this is the documented default for its language. */ + abstract Property getDefaultModel() + + /** Source dictionary name. */ + abstract Property getSourceName() + + /** Source dictionary version or explicit unavailable marker. */ + abstract Property getSourceVersion() + + /** Exact upstream revision or the explicit legacy-import sentinel. */ + abstract Property getSourceRevision() + + /** Upstream source project. */ + abstract Property getSourceProject() + + /** Official upstream repository URL. */ + abstract Property getSourceRepository() + + /** Upstream dataset identity. */ + abstract Property getSourceDataset() + + /** Whether the source revision is recorded or was not recorded by a legacy import. */ + abstract Property getSourceRevisionStatus() + + /** SPDX license identifier. */ + abstract Property getSourceLicense() + + /** Canonical URI for the source-data license. */ + abstract Property getSourceLicenseUri() + + /** Upstream attribution supplied with the source data. */ + abstract Property getSourceAttribution() + + /** Date on which the upstream metadata was verified. */ + abstract Property getSourceVerificationDate() + + /** Material transformations applied by Radixor. */ + abstract Property getTransformationsSummary() + + /** Model-specific data notice input file name, when required. */ + abstract Property getNoticeFileName() + + /** License input file name. */ + abstract Property getLicenseFileName() + + /** Creates the extension. */ + @Inject + RadixorModelExtension(final ObjectFactory objects) { + defaultModel.convention(false) + sourceVersion.convention('unavailable') + sourceLicense.convention('LicenseRef-Radixor-Stemmer-Data') + licenseFileName.convention('LICENSE-stemmer-data.txt') + noticeFileName.convention('NOTICE-model-data.txt') + } +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelPlugin.groovy b/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelPlugin.groovy new file mode 100644 index 0000000..c5bed2d --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/RadixorModelPlugin.groovy @@ -0,0 +1,505 @@ +package org.egothor.radixor + +import org.gradle.api.GradleException +import org.gradle.api.Plugin +import org.gradle.api.Project +import org.gradle.api.file.DuplicatesStrategy +import org.gradle.api.plugins.JavaPlugin +import org.gradle.api.publish.PublishingExtension +import org.gradle.api.publish.maven.MavenPublication +import org.gradle.api.tasks.Copy +import org.gradle.api.tasks.bundling.Jar +import org.gradle.api.tasks.bundling.Zip +import org.gradle.plugins.signing.SigningExtension + +import java.nio.charset.CodingErrorAction +import java.nio.charset.StandardCharsets +import java.nio.file.Files +import java.security.MessageDigest +import java.util.zip.GZIPInputStream + +/** Configures validation, generation, packaging, and publication for one model artifact. */ +final class RadixorModelPlugin implements Plugin { + /** Applies the model convention to a project. */ + @Override + void apply(final Project project) { + project.pluginManager.apply(JavaPlugin) + project.pluginManager.apply('maven-publish') + project.pluginManager.apply('signing') + project.java { + withSourcesJar() + withJavadocJar() + sourceCompatibility = org.gradle.api.JavaVersion.VERSION_21 + targetCompatibility = org.gradle.api.JavaVersion.VERSION_21 + } + final RadixorModelExtension model = project.extensions.create('radixorModel', RadixorModelExtension) + project.group = 'org.egothor' + project.version = project.providers.gradleProperty('modelReleaseVersion') + .orElse(project.providers.fileContents(project.layout.projectDirectory.file('model-version.txt')).asText.map(String::trim)) + .get() + + final File input = project.file('src/modelInput/stemmer.gz') + final File generated = project.layout.buildDirectory.dir('generated/modelResources').get().asFile + project.sourceSets.main.resources.setSrcDirs([generated]) + + final def validate = project.tasks.register('validateModelInput', ValidateModelInputTask) { + group = 'verification' + description = 'Validates the immutable source dictionary, metadata, version, and model-specific licensing material.' + dictionaryFile = project.layout.projectDirectory.file('src/modelInput/stemmer.gz') + versionFile = project.layout.projectDirectory.file('model-version.txt') + modelId = model.modelId + moduleName = project.name + shareAlike = model.sourceLicense.map { String license -> license == 'CC-BY-SA-3.0' } + metadata.put('source.project', model.sourceProject) + metadata.put('source.repository', model.sourceRepository) + metadata.put('source.dataset', model.sourceDataset) + metadata.put('source.revision', model.sourceRevision) + metadata.put('source.revisionStatus', model.sourceRevisionStatus) + metadata.put('source.license', model.sourceLicense) + metadata.put('source.licenseUri', model.sourceLicenseUri) + metadata.put('source.attribution', model.sourceAttribution) + metadata.put('source.verificationDate', model.sourceVerificationDate) + metadata.put('transformations.summary', model.transformationsSummary) + } + + final def prepare = project.tasks.register('prepareModelResources', PrepareModelResourcesTask) { + group = 'build' + description = 'Copies validated dictionary bytes and generates the immutable model descriptor and index.' + dependsOn(validate) + dictionaryFile = project.layout.projectDirectory.file('src/modelInput/stemmer.gz') + versionFile = project.layout.projectDirectory.file('model-version.txt') + shareAlike = model.sourceLicense.map { String license -> license == 'CC-BY-SA-3.0' } + generatedDirectory = project.layout.buildDirectory.dir('generated/modelResources') + descriptorValues.put('model.id', model.modelId) + descriptorValues.put('model.language', model.language) + descriptorValues.put('model.displayName', model.displayName) + descriptorValues.put('model.default', model.defaultModel.map(String::valueOf)) + descriptorValues.put('source.name', model.sourceName) + descriptorValues.put('source.version', model.sourceVersion) + descriptorValues.put('source.project', model.sourceProject) + descriptorValues.put('source.repository', model.sourceRepository) + descriptorValues.put('source.dataset', model.sourceDataset) + descriptorValues.put('source.revision', model.sourceRevision) + descriptorValues.put('source.revisionStatus', model.sourceRevisionStatus) + descriptorValues.put('source.license', model.sourceLicense) + descriptorValues.put('source.licenseUri', model.sourceLicenseUri) + descriptorValues.put('source.attribution', model.sourceAttribution) + descriptorValues.put('source.verificationDate', model.sourceVerificationDate) + descriptorValues.put('transformations.summary', model.transformationsSummary) + } + project.afterEvaluate { + final boolean shareAlike = model.sourceLicense.get() == 'CC-BY-SA-3.0' + if (shareAlike) { + final def notice = project.layout.projectDirectory.file("src/modelInput/${model.noticeFileName.get()}") + validate.configure { noticeFile = notice } + prepare.configure { noticeFile = notice } + } else { + final def license = project.layout.projectDirectory.file("src/modelInput/${model.licenseFileName.get()}") + validate.configure { licenseFile = license } + prepare.configure { licenseFile = license } + } + } + project.tasks.named('processResources', Copy).configure { dependsOn(prepare); duplicatesStrategy = DuplicatesStrategy.FAIL } + project.tasks.named('sourcesJar', Jar).configure { dependsOn(prepare); exclude('**/stemmer.gz') } + project.tasks.named('javadocJar', Jar).configure { exclude('**/stemmer.gz') } + project.tasks.named('jar', Jar).configure { + archiveBaseName.set("radixor-model-${project.name}") + preserveFileTimestamps = false + reproducibleFileOrder = true + } + final def verifyDescriptor = project.tasks.register('verifyModelDescriptor') { + group = 'verification'; description = 'Verifies generated descriptor identity and checksum.'; dependsOn(prepare) + doLast { + final Properties properties = new Properties() + new File(generated, "META-INF/radixor/models/${model.modelId.get()}.properties").withInputStream(properties::load) + if (properties.getProperty('model.sha256') != sha256(input)) { + throw new GradleException('Generated descriptor checksum does not match the immutable source input.') + } + } + } + final def verifyJar = project.tasks.register('verifyModelJar') { + group = 'verification'; description = 'Verifies the model JAR checksum, layout, metadata, and dictionary-free documentation artifacts.' + dependsOn(project.tasks.named('jar'), project.tasks.named('sourcesJar'), project.tasks.named('javadocJar')) + doLast { + final File archive = project.tasks.named('jar', Jar).get().archiveFile.get().asFile + final List names = [] + final String resource = "org/egothor/stemmer/models/${model.modelId.get()}/stemmer.gz" + final boolean shareAlike = model.sourceLicense.get() == 'CC-BY-SA-3.0' + final String licenseResource = 'META-INF/LICENSES/PoliMorf-BSD-2-Clause.txt' + final File sourceLicense = shareAlike ? null : project.file("src/modelInput/${model.licenseFileName.get()}") + final File sourceNotice = shareAlike + ? project.file("src/modelInput/${model.noticeFileName.get()}") : null + final String noticeResource = "META-INF/NOTICE/${model.modelId.get()}-data.txt" + String packagedChecksum + String packagedLicenseChecksum + String packagedNoticeChecksum + new java.util.zip.ZipFile(archive).withCloseable { zip -> + zip.entries().each { names.add(it.name) } + final def entry = zip.getEntry(resource) + if (entry != null) { + packagedChecksum = sha256(zip.getInputStream(entry).bytes) + } + final def licenseEntry = zip.getEntry(licenseResource) + if (licenseEntry != null) { + packagedLicenseChecksum = sha256(zip.getInputStream(licenseEntry).bytes) + } + final def noticeEntry = zip.getEntry(noticeResource) + if (noticeEntry != null) { + packagedNoticeChecksum = sha256(zip.getInputStream(noticeEntry).bytes) + } + } + if (names.count { String name -> name.endsWith('/stemmer.gz') } != 1 || !names.contains(resource)) { + throw new GradleException("Model JAR must contain exactly one dictionary at ${resource}.") + } + if (packagedChecksum != sha256(input)) { + throw new GradleException("Packaged dictionary checksum does not match the immutable source input at ${resource}.") + } + if (shareAlike) { + requireMatchingChecksum('notice', noticeResource, sha256(sourceNotice), packagedNoticeChecksum) + validateUniMorphJarContents(names) + } else { + requireMatchingChecksum('license', licenseResource, sha256(sourceLicense), packagedLicenseChecksum) + validatePoliMorfJarContents(names) + } + ['META-INF/radixor/models.index', "META-INF/radixor/models/${model.modelId.get()}.properties"].each { String name -> + if (!names.contains(name)) throw new GradleException("Model JAR is missing ${name}.") + } + [project.tasks.named('sourcesJar', Jar).get(), project.tasks.named('javadocJar', Jar).get()].each { Jar task -> + final File documentationArchive = task.archiveFile.get().asFile + new java.util.zip.ZipFile(documentationArchive).withCloseable { zip -> + if (zip.entries().any { entry -> entry.name.endsWith('/stemmer.gz') || entry.name == 'stemmer.gz' }) { + throw new GradleException("Documentation artifact ${documentationArchive.name} must not contain a model dictionary.") + } + } + } + } + } + project.tasks.register('validateModelRelease') { + group = 'verification'; description = 'Validates a tag-supplied model release version.'; dependsOn(verifyDescriptor, verifyJar) + doLast { + if (!project.hasProperty('modelReleaseVersion')) throw new GradleException('Model release validation requires -PmodelReleaseVersion=.') + final String recorded = project.file('model-version.txt').text.trim() + if (project.property('modelReleaseVersion').toString() != recorded) throw new GradleException("Release version does not match model-version.txt: ${recorded}") + } + } + project.tasks.named('check').configure { dependsOn(verifyDescriptor, verifyJar) } + project.extensions.configure(PublishingExtension) { PublishingExtension publishing -> + publishing.publications.create('model', MavenPublication) { MavenPublication publication -> + publication.from(project.components.java) + publication.artifactId = "radixor-model-${project.name}" + publication.pom { + name.set("Radixor model ${project.name}") + description.set(model.displayName.zip(model.sourceLicense) { String displayName, String licenseId -> + final String material = licenseId == 'CC-BY-SA-3.0' + ? 'See the packaged model-specific notice.' + : 'See the packaged model-data license.' + return "${displayName}. This artifact contains Radixor-derived model data licensed under ${licenseId}; " + .concat("Radixor software is licensed separately under BSD-3-Clause. ${material}") + }) + url.set('https://github.com/leogalambos/Radixor') + licenses { + license { + name.set(model.sourceLicense) + url.set(model.sourceLicenseUri) + distribution.set('repo') + } + } + developers { + developer { + id.set('egothor') + name.set('Leo Galambos') + email.set('egothor@gmail.com') + } + } + scm { + url.set('https://github.com/leogalambos/Radixor') + connection.set('scm:git:https://github.com/leogalambos/Radixor.git') + developerConnection.set('scm:git:ssh://git@github.com/leogalambos/Radixor.git') + } + } + } + publishing.repositories.maven { + name = 'modelStaging' + url = project.layout.buildDirectory.dir('model-staging-repository').get().asFile.toURI() + } + } + + final String signingKey = project.providers.environmentVariable('SIGNING_KEY').orNull + final String signingPassword = project.providers.environmentVariable('SIGNING_PASSWORD').orNull + project.extensions.configure(SigningExtension) { SigningExtension signing -> + signing.required = { + project.providers.environmentVariable('GITHUB_REF_TYPE').orNull == 'tag' + } + if (signingKey != null && !signingKey.isBlank()) { + signing.useInMemoryPgpKeys(signingKey, signingPassword) + signing.sign(project.extensions.getByType(PublishingExtension).publications.getByName('model')) + } + } + + final def checksums = project.tasks.register('createModelCentralChecksums') { + group = 'publishing' + description = 'Creates Maven Central checksums for this model staging repository.' + dependsOn(project.tasks.named('publishModelPublicationToModelStagingRepository')) + doLast { + final File repository = project.layout.buildDirectory.dir('model-staging-repository').get().asFile + repository.eachFileRecurse { File artifact -> + if (artifact.isFile() && !['.md5', '.sha1', '.sha256', '.sha512'].any { + String extension -> artifact.name.endsWith(extension) + }) { + new File(artifact.absolutePath + '.md5').setText(sha256WithAlgorithm(artifact, 'MD5'), 'US-ASCII') + new File(artifact.absolutePath + '.sha1').setText(sha256WithAlgorithm(artifact, 'SHA-1'), 'US-ASCII') + } + } + } + } + project.tasks.register('packageModelReleaseCandidate', Zip) { + group = 'distribution' + description = 'Packages only this model publication as a Maven-layout local release candidate.' + dependsOn(checksums) + from(project.layout.buildDirectory.dir('model-staging-repository')) { + exclude('**/maven-metadata*.xml*') + } + destinationDirectory.set(project.layout.buildDirectory.dir('model-release-candidate')) + archiveFileName.set('central-bundle.zip') + doFirst { + if (project.providers.environmentVariable('GITHUB_REF_TYPE').orNull == 'tag' + && (signingKey == null || signingKey.isBlank() + || signingPassword == null || signingPassword.isBlank())) { + throw new GradleException('A tagged model release requires SIGNING_KEY and SIGNING_PASSWORD.') + } + } + } + } + + /** Ensures a required file exists. */ + static void requireFile(final File file, final String diagnostic) { + if (!file.isFile()) throw new GradleException(diagnostic) + } + + /** Rejects a missing or byte-different packaged licensing resource. */ + static void requireMatchingChecksum(final String kind, final String resource, + final String sourceChecksum, final String packagedChecksum) { + if (packagedChecksum != sourceChecksum) { + throw new GradleException("Packaged ${kind} does not match the source ${kind} at ${resource}.") + } + } + + /** Validates complete source, licensing, attribution, revision-status, and transformation metadata. */ + private static void validateMetadata(final RadixorModelExtension model) { + final Map required = [ + 'source.project': model.sourceProject.orNull, + 'source.repository': model.sourceRepository.orNull, + 'source.dataset': model.sourceDataset.orNull, + 'source.revision': model.sourceRevision.orNull, + 'source.revisionStatus': model.sourceRevisionStatus.orNull, + 'source.license': model.sourceLicense.orNull, + 'source.licenseUri': model.sourceLicenseUri.orNull, + 'source.attribution': model.sourceAttribution.orNull, + 'source.verificationDate': model.sourceVerificationDate.orNull, + 'transformations.summary': model.transformationsSummary.orNull] + required.each { String key, String value -> + if (value == null || value.isBlank()) { + throw new GradleException("Required model metadata is missing: ${key}") + } + } + validateRevisionMetadata(model.sourceRevision.get(), model.sourceRevisionStatus.get()) + } + + /** Accepts an exact recorded revision or the explicit legacy-import sentinel, but never an absent status. */ + static void validateRevisionMetadata(final String revision, final String status) { + if (revision == null || revision.isBlank()) { + throw new GradleException('Required model metadata is missing: source.revision') + } + if (status == null || status.isBlank()) { + throw new GradleException('Required model metadata is missing: source.revisionStatus') + } + final String sentinel = 'not-recorded-in-legacy-import' + if (revision == sentinel && status != sentinel) { + throw new GradleException('The legacy revision sentinel requires source.revisionStatus=not-recorded-in-legacy-import.') + } + if (revision != sentinel && status != 'recorded') { + throw new GradleException('An exact source revision requires source.revisionStatus=recorded.') + } + } + + /** Validates the model-specific attribution and ShareAlike notice. */ + static void validateShareAlikeNotice(final File notice, final RadixorModelExtension model) { + validateShareAlikeNoticeText(notice.getText('UTF-8'), notice.toString(), model.modelId.get(), + model.sourceRepository.get(), model.sourceLicenseUri.get(), model.sourceRevision.get(), + model.sourceRevisionStatus.get()) + } + + /** Validates required content in one UniMorph model-data notice. */ + static void validateShareAlikeNoticeText(final String text, final String noticeName, + final String modelId, final String repository, final String licenseUri, + final String revision, final String revisionStatus) { + final List required = [ + "Model ID: ${modelId}", + "Official repository: ${repository}", + 'Attribution:', + 'License:\nCreative Commons Attribution-ShareAlike 3.0 Unported', + "Canonical license URI: ${licenseUri}", + 'Radixor modifications:', + "Revision status: ${revisionStatus}", + 'Copyright (C) 2026, Leo Galambos.', + 'Radixor-specific selection, verification, cleaning, normalization,', + 'to the extent protected by applicable law.', + 'The underlying morphological data remains attributed to UniMorph and', + "This derived model data, including Radixor's protectable contributions,", + 'is distributed under Creative Commons Attribution-ShareAlike 3.0', + 'Neither UniMorph nor any upstream contributor endorses Radixor.'] + if (revision == 'not-recorded-in-legacy-import') { + required.add('The exact UniMorph commit used for the original Radixor import was not recorded.') + } + final List missing = required.findAll { String value -> !text.contains(value) } + if (!missing.isEmpty()) { + throw new GradleException("Model notice ${noticeName} is missing required content: ${missing.join(', ')}") + } + } + + /** Rejects generic license files and foreign notices in a UniMorph model artifact. */ + static void validateUniMorphJarContents(final List names) { + if (names.any { String name -> name.startsWith('META-INF/LICENSES/') }) { + throw new GradleException('A UniMorph model artifact must use only its model-specific notice for data licensing.') + } + if (names.count { String name -> name.startsWith('META-INF/NOTICE/') && !name.endsWith('/') } != 1) { + throw new GradleException('A UniMorph model artifact must contain exactly one model-specific notice.') + } + } + + /** Rejects UniMorph licensing material in the separately licensed PoliMorf artifact. */ + static void validatePoliMorfJarContents(final List names) { + if (names.any { String name -> name.startsWith('META-INF/NOTICE/') + || name.contains('CC-BY-SA') }) { + throw new GradleException('The PoliMorf artifact must not contain UniMorph CC BY-SA material.') + } + } + + /** Memory-bounded validation statistics for one dictionary input. */ + static final class DictionaryValidationResult { + final long acceptedGroupCount + final long acceptedFormCount + final long ignoredEmptyVariantCount + + DictionaryValidationResult(final long acceptedGroupCount, final long acceptedFormCount, + final long ignoredEmptyVariantCount) { + this.acceptedGroupCount = acceptedGroupCount + this.acceptedFormCount = acceptedFormCount + this.ignoredEmptyVariantCount = ignoredEmptyVariantCount + } + } + + /** Validates GZip, strict UTF-8, and dictionary rows without retaining decompressed input. */ + static DictionaryValidationResult validateDictionary(final File file) { + long acceptedGroups = 0L + long acceptedForms = 0L + long ignoredEmptyVariants = 0L + try { + final def decoder = StandardCharsets.UTF_8.newDecoder() + .onMalformedInput(CodingErrorAction.REPORT) + .onUnmappableCharacter(CodingErrorAction.REPORT) + Files.newInputStream(file.toPath()).withCloseable { InputStream source -> + new BufferedInputStream(source).withCloseable { BufferedInputStream bufferedInput -> + new GZIPInputStream(bufferedInput).withCloseable { GZIPInputStream gzipInput -> + new BufferedReader(new InputStreamReader(gzipInput, decoder)).withCloseable { BufferedReader reader -> + String line + long lineNumber = 0L + while ((line = reader.readLine()) != null) { + lineNumber++ + final String trimmed = line.trim() + if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('//')) { + final String[] columns = line.split('\\t', -1) + if (columns[0].isEmpty()) { + throw new GradleException("Invalid Radixor dictionary row ${lineNumber} in ${file}.") + } + if (containsUnicodeWhitespace(columns[0])) continue + long acceptedRowForms = 1L + for (int index = 1; index < columns.length; index++) { + final String variant = columns[index] + if (variant.isEmpty()) { + ignoredEmptyVariants++ + } else if (!containsUnicodeWhitespace(variant)) { + acceptedRowForms++ + } + } + acceptedGroups++ + acceptedForms += acceptedRowForms + } + } + } + } + } + } + } catch (GradleException exception) { + throw exception + } catch (Exception exception) { + throw new GradleException("Invalid GZip or UTF-8 model input: ${file}", exception) + } + if (acceptedGroups == 0L) throw new GradleException("Model dictionary contains no valid rows: ${file}") + if (ignoredEmptyVariants > 0L) { + println("Model validation warning: " + file + " contains " + ignoredEmptyVariants + + " empty variant columns; the production parser intentionally ignores empty variants.") + } + return new DictionaryValidationResult(acceptedGroups, acceptedForms, ignoredEmptyVariants) + } + + /** Detects Unicode whitespace in one bounded dictionary field. */ + private static boolean containsUnicodeWhitespace(final String value) { + for (int index = 0; index < value.length(); index++) { + if (Character.isWhitespace(value.charAt(index))) return true + } + return false + } + + /** Builds deterministic descriptor text. */ + private static String descriptorText(final RadixorModelExtension model, final String version, + final String resource, final String checksum) { + return """model.id=${model.modelId.get()} +model.version=${version} +model.language=${model.language.get()} +model.displayName=${model.displayName.get()} +model.resource=${resource} +model.default=${model.defaultModel.get()} +model.format=radixor-dictionary-tsv-gzip +model.formatVersion=1 +model.sha256=${checksum} +model.rightToLeft=${['FA_IR', 'HE_IL', 'YI'].contains(model.language.get())} +model.caseProcessing=LOWERCASE_WITH_LOCALE_ROOT +model.diacriticProcessing=AS_IS +model.storeOriginal=true +source.name=${model.sourceName.get()} +source.version=${model.sourceVersion.get()} +source.project=${model.sourceProject.get()} +source.repository=${model.sourceRepository.get()} +source.dataset=${model.sourceDataset.get()} +source.revision=${model.sourceRevision.get()} +source.revisionStatus=${model.sourceRevisionStatus.get()} +source.license=${model.sourceLicense.get()} +source.licenseUri=${model.sourceLicenseUri.get()} +source.attribution=${model.sourceAttribution.get()} +source.verificationDate=${model.sourceVerificationDate.get()} +transformations.summary=${model.transformationsSummary.get()} +compiler.radixorVersion=3.x +compiler.radixorCommit=unavailable +statistics.groups=unavailable +statistics.forms=unavailable +""" + } + + /** Calculates the lowercase hexadecimal SHA-256 digest. */ + private static String sha256(final File file) { + return sha256(file.bytes) + } + + /** Calculates the lowercase hexadecimal SHA-256 digest of bytes. */ + private static String sha256(final byte[] bytes) { + return MessageDigest.getInstance('SHA-256').digest(bytes).collect { byte value -> String.format('%02x', value & 0xff) }.join() + } + + /** Calculates a lowercase hexadecimal digest using the requested algorithm. */ + private static String sha256WithAlgorithm(final File file, final String algorithm) { + return MessageDigest.getInstance(algorithm).digest(file.bytes) + .collect { byte value -> String.format('%02x', value & 0xff) }.join() + } + +} diff --git a/build-logic/src/main/groovy/org/egothor/radixor/ValidateModelInputTask.groovy b/build-logic/src/main/groovy/org/egothor/radixor/ValidateModelInputTask.groovy new file mode 100644 index 0000000..870c6d0 --- /dev/null +++ b/build-logic/src/main/groovy/org/egothor/radixor/ValidateModelInputTask.groovy @@ -0,0 +1,57 @@ +package org.egothor.radixor + +import org.gradle.api.DefaultTask +import org.gradle.api.GradleException +import org.gradle.api.file.RegularFileProperty +import org.gradle.api.provider.MapProperty +import org.gradle.api.provider.Property +import org.gradle.api.tasks.Input +import org.gradle.api.tasks.InputFile +import org.gradle.api.tasks.Optional +import org.gradle.api.tasks.PathSensitive +import org.gradle.api.tasks.PathSensitivity +import org.gradle.api.tasks.TaskAction + +/** Validates one immutable model input without retaining Project state. */ +abstract class ValidateModelInputTask extends DefaultTask { + @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getDictionaryFile() + @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getVersionFile() + @Optional @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getLicenseFile() + @Optional @InputFile @PathSensitive(PathSensitivity.RELATIVE) abstract RegularFileProperty getNoticeFile() + @Input abstract Property getModelId() + @Input abstract Property getModuleName() + @Input abstract Property getShareAlike() + @Input abstract MapProperty getMetadata() + + /** Performs deterministic metadata, licensing, and streaming dictionary validation. */ + @TaskAction + void validateInput() { + final File dictionary = dictionaryFile.get().asFile + final String id = modelId.get() + final String version = versionFile.get().asFile.getText('UTF-8').trim() + if (id != moduleName.get() || !(id ==~ /[a-z]{2}(?:-[a-z]{2})?-[a-z0-9]+(?:-[a-z0-9]+)*/)) { + throw new GradleException("Model ID '${id}' must equal module '${moduleName.get()}' and use the safe model-ID syntax.") + } + if (!(version ==~ /[0-9]+\.[0-9]+\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?/)) { + throw new GradleException("Invalid semantic model version '${version}'.") + } + final Map values = metadata.get() + values.each { String key, String value -> + if (value == null || value.isBlank()) throw new GradleException("Required model metadata is missing: ${key}") + } + RadixorModelPlugin.validateRevisionMetadata(values['source.revision'], values['source.revisionStatus']) + if (shareAlike.get()) { + final File notice = noticeFile.get().asFile + RadixorModelPlugin.validateShareAlikeNoticeText(notice.getText('UTF-8'), notice.toString(), id, + values['source.repository'], values['source.licenseUri'], values['source.revision'], + values['source.revisionStatus']) + } else { + final String text = licenseFile.get().asFile.getText('UTF-8') + if (!text.contains('SPDX-License-Identifier: BSD-2-Clause') + || !text.contains('Copyright (c) 2016, Marcin Miłkowski')) { + throw new GradleException('The PoliMorf license must contain the complete BSD-2-Clause text and upstream attribution.') + } + } + RadixorModelPlugin.validateDictionary(dictionary) + } +} diff --git a/build-logic/src/test/groovy/org/egothor/radixor/RadixorModelPluginTest.groovy b/build-logic/src/test/groovy/org/egothor/radixor/RadixorModelPluginTest.groovy new file mode 100644 index 0000000..8d9c4c1 --- /dev/null +++ b/build-logic/src/test/groovy/org/egothor/radixor/RadixorModelPluginTest.groovy @@ -0,0 +1,205 @@ +package org.egothor.radixor + +import org.gradle.api.GradleException +import org.junit.jupiter.api.Test +import org.junit.jupiter.api.io.TempDir + +import java.nio.charset.StandardCharsets +import java.nio.file.Files +import java.nio.file.Path +import java.util.zip.GZIPOutputStream + +import static org.junit.jupiter.api.Assertions.assertEquals +import static org.junit.jupiter.api.Assertions.assertThrows +import static org.junit.jupiter.api.Assertions.assertTrue + +/** Tests model licensing metadata and packaged-resource validation boundaries. */ +final class RadixorModelPluginTest { + @TempDir + Path temporaryDirectory + + /** Accepts a known exact source revision. */ + @Test + void acceptsKnownExactRevision() { + RadixorModelPlugin.validateRevisionMetadata('6e63b53', 'recorded') + } + + /** Accepts the explicit legacy-import sentinel without fabricating a revision. */ + @Test + void acceptsUnknownLegacyRevision() { + RadixorModelPlugin.validateRevisionMetadata( + 'not-recorded-in-legacy-import', 'not-recorded-in-legacy-import') + } + + /** Rejects a missing revision-status declaration. */ + @Test + void rejectsMissingRevisionStatus() { + assertThrows(GradleException) { + RadixorModelPlugin.validateRevisionMetadata('6e63b53', '') + } + } + + /** Rejects a missing model-specific notice input. */ + @Test + void rejectsMissingLicensingInputs() { + File missing = new File('build/nonexistent-model-licensing-input') + assertThrows(GradleException) { + RadixorModelPlugin.requireFile(missing, 'Required model notice is missing') + } + } + + /** Accepts a complete model-specific UniMorph notice. */ + @Test + void acceptsCompleteUniMorphNotice() { + validateNotice(validNotice()) + } + + /** Rejects each independently required notice statement. */ + @Test + void rejectsIncompleteUniMorphNotices() { + [ + 'Copyright (C) 2026, Leo Galambos.', + 'Attribution:', + 'Creative Commons Attribution-ShareAlike 3.0 Unported', + 'Canonical license URI:', + "This derived model data, including Radixor's protectable contributions,", + 'Radixor modifications:', + 'Revision status:', + 'Neither UniMorph nor any upstream contributor endorses Radixor.' + ].each { String required -> + assertThrows(GradleException) { + validateNotice(validNotice().replace(required, 'omitted')) + } + } + } + + /** Rejects packaged notice bytes that differ from their model-module source. */ + @Test + void rejectsIncorrectPackagedNotice() { + assertThrows(GradleException) { + RadixorModelPlugin.requireMatchingChecksum( + 'notice', 'META-INF/NOTICE/test-model-data.txt', 'source', 'different') + } + } + + /** Rejects UniMorph CC material in the separately licensed PoliMorf artifact. */ + @Test + void rejectsUniMorphMaterialInPoliMorf() { + assertThrows(GradleException) { + RadixorModelPlugin.validatePoliMorfJarContents( + ['META-INF/LICENSES/PoliMorf-BSD-2-Clause.txt', 'META-INF/NOTICE/test-data.txt']) + } + assertThrows(GradleException) { + RadixorModelPlugin.validatePoliMorfJarContents( + ['META-INF/LICENSES/PoliMorf-BSD-2-Clause.txt', 'META-INF/LICENSES/CC-BY-SA-3.0.txt']) + } + } + + /** Streams a large dictionary while retaining only aggregate counters and the current row. */ + @Test + void validatesLargeDictionaryWithBoundedState() { + final int groups = 250_000 + final File dictionary = temporaryDirectory.resolve('large.gz').toFile() + writeGzip(dictionary) { BufferedWriter writer -> + for (int index = 0; index < groups; index++) { + writer.write("stem${index}\tvariant${index}\t\n") + } + } + + final RadixorModelPlugin.DictionaryValidationResult result = + RadixorModelPlugin.validateDictionary(dictionary) + + assertEquals(groups, result.acceptedGroupCount) + assertEquals(groups * 2L, result.acceptedFormCount) + assertEquals(groups, result.ignoredEmptyVariantCount) + } + + /** Rejects a source that is not a GZip stream. */ + @Test + void rejectsInvalidGzip() { + final File dictionary = temporaryDirectory.resolve('invalid.gz').toFile() + Files.writeString(dictionary.toPath(), 'not gzip', StandardCharsets.UTF_8) + assertThrows(GradleException) { RadixorModelPlugin.validateDictionary(dictionary) } + } + + /** Rejects malformed UTF-8 through the strict incremental decoder. */ + @Test + void rejectsMalformedUtf8() { + final File dictionary = temporaryDirectory.resolve('malformed-utf8.gz').toFile() + new GZIPOutputStream(Files.newOutputStream(dictionary.toPath())).withCloseable { OutputStream output -> + output.write([0x73, 0x74, 0x65, 0x6d, 0x09, 0xc3, 0x28, 0x0a] as byte[]) + } + assertThrows(GradleException) { RadixorModelPlugin.validateDictionary(dictionary) } + } + + /** Rejects structurally invalid rows with an empty stem. */ + @Test + void rejectsInvalidRows() { + final File dictionary = temporaryDirectory.resolve('invalid-row.gz').toFile() + writeGzip(dictionary) { BufferedWriter writer -> writer.write("\tvariant\n") } + assertThrows(GradleException) { RadixorModelPlugin.validateDictionary(dictionary) } + } + + /** Preserves the production parser policy for Unicode-whitespace items. */ + @Test + void rejectsUnicodeWhitespaceItemsWithoutRejectingTheSource() { + final File dictionary = temporaryDirectory.resolve('whitespace-items.gz').toFile() + writeGzip(dictionary) { BufferedWriter writer -> + writer.write("invalid stem\tvariant\n") + writer.write("valid\taccepted\tinvalid variant\n") + } + final RadixorModelPlugin.DictionaryValidationResult result = + RadixorModelPlugin.validateDictionary(dictionary) + assertEquals(1L, result.acceptedGroupCount) + assertEquals(2L, result.acceptedFormCount) + } + + /** Streams the complete maintained PoliMorf model input successfully. */ + @Test + void validatesFullPoliMorfInput() { + final List candidates = [ + new File('models/pl-pl-polimorf/src/modelInput/stemmer.gz'), + new File('../models/pl-pl-polimorf/src/modelInput/stemmer.gz')] + final File dictionary = candidates.find { File candidate -> candidate.isFile() } + assertTrue(dictionary != null, 'The complete PoliMorf model input must be available to build-logic tests.') + + final RadixorModelPlugin.DictionaryValidationResult result = + RadixorModelPlugin.validateDictionary(dictionary) + assertTrue(result.acceptedGroupCount > 0L) + assertTrue(result.acceptedFormCount > result.acceptedGroupCount) + } + + private static void writeGzip(final File target, final Closure content) { + new GZIPOutputStream(Files.newOutputStream(target.toPath())).withCloseable { OutputStream gzip -> + new BufferedWriter(new OutputStreamWriter(gzip, StandardCharsets.UTF_8)).withCloseable { + BufferedWriter writer -> content.call(writer) + } + } + } + + private static void validateNotice(final String text) { + RadixorModelPlugin.validateShareAlikeNoticeText(text, 'test notice', 'test-model', + 'https://github.com/unimorph/test', 'https://creativecommons.org/licenses/by-sa/3.0/', + 'not-recorded-in-legacy-import', 'not-recorded-in-legacy-import') + } + + private static String validNotice() { + return '''Model ID: test-model +Official repository: https://github.com/unimorph/test +Attribution: UniMorph and upstream contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Radixor modifications: Cleaning and packaging. +Revision status: not-recorded-in-legacy-import +The exact UniMorph commit used for the original Radixor import was not recorded. +Copyright (C) 2026, Leo Galambos. +Radixor-specific selection, verification, cleaning, normalization, +to the extent protected by applicable law. +The underlying morphological data remains attributed to UniMorph and +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Neither UniMorph nor any upstream contributor endorses Radixor. +''' + } +} diff --git a/build.gradle b/build.gradle index dd76299..83cf961 100644 --- a/build.gradle +++ b/build.gradle @@ -1,4 +1,5 @@ plugins { + id 'org.egothor.radixor.build-support' id 'java' id 'eclipse' id 'application' @@ -7,9 +8,9 @@ plugins { id 'pmd' id 'jacoco' id 'info.solidsoft.pitest' version '1.19.0' - id 'me.champeau.jmh' version '0.7.2' + id 'me.champeau.jmh' version '0.7.3' id 'org.owasp.dependencycheck' version '12.2.1' - id 'org.cyclonedx.bom' version '3.2.4' + id 'org.cyclonedx.bom' version '3.3.0' id 'com.palantir.git-version' version '4.0.0' } @@ -45,6 +46,10 @@ java { targetCompatibility = JavaVersion.VERSION_21 } +tasks.withType(JavaCompile).configureEach { + options.compilerArgs.addAll(['-Xlint:deprecation', '-Xlint:unchecked']) +} + tasks.withType(AbstractArchiveTask).configureEach { preserveFileTimestamps = false reproducibleFileOrder = true @@ -70,6 +75,11 @@ dependencyLocking { dependencies { jmhImplementation sourceSets.main.output + modelProjects().each { Project modelProject -> + testRuntimeOnly project(modelProject.path) + jmhRuntimeOnly project(modelProject.path) + } + testImplementation platform(libs.junit.bom) testImplementation libs.junit.jupiter testRuntimeOnly libs.junit.platform.launcher @@ -77,12 +87,45 @@ dependencies { testImplementation libs.mockito.core testImplementation libs.mockito.junit.jupiter testImplementation libs.jqwik + testImplementation gradleTestKit() mockitoAgent(libs.mockito.core) { transitive = false } } +def modelProjects() { + Properties topology = new Properties() + rootProject.file('models/model-projects.properties').withInputStream { InputStream input -> + topology.load(input) + } + return topology.stringPropertyNames().toList().sort().collect { String modelId -> + project(":models:${modelId}") + } +} + +def defaultModelProjects() { + Properties topology = new Properties() + rootProject.file('models/model-projects.properties').withInputStream { InputStream input -> + topology.load(input) + } + return topology.stringPropertyNames().findAll { String modelId -> + topology.getProperty(modelId) == 'default' + }.sort().collect { String modelId -> project(":models:${modelId}") } +} + +tasks.named('projects') { + actions.clear() + doLast { + logger.lifecycle('Root project \'{}\'', rootProject.name) + rootProject.allprojects.findAll { Project candidate -> candidate != rootProject } + .sort { Project left, Project right -> left.path <=> right.path } + .each { Project candidate -> logger.lifecycle('+--- Project \'{}\'', candidate.path) } + gradle.includedBuilds.toList().sort { left, right -> left.name <=> right.name } + .each { includedBuild -> logger.lifecycle('Included build \'{}\'', includedBuild.name) } + } +} + sourceSets.jmh.compileClasspath = sourceSets.jmh.compileClasspath - sourceSets.test.output sourceSets.jmh.runtimeClasspath = sourceSets.jmh.runtimeClasspath - sourceSets.test.output sourceSets.test.compileClasspath += sourceSets.jmh.output + configurations.jmhCompileClasspath @@ -138,9 +181,10 @@ def splitTagExpression = { String tagsExpr -> } tasks.withType(Test).configureEach { - doFirst { - jvmArgs "-javaagent:${configurations.mockitoAgent.singleFile}" - } + final def mockitoAgentArguments = objects.newInstance( + org.egothor.radixor.MockitoAgentArgumentProvider) + mockitoAgentArguments.agentClasspath.from(configurations.mockitoAgent) + jvmArgumentProviders.add(mockitoAgentArguments) /* * Bundled dictionary integration tests compile and reload large real-world @@ -156,6 +200,30 @@ tasks.withType(Test).configureEach { } } +tasks.named('test', Test) { + dependsOn('prepareModelConsumerTestRepository') + systemProperty('radixor.consumer.repository', + layout.buildDirectory.dir('model-consumer-repository').get().asFile.absolutePath) + systemProperty('radixor.core.version', version.toString()) + systemProperty('radixor.catalog.version', project(':models:standard').version.toString()) +} + +tasks.register('modelDependencyResolutionTest', Test) { + group = 'verification' + description = 'Verifies that published model coordinates resolve from the generated consumer repository.' + dependsOn(tasks.named('prepareModelConsumerTestRepository')) + testClassesDirs = sourceSets.test.output.classesDirs + classpath = sourceSets.test.runtimeClasspath + useJUnitPlatform() + filter { + includeTestsMatching('org.egothor.stemmer.ModelDependencyResolutionTest') + } + systemProperty('radixor.consumer.repository', + layout.buildDirectory.dir('model-consumer-repository').get().asFile.absolutePath) + systemProperty('radixor.core.version', version.toString()) + systemProperty('radixor.catalog.version', project(':models:standard').version.toString()) +} + def configureJUnitPlatformTags = { Test task, String includeTagsExpr, String excludeTagsExpr -> task.useJUnitPlatform { final def includes = splitTagExpression(includeTagsExpr) @@ -173,11 +241,47 @@ def configureJUnitPlatformTags = { Test task, String includeTagsExpr, String exc tasks.named('test', Test) { final def requestedIncludes = splitTagExpression(cliIncludeTags) final boolean slowExplicitlyIncluded = requestedIncludes.contains('slow') - final String defaultExcludeTags = cliExcludeTags ?: (slowExplicitlyIncluded ? null : 'slow') + final String defaultExcludeTags = cliExcludeTags ?: (slowExplicitlyIncluded ? 'large-model' : 'slow,large-model') configureJUnitPlatformTags(it, cliIncludeTags, defaultExcludeTags) finalizedBy(tasks.named('jacocoTestReport')) } +def largeModelMaxHeap = providers.gradleProperty('radixorLargeModelMaxHeap').orElse('6g') +def runtimeModelId = providers.gradleProperty('modelId').orElse('pl-pl-polimorf') +def runtimeModelClasspath = configurations.testRuntimeClasspath.incoming.artifactView { + componentFilter { componentIdentifier -> + if (!(componentIdentifier instanceof org.gradle.api.artifacts.component.ProjectComponentIdentifier)) { + return true + } + final String projectPath = componentIdentifier.projectPath + return !projectPath.startsWith(':models:') || projectPath == ":models:${runtimeModelId.get()}" + } +}.files + +tasks.register('runtimeModelIntegrationTest', Test) { + group = 'verification' + description = 'Constructs one complete selected runtime model in an isolated, memory-sized JVM.' + testClassesDirs = sourceSets.test.output.classesDirs + classpath = sourceSets.test.output + sourceSets.main.output + sourceSets.jmh.output + runtimeModelClasspath + dependsOn(tasks.named('compileTestJava')) + useJUnitPlatform { + includeTags('large-model') + } + systemProperty('radixor.test.modelId', runtimeModelId.get()) + minHeapSize = '1g' + maxHeapSize = largeModelMaxHeap.get() + maxParallelForks = 1 + forkEvery = 1 + reports { + junitXml.required = true + html.required = true + } + doFirst { + logger.lifecycle("Runtime model integration uses model '{}' with maximum heap {}.", + systemProperties.get('radixor.test.modelId'), maxHeapSize) + } +} + def configureTaggedTestProfile = { String taskName, String includeTagsExpr, String excludeTagsExpr = null, String taskDescription = null, String testNameExcludePatterns = null -> tasks.register(taskName, Test) { @@ -189,10 +293,6 @@ def configureTaggedTestProfile = { String taskName, String includeTagsExpr, Stri classpath = sourceSets.test.runtimeClasspath dependsOn(tasks.named('compileTestJava')) - doFirst { - jvmArgs "-javaagent:${configurations.mockitoAgent.singleFile}" - } - if (testNameExcludePatterns != null && !testNameExcludePatterns.isBlank()) { filter { testNameExcludePatterns.split(',').each { String pattern -> @@ -253,11 +353,19 @@ configureTaggedTestProfile( configureTaggedTestProfile( 'ciRelease', null, - 'slow', + 'slow,large-model', 'Release-profile validation of all non-slow tests.', 'org.egothor.stemmer.CompileIntegrationTest*,org.egothor.stemmer.StemmerPatchTrieLoaderTest$BundledDictionaryTests*' ) +tasks.named('ciRelease', Test) { + dependsOn('prepareModelConsumerTestRepository') + systemProperty('radixor.consumer.repository', + layout.buildDirectory.dir('model-consumer-repository').get().asFile.absolutePath) + systemProperty('radixor.core.version', version.toString()) + systemProperty('radixor.catalog.version', project(':models:standard').version.toString()) +} + configureTaggedTestProfile( 'ciNightly', 'fuzz', @@ -333,25 +441,393 @@ tasks.named('check') { // no-default, only on-demand: dependsOn(tasks.named('dependencyCheckAnalyze')) } -allprojects { - tasks.matching { it.name == 'cyclonedxDirectBom' }.configureEach { - includeConfigs = ['runtimeClasspath', 'compileClasspath'] - skipConfigs = ['testRuntimeClasspath', 'testCompileClasspath', 'jmh.*', 'mockitoAgent'] - includeBomSerialNumber = true - includeLicenseText = false - includeMetadataResolution = true - includeBuildSystem = true +tasks.register('verifyCoreJarExcludesModels') { + group = 'verification' + description = 'Verifies that the root Radixor JAR contains no language dictionary bytes.' + dependsOn(tasks.named('jar')) + doLast { + File archive = tasks.named('jar', Jar).get().archiveFile.get().asFile + List dictionaries = [] + new java.util.zip.ZipFile(archive).withCloseable { zip -> + zip.entries().each { entry -> if (entry.name.endsWith('/stemmer.gz')) dictionaries.add(entry.name) } + } + if (!dictionaries.isEmpty()) { + throw new GradleException('The org.egothor:radixor JAR must not contain model data: ' + dictionaries) + } } } -tasks.named('cyclonedxBom') { +tasks.register('verifyJavaLicenseHeaders') { + group = 'verification' + description = 'Verifies deterministic license classification for every maintained Java source file.' + inputs.file(layout.projectDirectory.file('gradle/java-license-header.txt')) + inputs.files(fileTree('src/main/java') { include '**/*.java' }) + inputs.files(fileTree('src/test/java') { include '**/*.java' }) + inputs.files(fileTree('src/jmh/java') { include '**/*.java' }) + outputs.file(layout.buildDirectory.file('reports/license/java-license-headers.txt')) + doLast { + String canonicalHeader = layout.projectDirectory.file('gradle/java-license-header.txt') + .asFile.getText('UTF-8') + File canonicalSource = file('src/main/java/org/egothor/stemmer/CaseProcessingMode.java') + if (!canonicalSource.getText('UTF-8').startsWith(canonicalHeader)) { + throw new GradleException('CaseProcessingMode.java does not begin with the canonical Radixor license template.') + } + + List maintainedSources = files( + fileTree('src/main/java') { include '**/*.java' }, + fileTree('src/test/java') { include '**/*.java' }, + fileTree('src/jmh/java') { include '**/*.java' }) + .files.toList().sort { File left, File right -> + relativePath(left) <=> relativePath(right) + } + List classifications = [] + List failures = [] + maintainedSources.each { File sourceFile -> + String relative = relativePath(sourceFile) + String content = sourceFile.getText('UTF-8') + if (content.startsWith(canonicalHeader)) { + classifications.add("RADIXOR_CANONICAL_HEADER ${relative}") + return + } + + String leadingNotice = '' + if (content.startsWith('/*')) { + int closingIndex = content.indexOf('*/') + if (closingIndex >= 0) { + leadingNotice = content.substring(0, closingIndex + 2) + } + } else if (content.startsWith('//')) { + leadingNotice = content.readLines().takeWhile { String line -> + line.startsWith('//') || line.isBlank() + }.join('\n') + } + String remainder = content.substring(leadingNotice.length()).stripLeading() + boolean duplicateNotice = !leadingNotice.isEmpty() + && (remainder.startsWith('/*') || remainder.startsWith('//')) + boolean historicalRadixor = leadingNotice =~ /(?s)Copyright \(C\) \d{4}(?:-\d{4})?, Leo Galambos/ + && leadingNotice.contains('All rights reserved.') + && leadingNotice.contains('Redistribution and use in source and binary forms') + && leadingNotice.contains('THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS') + boolean thirdPartyOrProvenance = leadingNotice =~ /(?is)(SPDX-License-Identifier|Licensed under|MIT License|Apache License|Permission is hereby granted|Original source|Adapted from|Ported from|Source:\s*\S)/ + if (duplicateNotice) { + classifications.add("AMBIGUOUS_AUTHORSHIP ${relative}") + failures.add("${relative}: duplicate leading comment blocks") + } else if (historicalRadixor) { + classifications.add("RADIXOR_HISTORICAL_HEADER ${relative}") + } else if (thirdPartyOrProvenance) { + classifications.add("THIRD_PARTY_OR_PROVENANCE_HEADER ${relative}") + } else { + classifications.add("AMBIGUOUS_AUTHORSHIP ${relative}") + failures.add("${relative}: no recognized governing license or provenance header") + } + } + + File report = layout.buildDirectory.file('reports/license/java-license-headers.txt').get().asFile + report.parentFile.mkdirs() + report.setText(classifications.join('\n') + '\n', 'UTF-8') + if (!failures.isEmpty()) { + throw new GradleException('Maintained Java license verification failed: ' + + failures.sort().join(', ')) + } + } +} + +tasks.register('verifyAllDefaultModels') { + group = 'verification' + description = 'Verifies that every language default model project is configured.' + dependsOn(defaultModelProjects().collect { Project modelProject -> + modelProject.path + ':verifyModelDescriptor' + }) +} + +tasks.register('verifyAllModels') { + group = 'verification' + description = 'Runs complete validation and artifact verification for every independently versioned model module.' + dependsOn(modelProjects().collect { Project modelProject -> modelProject.tasks.named('check') }) +} + +tasks.register('verifyJmhModelClasspath') { + group = 'verification' + description = 'Verifies that JMH receives each individual model JAR exactly once and embeds no dictionary.' + dependsOn(tasks.named('jmhJar')) + dependsOn(modelProjects().collect { Project modelProject -> modelProject.tasks.named('jar') }) + outputs.file(layout.buildDirectory.file('reports/models/jmh-model-classpath.txt')) + doLast { + List modelJars = configurations.jmhRuntimeClasspath.files.findAll { File dependency -> + dependency.name.startsWith('radixor-model-') && dependency.name.endsWith('.jar') + }.sort { File left, File right -> left.name <=> right.name } + List expectedPrefixes = modelProjects().collect { Project modelProject -> + "radixor-model-${modelProject.name}-" + } + expectedPrefixes.each { String prefix -> + List matches = modelJars.findAll { File dependency -> dependency.name.startsWith(prefix) } + if (matches.size() != 1) { + throw new GradleException("JMH must resolve exactly one model JAR with prefix ${prefix}; resolved ${matches}.") + } + } + if (modelJars.any { File dependency -> dependency.name.contains('benchmark-pack') }) { + throw new GradleException('JMH must not resolve a benchmark-pack artifact.') + } + File executable = tasks.named('jmhJar', Jar).get().archiveFile.get().asFile + if (!zipTree(executable).matching { include '**/stemmer.gz' }.isEmpty()) { + throw new GradleException('The JMH executable JAR must not embed model dictionaries.') + } + File report = layout.buildDirectory.file('reports/models/jmh-model-classpath.txt').get().asFile + report.parentFile.mkdirs() + report.setText(modelJars.collect { File dependency -> dependency.name }.join('\n') + '\n', 'UTF-8') + } +} + +tasks.named('prepareModelConsumerTestRepository') { + coreVersion = version.toString() + catalogVersion = project(':models:standard').version.toString() + modelVersions = modelProjects().collectEntries { Project modelProject -> + final String modelVersion = providers.gradleProperty('modelReleaseVersion') + .orElse(providers.fileContents(modelProject.layout.projectDirectory.file('model-version.txt')) + .asText.map(String::trim)) + .get() + [(modelProject.name): modelVersion] + } + corePom = layout.file(tasks.named('generatePomFileForMavenJavaPublication').map { it.destination }) + coreJar = tasks.named('jar', Jar).flatMap { it.archiveFile } + modelPoms.from(modelProjects().collect { Project modelProject -> + modelProject.tasks.named('generatePomFileForModelPublication').map { it.destination } + }) + modelJars.from(modelProjects().collect { Project modelProject -> + modelProject.tasks.named('jar', Jar).flatMap { it.archiveFile } + }) + standardPom = layout.file(project(':models:standard').tasks.named('generatePomFileForStandardPublication') + .map { it.destination }) + bomPom = layout.file(project(':models:bom').tasks.named('generatePomFileForBomPublication') + .map { it.destination }) + repositoryDirectory = layout.buildDirectory.dir('model-consumer-repository') +} + +def cleanModelCatalogStaging = tasks.register('cleanModelCatalogStaging') { + group = 'publishing' + description = 'Cleans the isolated model catalog Maven staging repository.' + doLast { + project.delete(layout.buildDirectory.dir('model-catalog-staging-repository')) + } +} + +gradle.projectsEvaluated { + project(':models:standard').tasks.named('publishStandardPublicationToCatalogStagingRepository') { + dependsOn(cleanModelCatalogStaging) + } + project(':models:bom').tasks.named('publishBomPublicationToCatalogStagingRepository') { + dependsOn(cleanModelCatalogStaging) + } +} + +tasks.register('prepareModelCatalogReleaseCandidate') { + group = 'publishing' + description = 'Stages the POM-only standard aggregate and model BOM with Central checksums.' + dependsOn(project(':models:standard').tasks.named('check')) + dependsOn(project(':models:bom').tasks.named('check')) + dependsOn(':models:standard:publishStandardPublicationToCatalogStagingRepository') + dependsOn(':models:bom:publishBomPublicationToCatalogStagingRepository') + outputs.dir(layout.buildDirectory.dir('model-catalog-staging-repository')) + doLast { + File repository = layout.buildDirectory.dir('model-catalog-staging-repository').get().asFile + repository.eachFileRecurse { File artifact -> + if (artifact.isFile() && !['.md5', '.sha1', '.sha256', '.sha512'].any { + String extension -> artifact.name.endsWith(extension) + }) { + ['MD5': 'md5', 'SHA-1': 'sha1'].each { String algorithm, String extension -> + String digest = java.security.MessageDigest.getInstance(algorithm) + .digest(artifact.bytes).encodeHex().toString() + new File(artifact.absolutePath + ".${extension}").setText(digest, 'US-ASCII') + } + } + } + } +} + +tasks.register('modelCatalogCentralBundle', Zip) { + group = 'publishing' + description = 'Builds the local POM-only model catalog bundle without remote publication.' + dependsOn(tasks.named('prepareModelCatalogReleaseCandidate')) + from(layout.buildDirectory.dir('model-catalog-staging-repository')) { + exclude('**/maven-metadata*.xml*', '**/*.module*') + } + destinationDirectory = layout.buildDirectory.dir('model-catalog-release-candidate') + archiveFileName = "radixor-models-catalog-${project(':models:standard').version}-central-bundle.zip" + doFirst { + if (providers.environmentVariable('GITHUB_REF_TYPE').orNull == 'tag' + && (providers.environmentVariable('SIGNING_KEY').orNull?.isBlank() != false + || providers.environmentVariable('SIGNING_PASSWORD').orNull?.isBlank() != false)) { + throw new GradleException('A tagged model catalog release requires SIGNING_KEY and SIGNING_PASSWORD.') + } + } +} + +tasks.register('verifyModelCatalogReleaseCandidate') { + group = 'verification' + description = 'Verifies that the local catalog bundle contains only two POM publications, signatures when configured, and checksums.' + dependsOn(tasks.named('modelCatalogCentralBundle')) + outputs.file(layout.buildDirectory.file('reports/models/catalog-release-candidate.txt')) + doLast { + File bundle = tasks.named('modelCatalogCentralBundle', Zip).get().archiveFile.get().asFile + List entries = [] + new java.util.zip.ZipFile(bundle).withCloseable { java.util.zip.ZipFile archive -> + archive.entries().each { java.util.zip.ZipEntry entry -> + if (!entry.directory) entries.add(entry.name) + } + } + entries.sort() + List poms = entries.findAll { String entry -> entry.endsWith('.pom') } + if (poms.size() != 2 || entries.any { String entry -> + entry.endsWith('.jar') || entry.endsWith('/stemmer.gz') || entry.contains('benchmark-pack') + }) { + throw new GradleException('The model catalog bundle must contain only the standard and BOM POM publications.') + } + List unsupported = entries.findAll { String entry -> + !(entry.endsWith('.pom') || entry.endsWith('.pom.md5') || entry.endsWith('.pom.sha1') + || entry.endsWith('.pom.sha256') || entry.endsWith('.pom.sha512') + || entry.endsWith('.pom.asc') || entry.endsWith('.pom.asc.md5') + || entry.endsWith('.pom.asc.sha1') || entry.endsWith('.pom.asc.sha256') + || entry.endsWith('.pom.asc.sha512')) + } + if (!unsupported.isEmpty()) { + throw new GradleException("The model catalog bundle contains unsupported files: ${unsupported}.") + } + poms.each { String pom -> + if (!entries.contains(pom + '.md5') || !entries.contains(pom + '.sha1')) { + throw new GradleException("The model catalog POM is missing Central checksums: ${pom}.") + } + } + File report = layout.buildDirectory.file('reports/models/catalog-release-candidate.txt').get().asFile + report.parentFile.mkdirs() + report.setText("Bundle: ${bundle.name}\nBytes: ${bundle.length()}\n" + entries.join('\n') + '\n', 'UTF-8') + } +} + +tasks.register('verifyArtifactSizes') { + group = 'verification' + description = 'Reports artifact sizes and rejects dictionary bytes in core.' + dependsOn(tasks.named('verifyCoreJarExcludesModels')) + doLast { + File archive = tasks.named('jar', Jar).get().archiveFile.get().asFile + println('org.egothor:radixor:' + version + ' ' + archive.length() + ' bytes') + } +} + +tasks.named('check') { + dependsOn(tasks.named('verifyCoreJarExcludesModels')) + dependsOn(tasks.named('verifyAllDefaultModels')) + dependsOn(tasks.named('verifyJmhModelClasspath')) + dependsOn(tasks.named('verifyJavaLicenseHeaders')) +} + +def modelCatalogText = providers.provider { + StringBuilder output = new StringBuilder() + output.append('| Model ID | Language | Default | Coordinates | Version | Source | Repository | Source version | Revision | Revision status | License | Attribution | SHA-256 | Bytes |\n') + output.append('|---|---|---:|---|---:|---|---|---|---|---|---|---|---|---:|\n') + modelProjects().each { Project modelProject -> + String script = modelProject.file('build.gradle').getText('UTF-8') + def value = { String key -> + def matcher = script =~ /(?m)^\s*${key}\s*=\s*(?:'([^']+)'|([^\s]+))\s*$/ + if (!matcher.find()) return 'unavailable' + return matcher.group(1) != null ? matcher.group(1) : matcher.group(2) + } + File input = modelProject.file('src/modelInput/stemmer.gz') + String checksum = java.security.MessageDigest.getInstance('SHA-256').digest(input.bytes).encodeHex().toString() + output.append('| ').append(modelProject.name) + .append(' | ').append(value('language')) + .append(' | ').append(value('defaultModel')) + .append(' | org.egothor:radixor-model-').append(modelProject.name) + .append(' | ').append(modelProject.file('model-version.txt').text.trim()) + .append(' | ').append(value('sourceName')) + .append(' | ').append(value('sourceRepository')) + .append(' | ').append(value('sourceVersion')) + .append(' | ').append(value('sourceRevision')) + .append(' | ').append(value('sourceRevisionStatus')) + .append(' | ').append(value('sourceLicense')) + .append(' | ').append(value('sourceAttribution')) + .append(' | ').append(checksum) + .append(' | ').append(input.length()).append(' |\n') + } + return output.toString() +} + +tasks.register('generateModelCatalogDocumentation') { + group = 'documentation' + description = 'Generates the deterministic model catalog in the build documentation staging tree.' + outputs.file(layout.buildDirectory.file('mkdocs-source/stemmer-model-catalog.md')) + doLast { + File catalog = layout.buildDirectory.file('mkdocs-source/stemmer-model-catalog.md').get().asFile + catalog.parentFile.mkdirs() + catalog.setText('# Published Stemmer Model Catalog\n\n' + modelCatalogText.get(), 'UTF-8') + } +} + +tasks.register('prepareMkDocsSource', Sync) { + group = 'documentation' + description = 'Stages maintained documentation, generated catalog, and MkDocs configuration under build/.' + dependsOn(modelProjects().collect { Project modelProject -> modelProject.path + ':verifyModelDescriptor' }) + into(layout.buildDirectory.dir('mkdocs-source')) + from(layout.projectDirectory.dir('docs')) + doLast { + File catalog = layout.buildDirectory.file('mkdocs-source/stemmer-model-catalog.md').get().asFile + catalog.setText('# Published Stemmer Model Catalog\n\n' + modelCatalogText.get(), 'UTF-8') + File buildsPage = layout.buildDirectory.file('mkdocs-source/builds.md').get().asFile + buildsPage.setText('# Historical Builds\n\nThe Pages publication workflow replaces this staging placeholder with the retained build index.\n', 'UTF-8') + File configuration = layout.buildDirectory.file('mkdocs/mkdocs.yml').get().asFile + configuration.parentFile.mkdirs() + configuration.setText(layout.projectDirectory.file('mkdocs.yml').asFile.getText('UTF-8') + + '\ndocs_dir: ../mkdocs-source\nsite_dir: ../mkdocs-site\n', 'UTF-8') + } +} + +tasks.register('verifyModelCatalogDocumentation') { + group = 'verification' + description = 'Validates model metadata and the generated build-directory MkDocs catalog.' + dependsOn(tasks.named('prepareMkDocsSource')) + dependsOn(tasks.named('verifyAllDefaultModels')) + doLast { + File catalog = layout.buildDirectory.file('mkdocs-source/stemmer-model-catalog.md').get().asFile + String expected = '# Published Stemmer Model Catalog\n\n' + modelCatalogText.get() + if (!catalog.isFile() || catalog.getText('UTF-8') != expected) { + throw new GradleException('The staged model catalog is missing or nondeterministic.') + } + List identifiers = modelProjects().collect { Project modelProject -> modelProject.name } + if (identifiers != identifiers.sort()) { + throw new GradleException('Published model projects are not in deterministic model-ID order.') + } + identifiers.each { String identifier -> + if (!expected.contains('org.egothor:radixor-model-' + identifier)) { + throw new GradleException('The staged model catalog omits published model ' + identifier + '.') + } + } + if (!layout.buildDirectory.file('mkdocs/mkdocs.yml').get().asFile.isFile()) { + throw new GradleException('The staged MkDocs configuration is missing.') + } + } +} + +tasks.named('check') { + dependsOn(tasks.named('verifyModelCatalogDocumentation')) +} + +tasks.named('cyclonedxDirectBom') { + includeConfigs = ['runtimeClasspath', 'compileClasspath'] + skipConfigs = ['testRuntimeClasspath', 'testCompileClasspath', 'jmh.*', 'mockitoAgent'] includeBomSerialNumber = true includeLicenseText = false + includeMetadataResolution = true includeBuildSystem = true jsonOutput.set(sbomReportsDirectory.map { it.file('radixor-sbom.json') }) xmlOutput.set(sbomReportsDirectory.map { it.file('radixor-sbom.xml') }) } +subprojects { + tasks.matching { Task candidate -> candidate.name == 'cyclonedxDirectBom' }.configureEach { + enabled = false + description = 'Disabled because the root project exclusively owns CycloneDX SBOM generation.' + } +} + pitest { pitestVersion = '1.22.1' junit5PluginVersion = '1.2.3' @@ -461,6 +937,13 @@ tasks.named('jmh') { description = 'Runs JMH benchmarks for the Radixor algorithmic core and external stemmer comparison suites.' } +tasks.named('jmhJar', Jar) { + exclude 'META-INF/radixor/models.index' + exclude 'META-INF/radixor/models/**' + exclude 'org/egothor/stemmer/models/**' + exclude 'META-INF/LICENSES/**' +} + apply from: 'gradle/lucene-benchmarks.gradle' tasks.register('regressionArtifactGenerator', JavaExec) { @@ -486,13 +969,14 @@ tasks.register('regressionArtifactGenerator', JavaExec) { tasks.register('stemmingQuality', JavaExec) { group = 'verification' - description = 'Evaluates pairwise over-stemming and under-stemming against bundled dictionary groups.' + description = 'Evaluates pairwise over-stemming and under-stemming against registered model dictionary groups.' dependsOn(tasks.named('testClasses')) dependsOn(tasks.named('jmhClasses')) + dependsOn(tasks.named('prepareBenchmarkModelInputs')) classpath = files(sourceSets.test.runtimeClasspath, configurations.stemmingQualityJmhRuntime) mainClass = 'org.egothor.stemmer.benchmark.quality.StemmingQualityApplication' args layout.buildDirectory.dir('reports/stemming-quality').get().asFile.absolutePath, - layout.projectDirectory.dir('src/main/resources').asFile.absolutePath, + layout.buildDirectory.dir('generated/benchmark-model-inputs').get().asFile.absolutePath, providers.gradleProperty('stemmingQualityLanguage').getOrElse(''), providers.gradleProperty('stemmingQualityStemmer').getOrElse(''), providers.gradleProperty('stemmingQualityMode').getOrElse(''), @@ -503,6 +987,20 @@ tasks.register('stemmingQuality', JavaExec) { maxHeapSize = '6g' } +tasks.register('prepareBenchmarkModelInputs', Sync) { + group = 'verification' + description = 'Prepares default model inputs for JMH and quality evaluation without changing source data.' + into(layout.buildDirectory.dir('generated/benchmark-model-inputs')) + defaultModelProjects().each { Project modelProject -> + String languageDirectory = modelProject.name == 'pl-pl-unimorph' + ? 'pl_pl' + : modelProject.name.replace('-default', '').replace('-', '_') + from(modelProject.file('src/modelInput/stemmer.gz')) { + into(languageDirectory) + } + } +} + tasks.register('publishStemmingQualityDocumentation', JavaExec) { group = 'documentation' description = 'Publishes validated complete stemming-quality results on the language benchmark pages.' diff --git a/docs/architecture-and-reduction.md b/docs/architecture-and-reduction.md index 807c69a..09e45d4 100644 --- a/docs/architecture-and-reduction.md +++ b/docs/architecture-and-reduction.md @@ -17,6 +17,10 @@ The build-time flow is: Dictionary -> Mutable trie -> Reduced trie -> Compiled trie ``` +For registered models, the dictionary is an independently versioned GZip resource discovered through a descriptor and verified before this flow begins. The model resource is input to trie construction, not a precompiled trie. See [Model Selection and Loading](model-selection-and-loading.md) for discovery and [Architecture](architecture.md) for component and release boundaries. + +Explicit descriptors and stable model IDs now use the same compiled-value path as language defaults. `loadCompiled(descriptor, ...)` and `loadCompiled(modelId, ...)` first build with serialized patch commands and then map those values to `CompiledPatchCommand` while preserving metadata, reduction semantics, and ranked `getAll` order. Very large inputs can have a high temporary construction peak; PoliMorf is verified in an isolated 6 GiB JVM rather than increasing ordinary test or Gradle daemon heaps. + At runtime, the compiled trie does not directly return the final stem string. It returns one or more stored patch commands for the addressed key, and those commands are then applied to the original input word. ## Why this matters @@ -50,3 +54,5 @@ For most readers, the best order is: - [Programmatic usage](programmatic-usage.md) - [CLI compilation](cli-compilation.md) - [Dictionary format](dictionary-format.md) +- [Model selection and loading](model-selection-and-loading.md) +- [Stemmer models](stemmer-models.md) diff --git a/docs/architecture.md b/docs/architecture.md index 7ae5866..4829bb0 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -2,6 +2,92 @@ This document explains the structural architecture of **Radixor**: what data is stored, how it flows through the build pipeline, and how runtime lookup works once a compiled trie has been produced. +## Component boundaries + +| Component | Responsibility | +|---|---| +| Root Radixor core | Patch commands, dictionary parser, trie construction/lookup, descriptor and registry APIs, loaders; no language data | +| Individual model module | Immutable source input and license; publishes one independently versioned resource JAR | +| `StemmerModelRegistry` | Deterministic index/descriptor discovery and selection by model ID or language default | +| `StemmerModelDescriptor` | Immutable public view of validated runtime identity, format, resource, checksum, and source URL | +| Model convention plugin | Validates inputs and generates the resource namespace, descriptor, index, license, and publication | +| Standard aggregate | POM-only transitive runtime dependencies for one default per language | +| Verification classpaths | Direct individual-model dependencies for tests, quality evaluation, and JMH, including optional PoliMorf | +| Models BOM | POM-only recommended individual model versions in Maven dependency management | +| Documentation staging | Maintained `docs/` plus generated catalog under `build/mkdocs-source/` | +| Release workflows | Independent core, one-model, and catalog publication boundaries | + +Read [Model Selection and Loading](model-selection-and-loading.md) for executable application examples and [Stemmer Models](stemmer-models.md) for artifact maintenance. + +## Runtime model discovery and loading + +The implemented sequence is: + +1. use the thread context `ClassLoader`, or an explicit non-null loader; +2. enumerate every `META-INF/radixor/models.index` with `ClassLoader.getResources(...)`; +3. sort index URLs and validate every descriptor path; +4. read descriptor resources and required properties; +5. validate model ID, language, exact resource namespace, checksum syntax, format name, and format version; +6. sort descriptors by model ID and reject duplicate IDs; +7. resolve either `Language.defaultModelId()` or an exact explicit model ID; +8. open the declared model resource with the descriptor's discovering loader; +9. compare SHA-256 over the compressed bytes; +10. decompress GZip and parse UTF-8 Radixor dictionary rows; +11. build and reduce a `FrequencyTrie`; +12. optionally compile stored patch strings into `CompiledPatchCommand` values for the language-oriented compiled API. + +Descriptor discovery verifies resource presence before selection. Byte-level checksum verification happens when the selected model is loaded. The registry never scans arbitrary JAR contents and never selects “the first model for a language.” + +### Default Polish resolution + +`StemmerPatchTrieLoader.Language.PL_PL` declares `pl-pl-unimorph` in the enum constructor. A language-oriented load creates a context-loader registry and calls `requireDefault(PL_PL)`. If that ID is absent, loading stops with `StemmerModelNotFoundException` naming `org.egothor:radixor-model-pl-pl-unimorph:`. + +### Explicit PoliMorf resolution + +`registry.require("pl-pl-polimorf")` addresses the alternative directly. It neither changes nor consults the Polish default. Both descriptors may coexist; duplicate declarations of either same ID are rejected. + +## Version axes + +| Version | Owned by | Compatibility purpose | +|---|---|---| +| Core version | Root Git-derived release | Java implementation and public API | +| Model artifact version | Each `model-version.txt` | One independently published model JAR | +| Catalog version | `models/catalog-version.txt` | Standard aggregate and BOM recommendation set | +| Source dictionary version | Module provenance | Upstream lexical data lineage | +| Model format version | Descriptor and registry | Loader compatibility for packaged dictionary representation | + +No equality relationship is implied between these values. + +## Build topology and generated output + +`models/model-projects.properties` is the single Gradle-readable topology list for the 21 individual model projects and their default or optional aggregate role. Per-model build scripts and generated descriptors remain authoritative for language, resource, provenance, checksum, and model-specific metadata. `settings.gradle`, root verification classpaths, the standard POM, and BOM constraints all derive membership from the topology list. + +Gradle implicitly creates the lifecycle parent `:models` because child paths are nested. It has no build script, applied project plugin, Maven coordinate, publication, or archive. The root CycloneDX plugin exposes direct-task instances to subprojects internally; every subproject instance is disabled, so only root `:cyclonedxDirectBom` can generate an SBOM. The ignored path `models/build/` is generated output, not a module, and the supported build does not write reports there. Root aggregate reports, including `verifyJmhModelClasspath`, belong under `build/reports/models/`; each individual model retains its own outputs under `models//build/`. + +`models/bom` is a Maven dependency BOM: it controls recommended dependency versions and adds no runtime artifacts. The root CycloneDX task produces a software bill of materials (SBOM) under `build/reports/sbom/`. These artifacts have different purposes and output locations. + +## Build-time model packaging + +The `org.egothor.radixor.model` convention plugin treats `src/modelInput` as immutable. `validateModelInput` checks the GZip stream, strict UTF-8, dictionary rows, ID, semantic model version, and license. `prepareModelResources` copies identical compressed bytes under `org/egothor/stemmer/models//stemmer.gz` and generates the descriptor, index, and packaged license under `build/`. `verifyModelDescriptor` checks the digest, while `verifyModelJar` checks the unique resource, packaged-byte digest, metadata, and dictionary-free documentation artifacts. The root `runtimeModelIntegrationTest` accepts `-PmodelId=` and verifies transformation of a packaged resource into `FrequencyTrie`; PoliMorf release validation depends on this complete runtime test. + +For UniMorph models, the convention validates and packages one model-specific attribution, +licensing, provenance, and contribution notice. Source and packaged notice bytes must match. The +notice identifies CC BY-SA 3.0 through its canonical URI; no project-wide CC license directory or +duplicated full legal text is used. Descriptors distinguish exact revisions from the explicit +legacy-import sentinel. UniMorph supplies morphological data; runtime patch commands and tries are +constructed by Radixor. The Java software remains BSD-3-Clause, while PoliMorf data remains under +its separately packaged BSD-2-Clause license. + +## Release and security boundaries + +| Tag | Publication boundary | +|---|---| +| `release@` | Root `org.egothor:radixor` artifacts only; never model JARs | +| `model/@` | Exactly one matching model; never core, catalog, or other models | +| `models-catalog@` | BOM and standard aggregate only; never model bytes | + +License inclusion, strict metadata paths, resource presence, SHA-256 verification, unsupported-format rejection, and duplicate-ID rejection form the model integrity boundary. These checks detect packaging mistakes and corruption; model data remains non-executable dictionary input. + ## The central idea Radixor does not store final stems directly as a large flat lookup table. Instead, it stores **patch commands** that describe how a word form should be transformed into a canonical stem. @@ -10,7 +96,7 @@ For example, if a dictionary states that `running` should reduce to `run`, the f That matters because many words share similar transformation patterns. Once those mappings are organized in a trie and compiled into a canonical structure, the result is much smaller and more reusable than a naive direct-output table. -## End-to-end build flow +## Trie construction flow The full build-time flow is: @@ -191,7 +277,7 @@ This is why a very large dictionary can still produce a manageable deployable ru The compactness of the final artifact should not be confused with the memory usage of preparation. -Before reduction has completed, the mutable build-time structure must exist in memory. For large dictionaries, that temporary preparation cost can be noticeably higher than the size of the final persisted artifact or the loaded compiled trie. +Before reduction has completed, the mutable build-time structure must exist in memory. For large dictionaries, that temporary preparation cost can be noticeably higher than the size of the final persisted artifact or the loaded compiled trie. PoliMorf is the exceptional current case: two complete test constructions took 23.7 and 23.5 seconds, produced 358,993 canonical nodes, and used a task-specific 6 GiB maximum heap. The process peak does not establish the retained heap of the final trie, which is not currently measured separately. That is why the preferred operational model is usually: @@ -218,3 +304,5 @@ Determinism matters not only for tests, but also for operational trust. It makes - [Reduction Semantics](reduction-semantics.md) - [Programmatic usage](programmatic-usage.md) - [CLI compilation](cli-compilation.md) +- [Model selection and loading](model-selection-and-loading.md) +- [Stemmer models](stemmer-models.md) diff --git a/docs/benchmarking.md b/docs/benchmarking.md index c2b665f..69d3596 100644 --- a/docs/benchmarking.md +++ b/docs/benchmarking.md @@ -2,6 +2,10 @@ Radixor contains internal trie microbenchmarks, a separate stemmer comparison suite, and a dictionary coverage benchmark for Radixor itself. Published stemmer comparison results must come only from benchmark classes matching `.*StemmerComparisonBenchmark.*`; internal `FrequencyTrie*` microbenchmarks are not part of those results. +Every current default Radixor benchmark scenario uses the model ID declared by its `Language.defaultModelId()`. The root JMH runtime configuration depends directly on all default model projects plus optional `pl-pl-polimorf`; no benchmark-pack project or artifact exists. These dependencies are benchmark-only and never enter the root published POM. A PoliMorf comparison must be labeled with model ID `pl-pl-polimorf`, while the default Polish row remains `pl-pl-unimorph`. + +The optional model now has a verified complete compiled loading path. This does not alter existing benchmark rows or make PoliMorf part of the representative English JMH run. Any future full PoliMorf benchmark must provision its documented startup heap independently and record the exact model artifact version and checksum. + This page is the entry point for benchmark interpretation. Detailed tables and long reference material are split into focused subpages so that important points do not get buried. ## Key Takeaways @@ -40,3 +44,4 @@ The [English dictionary coverage benchmark](benchmarks/reference/english-coverag The current measured language results are published in [Language Benchmark Pages](benchmarks/languages/index.md). Generated local report files for this benchmark update are listed in [Benchmark environment and reports](benchmarks/reference/environment.md). JMH TXT and CSV reports are still published as benchmark artifacts. They are no longer converted into a Shields endpoint benchmark badge. +Model IDs, independent artifact versions, and descriptor checksums identify inputs for future reproducibility. Historical snapshots remain tied to the model inputs used when measured; the optional PoliMorf model must not be retroactively attributed to results that predate it. See [Model Selection and Loading](model-selection-and-loading.md) and [Reproducibility](benchmarks/reference/reproducibility.md). diff --git a/docs/benchmarks/reference/linguistic-quality.md b/docs/benchmarks/reference/linguistic-quality.md index 6b25d58..c5b76a7 100644 --- a/docs/benchmarks/reference/linguistic-quality.md +++ b/docs/benchmarks/reference/linguistic-quality.md @@ -4,7 +4,9 @@ This evaluation measures agreement between the relation predicted by a stemmer a ## Scope and fair-comparison rules -The authoritative Radixor language universe is the reconciled set of `stemmer.gz` resources under `src/main/resources` and `StemmerPatchTrieLoader.Language`. Radixor is evaluated for every reconciled language. A third-party adapter is evaluated only for languages supported by its tested implementation and having a compatible Radixor dictionary; unsupported combinations are absent rather than assigned zero quality. +The authoritative Radixor language universe is the reconciliation of registered default model descriptors and `StemmerPatchTrieLoader.Language`. Radixor is evaluated for every reconciled language. Optional models are separate comparison rows. A third-party adapter is evaluated only for languages supported by its tested implementation and having a compatible Radixor dictionary; unsupported combinations are absent rather than assigned zero quality. + +Model identity is part of the candidate identity. Default Polish means `pl-pl-unimorph`; optional PoliMorf means `pl-pl-polimorf`. Results for those inputs must not be combined or relabeled, and historical snapshots cannot acquire a newer model identity retroactively. Within one language and dictionary mode, every adapter receives the same original included forms. Exact duplicates are removed only within one dictionary row. Identical surface forms in different rows remain distinct entries. Candidate strings use exact `String.equals`, with no evaluation-only lowercasing, normalization, accent removal, or gold-label-aware selection. Adapter preprocessing and lifecycle match the JMH comparison path. diff --git a/docs/benchmarks/reference/methodology.md b/docs/benchmarks/reference/methodology.md index a0b2013..cf994c1 100644 --- a/docs/benchmarks/reference/methodology.md +++ b/docs/benchmarks/reference/methodology.md @@ -1,6 +1,6 @@ # Benchmark Methodology -The stemmer comparison suite measures Radixor and Java stemmers on the same language and deterministic Radixor dictionary-derived data. Published Radixor rows in this refresh use contracted compiled patch tries, where uniform preferred-command subtrees are collapsed into accepting leaves before the trie is frozen for lookup. For each language, the bundled dictionary resource stores the expected root as the first tab-separated field on a line and its surface forms on the same line. Every single-token field on that line can therefore be paired with the same expected root. +The stemmer comparison suite measures Radixor and Java stemmers on the same language and deterministic Radixor model dictionary-derived data. Published Radixor rows in this refresh use contracted compiled patch tries, where uniform preferred-command subtrees are collapsed into accepting leaves before the trie is frozen for lookup. For each language, the registered default model resource stores the expected root as the first tab-separated field on a line and its surface forms on the same line. Every single-token field on that line can therefore be paired with the same expected root. Published stemmer comparison results must come only from benchmark classes matching `.*StemmerComparisonBenchmark.*`. Internal `FrequencyTrie*` microbenchmarks are not part of those results. @@ -33,7 +33,7 @@ Radixor is measured over dictionary tokens from its own resources: lower-case wi Lucene TokenFilter paths include required normalization in the measured pipeline. Examples include lower-case normalization for filters requiring lower-case input, German normalization before German light/minimal stemming, and Persian decimal, Arabic, and Persian normalization before Persian stemming. No ASCII folding is applied to Czech or Polish paths, because those Lucene stemmers are diacritic-aware or dictionary/table-backed for those languages. TokenFilter throughput methods materialize each emitted `CharTermAttribute` as a `String` before passing it to the JMH `Blackhole`, so output consumption is easier to inspect and closer to the direct stemmer methods. -For right-to-left Radixor languages, patch application uses the traversal direction stored in trie metadata. This is required because static backward patch application is not correct for all bundled languages. +For right-to-left Radixor languages, patch application uses the traversal direction stored in trie metadata. This is required because static backward patch application is not correct for all registered language models. ## Quality Metric @@ -57,3 +57,4 @@ Morfologik can emit multiple terms for one input token. The quality benchmark us Quality reports use JMH auxiliary counter rows. Exact-root accounting is deterministic for a fixed corpus and stemmer, so repeated measurement samples duplicate the same counters; documentation uses the counter ratios and does not interpret quality benchmark timing scores. Pairwise over-stemming, under-stemming, candidate-aware policies, balanced accuracy, and partition comparison are a separate analytical evaluation. See [Linguistic Quality Methodology](linguistic-quality.md); exact-root accuracy must not be interpreted as the complement of pairwise under-stemming. +Default rows use `Language.defaultModelId()`. Optional variants require a separate model field; `pl-pl-unimorph` and `pl-pl-polimorf` must never share an ambiguous Polish label. The benchmark runtime receives each resource exactly once from its individual model JAR through direct JMH runtime dependencies. See [Model Selection and Loading](../../model-selection-and-loading.md). diff --git a/docs/benchmarks/reference/reproducibility.md b/docs/benchmarks/reference/reproducibility.md index d6d3d72..a89298a 100644 --- a/docs/benchmarks/reference/reproducibility.md +++ b/docs/benchmarks/reference/reproducibility.md @@ -20,7 +20,8 @@ The CSV contains raw TP, FP, FN, and TN counts; raw over/under numerators and de ./gradlew publishStemmingQualityDocumentation ./gradlew verifyStemmingQualityDocumentation ./gradlew test -mkdocs build --strict +./gradlew prepareMkDocsSource +mkdocs build --strict --config-file build/mkdocs/mkdocs.yml ``` `stemmingQuality` performs the expensive complete evaluation and is intentionally not attached to `test` or `check`. It prepares JMH third-party dependencies automatically and writes: @@ -34,6 +35,26 @@ Audit mode is enabled with `-PstemmingQualityAudit=true`. Language, stemmer, dic `publishStemmingQualityDocumentation` validates the complete build CSV, copies a versioned documentation snapshot, and replaces only marked generated sections. `verifyStemmingQualityDocumentation` re-renders from the checked-in snapshot and fails on changed values, ordering, missing pages, duplicate keys, arithmetic inconsistencies, policy violations, or stale sections. +The model catalog and rendered site are build outputs under `build/`. They are generated for publication and are never maintained in Git. + +For new measurements, record language, stable model ID, model artifact version, descriptor checksum, source dictionary identity/version, core revision, and benchmark configuration. JMH resolves the required default models and optional PoliMorf directly from their individual model JARs; these benchmark-only dependencies are not transitive to ordinary users. + +Current model descriptors also record the official repository, dataset, license, attribution, +verification date, transformations, and source-revision status. Exact historical revisions were +not recorded for the legacy UniMorph imports; that limitation is disclosed with +`not-recorded-in-legacy-import` rather than reconstructed. Future imports must record the exact +upstream revision and source-archive checksum. This reproducibility limitation does not replace or +weaken the packaged license and attribution requirements. + +Each UniMorph-derived model artifact carries its own notice with the canonical CC BY-SA 3.0 URI, +upstream attribution, transformations, ShareAlike statement, and Leo Galambos contribution notice. +The full CC legal text is not duplicated or presented as a root-project license. PoliMorf retains +its separately packaged BSD-2-Clause license. + +For a future full PoliMorf measurement, also record the startup heap separately from benchmark parameters. Complete runtime construction is currently verified with a dedicated 6 GiB maximum heap; this limit is neither a retained-trie measurement nor a setting applied to ordinary JMH runs. + +The Pages workflow publishes that staged documentation together with Javadoc, JUnit, PMD, JaCoCo, PIT, representative JMH, SBOM, optional dependency-check output, badge metadata, and retained build history. Its filesystem merge explicitly preserves the `builds/` tree in the separate `gh-pages` publication branch, so documentation regeneration cannot erase durable report URLs. + ## Performance benchmark reproduction The JMH comparison command family is: @@ -46,7 +67,7 @@ The exact JMH configuration, hardware, operating system, and JDK captured for th ## Recorded and unavailable provenance -The performance documentation records its 2026-07-06 environment, JDK 25.0.3, operating system, and hardware. The quality CSV records the evaluated identifiers and counts but does not embed the Radixor Git revision, generation date, JDK, operating system, dictionary content hash, or immutable upstream revisions for every downloaded source. These fields are explicitly unavailable for this snapshot and are not reconstructed from filesystem timestamps. +The performance documentation records its 2026-07-06 environment, JDK 25.0.3, operating system, and hardware. The quality CSV records the evaluated identifiers and counts but does not embed the Radixor Git revision, generation date, JDK, operating system, model ID, dictionary content hash, or immutable upstream revisions for every downloaded source. These fields are explicitly unavailable for this historical snapshot and are not reconstructed from filesystem timestamps. In particular, the snapshot predates the optional PoliMorf integration and must not be relabeled as `pl-pl-polimorf`. Dependency versions that are reproducible from repository configuration include Apache Lucene 10.5.0, Morfologik 2.1.9, the Ukrainian dictionary artifact 4.9.1, and JMH 1.37. Other upstream branches or downloaded dictionary revisions should be pinned and embedded in a future result schema. @@ -59,3 +80,4 @@ Audit reports preserve original multilingual forms and identify high-contributin ## JMH badge compatibility The quality documentation generator does not invoke JMH, change JMH result formats, or modify badge tooling. Existing JMH result paths and historical badge-compatible inputs remain independent. The repository currently publishes coverage and mutation badge metadata and retains JMH TXT/CSV artifacts as documented in [Environment and reports](environment.md). +See [Model Selection and Loading](../../model-selection-and-loading.md), [Stemmer Models](../../stemmer-models.md), and the generated [model catalog](../../stemmer-model-catalog.md) for current model identities. diff --git a/docs/benchmarks/reference/tested-stemmers.md b/docs/benchmarks/reference/tested-stemmers.md index 26f0799..a10c2fe 100644 --- a/docs/benchmarks/reference/tested-stemmers.md +++ b/docs/benchmarks/reference/tested-stemmers.md @@ -4,7 +4,7 @@ The JMH adapter registry is authoritative for evaluated implementations and lang | Family or implementation | Upstream / attribution | Tested version or revision | Evaluated scope | Output capability and adapter behaviour | Interpretation notes | | --- | --- | --- | --- | --- | --- | -| Radixor | Egothor / Radixor project | Current repository revision; exact revision was not embedded in the quality CSV | All 20 reconciled Radixor dictionary languages; 19 have benchmark pages | Deterministic preferred patch via `get`; ranked distinct alternatives via `getAll`; primary is always included | Dictionary-derived compiled patch trie. Quality depends on dictionary coverage and annotation. | +| Radixor | Egothor / Radixor project | Current repository revision; exact revision was not embedded in the quality CSV | All 20 reconciled default model languages; 19 have benchmark pages | Deterministic preferred patch via `get`; ranked distinct alternatives via `getAll`; primary is always included | Model-dictionary-derived compiled patch trie. Default rows use each language's stable default model ID. | | Apache Lucene language stem filters | Apache Lucene project | 10.5.0 | Adapter-declared language-specific subsets | TokenFilter lifecycle and language normalization match JMH; normally single-output | Light, minimal, possessive, and language stem filters deliberately implement different scopes. Narrow scope is not a defect. | | Apache Lucene SnowballFilter | Apache Lucene project using Snowball algorithms | Lucene 10.5.0 | Snowball-supported subset of Radixor languages | Single primary token emitted through the Lucene TokenFilter path | Includes TokenStream overhead and required normalization. | | Official Snowball Java | Snowball project | Repository preparation downloads the configured upstream Java distribution; an immutable revision was not recorded in the quality CSV | Same-language adapter subset | Direct generated Java API; single output | Rule-based suffix algorithms provide broad baselines rather than dictionary-root guarantees. | @@ -24,6 +24,7 @@ Candidate sets are non-null, non-empty, contain the deterministic primary output ## Coverage fairness -Radixor coverage is derived independently from its resources and language enumeration. Third-party coverage is the intersection of that universe with actual adapter support. Absence therefore means “not supported or not configured for this language,” not “zero quality.” Consult each language page for the exact evaluated rows. +Radixor coverage is derived from registered default descriptors reconciled with language enumeration. Third-party coverage is the intersection of that universe with actual adapter support. Absence therefore means “not supported or not configured for this language,” not “zero quality.” Optional `pl-pl-polimorf` is a separate model row and does not replace default `pl-pl-unimorph`. Consult each language page for the exact evaluated rows. Project authors and organizations are named only where repository configuration or source notices establish attribution. No broader authorship or license claim is inferred when metadata was not captured. +The JMH runtime configuration directly includes optional models needed for controlled comparisons; ordinary users do not receive these benchmark-only dependencies transitively. Historical rows retain their original model inputs. See [Model Selection and Loading](../../model-selection-and-loading.md). diff --git a/docs/built-in-languages.md b/docs/built-in-languages.md index 0bed705..3d6b261 100644 --- a/docs/built-in-languages.md +++ b/docs/built-in-languages.md @@ -1,267 +1,104 @@ -# Built-in Languages +# Built-in Languages and Default Models -Radixor ships with a curated set of bundled stemmer dictionaries that can be loaded directly from the library distribution. These resources are intended to provide an immediately usable baseline for evaluation, prototyping, integration, and general-purpose stemming workloads, while still fitting naturally into workflows where the bundled baseline is later refined, extended, or replaced with custom lexical data. +“Supported language” means that Radixor defines a language enum value and publishes a corresponding default model artifact. It does not mean that a dictionary is embedded in the core JAR. Applications add model artifacts explicitly or use the optional standard pack. -## Overview +The language enum carries language identity, writing direction, a legacy resource-directory name, and the stable default model ID. A model descriptor carries the independently versioned model identity and resource. See [Model Selection and Loading](model-selection-and-loading.md) for the API and the generated [model catalog](stemmer-model-catalog.md) for versions, provenance, checksums, and sizes. -Bundled dictionaries are exposed through: +## Defaults and variants -```java -org.egothor.stemmer.StemmerPatchTrieLoader.Language -``` +| Language | Enum | Default model ID | Default artifact | Optional variants | +|---|---|---|---|---| +| Czech | `CS_CZ` | `cs-cz-default` | `org.egothor:radixor-model-cs-cz-default` | — | +| Danish | `DA_DK` | `da-dk-default` | `org.egothor:radixor-model-da-dk-default` | — | +| German | `DE_DE` | `de-de-default` | `org.egothor:radixor-model-de-de-default` | — | +| Spanish | `ES_ES` | `es-es-default` | `org.egothor:radixor-model-es-es-default` | — | +| Persian | `FA_IR` | `fa-ir-default` | `org.egothor:radixor-model-fa-ir-default` | — | +| Finnish | `FI_FI` | `fi-fi-default` | `org.egothor:radixor-model-fi-fi-default` | — | +| French | `FR_FR` | `fr-fr-default` | `org.egothor:radixor-model-fr-fr-default` | — | +| Hebrew | `HE_IL` | `he-il-default` | `org.egothor:radixor-model-he-il-default` | — | +| Hungarian | `HU_HU` | `hu-hu-default` | `org.egothor:radixor-model-hu-hu-default` | — | +| Italian | `IT_IT` | `it-it-default` | `org.egothor:radixor-model-it-it-default` | — | +| Norwegian Bokmål | `NB_NO` | `nb-no-default` | `org.egothor:radixor-model-nb-no-default` | — | +| Dutch | `NL_NL` | `nl-nl-default` | `org.egothor:radixor-model-nl-nl-default` | — | +| Norwegian Nynorsk | `NN_NO` | `nn-no-default` | `org.egothor:radixor-model-nn-no-default` | — | +| Polish | `PL_PL` | `pl-pl-unimorph` | `org.egothor:radixor-model-pl-pl-unimorph` | `pl-pl-polimorf` / `org.egothor:radixor-model-pl-pl-polimorf` | +| Portuguese | `PT_PT` | `pt-pt-default` | `org.egothor:radixor-model-pt-pt-default` | — | +| Russian | `RU_RU` | `ru-ru-default` | `org.egothor:radixor-model-ru-ru-default` | — | +| Swedish | `SV_SE` | `sv-se-default` | `org.egothor:radixor-model-sv-se-default` | — | +| Ukrainian | `UK_UA` | `uk-ua-default` | `org.egothor:radixor-model-uk-ua-default` | — | +| English | `US_UK` | `us-uk-default` | `org.egothor:radixor-model-us-uk-default` | — | +| Yiddish | `YI` | `yi-default` | `org.egothor:radixor-model-yi-default` | — | -Each bundled dictionary is packaged with the library as a compressed UTF-8 text resource. When loaded through the runtime API, the resource is parsed by `StemmerDictionaryParser`, transformed into patch-command mappings, and compiled into a read-only `FrequencyTrie` by `StemmerPatchTrieLoader`. +The maintained table deliberately avoids duplicating mutable provenance and checksum fields. Those values come from module metadata and are generated into the model catalog. -The bundled language definition also carries a language-level right-to-left flag. That flag is used by the loader to derive the `WordTraversalDirection` used for both trie-key construction and patch-command generation. In practice, left-to-right bundled languages use historical backward Egothor traversal, while right-to-left bundled languages use forward traversal over the stored form. +## The Polish dual-model case -## Supported bundled languages +`PL_PL` represents Polish. It is not an alias for either source dictionary. -The following bundled language identifiers are currently available: +- `loadCompiled(Language.PL_PL, ...)` resolves `pl-pl-unimorph`. +- `registry.require("pl-pl-polimorf")` resolves the optional PoliMorf model. +- `StemmerPatchTrieLoader.loadCompiled("pl-pl-polimorf", true, reductionMode)` constructs its compiled trie explicitly; complete construction is verified with a dedicated 6 GiB test heap. +- Both artifacts may be present and loaded independently. +- Adding PoliMorf does not change the language default. +- Radixor does not merge their dictionaries or outputs automatically. -| Language | Enum constant | Writing direction | Notes | Benchmark page | -|---|---|---:|---|---| -| Czech | `CS_CZ` | LTR | Bundled general-purpose dictionary | [Czech](benchmarks/languages/czech.md) | -| Danish | `DA_DK` | LTR | Bundled general-purpose dictionary | [Danish](benchmarks/languages/danish.md) | -| German | `DE_DE` | LTR | Bundled general-purpose dictionary | [German](benchmarks/languages/german.md) | -| Spanish | `ES_ES` | LTR | Bundled general-purpose dictionary | [Spanish](benchmarks/languages/spanish.md) | -| Persian | `FA_IR` | RTL | Bundled dictionary uses forward traversal over the stored form | [Persian](benchmarks/languages/persian.md) | -| Finnish | `FI_FI` | LTR | Bundled general-purpose dictionary | [Finnish](benchmarks/languages/finnish.md) | -| French | `FR_FR` | LTR | Bundled general-purpose dictionary | [French](benchmarks/languages/french.md) | -| Hebrew | `HE_IL` | RTL | Bundled dictionary uses forward traversal over the stored form | No same-language external benchmark in this run | -| Hungarian | `HU_HU` | LTR | Bundled general-purpose dictionary | [Hungarian](benchmarks/languages/hungarian.md) | -| Italian | `IT_IT` | LTR | Bundled general-purpose dictionary | [Italian](benchmarks/languages/italian.md) | -| Norwegian Bokmål | `NB_NO` | LTR | Bundled general-purpose dictionary | [Norwegian Bokmal](benchmarks/languages/norwegian-bokmal.md) | -| Dutch | `NL_NL` | LTR | Bundled general-purpose dictionary | [Dutch](benchmarks/languages/dutch.md) | -| Norwegian Nynorsk | `NN_NO` | LTR | Bundled general-purpose dictionary | [Norwegian Nynorsk](benchmarks/languages/norwegian-nynorsk.md) | -| Polish | `PL_PL` | LTR | Bundled general-purpose dictionary | [Polish](benchmarks/languages/polish.md) | -| Portuguese | `PT_PT` | LTR | Bundled general-purpose dictionary | [Portuguese](benchmarks/languages/portuguese.md) | -| Russian | `RU_RU` | LTR | Bundled general-purpose dictionary | [Russian](benchmarks/languages/russian.md) | -| Swedish | `SV_SE` | LTR | Bundled general-purpose dictionary | [Swedish](benchmarks/languages/swedish.md) | -| Ukrainian | `UK_UA` | LTR | Bundled general-purpose dictionary | [Ukrainian](benchmarks/languages/ukrainian.md) | -| English | `US_UK` | LTR | Bundled general-purpose dictionary | [English](benchmarks/languages/english.md) | -| Yiddish | `YI` | RTL | Bundled dictionary uses forward traversal over the stored form | [Yiddish](benchmarks/languages/yiddish.md) | +UniMorph and PoliMorf have different lexical sources and provenance. Applications should compare outputs with application-specific regression tests before changing an explicit model choice. -## Basic usage +## Dependency patterns -Load a bundled dictionary like this: +Minimal English: -```java -import java.io.IOException; - -import org.egothor.stemmer.CompiledPatchCommand; -import org.egothor.stemmer.FrequencyTrie; -import org.egothor.stemmer.ReductionMode; -import org.egothor.stemmer.StemmerPatchTrieLoader; - -public final class BuiltInExample { - - private BuiltInExample() { - throw new AssertionError("No instances."); - } - - public static void main(final String[] arguments) throws IOException { - final FrequencyTrie trie = StemmerPatchTrieLoader.loadCompiled( - StemmerPatchTrieLoader.Language.US_UK, - true, - ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); - - System.out.println(trie.traversalDirection()); - } +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-us-uk-default:1.0.0' } ``` -This call loads the bundled dictionary resource for the selected language, parses its lexical entries, derives patch-command mappings, and compiles the result into a read-only trie. +All documented defaults: -## Example: stemming with a bundled dictionary - -```java -import java.io.IOException; - -import org.egothor.stemmer.CompiledPatchCommand; -import org.egothor.stemmer.FrequencyTrie; -import org.egothor.stemmer.ReductionMode; -import org.egothor.stemmer.StemmerPatchTrieLoader; - -public final class EnglishExample { - - private EnglishExample() { - throw new AssertionError("No instances."); - } - - public static void main(final String[] arguments) throws IOException { - final FrequencyTrie trie = StemmerPatchTrieLoader.loadCompiled( - StemmerPatchTrieLoader.Language.US_UK, - true, - ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); - - final String word = "running"; - final CompiledPatchCommand patch = trie.get(word); - final String stem = patch == null ? word : patch.apply(word); - - System.out.println(word + " -> " + stem); - } +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-models-standard:' } ``` -`CompiledPatchCommand` values are compiled with the traversal direction used when the trie and its patch commands were produced. +The standard pack is metadata-only and excludes optional PoliMorf. -## Traversal behavior and right-to-left languages +Every individual model artifact carries its own provenance and licensing material. UniMorph +models carry different model-specific CC BY-SA 3.0 notices because their official language +repositories identify different lexical sources and contributors. Each notice preserves upstream +attribution and records the Radixor transformations and Leo Galambos contribution statement. +Legacy imports disclose when an exact historical revision was not recorded; this is a +reproducibility limitation, not a claim that the source or license is unknown. -Bundled dictionaries are not all processed identically. - -For traditional left-to-right suffix-oriented resources, Radixor preserves historical Egothor behavior and traverses logical word characters backward. That means trie paths are constructed from the logical end of the stored word toward its beginning, and patch commands are interpreted with the same backward traversal model. - -For bundled right-to-left languages such as Persian, Hebrew, and Yiddish, Radixor uses forward traversal over the stored form. In those cases: - -- trie keys are traversed from the logical beginning of the stored form, -- patch commands are generated in that same forward direction, -- compiled patch-command application uses `WordTraversalDirection.FORWARD`, which is naturally captured when `loadCompiled(...)` creates `CompiledPatchCommand` values. - -This design keeps the traversal policy explicit and consistent across dictionary loading, trie lookup, binary persistence, builder reconstruction, and patch application. - -## Reduction behavior - -Bundled dictionaries can be compiled using any supported `ReductionMode`. The reduction configuration controls how semantically equivalent subtrees are merged during trie compilation, while preserving the contract of the selected mode. - -Typical entry points are: - -- `StemmerPatchTrieLoader.loadCompiled(language, storeOriginal, reductionMode)` -- `StemmerPatchTrieLoader.loadCompiled(language, storeOriginal, reductionSettings)` - -For most users, `ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS` is the most conservative general-purpose choice because it preserves ranked `getAll(...)` behavior. - -Compiled bundled dictionaries also use internal uniform-subtree contraction. If a whole subtree -would return the same preferred patch command, Radixor stores that subtree as an accepting leaf and -removes the deeper branches. This is the contracted trie representation used by the published -benchmark tables and is independent of the public reduction mode selected by the caller. - -## Intended role of bundled dictionaries - -Bundled dictionaries should be understood as practical default resources. - -They are a good fit when: - -- a supported language is already available, -- immediate usability matters, -- a reasonable baseline is sufficient, -- the goal is evaluation, prototyping, or straightforward integration. - -They are also well suited to staged refinement workflows in which a bundled base is loaded first, then extended with domain-specific vocabulary, and finally persisted as a custom binary artifact. - -## Character representation - -Bundled dictionaries are ordinary UTF-8 lexical resources. The parser reads them as text, the trie stores standard Java strings, and the patch-command model operates on general character sequences. - -This is important for two reasons: - -1. the built-in resources are not limited to ASCII-only processing, -2. the traversal model is orthogonal to character encoding and script choice. - -In other words, right-to-left handling in the loader is about logical traversal strategy, not about introducing a separate character model. - -## When to prefer custom dictionaries - -A custom dictionary is usually the better choice when: - -- domain-specific vocabulary materially affects stemming quality, -- lexical coverage must be controlled more precisely, -- a stronger lexical resource is available than the bundled baseline, -- operational requirements demand an explicitly curated, versioned artifact. - -Typical examples include: - -- technical terminology, -- biomedical language, -- legal or financial vocabulary, -- organization-specific product and process names, -- dictionaries maintained with project-specific validation rules. - -## Production recommendation - -For production systems, the most robust workflow is usually: - -1. start from a bundled dictionary when it is suitable, -2. extend it with domain-specific forms if needed, -3. rebuild it into a binary artifact, -4. deploy that compiled binary artifact, -5. load it at runtime through `loadBinaryCompiled(...)`. - -This avoids repeated startup parsing and makes the deployed stemming behavior explicit, reproducible, and versionable. - -## Example refinement workflow +## Loading a language default ```java -import java.io.IOException; -import java.nio.file.Path; - -import org.egothor.stemmer.FrequencyTrie; -import org.egothor.stemmer.FrequencyTrieBuilders; -import org.egothor.stemmer.PatchCommandEncoder; -import org.egothor.stemmer.ReductionMode; -import org.egothor.stemmer.ReductionSettings; -import org.egothor.stemmer.StemmerPatchTrieBinaryIO; -import org.egothor.stemmer.StemmerPatchTrieLoader; - -public final class BundledRefinementExample { - - private BundledRefinementExample() { - throw new AssertionError("No instances."); - } - - public static void main(final String[] arguments) throws IOException { - final FrequencyTrie base = StemmerPatchTrieLoader.load( +final FrequencyTrie trie = + StemmerPatchTrieLoader.loadCompiled( StemmerPatchTrieLoader.Language.US_UK, true, ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); - - final FrequencyTrie.Builder builder = FrequencyTrieBuilders.copyOf( - base, - String[]::new, - ReductionSettings.withDefaults( - ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS)); - - final PatchCommandEncoder encoder = PatchCommandEncoder.builder() - .traversalDirection(base.traversalDirection()) - .build(); - - builder.put("microservices", encoder.encode("microservices", "microservice")); - - final FrequencyTrie compiled = builder.build(); - - StemmerPatchTrieBinaryIO.write(compiled, Path.of("english-custom.radixor.gz")); - } -} ``` -The reconstructed builder preserves the traversal direction of the source trie, so refinements remain semantically aligned with the original bundled dictionary. +The call discovers the default descriptor from the runtime classpath, verifies its compressed resource, parses the GZip UTF-8 dictionary, and constructs a read-only trie. A missing default throws `StemmerModelNotFoundException`; there is no arbitrary fallback. -## Extending language support +## Writing direction -The built-in set is intentionally a practical baseline rather than a closed catalog. Additional languages, stronger lexical coverage, and improved dictionaries for currently supported languages are all natural extension paths. +Persian, Hebrew, and Yiddish declare right-to-left language metadata and use forward traversal over stored forms. Other defaults use historical backward Egothor traversal. This setting must remain aligned across dictionary parsing, trie lookup, patch generation, persistence, and application. Model identity remains separate from writing direction. -What matters most is not only the number of entries, but the quality, consistency, maintainability, and operational usefulness of the lexical resource being added. +## Custom and persisted alternatives -## Related API surface +Registered model artifacts are a convenient reproducible baseline. Applications may instead load caller-owned textual dictionaries or persist compiled `.radixor.gz` tries. Those paths are distinct from model artifact discovery: -The following types are typically involved when working with bundled dictionaries: +- a model `stemmer.gz` is a compressed textual dictionary plus descriptor/index metadata; +- a `.radixor.gz` created by the binary writer is a persisted compiled trie; +- a source dictionary is upstream input, not automatically a valid model artifact. -- `StemmerPatchTrieLoader` -- `StemmerPatchTrieLoader.Language` -- `FrequencyTrie` -- `PatchCommandEncoder` -- `WordTraversalDirection` -- `ReductionMode` -- `ReductionSettings` -- `StemmerPatchTrieBinaryIO` -- `FrequencyTrieBuilders` +See [Dictionary Format](dictionary-format.md), [CLI Compilation](cli-compilation.md), and [Stemmer Models](stemmer-models.md). -## Next steps +## Benchmark interpretation -- [Quick start](quick-start.md) -- [Dictionary format](dictionary-format.md) -- [CLI compilation](cli-compilation.md) -- [Programmatic usage](programmatic-usage.md) - -## Summary - -Radixor’s built-in language support provides immediate usability, a professionally defined baseline API, and a practical starting point for custom refinement. The bundled set now includes both left-to-right and right-to-left languages, and the library models that distinction explicitly through `WordTraversalDirection` so that trie construction, lookup, and patch application remain consistent. +Benchmark rows must identify the Radixor model ID used. Default rows use the default IDs above. Optional Polish PoliMorf comparisons must be labeled `pl-pl-polimorf`; they are not interchangeable with the historical default Polish row. Continue with [Benchmarking](benchmarking.md) and [Reproducibility](benchmarks/reference/reproducibility.md). diff --git a/docs/cli-compilation.md b/docs/cli-compilation.md index 04a4188..29c7ab0 100644 --- a/docs/cli-compilation.md +++ b/docs/cli-compilation.md @@ -2,6 +2,8 @@ Radixor provides a command-line compiler for turning line-oriented dictionary files into compact binary stemmer artifacts. +The CLI output is not a model JAR. A model artifact contains a compressed textual dictionary, descriptor, index, checksum, and license so the runtime registry can discover and compile it. The CLI instead emits an already compiled binary trie for direct `loadBinaryCompiled(...)` use. Choose the model-module workflow when independently published classpath discovery is required; choose the CLI when the application owns a compiled binary asset. + This is the preferred preparation workflow when stemming should run against an already compiled artifact rather than against raw dictionary input. The CLI reads the dictionary, derives patch commands, builds a mutable trie, applies the selected subtree reduction strategy, and writes the final compiled trie in the project binary format under GZip compression. The result is a deployment-ready `.radixor.gz` file that can be loaded directly by application code. ## What the CLI does @@ -17,6 +19,10 @@ The `Compile` tool performs the following steps: This workflow is intentionally aligned with the same dictionary semantics used elsewhere in the library. Remarks introduced by `#` or `//` are supported through the shared dictionary parser. +## Create a registered custom model instead + +To publish or deploy a custom dictionary through `StemmerModelRegistry`, do not merely rename CLI output to `stemmer.gz`. Create `models/`, preserve the textual dictionary as a GZip module input, provide source metadata and a license, apply `org.egothor.radixor.model`, and run the model validation tasks. The resulting JAR has an index, descriptor, namespaced textual dictionary, checksum, and license. Detailed packaging is documented in [Stemmer Models](stemmer-models.md); selection is documented in [Model Selection and Loading](model-selection-and-loading.md). + ## Basic usage ```bash @@ -220,6 +226,8 @@ The ranked `getAll()` mode is the safest default. The unordered and dominant mod Compilation is usually a one-time step and is generally fast. The more important operational consideration is memory usage during preparation, because the dictionary-derived mutable structure exists before reduction compacts it into the final read-only trie. This is especially relevant for very large source dictionaries. +The complete PoliMorf model is the current exceptional case: registered-model verification uses `runtimeModelIntegrationTest` with a 6 GiB maximum heap, configurable through `-PradixorLargeModelMaxHeap=`. This setting applies only to that isolated test process, not the Gradle daemon or ordinary tests. + ## Example workflow ### 1. Prepare a dictionary @@ -282,3 +290,5 @@ The CLI and the programmatic API implement the same conceptual preparation step. - [Quick start](quick-start.md) - [Programmatic usage](programmatic-usage.md) - [Architecture and reduction](architecture-and-reduction.md) +!!! note "Radixor 4 model artifacts" + Language dictionaries are independently versioned runtime model artifacts, not resources embedded in `radixor`. Language-based APIs resolve deterministic defaults through `StemmerModelRegistry`; see [Stemmer Models](stemmer-models.md). diff --git a/docs/compatibility-and-guarantees.md b/docs/compatibility-and-guarantees.md index d64af19..70c2bad 100644 --- a/docs/compatibility-and-guarantees.md +++ b/docs/compatibility-and-guarantees.md @@ -37,7 +37,7 @@ This API is expected to remain supportable across future versions. The preferred Examples of likely additive evolution include: -- additional bundled language resources, +- additional independently versioned language models, - fuller support for diacritics or native-script language resources, - expanded documentation and operational tooling, - new convenience methods that do not break existing code. @@ -83,6 +83,8 @@ Compiled `FrequencyTrie` instances are immutable and thread-safe for concurrent Serialized patch-command strings remain the stable stored representation used by textual dictionaries and binary artifacts. Runtime stemming should use `CompiledPatchCommand` values produced by `StemmerPatchTrieLoader.loadCompiled(...)`, `StemmerPatchTrieLoader.loadBinaryCompiled(...)`, or `PatchCommandEncoder.compile(...)`. +Language-default, descriptor, and stable model-ID `loadCompiled` entry points share the same compiled-value conversion. Explicit model IDs never fall back to a language default. Model loading is not cached, and construction-memory requirements are model-dependent; the unusually large PoliMorf input is verified separately with a 6 GiB maximum heap. + The historical `PatchCommandEncoder.apply(...)` and String-based `applyTo(...)` overloads remain compatibility APIs during the 2.x transition, but they are deprecated because they reparse the patch-command string on each application. See [Migration and Backward Compatibility](migration-and-backward-compatibility.md) for old and new code examples. Compiled buffer-oriented `CompiledPatchCommand.applyTo(...)` overloads use caller-owned output storage. They do not retain output arrays and report insufficient capacity with `CompiledPatchCommand.APPLY_INSUFFICIENT_CAPACITY`. @@ -110,7 +112,7 @@ The following kinds of change are generally compatible with the project’s dire - improved internal data structures, - changes inside `org.egothor.stemmer.trie`, -- expanded bundled dictionaries, +- expanded model dictionaries, - additional supported languages, - improved native-script handling, - better benchmarks, tests, and reports, @@ -122,11 +124,11 @@ The project should be able to improve substantially while keeping the main user- Some areas should be treated as stable in intent but still approached carefully when changed. -### Bundled dictionary contents +### Independently versioned model contents -Bundled resources are versioned project data, not immutable language standards. Their contents may improve over time. +Model resources are independently versioned project data, not immutable language standards. Their contents may improve over time. -That means stemming outcomes can legitimately change when bundled dictionaries are refined or expanded. Such changes are compatible with the project’s direction, but they should still be understood as behavior changes at the lexical-resource level. +That means stemming outcomes can legitimately change when a model artifact is updated. Such changes are separate from core compatibility and should be reviewed as lexical-resource behavior changes. ### Binary format evolution @@ -159,7 +161,7 @@ Users should avoid depending on: - internal trie package details, - undocumented internal classes or intermediate representations, - incidental internal ordering outside documented lookup semantics, -- assumptions that bundled dictionary contents will never evolve, +- assumptions that a model's dictionary contents will never evolve across model versions, - assumptions that internal binary-format details are frozen forever. If a behavior is important to your integration, it should ideally be documented at the public API or project-documentation level rather than inferred from internal implementation details. diff --git a/docs/contributing-dictionaries.md b/docs/contributing-dictionaries.md index ed20b6f..626b746 100644 --- a/docs/contributing-dictionaries.md +++ b/docs/contributing-dictionaries.md @@ -2,7 +2,7 @@ High-quality dictionaries are one of the most valuable ways to improve **Radixor**. -The project already includes practical bundled dictionaries for common use, but the long-term quality and language reach of the stemmer depend heavily on the quality of its lexical resources. Contributions are therefore welcome not only in the form of code changes, but also in the form of well-prepared dictionary data for existing or additional languages. +The project already publishes practical model dictionaries for common use, but long-term quality and language reach depend heavily on lexical-resource quality. Contributions may provide well-prepared model inputs for existing or additional languages. This document explains what makes a dictionary contribution useful, how to structure it, and how to prepare it so that it integrates cleanly with the project. @@ -52,7 +52,7 @@ For full format details, see [Dictionary format](dictionary-format.md). The most useful dictionary contributions generally fall into one of four categories. -### 1. Stronger dictionaries for already bundled languages +### 1. Stronger models for already supported languages Improving lexical quality for already supported languages is often more valuable than merely expanding the language list. Better coverage, cleaner canonicalization, and improved consistency directly improve practical stemming outcomes. @@ -68,7 +68,7 @@ That convention belongs to the supplied dictionaries, not to the underlying algo ### 4. Domain-quality refinements -Some contributions may be more appropriate as curated domain extensions than as replacements for a general-purpose bundled dictionary. These are still useful when they are clearly scoped and operationally coherent. +Some contributions may be more appropriate as curated domain extensions than as replacements for a general-purpose default model. These are still useful when clearly scoped and operationally coherent. ## Normalization guidance @@ -139,6 +139,14 @@ A dictionary should read like a curated lexical resource, not like an unfiltered ## Practical preparation workflow +Before conversion, record the official source project and repository, exact revision or release, +source-archive checksum, retrieval date, dataset license and URI, supplied attribution, and any +required upstream notice. Add a model-specific notice describing every material transformation and +the license applied to the derived data, including its canonical URI. Record any protectable +Radixor-specific contribution without claiming ownership over the upstream data. A legacy model +may disclose that its historical revision was not recorded; new imports must record an exact +revision and source-archive checksum rather than using that sentinel. + A disciplined dictionary contribution should typically follow this path: 1. prepare or normalize the lexical source, @@ -183,7 +191,7 @@ This note does not need to be long. It simply needs to make the resource intelli ## Bundled-resource expectations -Not every useful dictionary must automatically become a bundled language resource. +Not every useful dictionary must automatically become a published default model. To be suitable for bundling, a dictionary should generally be: diff --git a/docs/dictionary-format.md b/docs/dictionary-format.md index eb0aa11..af707b8 100644 --- a/docs/dictionary-format.md +++ b/docs/dictionary-format.md @@ -2,6 +2,27 @@ Radixor uses a simple line-oriented dictionary format designed for practical stemming workflows. The textual source format is tab-separated values, meaning that columns are separated by the tab character. +## Source text, model resource, and compiled trie + +Three artifacts must not be confused: + +| Artifact | Representation | Consumer | +|---|---|---| +| Source textual dictionary | Plain UTF-8 tab-separated rows | Authors, parser, CLI, or model preparation | +| Registered model resource | The same Radixor dictionary bytes under GZip, accompanied by index, descriptor, checksum, and license | `StemmerModelRegistry` and `StemmerPatchTrieLoader` | +| Persisted compiled trie | GZip-compressed Radixor binary format, commonly `.radixor.gz` | `loadBinaryCompiled(...)` | + +The model file named `stemmer.gz` is not Java serialization and is not a pre-instantiated or persisted trie. It is compressed textual dictionary input parsed when the model is loaded. + +Consequently, compressed size is not a construction-memory estimate. The PoliMorf resource is 12,624,997 bytes compressed and 68,093,680 bytes decompressed, while full parsing, trie construction, reduction, and patch compilation require a dedicated verification JVM with a 6 GiB maximum heap. + +Comment headers in maintained model inputs summarize provenance but do not replace packaged legal +material. Each UniMorph-derived artifact includes a language-specific notice describing its +official repository, lexical source, upstream attribution, CC BY-SA 3.0 canonical URI, ShareAlike +status, Radixor transformations, and Leo Galambos's protectable model-data contributions. The +notice does not claim ownership over the underlying data. GZip packaging and descriptor/checksum +generation are disclosed transformations; the in-memory trie is a Radixor runtime structure. + Each logical line describes one canonical stem and zero or more known word variants that should reduce to that stem. The format is intentionally lightweight, easy to maintain in source control, and directly consumable both by the programmatic loader and by the CLI compiler. ## Core structure @@ -129,7 +150,11 @@ run running runs ran ## Character set, compression, and normalization -Dictionary files are read as UTF-8 text. Files loaded through `StemmerPatchTrieLoader.load(Path, ...)` may be either plain UTF-8 text or GZip-compressed UTF-8 text; the loader detects GZip input from the stream header instead of relying on the file extension. Bundled dictionaries are stored as GZip resources and are decoded as UTF-8 after decompression. +Dictionary files are read as UTF-8 text. Files loaded through `StemmerPatchTrieLoader.load(Path, ...)` may be either plain UTF-8 text or GZip-compressed UTF-8 text; the loader detects GZip input from the stream header instead of relying on the file extension. Registered model dictionaries are stored as GZip resources and are decoded as UTF-8 after decompression. + +## Turn a dictionary into a model artifact + +An arbitrary classpath copy is not a discoverable model. A model module places immutable input and its license under `models//src/modelInput/`, declares metadata and an independent version, and applies the model convention plugin. The build validates the input, copies identical bytes into a generated namespaced resource, generates `META-INF/radixor/models.index` and a descriptor, records SHA-256, and packages licensing material. See [Stemmer Models](stemmer-models.md#create-or-update-a-model-module) for the complete procedure and [Model Selection and Loading](model-selection-and-loading.md) for runtime use. The parser and trie are not restricted to ASCII. Dictionary items are ordinary Java `String` values, and trie traversal works over Java `char` sequences. This supports Latin-script data with diacritics, Cyrillic data, Hebrew, Persian, Yiddish, and other scripts represented in UTF-8, subject to the normal Java `String` model and the project’s traversal configuration. @@ -235,3 +260,5 @@ To understand how those dictionary lines are transformed into compiled runtime a - [CLI compilation](cli-compilation.md) - [Programmatic usage](programmatic-usage.md) - [Architecture and reduction](architecture-and-reduction.md) +!!! note "Radixor 4 model artifacts" + Language dictionaries are independently versioned runtime model artifacts, not resources embedded in `radixor`. Language-based APIs resolve deterministic defaults through `StemmerModelRegistry`; see [Stemmer Models](stemmer-models.md). diff --git a/docs/fast-track.md b/docs/fast-track.md index e17f1f6..49a1d87 100644 --- a/docs/fast-track.md +++ b/docs/fast-track.md @@ -1,14 +1,14 @@ # Fast Track This page is the shortest path from an empty Java project to a working Radixor stemmer. -It deliberately uses a bundled dictionary and the preferred compiled-command runtime API, so the +It deliberately uses an external model artifact and the preferred compiled-command runtime API, so the first result does not require writing a dictionary, running the CLI compiler, or understanding reduction internals. Use this page when the goal is: - add the dependency, -- load a bundled language resource, +- load a registered language model, - stem a token, - know where to go next. @@ -23,14 +23,14 @@ groupId: org.egothor artifactId: radixor ``` -Use the current published version from Maven Central. The snippets below use `3.0.0`; replace it -with the version you deploy if a newer release is available. +Radixor 4 is not yet represented by a published release in this working tree. Replace the version placeholder with the reviewed release you deploy. For a Gradle project: ```kotlin dependencies { - implementation("org.egothor:radixor:3.0.0") + implementation("org.egothor:radixor:") + runtimeOnly("org.egothor:radixor-model-us-uk-default:1.0.0") } ``` @@ -40,17 +40,23 @@ For a Maven project: org.egothor radixor - 3.0.0 + ${radixor.version} + + + org.egothor + radixor-model-us-uk-default + 1.0.0 + runtime ``` Radixor targets modern Java and has a dependency-light runtime core. The project documentation and benchmarks assume a current JDK; Java 21 or newer is the practical baseline for current releases. -## 2. Load A Bundled Dictionary +## 2. Load An External Model Dictionary -The fastest path is to use a bundled dictionary through `StemmerPatchTrieLoader.Language`. -This example uses the bundled English resource, `US_UK`. +The fastest path is to use a registered model through `StemmerPatchTrieLoader.Language`. +This example uses `US_UK`, whose default ID is `us-uk-default`; the runtime model dependency above must be present. ```java import java.io.IOException; @@ -81,12 +87,11 @@ public final class RadixorFirstStem { } ``` -The loaded `FrequencyTrie` is immutable and can be shared across request -threads. Load it once during application startup and reuse it for indexing and query processing. +The loaded `FrequencyTrie` has no mutating API. Load it once during application startup, publish it safely through application-owned lifecycle code, and reuse it for indexing and query processing. -## 3. Choose A Language Resource +## 3. Choose a Language Default or Explicit Model -Bundled dictionaries are exposed as enum constants. Common examples: +Language defaults are exposed as enum constants. Common examples: | Language | Enum constant | | --- | --- | @@ -102,6 +107,8 @@ Bundled dictionaries are exposed as enum constants. Common examples: The full list, writing-direction notes, and benchmark links are in [Built-in Languages](built-in-languages.md). +Polish has two models. `Language.PL_PL` selects `pl-pl-unimorph`; load the alternative explicitly with `StemmerPatchTrieLoader.loadCompiled("pl-pl-polimorf", true, reductionMode)`, or retain a registry and pass `registry.require("pl-pl-polimorf")` to the descriptor overload. See [Model Selection and Loading](model-selection-and-loading.md). Full PoliMorf construction requires substantially more startup heap than ordinary models; the repository verifies it in a dedicated 6 GiB test JVM. + ## 4. Use The Same Stemmer On Both Sides For search, use the same Radixor configuration during indexing and query processing. A typical @@ -118,7 +125,7 @@ limited to lookup and patch application. ## 5. Next Step For Production -The fast path compiles a bundled dictionary during startup. That is convenient for evaluation and +The fast path parses and compiles a registered model dictionary during startup. That is convenient for evaluation and small services. For larger deployments, compile once, persist a `.radixor.gz` artifact, and load that binary artifact at runtime. @@ -126,5 +133,6 @@ Continue with: - [Integration Deep Dive](integration-deep-dive.md) for production lifecycle guidance. - [Loading and Building Stemmers](programmatic-loading-and-building.md) for all loading APIs. -- [Built-in Languages](built-in-languages.md) for bundled resources and dictionary locations. +- [Model Selection and Loading](model-selection-and-loading.md) for model dependencies, variants, and failures. +- [Built-in Languages](built-in-languages.md) for defaults and optional variants. - [Benchmarking](benchmarking.md) for speed and quality interpretation. diff --git a/docs/index.md b/docs/index.md index 2388f2e..dd7d4e9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,12 +28,26 @@ Radixor delivers: Radixor is intended for teams that require consistent stemming quality at scale, while retaining the ability to evolve lexical resources after compilation and to handle ambiguous reductions with greater precision than traditional single-stem pipelines allow. +## Add the core and model data + +The core `org.egothor:radixor` JAR contains no language dictionary. A minimal application adds one model; broad deployments may use the optional standard pack: + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' +} +``` + +`StemmerPatchTrieLoader.loadCompiled(Language.PL_PL, ...)` resolves the default `pl-pl-unimorph`. `pl-pl-polimorf` is a separate optional model selected by stable model ID. Follow [Model Selection and Loading](model-selection-and-loading.md) for runnable examples or choose artifacts from the generated [model catalog](stemmer-model-catalog.md). + ## Start here - Read [Fast Track](fast-track.md) when you want the shortest path to a working bundled stemmer. +- Use [Model Selection and Loading](model-selection-and-loading.md) for default, explicit, dual-model, and ClassLoader examples. - Use [Integration Deep Dive](integration-deep-dive.md) when you are wiring Radixor into a real application or search pipeline. - Read [Quick Start](quick-start.md) for the broader developer walkthrough after the first result works. -- Use [Built-in Languages](built-in-languages.md) to find the bundled dictionaries exposed by Radixor. +- Use [Built-in Languages](built-in-languages.md) to interpret language defaults and optional model variants. - Review [Benchmarking](benchmarking.md) and [Benchmark Results](benchmarks/index.md) for reproducible performance and quality methodology. - Open [CI Reports](reports.md) to inspect published build artifacts and quality metrics. - See the historical paper: [*Lemmatizer for Document Information Retrieval Systems in JAVA*](https://www.researchgate.net/publication/221512865_Lemmatizer_for_Document_Information_Retrieval_Systems_in_JAVA). diff --git a/docs/integration-deep-dive.md b/docs/integration-deep-dive.md index 71aa6cb..69efb5f 100644 --- a/docs/integration-deep-dive.md +++ b/docs/integration-deep-dive.md @@ -1,7 +1,7 @@ # Integration Deep Dive This page explains how to integrate Radixor into a real Java application after the first -fast-track experiment works. It covers dependencies, bundled dictionaries, runtime lifecycle, +fast-track experiment works. It covers dependencies, external model artifacts, runtime lifecycle, deployment artifacts, and the decisions that matter in search or text-processing systems. ## Integration Model @@ -15,9 +15,10 @@ Radixor has two separate phases: The practical rule is simple: compile rarely, stem often. -For production systems, prefer a startup-owned or dependency-injected singleton -`FrequencyTrie` per language/configuration. The trie is immutable after -construction and is suitable for concurrent reads. +For production systems, prefer a startup-owned or dependency-injected +`FrequencyTrie` per language/configuration. The compiled structure has no +mutating API. The project does not currently publish a formal cross-thread safety guarantee, so +applications should use normal safe-publication practices when sharing a loaded trie. ## Dependency Coordinates @@ -31,7 +32,8 @@ Gradle: ```kotlin dependencies { - implementation("org.egothor:radixor:3.0.0") + implementation("org.egothor:radixor:") + runtimeOnly("org.egothor:radixor-models-standard:") } ``` @@ -41,11 +43,17 @@ Maven: org.egothor radixor - 3.0.0 + ${radixor.version} + + + org.egothor + radixor-models-standard + ${model.catalog.version} + runtime ``` -Replace `3.0.0` with the current release selected for your deployment. +Replace the example versions with the independently selected core and catalog releases for your deployment. The core Java module is: @@ -61,30 +69,15 @@ module example.search { } ``` -## Bundled Dictionaries +## Runtime Model Artifacts -Radixor ships bundled dictionaries inside the library artifact. The public API exposes them through: +The core ships no language dictionary. Add one or more `radixor-model-` artifacts, or the optional metadata-only standard pack. Each model JAR contains an indexed descriptor and a namespaced GZip dictionary. `StemmerPatchTrieLoader.Language` represents language properties and a stable default model ID; it does not own embedded data. -```java -StemmerPatchTrieLoader.Language -``` +The standard option is specifically a POM-only runtime dependency aggregate, not an all-model binary JAR. It resolves one default model JAR per language and excludes optional PoliMorf. The separate POM-only `radixor-models-bom` manages recommended versions without adding runtime artifacts. Repository tests and JMH attach individual model projects directly to non-production configurations, so neither path changes the root publication's dependency graph. -The physical resources are packaged as compressed UTF-8 dictionaries under resource directories -such as: +For minimal deployments choose only required model artifacts. For multiple Polish variants add both `pl-pl-unimorph` and `pl-pl-polimorf`, retain UniMorph as the language default, and request PoliMorf explicitly. See [Model Selection and Loading](model-selection-and-loading.md) for complete dependencies and [Built-in Languages](built-in-languages.md) for mappings. -```text -us_uk/stemmer.gz -de_de/stemmer.gz -fr_fr/stemmer.gz -pl_pl/stemmer.gz -``` - -Treat those resource paths as implementation details. Application code should load bundled -dictionaries through `StemmerPatchTrieLoader.Language`, because the enum also carries the language -metadata needed for correct traversal. - -See [Built-in Languages](built-in-languages.md) for the complete language list, writing-direction -notes, and links to per-language benchmark pages. +Use `loadCompiled("pl-pl-polimorf", true, reductionMode)` for direct exact selection, or discover once and call `loadCompiled(descriptor, true, reductionMode)`. Neither form caches the trie. Complete PoliMorf startup is memory-intensive and is verified with a dedicated 6 GiB heap; construct it once during application initialization and retain the immutable result. ## Minimal Service Wrapper @@ -126,7 +119,7 @@ searchable. For a controlled deployment, compile once and deploy the binary artifact: -1. choose a bundled or custom dictionary, +1. choose a registered model resource or caller-owned custom dictionary, 2. optionally extend it with domain vocabulary, 3. compile a contracted trie, 4. persist it as `.radixor.gz`, @@ -173,9 +166,9 @@ Use Radixor consistently across indexing and querying: For multilingual content, do not run every token through every language. Route text by field, document metadata, or language detection before stemming. -## Choosing Bundled Versus Custom Dictionaries +## Choosing Registered Versus Custom Dictionaries -Start with bundled dictionaries when: +Start with registered model artifacts when: - the language is supported, - the application needs a strong baseline quickly, @@ -218,7 +211,7 @@ use [Benchmark Results](benchmarks/index.md) for the detailed reference tree. Before production rollout: - dependency version is pinned, -- language resource and reduction mode are documented, +- language, model ID, model artifact version, checksum, and reduction mode are documented, - indexing and query pipelines use the same stemming configuration, - custom artifacts are versioned and reproducible, - fallback behavior for unknown tokens is explicit, @@ -231,5 +224,6 @@ Before production rollout: - [Quick Start](quick-start.md) - [Built-in Languages](built-in-languages.md) - [Programmatic Usage](programmatic-usage.md) +- [Model Selection and Loading](model-selection-and-loading.md) - [CLI Compilation](cli-compilation.md) - [Benchmarking](benchmarking.md) diff --git a/docs/migration-and-backward-compatibility.md b/docs/migration-and-backward-compatibility.md index b5f514b..7afb9de 100644 --- a/docs/migration-and-backward-compatibility.md +++ b/docs/migration-and-backward-compatibility.md @@ -1,6 +1,149 @@ # Migration and Backward Compatibility -This page describes the migration from repeated serialized patch-command application to compiled patch commands. +## Radixor 3.x to 4.x architecture migration + +Radixor 3.x published algorithm classes and language dictionaries together as `org.egothor:radixor`. Radixor 4 keeps that established coordinate for the algorithmic core but removes every dictionary from the core JAR. Applications must now choose independently versioned model artifacts. This is deliberately source-compatible where practical and deliberately different at runtime. + +### Before and after: dependencies + +| Deployment | 3.x | 4.x | +|---|---|---| +| Core | `org.egothor:radixor:<3.x-version>` included dictionaries | `org.egothor:radixor:` contains code only | +| Minimal Polish | No separate data dependency | Add `radixor-model-pl-pl-unimorph:1.0.0` | +| All defaults | Implicitly embedded | Add optional `radixor-models-standard:` | +| Optional Polish variant | Not independently selectable | Add and explicitly select `radixor-model-pl-pl-polimorf:1.0.0` | + +Gradle, preserving the previous Polish default: + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' +} +``` + +Gradle, broad default coverage: + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-models-standard:' +} +``` + +Maven, preserving the Polish default: + +```xml + + org.egothor + radixor + ${radixor.version} + + + org.egothor + radixor-model-pl-pl-unimorph + 1.0.0 + runtime + +``` + +### Before and after: API behavior + +Language-oriented calls remain source-compatible: + +```java +final FrequencyTrie polish = + StemmerPatchTrieLoader.loadCompiled( + StemmerPatchTrieLoader.Language.PL_PL, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +In 4.x this call creates a registry and resolves `Language.PL_PL.defaultModelId()`, which is `pl-pl-unimorph`. Source compatibility does not imply runtime classpath compatibility: the call fails with `StemmerModelNotFoundException` unless that model is visible. + +Explicit selection enables multiple variants: + +```java +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); +final StemmerModelDescriptor polimorf = registry.require("pl-pl-polimorf"); +final FrequencyTrie trie = + StemmerPatchTrieLoader.loadCompiled( + polimorf, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +The existing `load(String, ...)` overload means a filesystem path. The compiled `loadCompiled(String, boolean, ReductionMode)` overload now means a stable model ID; use the `Path` overload for a filesystem dictionary. Descriptor-based compiled loading avoids rediscovery when an application retains a registry. See [Model Selection and Loading](model-selection-and-loading.md) for complete examples. + +### Polish migration scenarios + +1. **Preserve previous default behavior:** add `radixor-model-pl-pl-unimorph` and keep using `Language.PL_PL`. +2. **Use PoliMorf:** add `radixor-model-pl-pl-polimorf` and call `registry.require("pl-pl-polimorf")`. +3. **Deploy both:** add both runtime artifacts and load each descriptor by ID. They are not merged. +4. **Verify selection:** compare `registry.requireDefault(Language.PL_PL).id()` with `pl-pl-unimorph` through normal application control flow or a JUnit assertion, and inspect `registry.findByLanguage(Language.PL_PL)`. +5. **Diagnose absence:** read the exact `StemmerModelNotFoundException` message, then inspect the production `runtimeClasspath` rather than changing dependency order. + +UniMorph and PoliMorf are not interchangeable quality datasets. They can differ in vocabulary, provenance, licensing, and stemming outputs. + +Model migration does not erase source obligations. Each migrated UniMorph artifact packages its +language-specific notice with upstream attribution, Radixor modifications and contribution +statement, ShareAlike terms, and the canonical CC BY-SA 3.0 URI. The original imports did not +record exact UniMorph commits, so descriptors use +`source.revision=not-recorded-in-legacy-import` and disclose that fact. Future model imports must +record an exact upstream revision and source-archive checksum. + +### Compatibility table + +| Dimension | 4.x migration status | +|---|---| +| Source compatibility | Language-oriented loader signatures remain; external model dependencies are new | +| Binary compatibility | Removing resources is a major-version boundary; review all deployed artifacts | +| Runtime classpath | At least one selected model JAR is required | +| Model format | Descriptor format `radixor-dictionary-tsv-gzip` version `1` is validated by the registry | +| Model IDs | Stable runtime identities, independent of artifact discovery order | +| Core Maven coordinate | Remains `org.egothor:radixor` | +| Release versions | Core, each model, upstream source, format, and catalog versions evolve separately | + +### Upgrade checklist + +- Update the core dependency. +- Choose individual model artifacts or the standard pack. +- Put resource-only model dependencies on the production runtime classpath. +- Verify `Language.defaultModelId()` mappings used by the application. +- Inspect shaded, minimized, plugin, or modular packaging for indexes and resources. +- Run application-level vocabulary and output regression tests. +- Track model artifact versions and checksums separately from the core version. + +### Roll back model choice + +To return from optional PoliMorf to the default UniMorph behavior, add or retain `radixor-model-pl-pl-unimorph`, stop requesting `pl-pl-polimorf`, and load `Language.PL_PL` or explicitly request `pl-pl-unimorph`. Do not change the language constant. Remove the unused PoliMorf runtime dependency after verifying no explicit lookup still needs it. + +Rolling the whole application back to 3.x instead requires restoring the reviewed 3.x core dependency and removing 4.x model assumptions. Do not combine 3.x embedded resources with the 4.x registry architecture. + +Core, model, and catalog releases are independent: + +```bash +git tag -a "release@4.0.0" -m "Release Radixor 4.0.0" +git tag -a "model/pl-pl-polimorf@1.0.0" -m "Release Polish PoliMorf model 1.0.0" +git tag -a "models-catalog@2026.1" -m "Release Radixor model catalog 2026.1" +``` + +A core tag publishes only the root `org.egothor:radixor` software artifacts, never model JARs. A model tag validates and publishes exactly its matching module, never core, standard, BOM, JMH, or the multilingual quality suite. A catalog tag publishes only BOM and standard aggregate metadata. Local model dry-run: + +The catalog artifacts are POM-only: `radixor-models-standard` carries runtime dependencies on the 20 defaults, while `radixor-models-bom` carries dependency-management constraints for all 21 individual models. Neither publishes an empty binary, sources, or Javadoc JAR. This Maven BOM is distinct from the root CycloneDX SBOM report under `build/reports/sbom/`. + +```bash +./tools/parse-model-release-tag.sh "model/pl-pl-polimorf@1.0.0" . +./gradlew --no-daemon :models:pl-pl-polimorf:check +./gradlew --no-daemon :models:pl-pl-polimorf:validateModelRelease -PmodelReleaseVersion=1.0.0 +./gradlew --no-daemon :models:pl-pl-polimorf:packageModelReleaseCandidate -PmodelReleaseVersion=1.0.0 +``` + +Model format compatibility is descriptor-level and does not alter migrated bytes. Version 1 is `radixor-dictionary-tsv-gzip`. Model versions come from each module's `model-version.txt` or the matching explicit release property; catalog version comes from `models/catalog-version.txt`; only core uses Git-derived `release@` versioning. + +The model catalog used by the published documentation is generated under `build/mkdocs-source/`. Neither generated Markdown nor rendered MkDocs output belongs in Git. + +The remainder of this page describes the earlier migration from repeated serialized patch-command application to compiled patch commands. ## Summary diff --git a/docs/model-selection-and-loading.md b/docs/model-selection-and-loading.md new file mode 100644 index 0000000..6fbb203 --- /dev/null +++ b/docs/model-selection-and-loading.md @@ -0,0 +1,277 @@ +# Model Selection and Loading + +Radixor separates executable stemming code from language data. The core artifact supplies dictionary parsing, trie construction, patch commands, lookup, and the model registry. A model artifact supplies one indexed descriptor, one GZip-compressed Radixor dictionary, and its licensing material. The core JAR contains no language dictionary. + +```text +Application + -> org.egothor:radixor (algorithmic core) + -> StemmerModelRegistry + -> indexed model descriptor + -> namespaced stemmer.gz resource + -> checksum verification and dictionary parsing + -> FrequencyTrie construction + -> patch lookup and stemming +``` + +## Language and model ID + +These identifiers answer different questions: + +| Concept | Example | Meaning | +|---|---|---| +| Language | `Language.PL_PL` | Polish as a linguistic identity | +| Model ID | `pl-pl-unimorph` | One concrete Polish model configuration | +| Model ID | `pl-pl-polimorf` | A different concrete Polish model configuration | +| Default model | `PL_PL -> pl-pl-unimorph` | The model selected by the language convenience API | + +One language can have several models. `Language.PL_PL` is neither UniMorph nor PoliMorf. `loadCompiled(Language.PL_PL, ...)` resolves the stable default ID declared by `Language.defaultModelId()`. An explicit lookup requests exactly one ID. Registry ordering never changes either decision. + +Licensing follows the selected artifact. Radixor Java software is BSD-3-Clause; UniMorph-derived +model data carries a model-specific CC BY-SA 3.0 notice, while PoliMorf carries its separate +BSD-2-Clause license. The UniMorph notice preserves upstream attribution and identifies the +Radixor transformations and limited protectable contributions without claiming the underlying data. + +## Choose runtime dependencies + +Radixor 4 is an architectural migration that is not yet represented by a published release in this working tree, so core and catalog versions below use placeholders. Every source-controlled model currently has model version `1.0.0`. + +### Core plus the default Polish model + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' +} +``` + +### Core plus optional PoliMorf + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-pl-pl-polimorf:1.0.0' +} +``` + +This dependency makes `pl-pl-polimorf` discoverable; it does not change the default for `PL_PL`. + +### Both Polish models + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' + runtimeOnly 'org.egothor:radixor-model-pl-pl-polimorf:1.0.0' +} +``` + +### Standard defaults + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-models-standard:' +} +``` + +The standard aggregate is POM-only. Its POM supplies exactly one default model per supported language as transitive runtime dependencies and excludes optional PoliMorf. It publishes no empty binary JAR. + +### BOM-managed versions + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + implementation platform('org.egothor:radixor-models-bom:') + runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph' + runtimeOnly 'org.egothor:radixor-model-pl-pl-polimorf' +} +``` + +Equivalent Maven dependencies use ordinary runtime scope: + +```xml + + org.egothor + radixor + ${radixor.version} + + + org.egothor + radixor-model-pl-pl-unimorph + 1.0.0 + runtime + +``` + +Use `implementation` for the core because application code imports its API. Models normally use `runtimeOnly` because they provide resources rather than Java types. Tests with a deliberately isolated model set use `testRuntimeOnly`. The repository attaches every default model and optional PoliMorf directly to `jmhRuntimeOnly`; test and quality configurations likewise use direct non-production model dependencies. No benchmark aggregate artifact exists, and no model dependency enters the root published POM. + +## Load the documented default + +Dependency prerequisite: core plus `radixor-model-pl-pl-unimorph` (or the standard pack). + +```java +import org.egothor.stemmer.CompiledPatchCommand; +import org.egothor.stemmer.FrequencyTrie; +import org.egothor.stemmer.ReductionMode; +import org.egothor.stemmer.ReductionSettings; +import org.egothor.stemmer.StemmerPatchTrieLoader; + +final FrequencyTrie polish = + StemmerPatchTrieLoader.loadCompiled( + StemmerPatchTrieLoader.Language.PL_PL, + true, + ReductionSettings.withDefaults( + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS)); + +final String word = "koty"; +final CompiledPatchCommand patch = polish.get(word); +final String stem = patch == null ? word : patch.apply(word); +``` + +The loader creates a registry from the thread context class loader, resolves `PL_PL` to `pl-pl-unimorph`, verifies the compressed resource checksum, decompresses and parses the UTF-8 dictionary, constructs the trie, and compiles its patch commands. It does not load a serialized Java object. If the default artifact is absent, `StemmerModelNotFoundException` names the missing ID and suggested Maven artifact. + +## Load PoliMorf explicitly + +Dependency prerequisite: core plus `radixor-model-pl-pl-polimorf`. + +```java +import org.egothor.stemmer.CompiledPatchCommand; +import org.egothor.stemmer.FrequencyTrie; +import org.egothor.stemmer.ReductionMode; +import org.egothor.stemmer.StemmerModelDescriptor; +import org.egothor.stemmer.StemmerModelRegistry; +import org.egothor.stemmer.StemmerPatchTrieLoader; + +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); +final StemmerModelDescriptor descriptor = registry.require("pl-pl-polimorf"); + +final FrequencyTrie polish = + StemmerPatchTrieLoader.loadCompiled( + descriptor, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); + +final String word = "koty"; +final CompiledPatchCommand patch = polish.get(word); +final String stem = patch == null ? word : patch.apply(word); +``` + +The equivalent direct model-ID form is: + +```java +final FrequencyTrie polimorf = + StemmerPatchTrieLoader.loadCompiled( + "pl-pl-polimorf", + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +`require("pl-pl-polimorf")` and the direct overload are deterministic because registry keys are stable model IDs. Discovery order is sorted, duplicate IDs are rejected, and no “first Polish model on the classpath” fallback exists. Both overloads return compiled patch-command values and perform complete integrity checking, parsing, reduction, and trie construction. + +!!! warning "PoliMorf startup memory" + Full construction of the PoliMorf model is memory-intensive. Radixor verifies it in one isolated JVM with a task-specific maximum heap of 6 GiB. Two measured verification runs completed full construction in 23.7 seconds and 23.5 seconds, producing 358,993 canonical trie nodes; the complete Gradle processes peaked at approximately 6.23 GiB resident memory. The compressed model is only 12,624,997 bytes (68,093,680 bytes decompressed), so JAR size is not a proxy for construction-time heap. Applications loading the complete model must provision sufficient startup heap. Radixor does not currently expose a measured retained-heap value, so do not infer one from the process peak. + +## Use both Polish models + +Dependency prerequisite: both Polish model artifacts. + +```java +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); + +final StemmerModelDescriptor unimorph = registry.require("pl-pl-unimorph"); +final StemmerModelDescriptor polimorf = registry.require("pl-pl-polimorf"); +final StemmerModelDescriptor defaultPolish = + registry.requireDefault(StemmerPatchTrieLoader.Language.PL_PL); + +if (!"pl-pl-unimorph".equals(defaultPolish.id())) { + throw new IllegalStateException( + "Unexpected default Polish model: " + defaultPolish.id()); +} + +final FrequencyTrie unimorphTrie = + StemmerPatchTrieLoader.loadCompiled(unimorph, true, reductionMode); +final FrequencyTrie polimorfTrie = + StemmerPatchTrieLoader.loadCompiled(polimorf, true, reductionMode); +``` + +The descriptors and tries coexist independently. The models are not merged, and adding PoliMorf does not alter the language default. An application that compares, votes across, or merges model outputs must implement that higher-level policy explicitly. + +## Discover available models + +```java +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); + +for (final StemmerModelDescriptor model : registry.models()) { + System.out.printf("%s %s %s %s/%d descriptor=%s%n", + model.id(), model.language(), model.version(), + model.format(), model.formatVersion(), model.source()); +} + +final java.util.List polishModels = + registry.findByLanguage(StemmerPatchTrieLoader.Language.PL_PL); +``` + +Both lists use stable model-ID order. The public descriptor API exposes ID, model artifact version, language, display name, runtime resource, default flag, format, format version, checksum, and descriptor source URL. Packaged provenance properties such as `source.name` and `source.version` are not currently exposed as typed descriptor accessors; consult the generated [model catalog](stemmer-model-catalog.md) for them. + +## Use an explicit ClassLoader + +```java +final ClassLoader pluginLoader = plugin.getClass().getClassLoader(); +final StemmerModelRegistry pluginModels = + StemmerModelRegistry.fromClassLoader(pluginLoader); +final StemmerModelDescriptor model = pluginModels.require("pl-pl-polimorf"); +``` + +`fromContextClassLoader()` uses the current thread context loader, falling back to Radixor's defining loader when the context loader is `null`. `fromClassLoader(loader)` searches only what that loader can expose through `getResources(...)` and ordinary resource lookup. Plugin containers, application servers, and isolated tests can therefore observe different model sets. Pass a non-null loader and retain the registry associated with that deployment scope. + +## Error handling + +```java +try { + final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); + final StemmerModelDescriptor model = registry.require("pl-pl-polimorf"); + // Load and cache the trie during application startup. +} catch (final StemmerModelNotFoundException exception) { + // Missing runtime dependency or model hidden from this ClassLoader. + throw exception; +} catch (final DuplicateStemmerModelException exception) { + // Conflicting artifacts or a fat JAR duplicated one stable ID. + throw exception; +} catch (final UnsupportedStemmerModelFormatException exception) { + // The model format or format version is not supported by this core. + throw exception; +} catch (final StemmerModelIntegrityException exception) { + // Malformed descriptor/index, missing resource, wrong language, or checksum failure. + throw exception; +} catch (final java.io.IOException exception) { + // Classpath enumeration or resource I/O failed. + throw new java.io.UncheckedIOException(exception); +} +``` + +Malformed metadata does not have a separate public exception: it is reported as `StemmerModelIntegrityException`. Missing explicit and default models both use `StemmerModelNotFoundException`; the default diagnostic additionally names the language and expected default ID. Never swallow these failures or choose an arbitrary model. + +## Lifecycle and concurrency + +`StemmerModelRegistry` copies discovered descriptors into an unmodifiable map, returns immutable list copies, and has no mutating API. `StemmerModelDescriptor` is final with final fields. These objects are safe to retain after discovery. Registry discovery is not globally cached: every call enumerates indexes and parses descriptors again. Model loading is also not cached: every call reads, hashes, decompresses, parses, and builds a new trie. + +Compiled tries are immutable and thread-safe for concurrent reads. Load a registry and the required tries once during application startup, publish them safely, and reuse them. The loader does not cache model tries; do not repeatedly discover and compile models per token. When comparing both Polish models, account for the memory of two independent tries and avoid constructing them concurrently unless the deployment is sized for that peak. + +## Troubleshooting + +| Symptom | Meaning | Action | +|---|---|---| +| `No default model '...' is available` | The default artifact is absent from the selected loader | Add the named model as a runtime dependency and inspect `runtimeClasspath` | +| `No model 'pl-pl-polimorf' is available` | Explicit optional model is absent or invisible | Add `radixor-model-pl-pl-polimorf` to runtime, not only tests | +| Duplicate model ID | Two resources declare one stable ID | Remove the duplicate artifact or fix fat-JAR resource duplication; do not reorder the classpath | +| Checksum mismatch | Descriptor and compressed bytes differ | Replace the corrupted or incorrectly repackaged artifact | +| Unsupported format | Core supports neither the format name nor version | Use a compatible core/model pair; do not bypass validation | +| Works in tests, fails in production | The model is probably `testRuntimeOnly` | Inspect `./gradlew dependencies --configuration runtimeClasspath` | +| Visible with one loader only | Class loaders expose different resources | Call `fromClassLoader(...)` with the loader that owns the model JAR | +| PoliMorf is installed but language loading uses UniMorph | Expected default behavior | Select `pl-pl-polimorf` explicitly | +| Dependency minimization removed the model | Resource-only dependency was treated as unused | Preserve the model JAR, index, descriptor, license, and dictionary | +| Shaded JAR fails or reports duplicates | Indexes/resources were dropped or duplicated | Inspect with `jar tf app.jar | grep -E 'models.index|stemmer.gz'`; configure deterministic resource merging without duplicating IDs | + +Useful Gradle diagnostics include `./gradlew dependencyInsight --dependency radixor-model --configuration runtimeClasspath` and `./gradlew dependencies --configuration testRuntimeClasspath`. Classpath order is not a remediation mechanism. + +Continue with [Programmatic Usage](programmatic-usage.md), [Stemmer Models](stemmer-models.md), [Built-in Languages](built-in-languages.md), the generated [model catalog](stemmer-model-catalog.md), and [Architecture](architecture.md). diff --git a/docs/programmatic-loading-and-building.md b/docs/programmatic-loading-and-building.md index 9dbefae..e500479 100644 --- a/docs/programmatic-loading-and-building.md +++ b/docs/programmatic-loading-and-building.md @@ -2,9 +2,9 @@ This document explains how to acquire a compiled Radixor stemmer in Java. -## Load a bundled language dictionary +## Load a registered default model -Bundled language resources are simple to use and compile directly into a `FrequencyTrie` during loading. +Language-oriented entry points resolve a registered default model and compile its GZip textual dictionary into a `FrequencyTrie`. The corresponding model JAR must be on the runtime classpath; the core contains no dictionary. ```java import java.io.IOException; @@ -14,9 +14,9 @@ import org.egothor.stemmer.FrequencyTrie; import org.egothor.stemmer.ReductionMode; import org.egothor.stemmer.StemmerPatchTrieLoader; -public final class BundledLanguageExample { +public final class RegisteredLanguageModelExample { - private BundledLanguageExample() { + private RegisteredLanguageModelExample() { throw new AssertionError("No instances."); } @@ -31,14 +31,16 @@ public final class BundledLanguageExample { The `storeOriginal` flag controls whether the canonical stem is inserted as a no-op patch entry for the stem itself. -Bundled `loadCompiled(...)` entry points build the runtime trie with the same contracted +Language-oriented `loadCompiled(...)` entry points build the runtime trie with the same contracted representation used by the published benchmarks. During compilation, uniform preferred-command subtrees are collapsed into accepting leaves, so lookup can stop before consuming the entire input when the remaining characters cannot change the selected patch command. ## Load a textual dictionary -Loading from a dictionary file follows the same preparation model as bundled resources, but the source comes from your own file or path. The input may be plain UTF-8 text or GZip-compressed UTF-8 text; the loader detects GZip data from the stream header. The textual format is tab-separated values, meaning that columns are separated by the tab character. Each non-empty logical line starts with the stem column and may contain zero or more variant columns. Input case normalization is controlled by `CaseProcessingMode` (default: `LOWERCASE_WITH_LOCALE_ROOT`), trailing remarks introduced by `#` or `//` are ignored, and dictionary items containing embedded whitespace are currently ignored with warning-level diagnostics. +Loading from a dictionary file follows the same trie preparation model as registered model resources, but the source comes from your own file or path and bypasses registry metadata. The input may be plain UTF-8 text or GZip-compressed UTF-8 text; the loader detects GZip data from the stream header. The textual format is tab-separated values, meaning that columns are separated by the tab character. Each non-empty logical line starts with the stem column and may contain zero or more variant columns. Input case normalization is controlled by `CaseProcessingMode` (default: `LOWERCASE_WITH_LOCALE_ROOT`), trailing remarks introduced by `#` or `//` are ignored, and dictionary items containing embedded whitespace are currently ignored with warning-level diagnostics. + +For explicit model IDs, multiple variants, and ClassLoader control, see [Model Selection and Loading](model-selection-and-loading.md). ```java import java.io.IOException; diff --git a/docs/programmatic-usage.md b/docs/programmatic-usage.md index fe109d8..f2c23ae 100644 --- a/docs/programmatic-usage.md +++ b/docs/programmatic-usage.md @@ -1,80 +1,133 @@ # Programmatic Usage -This document provides the programmatic entry point to **Radixor**. +Radixor code and model data are separate runtime components. Every example on this page requires `org.egothor:radixor:` as an `implementation` dependency and at least one model JAR as a runtime dependency. The core JAR contains no `stemmer.gz`. -Radixor follows a clear lifecycle: +For complete dependency patterns, lifecycle guidance, and troubleshooting, use [Model Selection and Loading](model-selection-and-loading.md). The generated [model catalog](stemmer-model-catalog.md) records the current artifacts, versions, checksums, and provenance. -1. acquire a compiled stemmer, -2. query it for patch commands, -3. apply those commands to produce stems, -4. reopen and extend the compiled structure when needed. +## 1. Minimal use: the Polish default -## Conceptual model +Dependency prerequisite: -Radixor is dictionary-driven, but runtime stemming does not operate by scanning raw dictionary files. A source dictionary is parsed as a sequence of canonical stems and their known variants. Each variant is converted into a compact patch command that transforms the variant into the stem, while the stem itself may optionally be stored as a canonical no-op patch. The mutable trie is then reduced into a compiled read-only structure that stores ordered values and their counts at addressed nodes. - -Two consequences matter for developers: - -- the quality and coverage of stemming behavior depend on dictionary richness, -- runtime usage is based on compiled patch-command lookup rather than on direct dictionary traversal. - -This is why Radixor can generalize beyond explicitly listed forms and why compiled artifacts are well suited for deployment. - -## Documentation map - -The programmatic API is easier to understand when split by developer task: - -- [Fast Track](fast-track.md) gives the shortest dependency-to-first-stem path for a new Java project. -- [Integration Deep Dive](integration-deep-dive.md) explains production integration, deployment artifacts, search-pipeline usage, and operational decisions. -- [Loading and Building Stemmers](programmatic-loading-and-building.md) explains how to acquire a compiled stemmer from bundled resources, textual dictionaries, binary artifacts, or direct builder usage. -- [Lookup Edge Optimization](lookup-edge-optimization.md) explains dense child lookup tuning and the speed/memory trade-off when materializing compiled tries. -- [Querying and Ambiguity Handling](programmatic-querying-and-ambiguity.md) explains `get(...)`, `getAll(...)`, `getEntries(...)`, patch application, and the practical meaning of reduction modes. -- [Extending and Persisting Compiled Tries](programmatic-extending-and-persistence.md) explains how to reopen compiled tries, add new lexical data, rebuild them, and store them as binary artifacts. - -## Core types - -The main types involved in programmatic usage are: - -- `FrequencyTrie.Builder` for mutable construction and extension, -- `FrequencyTrie` for the compiled read-only trie, -- `PatchCommandEncoder` for creating serialized patch commands, -- `CompiledPatchCommand` for repeated runtime patch application, -- `StemmerPatchTrieLoader` for loading bundled or textual dictionaries, -- `StemmerPatchTrieBinaryIO` for reading and writing compressed binary artifacts, -- `FrequencyTrieBuilders` for reconstructing a mutable builder from a compiled trie, -- `ReductionMode` and `ReductionSettings` for controlling compilation semantics. - -## Java module system (JPMS) - -The core artifact is published as an explicit JPMS module: - -```java -module org.egothor.radixor; +```groovy +implementation 'org.egothor:radixor:' +runtimeOnly 'org.egothor:radixor-model-pl-pl-unimorph:1.0.0' ``` -A named consuming module uses: +```java +import org.egothor.stemmer.CompiledPatchCommand; +import org.egothor.stemmer.FrequencyTrie; +import org.egothor.stemmer.ReductionMode; +import org.egothor.stemmer.StemmerPatchTrieLoader; + +final FrequencyTrie trie = + StemmerPatchTrieLoader.loadCompiled( + StemmerPatchTrieLoader.Language.PL_PL, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); + +final String word = "koty"; +final CompiledPatchCommand patch = trie.get(word); +final String stem = patch == null ? word : patch.apply(word); +``` + +`Language.PL_PL` resolves to `pl-pl-unimorph`. The loader creates the registry internally through the thread context class loader. + +## 2. Explicit model selection + +Dependency prerequisite: replace or supplement the default dependency with `runtimeOnly 'org.egothor:radixor-model-pl-pl-polimorf:1.0.0'`. ```java -module example.consumer { - requires org.egothor.radixor; +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); +final StemmerModelDescriptor polimorf = registry.require("pl-pl-polimorf"); +final FrequencyTrie trie = + StemmerPatchTrieLoader.loadCompiled( + polimorf, + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +The stable model-ID overload performs the same exact selection without a separately retained registry: + +```java +final FrequencyTrie trie = + StemmerPatchTrieLoader.loadCompiled( + "pl-pl-polimorf", + true, + ReductionMode.MERGE_SUBTREES_WITH_EQUIVALENT_RANKED_GET_ALL_RESULTS); +``` + +## 3. Multiple variants for one language + +Dependency prerequisite: both `radixor-model-pl-pl-unimorph:1.0.0` and `radixor-model-pl-pl-polimorf:1.0.0` at runtime. + +```java +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); +final StemmerModelDescriptor unimorph = registry.require("pl-pl-unimorph"); +final StemmerModelDescriptor polimorf = registry.require("pl-pl-polimorf"); + +final FrequencyTrie unimorphTrie = + StemmerPatchTrieLoader.loadCompiled(unimorph, true, reductionMode); +final FrequencyTrie polimorfTrie = + StemmerPatchTrieLoader.loadCompiled(polimorf, true, reductionMode); + +final StemmerModelDescriptor defaultPolish = + registry.requireDefault(StemmerPatchTrieLoader.Language.PL_PL); +if (!"pl-pl-unimorph".equals(defaultPolish.id())) { + throw new IllegalStateException( + "Unexpected default Polish model: " + defaultPolish.id()); } ``` -The core module is standalone and can be consumed directly as a normal Java module. +The tries remain independent. Radixor does not merge models or infer an alternative default from classpath order. -## Recommended reading order +## 4. Discovery -For most developers, the best order is: +Dependency prerequisite: whichever model artifacts the application intends to discover. -1. [Fast Track](fast-track.md) -2. [Integration Deep Dive](integration-deep-dive.md) -3. [Loading and Building Stemmers](programmatic-loading-and-building.md) -4. [Querying and Ambiguity Handling](programmatic-querying-and-ambiguity.md) -5. [Extending and Persisting Compiled Tries](programmatic-extending-and-persistence.md) +```java +final StemmerModelRegistry registry = StemmerModelRegistry.fromContextClassLoader(); -## Next steps +for (final StemmerModelDescriptor descriptor : registry.models()) { + System.out.printf("%s %s %s %s/%d%n", + descriptor.id(), descriptor.language(), descriptor.version(), + descriptor.format(), descriptor.formatVersion()); +} -- [Quick Start](quick-start.md) -- [CLI compilation](cli-compilation.md) -- [Dictionary format](dictionary-format.md) -- [Architecture and reduction](architecture-and-reduction.md) +final java.util.List polish = + registry.findByLanguage(StemmerPatchTrieLoader.Language.PL_PL); +``` + +Results use deterministic model-ID order. See [Built-in Languages](built-in-languages.md) for default interpretation and the generated [catalog](stemmer-model-catalog.md) for provenance. + +## 5. Advanced ClassLoader selection + +Dependency prerequisite: the model JAR must be visible to the selected loader. + +```java +final ClassLoader applicationLoader = application.getClass().getClassLoader(); +final StemmerModelRegistry isolatedRegistry = + StemmerModelRegistry.fromClassLoader(applicationLoader); +``` + +This form is useful for plugin containers, isolated application servers, and tests. It can discover a different set from the thread context loader. See [ClassLoader troubleshooting](model-selection-and-loading.md#troubleshooting). + +## 6. Error handling + +Dependency prerequisite: none beyond core; this example demonstrates an absent optional model. + +```java +try { + StemmerModelRegistry.fromContextClassLoader().require("pl-pl-polimorf"); +} catch (final StemmerModelNotFoundException exception) { + System.err.println(exception.getMessage()); +} +``` + +Missing models never produce an empty trie or arbitrary fallback. Duplicate IDs, unsupported formats, malformed descriptors, missing resources, and checksum mismatches are also fatal. The full exception mapping and remediation table are in [Model Selection and Loading](model-selection-and-loading.md#error-handling). + +## Continue into the trie API + +- [Loading and Building Stemmers](programmatic-loading-and-building.md) +- [Querying and Ambiguity Handling](programmatic-querying-and-ambiguity.md) +- [Extending and Persisting Compiled Tries](programmatic-extending-and-persistence.md) +- [Architecture](architecture.md) diff --git a/docs/quick-start.md b/docs/quick-start.md index 294409a..2d88258 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -4,10 +4,23 @@ This guide introduces the fastest practical path to using **Radixor**. If you are new to Radixor and want the shortest possible path to a first working stem, start with [Fast Track](fast-track.md). This Quick Start is a broader developer walkthrough: it introduces the -main loading options, query methods, artifact workflow, and metadata model. +main loading options, query methods, artifact workflow, and metadata model. For model-ID selection and failures, use [Model Selection and Loading](model-selection-and-loading.md). Radixor separates preparation from runtime usage. Source dictionaries are used to derive patch commands and reduce them into a compact read-only trie. Runtime stemming then operates on that compiled structure rather than on the original dictionary text. A richer dictionary usually improves the quality and coverage of inferred transformations, including transformations that are applicable to words not explicitly present in the source material. The reduction step also removes a large amount of redundant lexical information, which is why very large dictionaries can still produce compact runtime artifacts. These artifacts can be persisted and loaded directly when needed. +From version 4 onward, the core and models are explicit dependencies: + +```groovy +dependencies { + implementation 'org.egothor:radixor:' + runtimeOnly 'org.egothor:radixor-models-standard:' +} +``` + +The core JAR contains no dictionary. Replace the standard pack with `runtimeOnly 'org.egothor:radixor-model-us-uk-default:1.0.0'` for the minimal English example below. For Polish, `Language.PL_PL` resolves `pl-pl-unimorph`; installing optional `pl-pl-polimorf` does not select it automatically. + +Explicit PoliMorf loading uses `StemmerPatchTrieLoader.loadCompiled("pl-pl-polimorf", true, reductionMode)`. Its complete dictionary is supported, but construction is exceptional enough that repository verification runs it separately with a 6 GiB maximum heap. See [Model Selection and Loading](model-selection-and-loading.md#load-polimorf-explicitly) for the complete dependency and Java example. + A practical workflow usually consists of two independent phases: 1. obtain a compiled stemmer, @@ -17,9 +30,9 @@ A practical workflow usually consists of two independent phases: A compiled stemmer can be obtained in three common ways. -### Use a bundled language dictionary +### Use an external language model -Radixor ships with bundled dictionaries for a set of supported languages. These resources are line-oriented dictionaries stored with the library and compiled into a `FrequencyTrie` when loaded through the runtime API. The loader can also store the canonical stem itself as a no-op patch command. Compiled trie artifacts now persist self-describing metadata, including the traversal direction and compilation reduction settings used to build the artifact. +Language dictionaries are independently versioned model JARs discovered by `StemmerModelRegistry`. The root `org.egothor:radixor` JAR contains no dictionary bytes. The loader compiles a selected model into a `FrequencyTrie`; compiled trie artifacts retain self-describing traversal and reduction metadata. ```java import java.io.IOException; @@ -29,9 +42,9 @@ import org.egothor.stemmer.FrequencyTrie; import org.egothor.stemmer.ReductionMode; import org.egothor.stemmer.StemmerPatchTrieLoader; -public final class BundledStemmerExample { +public final class RegisteredModelExample { - private BundledStemmerExample() { + private RegisteredModelExample() { throw new AssertionError("No instances."); } @@ -251,3 +264,5 @@ Dictionary compilation is usually a one-time preparation step and is generally f Every compiled trie artifact stores a `TrieMetadata` descriptor together with the immutable trie payload. That metadata currently records the binary format version, the `WordTraversalDirection`, the `ReductionSettings` used during compilation, the declared `DiacriticProcessingMode`, and the selected `CaseProcessingMode`. Traversal, case processing, and diacritic processing are applied during runtime lookup (`get`, `getAll`), and case/diacritic processing are also applied during dictionary insertion when a trie is built. `DiacriticProcessingMode.AS_IS` keeps dictionary keys and lookup keys unchanged. `DiacriticProcessingMode.REMOVE` strips diacritics from dictionary keys and lookup keys (for Czech diacritics and broad European Latin-script variants). `DiacriticProcessingMode.AS_IS_AND_STRIPPED_FALLBACK` is currently not supported and raises an `UnsupportedOperationException`. +!!! note "Radixor 4 model artifacts" + Language dictionaries are independently versioned runtime model artifacts, not resources embedded in `radixor`. Language-based APIs resolve deterministic defaults through `StemmerModelRegistry`; see [Stemmer Models](stemmer-models.md). diff --git a/docs/reports.md b/docs/reports.md index 3516178..d76405e 100644 --- a/docs/reports.md +++ b/docs/reports.md @@ -2,6 +2,8 @@ Radixor publishes durable build outputs to GitHub Pages from qualifying runs of `.github/workflows/pages.yml`. +The workflow builds maintained MkDocs documentation and the generated model catalog from the staged source tree under `build/mkdocs-source/`. It then merges the rendered site into the separate `gh-pages` publication worktree while preserving `builds/`. The main branch stores neither generated Markdown nor rendered site output. The publication retains the ten newest numbered report sets and maintains `builds/latest/` as a stable alias. + This page is the central entry point for published project artifacts, including build summaries, API documentation, test and quality reports, benchmark outputs, and software composition materials. It is intended both for routine project inspection and for linking stable report surfaces from external references such as the README, release notes, or development workflows. ## Stable entry points diff --git a/docs/stemmer-models.md b/docs/stemmer-models.md new file mode 100644 index 0000000..3e29d53 --- /dev/null +++ b/docs/stemmer-models.md @@ -0,0 +1,192 @@ +# Stemmer Models + +This page defines the model artifact and its maintenance lifecycle. Application developers should begin with [Model Selection and Loading](model-selection-and-loading.md); the generated [model catalog](stemmer-model-catalog.md) is the detailed inventory. + +## Terminology + +| Term | Definition | +|---|---| +| Radixor core | Java parsing, patch-command, trie, registry, descriptor, and loader code in `org.egothor:radixor` | +| Language | Locale-level identity such as `PL_PL`; not a dictionary or model | +| Model ID | Stable identity of one concrete model, such as `pl-pl-unimorph` | +| Model artifact | Independently versioned JAR containing one descriptor, one runtime dictionary, and licensing material | +| Source dictionary | Upstream lexical or morphological source recorded in provenance | +| Runtime dictionary | GZip-compressed UTF-8 Radixor tab-separated data consumed during trie construction | +| Compiled trie | In-memory lookup structure built by the loader; not the `stemmer.gz` resource | +| Default model | Stable ID selected by a language-oriented loader call | +| Optional model | Discoverable only when installed and selected explicitly; PoliMorf is optional for Polish | + +Core version, model artifact version, catalog version, source dictionary version, and model format version are separate compatibility axes. Updating Java code need not republish unchanged model bytes; updating one model need not release core or every other model. + +## Model artifact identity and layout + +A module named `models/` publishes: + +```text +org.egothor:radixor-model-: +``` + +The built PoliMorf JAR has this effective tree: + +```text +META-INF/ + LICENSES/PoliMorf-BSD-2-Clause.txt + MANIFEST.MF + radixor/ + models.index + models/pl-pl-polimorf.properties +org/egothor/stemmer/models/pl-pl-polimorf/stemmer.gz +``` + +Each UniMorph-derived model instead contains one model-specific +`META-INF/NOTICE/-data.txt`. That notice records the upstream attribution, the Radixor +transformations and contribution statement, the ShareAlike distribution terms, and the canonical +CC BY-SA 3.0 URI. The repository has no root CC license directory because CC BY-SA applies to +these model-data artifacts, not to the BSD-3-Clause Radixor Java software. PoliMorf retains only +its BSD-2-Clause data license. + +`models.index` contains the descriptor path. The descriptor contains the exact resource path. No Java provider class is required, and model modules do not compile against a core API. + +## Discovery and integrity + +`StemmerModelRegistry` asks the selected `ClassLoader` for every `META-INF/radixor/models.index`. It sorts index URLs, validates each non-comment entry, loads the named descriptors, sorts descriptors by model ID, and rejects duplicate IDs. It does not scan arbitrary JAR entries. + +Descriptor parsing verifies: + +- the model-ID syntax; +- required nonblank runtime properties; +- a known `Language` enum name; +- format `radixor-dictionary-tsv-gzip` and format version `1`; +- the exact namespaced resource path; +- presence of the runtime resource; +- a lowercase 64-character SHA-256 value. + +Loading then reads the compressed resource bytes through the descriptor's discovering class loader, compares their SHA-256 digest, opens GZip, parses UTF-8 Radixor dictionary rows, and constructs a trie. Duplicate-ID and checksum checks make selection independent of classpath order. + +## Descriptor fields + +The convention plugin generates these fields: + +| Property | Role | Meaning | +|---|---|---| +| `model.id` | Authoritative runtime identity | Stable model ID | +| `model.version` | Authoritative artifact identity | Independently managed model version | +| `model.language` | Authoritative selection metadata | Existing `Language` enum value | +| `model.displayName` | Display metadata | Human-readable name | +| `model.resource` | Authoritative loading metadata | Namespaced GZip resource | +| `model.default` | Catalog/build declaration | Whether the module declares itself a default; runtime language selection uses `Language.defaultModelId()` | +| `model.format` | Authoritative compatibility metadata | `radixor-dictionary-tsv-gzip` | +| `model.formatVersion` | Authoritative compatibility metadata | Currently `1` | +| `model.sha256` | Authoritative integrity metadata | Digest of the compressed source bytes | +| `model.rightToLeft` | Processing metadata | Language direction recorded by the build | +| `model.caseProcessing` | Processing metadata | `LOWERCASE_WITH_LOCALE_ROOT` | +| `model.diacriticProcessing` | Processing metadata | `AS_IS` | +| `model.storeOriginal` | Processing metadata | Currently `true` | +| `source.name` | Provenance | Source dictionary name | +| `source.version` | Provenance | Upstream version or the legacy-import sentinel | +| `source.project` | Provenance | Upstream project | +| `source.repository` | Provenance | Official language repository | +| `source.dataset` | Provenance | Upstream dataset and lexical-source identity | +| `source.revision` | Provenance | Exact revision or `not-recorded-in-legacy-import` | +| `source.revisionStatus` | Provenance | `recorded` or `not-recorded-in-legacy-import` | +| `source.license` | Provenance | SPDX or project license reference | +| `source.licenseUri` | Provenance | Canonical license URI | +| `source.attribution` | Provenance | Attribution supplied by the official source | +| `source.verificationDate` | Provenance | Date the maintained upstream information was checked | +| `transformations.summary` | Provenance | Material Radixor conversion operations | +| `compiler.radixorVersion` | Provenance | Compiler lineage recorded by the plugin | +| `compiler.radixorCommit` | Provenance | Commit when available; currently `unavailable` | +| `statistics.groups` | Provenance/statistics | Currently `unavailable` | +| `statistics.forms` | Provenance/statistics | Currently `unavailable` | + +The current registry consumes the authoritative `model.*` identity, format, resource, and checksum fields. Processing and provenance fields remain packaged for audit and catalog generation but are not all exposed as typed `StemmerModelDescriptor` accessors. The generated catalog is the supported documentation view of source name, version, license, checksum, and size. + +## Immutable input to runtime model + +The packaging sequence is: + +```text +models//src/modelInput/stemmer.gz + -> validate GZip, strict UTF-8, rows, metadata, version, and license + -> copy identical bytes into build/generated/modelResources + -> generate descriptor, index, and packaged license + -> package radixor-model--.jar + -> discover from the application's runtime classpath + -> verify checksum, parse dictionary, and build a trie +``` + +Application runtime never reads `src/modelInput` from a source checkout. + +For PoliMorf, the immutable input is exactly: + +`models/pl-pl-polimorf/src/modelInput/stemmer.gz` + +Its required upstream license is: + +`models/pl-pl-polimorf/src/modelInput/LICENSE-BSD-2-Clause.txt` + +The final runtime resource is exactly: + +`org/egothor/stemmer/models/pl-pl-polimorf/stemmer.gz` + +## Aggregate projects + +| Project | Published coordinate | Contents and purpose | +|---|---|---| +| `models/standard` | `org.egothor:radixor-models-standard:` | POM-only aggregate with one transitive runtime default per language; excludes PoliMorf | +| `models/bom` | `org.egothor:radixor-models-bom:` | POM-only Maven dependency-management constraints for all individual published model versions | + +Neither catalog artifact publishes a binary, sources, or Javadoc JAR. The standard aggregate resolves model JARs because its POM contains runtime dependencies. Importing the BOM only manages versions and resolves no model by itself. JMH, tests, and quality evaluation depend directly on individual model projects through non-production Gradle configurations. + +The Maven dependency BOM is not a software bill of materials. The root `cyclonedxDirectBom` task generates the project-wide CycloneDX SBOM under `build/reports/sbom/`; it does not write into `models/bom/build/`. + +`models/build/` is an ignored Gradle output directory for the implicit lifecycle parent `:models`, not a source module. CycloneDX direct tasks exposed on subprojects by the root plugin are disabled, so the supported build does not write an SBOM there. Aggregate model reports are owned by the root project under `build/reports/models/`; individual model reports and publication files stay under `models//build/`. + +## Create or update a model module + +1. Choose a stable lowercase model ID matching the module directory. +2. Add `models//model-version.txt`; do not derive it from core. +3. Apply `org.egothor.radixor.model` in the module build script. +4. Declare `modelId`, `language`, `displayName`, `defaultModel`, repository, dataset, revision and status, license URI, attribution, verification date, and transformations. +5. Put immutable `stemmer.gz` and a model-specific `NOTICE-model-data.txt` under `src/modelInput/`. The notice must identify the applicable data license and canonical URI, upstream attribution, transformations, and derived-data contributions without implying that the core software uses that license. +6. Add the module ID and its `default` or `optional` build-topology role to `models/model-projects.properties`. `settings.gradle`, verification, standard membership, BOM constraints, tests, and JMH all consume that list; descriptor metadata remains authoritative for model identity and language properties. +7. Run: + +```bash +./gradlew --no-daemon :models::validateModelInput +./gradlew --no-daemon :models::prepareModelResources +./gradlew --no-daemon :models::verifyModelDescriptor +./gradlew --no-daemon :models::verifyModelJar +./gradlew --no-daemon :models::check +./gradlew --no-daemon runtimeModelIntegrationTest -PmodelId= +``` + +Validation fails for missing inputs, notices, attribution, repository, revision status, Radixor contribution and transformation disclosures, ShareAlike and no-endorsement statements, notice byte identity, unsafe or mismatched ID, invalid semantic version, invalid GZip/UTF-8, invalid dictionary rows, checksum mismatch, wrong packaged path, duplicate dictionaries, or dictionaries in sources/Javadoc artifacts. The explicit legacy revision sentinel is valid; an absent revision or status is not. The PoliMorf module separately validates its complete BSD-2-Clause license and attribution. + +Copying an arbitrary `stemmer.gz` into an application is insufficient: registry discovery requires an index, a valid descriptor, namespaced resource, checksum, version, language, format declaration, and licensing material. + +## Release boundaries + +| Tag | Publishes | Does not publish | +|---|---|---| +| `release@` | Root `org.egothor:radixor` software artifacts | Model JARs, standard pack, or BOM | +| `model/@` | Exactly the matching independently versioned model | Core, other models, standard pack, BOM, JMH, or full quality suite | +| `models-catalog@` | Standard aggregate and models BOM | Individual model JARs or core | + +Local validation for PoliMorf 1.0.0 is: + +```bash +./tools/parse-model-release-tag.sh "model/pl-pl-polimorf@1.0.0" . +./gradlew --no-daemon :models:pl-pl-polimorf:check +./gradlew --no-daemon runtimeModelIntegrationTest -PmodelId=pl-pl-polimorf +./gradlew --no-daemon :models:pl-pl-polimorf:validateModelRelease \ + -PmodelReleaseVersion=1.0.0 +./gradlew --no-daemon :models:pl-pl-polimorf:packageModelReleaseCandidate \ + -PmodelReleaseVersion=1.0.0 +``` + +`runtimeModelIntegrationTest` uses an isolated JVM, defaults to a 6 GiB maximum heap, and can be overridden with `-PradixorLargeModelMaxHeap=10g`. For PoliMorf, `validateModelRelease` depends on this complete runtime construction and real stemming smoke verification in addition to descriptor, checksum, license, and package validation. The generic release workflow still selects and publishes only the requested model. The commands above are local validation only; repository owners control tags and publication. + +## Documentation and troubleshooting + +`prepareMkDocsSource` generates the catalog only at `build/mkdocs-source/stemmer-model-catalog.md`; generated Markdown and rendered site content are not tracked. For runtime failures, dependency inspection, ClassLoader isolation, and fat-JAR guidance, see [Model Selection and Loading](model-selection-and-loading.md#troubleshooting). diff --git a/docs/stemming-quality.md b/docs/stemming-quality.md index 0cc7144..4e05a14 100644 --- a/docs/stemming-quality.md +++ b/docs/stemming-quality.md @@ -1,12 +1,16 @@ # Stemming quality evaluation -The explicit `stemmingQuality` analysis measures agreement between stemmer outputs and gold-standard equivalence classes represented by bundled multilingual dictionary rows. Dictionary text remains unchanged; reports and diagnostics use English. +The explicit `stemmingQuality` analysis measures agreement between stemmer outputs and gold-standard equivalence classes represented by registered multilingual model dictionary rows. Dictionary text remains unchanged; reports and diagnostics use English. JMH adapters, registries, third-party versions, language mappings, and preparation remain in `src/jmh`. The evaluator, reports, audits, and tests reside in the standard `src/test` source set. The former `src/stemmingQualityTest` source set was removed, and neither analytical nor JMH classes enter the production JAR. ## Language and adapter coverage -The authoritative Radixor universe is the validated one-to-one reconciliation of `src/main/resources/*/stemmer.gz` and every `StemmerPatchTrieLoader.Language` value. All 20 current values have exactly one resource; no sentinel or alias is excluded. Radixor is evaluated for all 20 languages, independently of third-party support. Third-party combinations come only from explicit JMH adapter metadata. Unsupported combinations are documented and never fabricated as zero-valued rows. +The authoritative Radixor universe is the validated one-to-one reconciliation of every `StemmerPatchTrieLoader.Language` value with its registered default model descriptor. All 20 current values have exactly one documented default. Optional comparison models, including `pl-pl-polimorf`, are identified separately and never replace default benchmark rows. Third-party combinations come only from explicit JMH adapter metadata. + +Default Polish evaluation is therefore `Radixor` with model `pl-pl-unimorph`. A future PoliMorf evaluation is a distinct `Radixor` / `pl-pl-polimorf` row. Evaluation classpaths receive individual models through direct non-production Gradle dependencies; ordinary applications inherit none of them from the core. + +Complete PoliMorf trie construction and deterministic stemming smoke fixtures are runtime-verified separately. That functional verification is not a linguistic-quality measurement and does not justify rewriting the historical quality snapshot. The expected matrix is constructed before evaluation from stemmer, language, dictionary mode, and supported output policy. Generation fails on missing, duplicate, unexpected, or stale keys. @@ -80,3 +84,4 @@ Generated files under `build/reports/stemming-quality/` include `stemming-qualit ## Limitations These measurements evaluate agreement with the available dictionary grouping. They do not capture every semantic, morphological, downstream, or dataset-specific property. `ANY_CANDIDATE` is optimistic and may not be globally realizable. `ALL_CANDIDATES` measures an overlap graph rather than a partition. Language coverage must remain visible in cross-stemmer comparisons. No single published metric establishes universal superiority; multiple metrics and their correlations are provided for transparent scientific assessment. +Historical checked-in quality results retain their original inputs and claims. The optional PoliMorf model is not attributed to snapshots that predate it. See [Model Selection and Loading](model-selection-and-loading.md) and the generated [model catalog](stemmer-model-catalog.md). diff --git a/gradle/java-license-header.txt b/gradle/java-license-header.txt new file mode 100644 index 0000000..9bd8404 --- /dev/null +++ b/gradle/java-license-header.txt @@ -0,0 +1,30 @@ +/******************************************************************************* + * Copyright (C) 2026, Leo Galambos + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. Neither the name of the copyright holder nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + ******************************************************************************/ diff --git a/gradle/maven-pom.gradle b/gradle/maven-pom.gradle index c7a8801..049fd57 100644 --- a/gradle/maven-pom.gradle +++ b/gradle/maven-pom.gradle @@ -51,11 +51,6 @@ publishing { url = pomLicenseUrl distribution = pomLicenseDistribution } - license { - name = pomStemmerDataLicenseName - url = pomStemmerDataLicenseUrl - distribution = pomLicenseDistribution - } } developers { @@ -104,8 +99,6 @@ tasks.register('validateReleaseMetadata') { if (pomScmDeveloperConnection == null || pomScmDeveloperConnection.isBlank()) missing.add('pomScmDeveloperConnection') if (pomLicenseName == null || pomLicenseName.isBlank()) missing.add('pomLicenseName') if (pomLicenseUrl == null || pomLicenseUrl.isBlank()) missing.add('pomLicenseUrl') - if (pomStemmerDataLicenseName == null || pomStemmerDataLicenseName.isBlank()) missing.add('pomStemmerDataLicenseName') - if (pomStemmerDataLicenseUrl == null || pomStemmerDataLicenseUrl.isBlank()) missing.add('pomStemmerDataLicenseUrl') if (signingKey == null || signingKey.isBlank()) missing.add('pomSigningKey / SIGNING_KEY') if (signingPassword == null || signingPassword.isBlank()) missing.add('pomSigningPassword / SIGNING_PASSWORD') diff --git a/gradle/paicehusk-benchmarks.gradle b/gradle/paicehusk-benchmarks.gradle index b21c903..7a6d3bc 100644 --- a/gradle/paicehusk-benchmarks.gradle +++ b/gradle/paicehusk-benchmarks.gradle @@ -120,6 +120,11 @@ def transformPaiceHuskSource = { final File sourceFile, final File rulesFile, fi transformedText = 'package org.egothor.stemmer.benchmark;' + '\n\n' + transformedText transformedText = transformedText.replaceFirst(/(?m)^\s*class\s+PaiceHusk\s*\{/, 'public final class PaiceHuskLancasterStemmer {') + transformedText = transformedText.replace('new Character(rule.letter)', 'Character.valueOf(rule.letter)') + transformedText = transformedText.replace('new Character(stem.charAt(stem.length() - 1))', + 'Character.valueOf(stem.charAt(stem.length() - 1))') + transformedText = transformedText.replaceFirst(/(?m)^(\s*)static HashMap loadRules\(/, + '$1@SuppressWarnings("unchecked")\n$1static HashMap loadRules(') final int packageEnd = transformedText.indexOf('\n', transformedText.indexOf('package org.egothor.stemmer.benchmark;')) if (packageEnd >= 0) { diff --git a/gradle/verification-metadata.xml b/gradle/verification-metadata.xml index 974560c..00ab5ab 100644 --- a/gradle/verification-metadata.xml +++ b/gradle/verification-metadata.xml @@ -248,11 +248,24 @@ + + + + + + + + + + + + + @@ -274,6 +287,14 @@ + + + + + + + + @@ -294,6 +315,11 @@ + + + + + @@ -524,11 +550,24 @@ + + + + + + + + + + + + + @@ -725,6 +764,11 @@ + + + + + @@ -995,6 +1039,11 @@ + + + + + @@ -1003,6 +1052,14 @@ + + + + + + + + @@ -1011,6 +1068,14 @@ + + + + + + + + @@ -1019,6 +1084,14 @@ + + + + + + + + @@ -1027,6 +1100,14 @@ + + + + + + + + @@ -1035,6 +1116,14 @@ + + + + + + + + @@ -1045,6 +1134,11 @@ + + + + + @@ -1053,6 +1147,14 @@ + + + + + + + + @@ -1061,6 +1163,14 @@ + + + + + + + + @@ -1069,6 +1179,14 @@ + + + + + + + + @@ -1077,6 +1195,14 @@ + + + + + + + + @@ -1085,6 +1211,14 @@ + + + + + + + + @@ -1244,6 +1378,11 @@ + + + + + @@ -1257,6 +1396,14 @@ + + + + + + + + @@ -1302,6 +1449,14 @@ + + + + + + + + @@ -1326,11 +1481,24 @@ + + + + + + + + + + + + + @@ -1558,6 +1726,14 @@ + + + + + + + + diff --git a/mkdocs.yml b/mkdocs.yml index 445b394..9920fe1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -45,6 +45,7 @@ nav: - Integration: - Overview: programmatic-usage.md + - Model Selection and Loading: model-selection-and-loading.md - Loading and Building Stemmers: programmatic-loading-and-building.md - Querying and Ambiguity Handling: programmatic-querying-and-ambiguity.md - Extending and Persisting Compiled Tries: programmatic-extending-and-persistence.md @@ -52,6 +53,8 @@ nav: - CLI Compilation: cli-compilation.md - Dictionaries and Languages: + - Stemmer Models: stemmer-models.md + - Published Model Catalog: stemmer-model-catalog.md - Built-in Languages: built-in-languages.md - Dictionary Format: dictionary-format.md - Contributing Dictionaries: contributing-dictionaries.md @@ -101,4 +104,5 @@ nav: - Quality and Operations: quality-and-operations.md - Stemming Quality: stemming-quality.md - Reports: reports.md + - Historical Builds: builds.md - Test taxonomy and execution filtering: test-taxonomy-and-filtering.md diff --git a/models/bom/build.gradle b/models/bom/build.gradle new file mode 100644 index 0000000..9a32782 --- /dev/null +++ b/models/bom/build.gradle @@ -0,0 +1,101 @@ +import groovy.xml.XmlParser + +plugins { + id 'java-platform' + id 'maven-publish' + id 'signing' +} + +group = 'org.egothor' +version = providers.fileContents(rootProject.layout.projectDirectory.file('models/catalog-version.txt')) + .asText.map(String::trim).get() + +Properties modelTopology = new Properties() +rootProject.file('models/model-projects.properties').withInputStream { InputStream input -> + modelTopology.load(input) +} +List modelIds = modelTopology.stringPropertyNames().toList().sort() + +dependencies { + constraints { + modelIds.each { String modelId -> + api project(":models:${modelId}") + } + } +} + +publishing { + publications { + bom(MavenPublication) { + from components.javaPlatform + artifactId = 'radixor-models-bom' + pom { + name = 'Radixor Stemmer Models BOM' + description = 'Maven dependency-management BOM containing recommended versions for published Radixor models.' + packaging = 'pom' + url = 'https://github.com/leogalambos/Radixor' + licenses { + license { + name = 'BSD-3-Clause' + url = 'https://spdx.org/licenses/BSD-3-Clause.html' + distribution = 'repo' + } + } + developers { + developer { + id = 'egothor' + name = 'Leo Galambos' + email = 'egothor@gmail.com' + } + } + scm { + url = 'https://github.com/leogalambos/Radixor' + connection = 'scm:git:https://github.com/leogalambos/Radixor.git' + developerConnection = 'scm:git:ssh://git@github.com/leogalambos/Radixor.git' + } + } + } + } + repositories { + maven { + name = 'catalogStaging' + url = rootProject.layout.buildDirectory.dir('model-catalog-staging-repository').get().asFile.toURI() + } + } +} + +String signingKey = providers.environmentVariable('SIGNING_KEY').orNull +String signingPassword = providers.environmentVariable('SIGNING_PASSWORD').orNull +signing { + required = { providers.environmentVariable('GITHUB_REF_TYPE').orNull == 'tag' } + if (signingKey != null && !signingKey.isBlank()) { + useInMemoryPgpKeys(signingKey, signingPassword) + sign publishing.publications.bom + } +} + +tasks.register('verifyPomOnlyPlatform') { + group = 'verification' + description = 'Verifies the POM-only model dependency-management platform.' + dependsOn(tasks.named('generatePomFileForBomPublication')) + doLast { + File pomFile = layout.buildDirectory.file('publications/bom/pom-default.xml').get().asFile + Node pom = new XmlParser().parse(pomFile) + List constraints = pom.dependencyManagement.dependencies.dependency as List + List artifactIds = constraints.collect { Node dependency -> dependency.artifactId.text() } + List expected = modelIds.collect { String modelId -> "radixor-model-${modelId}" } + if (pom.packaging.text() != 'pom' || artifactIds != expected) { + throw new GradleException('radixor-models-bom must publish exactly the ordered model constraints as Maven packaging pom.') + } + if (!pom.dependencies.isEmpty()) { + throw new GradleException('radixor-models-bom must not introduce runtime model dependencies.') + } + if (!tasks.withType(Jar).isEmpty()) { + throw new GradleException('radixor-models-bom must not create binary, sources, or Javadoc JARs.') + } + } +} + +tasks.named('check') { + dependsOn(tasks.named('verifyPomOnlyPlatform')) +} diff --git a/models/catalog-version.txt b/models/catalog-version.txt new file mode 100644 index 0000000..6033ed8 --- /dev/null +++ b/models/catalog-version.txt @@ -0,0 +1 @@ +2026.1 diff --git a/models/cs-cz-default/build.gradle b/models/cs-cz-default/build.gradle new file mode 100644 index 0000000..887efad --- /dev/null +++ b/models/cs-cz-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'cs-cz-default' + language = 'CS_CZ' + displayName = 'Czech default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/ces' + sourceDataset = 'UniMorph Czech morphological dataset (`ces`); repository also documents non-distributed MorfFlex-CZ data' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph; Witold Kieraś is credited for the separate MorfFlex-CZ conversion' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/cs-cz-default/model-version.txt b/models/cs-cz-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/cs-cz-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/cs-cz-default/src/modelInput/NOTICE-model-data.txt b/models/cs-cz-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..5a0bd31 --- /dev/null +++ b/models/cs-cz-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: cs-cz-default +Radixor language: CS_CZ +Source project: UniMorph +Official repository: https://github.com/unimorph/ces +Upstream dataset: UniMorph Czech morphological dataset (`ces`); repository also documents non-distributed MorfFlex-CZ data +Upstream lexical source: Wiktionary; the CC BY-NC-SA MorfFlex-CZ dataset is excluded +Attribution: UniMorph; Witold Kieraś is credited for the separate MorfFlex-CZ conversion +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/cs_cz/stemmer.gz b/models/cs-cz-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/cs_cz/stemmer.gz rename to models/cs-cz-default/src/modelInput/stemmer.gz diff --git a/models/da-dk-default/build.gradle b/models/da-dk-default/build.gradle new file mode 100644 index 0000000..8b57e87 --- /dev/null +++ b/models/da-dk-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'da-dk-default' + language = 'DA_DK' + displayName = 'Danish default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/dan' + sourceDataset = 'UniMorph Danish morphological dataset (`dan`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/da-dk-default/model-version.txt b/models/da-dk-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/da-dk-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/da-dk-default/src/modelInput/NOTICE-model-data.txt b/models/da-dk-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..2467700 --- /dev/null +++ b/models/da-dk-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: da-dk-default +Radixor language: DA_DK +Source project: UniMorph +Official repository: https://github.com/unimorph/dan +Upstream dataset: UniMorph Danish morphological dataset (`dan`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/da_dk/stemmer.gz b/models/da-dk-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/da_dk/stemmer.gz rename to models/da-dk-default/src/modelInput/stemmer.gz diff --git a/models/de-de-default/build.gradle b/models/de-de-default/build.gradle new file mode 100644 index 0000000..4312802 --- /dev/null +++ b/models/de-de-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'de-de-default' + language = 'DE_DE' + displayName = 'German default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/deu' + sourceDataset = 'UniMorph German morphological dataset (`deu`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and English Wiktionary contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/de-de-default/model-version.txt b/models/de-de-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/de-de-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/de-de-default/src/modelInput/NOTICE-model-data.txt b/models/de-de-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..e7733f3 --- /dev/null +++ b/models/de-de-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: de-de-default +Radixor language: DE_DE +Source project: UniMorph +Official repository: https://github.com/unimorph/deu +Upstream dataset: UniMorph German morphological dataset (`deu`) +Upstream lexical source: English Wiktionary +Attribution: UniMorph and English Wiktionary contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/de_de/stemmer.gz b/models/de-de-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/de_de/stemmer.gz rename to models/de-de-default/src/modelInput/stemmer.gz diff --git a/models/es-es-default/build.gradle b/models/es-es-default/build.gradle new file mode 100644 index 0000000..657ff2e --- /dev/null +++ b/models/es-es-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'es-es-default' + language = 'ES_ES' + displayName = 'Spanish default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/spa' + sourceDataset = 'UniMorph Spanish morphological dataset (`spa`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and English Wiktionary contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/es-es-default/model-version.txt b/models/es-es-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/es-es-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/es-es-default/src/modelInput/NOTICE-model-data.txt b/models/es-es-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..5e9e1f2 --- /dev/null +++ b/models/es-es-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: es-es-default +Radixor language: ES_ES +Source project: UniMorph +Official repository: https://github.com/unimorph/spa +Upstream dataset: UniMorph Spanish morphological dataset (`spa`) +Upstream lexical source: English Wiktionary +Attribution: UniMorph and English Wiktionary contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/es_es/stemmer.gz b/models/es-es-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/es_es/stemmer.gz rename to models/es-es-default/src/modelInput/stemmer.gz diff --git a/models/fa-ir-default/build.gradle b/models/fa-ir-default/build.gradle new file mode 100644 index 0000000..e3a2a93 --- /dev/null +++ b/models/fa-ir-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'fa-ir-default' + language = 'FA_IR' + displayName = 'Persian default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/fas' + sourceDataset = 'UniMorph Persian morphological dataset (`fas`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/fa-ir-default/model-version.txt b/models/fa-ir-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/fa-ir-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/fa-ir-default/src/modelInput/NOTICE-model-data.txt b/models/fa-ir-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..92f065b --- /dev/null +++ b/models/fa-ir-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: fa-ir-default +Radixor language: FA_IR +Source project: UniMorph +Official repository: https://github.com/unimorph/fas +Upstream dataset: UniMorph Persian morphological dataset (`fas`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/fa_ir/stemmer.gz b/models/fa-ir-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/fa_ir/stemmer.gz rename to models/fa-ir-default/src/modelInput/stemmer.gz diff --git a/models/fi-fi-default/build.gradle b/models/fi-fi-default/build.gradle new file mode 100644 index 0000000..7602b05 --- /dev/null +++ b/models/fi-fi-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'fi-fi-default' + language = 'FI_FI' + displayName = 'Finnish default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/fin' + sourceDataset = 'UniMorph Finnish morphological dataset (`fin`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/fi-fi-default/model-version.txt b/models/fi-fi-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/fi-fi-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/fi-fi-default/src/modelInput/NOTICE-model-data.txt b/models/fi-fi-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..6ef855e --- /dev/null +++ b/models/fi-fi-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: fi-fi-default +Radixor language: FI_FI +Source project: UniMorph +Official repository: https://github.com/unimorph/fin +Upstream dataset: UniMorph Finnish morphological dataset (`fin`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/fi_fi/stemmer.gz b/models/fi-fi-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/fi_fi/stemmer.gz rename to models/fi-fi-default/src/modelInput/stemmer.gz diff --git a/models/fr-fr-default/build.gradle b/models/fr-fr-default/build.gradle new file mode 100644 index 0000000..55f2b4c --- /dev/null +++ b/models/fr-fr-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'fr-fr-default' + language = 'FR_FR' + displayName = 'French default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/fra' + sourceDataset = 'UniMorph French morphological dataset (`fra`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/fr-fr-default/model-version.txt b/models/fr-fr-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/fr-fr-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/fr-fr-default/src/modelInput/NOTICE-model-data.txt b/models/fr-fr-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..6591afc --- /dev/null +++ b/models/fr-fr-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: fr-fr-default +Radixor language: FR_FR +Source project: UniMorph +Official repository: https://github.com/unimorph/fra +Upstream dataset: UniMorph French morphological dataset (`fra`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/fr_fr/stemmer.gz b/models/fr-fr-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/fr_fr/stemmer.gz rename to models/fr-fr-default/src/modelInput/stemmer.gz diff --git a/models/he-il-default/build.gradle b/models/he-il-default/build.gradle new file mode 100644 index 0000000..ff0c6b3 --- /dev/null +++ b/models/he-il-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'he-il-default' + language = 'HE_IL' + displayName = 'Hebrew default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/heb' + sourceDataset = 'UniMorph Hebrew morphological dataset (`heb`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph; Omer Goldman (annotator); Wiktionary contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/he-il-default/model-version.txt b/models/he-il-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/he-il-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/he-il-default/src/modelInput/NOTICE-model-data.txt b/models/he-il-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..483c368 --- /dev/null +++ b/models/he-il-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: he-il-default +Radixor language: HE_IL +Source project: UniMorph +Official repository: https://github.com/unimorph/heb +Upstream dataset: UniMorph Hebrew morphological dataset (`heb`) +Upstream lexical source: Wiktionary +Attribution: UniMorph; Omer Goldman (annotator); Wiktionary contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/he_il/stemmer.gz b/models/he-il-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/he_il/stemmer.gz rename to models/he-il-default/src/modelInput/stemmer.gz diff --git a/models/hu-hu-default/build.gradle b/models/hu-hu-default/build.gradle new file mode 100644 index 0000000..9f96807 --- /dev/null +++ b/models/hu-hu-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'hu-hu-default' + language = 'HU_HU' + displayName = 'Hungarian default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/hun' + sourceDataset = 'UniMorph Hungarian morphological dataset (`hun`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph; Christo Kirov, Ryan Cotterell, and Khuyagbaatar Batsuren (conversion); Judit Ács and Gábor Bella (validation); English Wiktionary contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/hu-hu-default/model-version.txt b/models/hu-hu-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/hu-hu-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/hu-hu-default/src/modelInput/NOTICE-model-data.txt b/models/hu-hu-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..a0327e6 --- /dev/null +++ b/models/hu-hu-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: hu-hu-default +Radixor language: HU_HU +Source project: UniMorph +Official repository: https://github.com/unimorph/hun +Upstream dataset: UniMorph Hungarian morphological dataset (`hun`) +Upstream lexical source: English Wiktionary +Attribution: UniMorph; Christo Kirov, Ryan Cotterell, and Khuyagbaatar Batsuren (conversion); Judit Ács and Gábor Bella (validation); English Wiktionary contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/hu_hu/stemmer.gz b/models/hu-hu-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/hu_hu/stemmer.gz rename to models/hu-hu-default/src/modelInput/stemmer.gz diff --git a/models/it-it-default/build.gradle b/models/it-it-default/build.gradle new file mode 100644 index 0000000..b7776e4 --- /dev/null +++ b/models/it-it-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'it-it-default' + language = 'IT_IT' + displayName = 'Italian default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/ita' + sourceDataset = 'UniMorph Italian morphological dataset (`ita`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/it-it-default/model-version.txt b/models/it-it-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/it-it-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/it-it-default/src/modelInput/NOTICE-model-data.txt b/models/it-it-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..7ce8c6f --- /dev/null +++ b/models/it-it-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: it-it-default +Radixor language: IT_IT +Source project: UniMorph +Official repository: https://github.com/unimorph/ita +Upstream dataset: UniMorph Italian morphological dataset (`ita`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/it_it/stemmer.gz b/models/it-it-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/it_it/stemmer.gz rename to models/it-it-default/src/modelInput/stemmer.gz diff --git a/models/model-projects.properties b/models/model-projects.properties new file mode 100644 index 0000000..6511de4 --- /dev/null +++ b/models/model-projects.properties @@ -0,0 +1,22 @@ +# Build-topology membership only. Per-model metadata remains authoritative. +cs-cz-default=default +da-dk-default=default +de-de-default=default +es-es-default=default +fa-ir-default=default +fi-fi-default=default +fr-fr-default=default +he-il-default=default +hu-hu-default=default +it-it-default=default +nb-no-default=default +nl-nl-default=default +nn-no-default=default +pl-pl-polimorf=optional +pl-pl-unimorph=default +pt-pt-default=default +ru-ru-default=default +sv-se-default=default +uk-ua-default=default +us-uk-default=default +yi-default=default diff --git a/models/nb-no-default/build.gradle b/models/nb-no-default/build.gradle new file mode 100644 index 0000000..761a0dd --- /dev/null +++ b/models/nb-no-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'nb-no-default' + language = 'NB_NO' + displayName = 'Norwegian Bokmål default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/nob' + sourceDataset = 'UniMorph Norwegian Bokmål morphological dataset (`nob`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/nb-no-default/model-version.txt b/models/nb-no-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/nb-no-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/nb-no-default/src/modelInput/NOTICE-model-data.txt b/models/nb-no-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..436f4b8 --- /dev/null +++ b/models/nb-no-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: nb-no-default +Radixor language: NB_NO +Source project: UniMorph +Official repository: https://github.com/unimorph/nob +Upstream dataset: UniMorph Norwegian Bokmål morphological dataset (`nob`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/nb_no/stemmer.gz b/models/nb-no-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/nb_no/stemmer.gz rename to models/nb-no-default/src/modelInput/stemmer.gz diff --git a/models/nl-nl-default/build.gradle b/models/nl-nl-default/build.gradle new file mode 100644 index 0000000..901983b --- /dev/null +++ b/models/nl-nl-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'nl-nl-default' + language = 'NL_NL' + displayName = 'Dutch default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/nld' + sourceDataset = 'UniMorph Dutch morphological dataset (`nld`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/nl-nl-default/model-version.txt b/models/nl-nl-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/nl-nl-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/nl-nl-default/src/modelInput/NOTICE-model-data.txt b/models/nl-nl-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..42b9f7f --- /dev/null +++ b/models/nl-nl-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: nl-nl-default +Radixor language: NL_NL +Source project: UniMorph +Official repository: https://github.com/unimorph/nld +Upstream dataset: UniMorph Dutch morphological dataset (`nld`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/nl_nl/stemmer.gz b/models/nl-nl-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/nl_nl/stemmer.gz rename to models/nl-nl-default/src/modelInput/stemmer.gz diff --git a/models/nn-no-default/build.gradle b/models/nn-no-default/build.gradle new file mode 100644 index 0000000..a992d11 --- /dev/null +++ b/models/nn-no-default/build.gradle @@ -0,0 +1,23 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'nn-no-default' + language = 'NN_NO' + displayName = 'Norwegian Nynorsk default model' + defaultModel = true + sourceName = 'UniMorph' + sourceVersion = 'not-recorded-in-legacy-import' + sourceRevision = 'not-recorded-in-legacy-import' + sourceProject = 'UniMorph' + sourceRepository = 'https://github.com/unimorph/nno' + sourceDataset = 'UniMorph Norwegian Nynorsk morphological dataset (`nno`)' + sourceRevisionStatus = 'not-recorded-in-legacy-import' + sourceLicense = 'CC-BY-SA-3.0' + sourceLicenseUri = 'https://creativecommons.org/licenses/by-sa/3.0/' + sourceAttribution = 'UniMorph and Wikipedia contributors' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + noticeFileName = 'NOTICE-model-data.txt' +} diff --git a/models/nn-no-default/model-version.txt b/models/nn-no-default/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/nn-no-default/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/nn-no-default/src/modelInput/NOTICE-model-data.txt b/models/nn-no-default/src/modelInput/NOTICE-model-data.txt new file mode 100644 index 0000000..cc81eeb --- /dev/null +++ b/models/nn-no-default/src/modelInput/NOTICE-model-data.txt @@ -0,0 +1,38 @@ +Radixor model-data notice + +Radixor-derived model data + +Copyright (C) 2026, Leo Galambos. + +Copyright and, where applicable, database rights are claimed in the +Radixor-specific selection, verification, cleaning, normalization, +grouping, deduplication, filtering, reformatting, metadata preparation, +and packaging of this model, to the extent protected by applicable law. + +The underlying morphological data remains attributed to UniMorph and +the upstream contributors identified in this notice. + +This derived model data, including Radixor's protectable contributions, +is distributed under Creative Commons Attribution-ShareAlike 3.0 +Unported. + +Model ID: nn-no-default +Radixor language: NN_NO +Source project: UniMorph +Official repository: https://github.com/unimorph/nno +Upstream dataset: UniMorph Norwegian Nynorsk morphological dataset (`nno`) +Upstream lexical source: Wikipedia +Attribution: UniMorph and Wikipedia contributors +License: +Creative Commons Attribution-ShareAlike 3.0 Unported +Canonical license URI: https://creativecommons.org/licenses/by-sa/3.0/ +Source revision: not-recorded-in-legacy-import +Revision status: not-recorded-in-legacy-import + +The exact UniMorph commit used for the original Radixor import was not recorded. The model remains attributed to the official UniMorph language repository and is distributed under the repository's stated data license. + +Radixor modifications: Cleaning, normalization, grouping inflected forms by lemma, deduplication, filtering invalid rows, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata. + +The derived model data is distributed under CC BY-SA 3.0. UniMorph supplies morphological data; Radixor constructs its own patch-command trie at runtime. Neither UniMorph nor any upstream contributor endorses Radixor. + +Upstream information verified: 2026-07-22 diff --git a/src/main/resources/nn_no/stemmer.gz b/models/nn-no-default/src/modelInput/stemmer.gz similarity index 100% rename from src/main/resources/nn_no/stemmer.gz rename to models/nn-no-default/src/modelInput/stemmer.gz diff --git a/models/pl-pl-polimorf/build.gradle b/models/pl-pl-polimorf/build.gradle new file mode 100644 index 0000000..df981c3 --- /dev/null +++ b/models/pl-pl-polimorf/build.gradle @@ -0,0 +1,27 @@ +plugins { + id 'org.egothor.radixor.model' +} + +radixorModel { + modelId = 'pl-pl-polimorf' + language = 'PL_PL' + displayName = 'Polish — PoliMorf 2.1' + defaultModel = false + sourceName = 'PoliMorf 2.1' + sourceVersion = '2.1' + sourceRevision = '6e63b53' + sourceProject = 'Morfologik' + sourceRepository = 'https://github.com/morfologik/morfologik-stemming' + sourceDataset = 'PoliMorf 2.1 from org.carrot2:morfologik-polish:2.1.9' + sourceRevisionStatus = 'recorded' + sourceLicense = 'BSD-2-Clause' + sourceLicenseUri = 'https://spdx.org/licenses/BSD-2-Clause.html' + sourceAttribution = 'Copyright (c) 2016, Marcin Miłkowski' + sourceVerificationDate = '2026-07-22' + transformationsSummary = 'Decoding the compiled FSA dictionary, grouping inflected forms by lemma, removing morphosyntactic tags, exact duplicate removal, deterministic sorting, reformatting into Radixor dictionary groups, GZip packaging, and generation of runtime descriptor and checksum metadata' + licenseFileName = 'LICENSE-BSD-2-Clause.txt' +} + +tasks.named('validateModelRelease') { + dependsOn(rootProject.tasks.named('runtimeModelIntegrationTest')) +} diff --git a/models/pl-pl-polimorf/model-version.txt b/models/pl-pl-polimorf/model-version.txt new file mode 100644 index 0000000..3eefcb9 --- /dev/null +++ b/models/pl-pl-polimorf/model-version.txt @@ -0,0 +1 @@ +1.0.0 diff --git a/models/pl-pl-polimorf/src/modelInput/LICENSE-BSD-2-Clause.txt b/models/pl-pl-polimorf/src/modelInput/LICENSE-BSD-2-Clause.txt new file mode 100644 index 0000000..f2b10b4 --- /dev/null +++ b/models/pl-pl-polimorf/src/modelInput/LICENSE-BSD-2-Clause.txt @@ -0,0 +1,38 @@ +Upstream artifact: org.carrot2:morfologik-polish:2.1.9 +Dictionary: PoliMorf 2.1 +Upstream build date: 2016-02-13 +Upstream dictionary revision: 6e63b53 + +Changes in this version: decoding of the compiled FSA dictionary, +grouping of inflected forms by lemma, removal of morphosyntactic tags, +exact duplicate removal, deterministic sorting, and conversion to the +Radixor tab-separated dictionary format. + +Modifications copyright (c) 2026 Leo Galambos. + +SPDX-License-Identifier: BSD-2-Clause + +Copyright (c) 2016, Marcin Miłkowski +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. diff --git a/models/pl-pl-polimorf/src/modelInput/stemmer.gz b/models/pl-pl-polimorf/src/modelInput/stemmer.gz new file mode 100644 index 0000000000000000000000000000000000000000..b04b1a47f0f757add85bb877f250bb58d8a3e553 GIT binary patch literal 12624997 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

    ?SdT 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