latex/latex-packages-build
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

add makefile in cache tests

Browse source 
Build branch master (b15dedb) from kesslermaximilian/LatexPackages
This commit is contained in:
Maximilian Keßler 2022-02-03 14:11:55 +00:00
parent 0febf65674
commit 5ca7c2e3f8
4 changed files with 496 additions and 117 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
build_info.json
View file

@ -1,8 +1,8 @@
{ {
"build_time": "", "build_time": "",
"source files": { "source files": {
"version": "v2.8.1-9-g4bda829", "version": "v2.8.2",
"commit": "4bda829518c07d985656547cf897712db361160e", "commit": "b15dedb36666df299d532ebacd861ff40858857b",
"dirty": false "dirty": false
}, },
"pytex": { "pytex": {
@ -352,6 +352,17 @@
"md5sum": "627dbd45b232b8bf570b7464bd4a2a81", "md5sum": "627dbd45b232b8bf570b7464bd4a2a81",
"dirty": false "dirty": false
}, },
{
"name": "wip/cache/mkessler-cache.sty",
"source file": "wip/cache/cache.pysty3",
"build time": "2022/02/03 14:11",
"source version": "v2.8.2",
"source commit hash": "b15dedb36666df299d532ebacd861ff40858857b",
"pytex version": "v1.2.0-31-gc9bb0e8",
"pytex commit hash": "c9bb0e87c91beae3e17a829603e4459cf804ec51",
"md5sum": "6ee0c2e6128d54b6743531b515d7c905",
"dirty": false
},
{ {
"name": "math/categories/mkessler-categories.sty", "name": "math/categories/mkessler-categories.sty",
"source file": "math/categories/categories.pysty3", "source file": "math/categories/categories.pysty3",
@ -410,23 +421,23 @@
{ {
"name": "environments/groupthm/groupthm.sty", "name": "environments/groupthm/groupthm.sty",
"source file": "environments/groupthm/groupthm.dtx", "source file": "environments/groupthm/groupthm.dtx",
"build time": "2022/01/30 23:48", "build time": "2022/02/03 14:11",
"source version": "v2.8.1-9-g4bda829", "source version": "v2.8.2",
"source commit hash": "4bda829518c07d985656547cf897712db361160e", "source commit hash": "b15dedb36666df299d532ebacd861ff40858857b",
"pytex version": "v1.2.0-31-gc9bb0e8", "pytex version": "v1.2.0-31-gc9bb0e8",
"pytex commit hash": "c9bb0e87c91beae3e17a829603e4459cf804ec51", "pytex commit hash": "c9bb0e87c91beae3e17a829603e4459cf804ec51",
"md5sum": "5e07a023a5aac2de1d23fe6467d72ff9", "md5sum": "f1cce2b87d3e6d2b320b84daece33f22",
"dirty": false "dirty": false
}, },
{ {
"name": "environments/fancythm/fancythm.sty", "name": "environments/fancythm/fancythm.sty",
"source file": "environments/fancythm/fancythm.dtx", "source file": "environments/fancythm/fancythm.dtx",
"build time": "2022/01/30 23:48", "build time": "2022/02/03 14:11",
"source version": "v2.8.1-9-g4bda829", "source version": "v2.8.2",
"source commit hash": "4bda829518c07d985656547cf897712db361160e", "source commit hash": "b15dedb36666df299d532ebacd861ff40858857b",
"pytex version": "v1.2.0-31-gc9bb0e8", "pytex version": "v1.2.0-31-gc9bb0e8",
"pytex commit hash": "c9bb0e87c91beae3e17a829603e4459cf804ec51", "pytex commit hash": "c9bb0e87c91beae3e17a829603e4459cf804ec51",
"md5sum": "607c774cd2cfd9efa081b6d3e2225481", "md5sum": "e659775e98a2451a69f4bf6ab66917f0",
"dirty": false "dirty": false
} }
] ]

7
environments/fancythm/fancythm.sty
View file

@ -184,7 +184,7 @@
} }
\tl_set:Nx \l__fancythm_name_tl \tl_set:Nx \l__fancythm_name_tl
{ {
\exp_not:N \__fancythm_translate:n { \tl_use:N \l__fancythm_name_tl } \exp_not:N \csname __fancythm_translate:n \exp_not:N \endcsname { \tl_use:N \l__fancythm_name_tl }
} }
} }
\cs_new:Npn \__fancythm_wrap_multiple:nnn #1 #2 #3 \cs_new:Npn \__fancythm_wrap_multiple:nnn #1 #2 #3
@ -209,11 +209,11 @@
{ {
\IfBooleanT { ####1 } \IfBooleanT { ####1 }
{ {
\groupthm_add_theorem_to_group:n { star } \AddTheoremToGroup { star }
} }
\IfBooleanT { ####2 } \IfBooleanT { ####2 }
{ {
\groupthm_add_theorem_to_group:n { dagger } \AddTheoremToGroup { dagger }
} }
} }
{ ##2 } { ##2 }
@ -379,6 +379,7 @@
\fancythm_provide_tiny_theorem:nn { } { reminder } \fancythm_provide_tiny_theorem:nn { } { reminder }
} }
} }
\DeclareHookRule { begindocument / before } { groupthm } { after } { fancythm }
\endinput \endinput
%% %%
%% End of file `fancythm.sty'. %% End of file `fancythm.sty'.

179
environments/groupthm/groupthm.sty
View file

@ -4,7 +4,7 @@
%% %%
%% The original source files were: %% The original source files were:
%% %%
%% groupthm.dtx (with options: `package') %% groupthm.dtx (with options: `package,benchmark')
%% %%
%% IMPORTANT NOTICE: %% IMPORTANT NOTICE:
%% %%
@ -21,13 +21,19 @@
%% same distribution. (The sources need not necessarily be %% same distribution. (The sources need not necessarily be
%% in the same archive or directory.) %% in the same archive or directory.)
%% File: groupthm.dtx %% File: groupthm.dtx
\ProvidesExplPackage{groupthm}{2022/01/17}{0.0.1}{Grouped theorems.} \ProvidesExplPackage{groupthm}{2022/02/02}{0.0.2}{Grouped theorems.}
\RequirePackage{amsthm} \RequirePackage{amsthm}
\RequirePackage{thmtools} \RequirePackage{thmtools}
\RequirePackage{l3benchmark}
\RequirePackage{l3keys2e}
\cs_new:Npn \__groupthm_thmtools_declare_theorem:nn #1 #2 \cs_new:Npn \__groupthm_thmtools_declare_theorem:nn #1 #2
{ {
\tl_log:n { Declaring ~ thmtools ~ theorem ~ #2 } \tl_log:n { Declaring ~ thmtools ~ theorem ~ #2 }
\declaretheorem [ #1 ] { #2 } \declaretheorem [ #1 ] { #2 }
\__groupthm_cache:n
{
\csname __groupthm_thmtools_declare_theorem:nn \endcsname { #1 } { #2 }
}
} }
\cs_generate_variant:Nn \__groupthm_thmtools_declare_theorem:nn { V n } \cs_generate_variant:Nn \__groupthm_thmtools_declare_theorem:nn { V n }
\cs_new:Npn \__groupthm_hook_gset_rule_foreach:nNnn #1 #2 #3 #4 \cs_new:Npn \__groupthm_hook_gset_rule_foreach:nNnn #1 #2 #3 #4
@ -88,6 +94,22 @@
\clist_new:N \g__groupthm_defined_groups_clist \clist_new:N \g__groupthm_defined_groups_clist
\bool_new:N \l__groupthm_in_family_options_environment_bool \bool_new:N \l__groupthm_in_family_options_environment_bool
\int_new:N \g__groupthm_append_groups_int \int_new:N \g__groupthm_append_groups_int
\bool_new:N \g__groupthm_cache_bool
\int_new:N \g__groupthm_cache_version_aux_int
\int_new:N \g__groupthm_cache_version_document_int
\int_set:Nn \g__groupthm_cache_version_aux_int { -1 }
\tl_new:N \g__groupthm_lazy_document_tl
\tl_new:N \g__groupthm_lazy_auxfile_tl
\clist_new:N \g__groupthm_dump_auxfile_clist
\clist_new:N \g__groupthm_dump_cache_clist
\keys_define:nn { groupthm }
{
cache .bool_set:N = \g__groupthm_cache_bool,
cache .default:n = { true },
__cache version__ .int_set:N = \g__groupthm_cache_version_document_int,
cache version .meta:nn = { groupthm } { cache = true, __cache version__ = #1 },
cache version .default:n = { 0 },
}
\keys_define:nn { groupthm / theorem ~ group } \keys_define:nn { groupthm / theorem ~ group }
{ {
prefix .tl_set:N = \l__groupthm_key_prefix_tl, prefix .tl_set:N = \l__groupthm_key_prefix_tl,
@ -136,6 +158,7 @@
unknown .code:n = unknown .code:n =
\msg_error:nnx { groupthm } { unknown ~ key } { \str_use:N \l_keys_key_str } \msg_error:nnx { groupthm } { unknown ~ key } { \str_use:N \l_keys_key_str }
} }
\ProcessKeysOptions { groupthm }
\cs_new:Npn \__groupthm_set_normalized_keys:nnn #1 #2 #3 \cs_new:Npn \__groupthm_set_normalized_keys:nnn #1 #2 #3
{ {
\keys_set:nn { groupthm / theorem ~ group } \keys_set:nn { groupthm / theorem ~ group }
@ -315,6 +338,8 @@
\cs_set:Npn \__groupthm_map_aux:n ##1 \cs_set:Npn \__groupthm_map_aux:n ##1
{ {
\cs_new:cn { #6 } \cs_new:cn { #6 }
{
\__groupthm_lazy:n
{ {
\__groupthm_define:nnncNNn \__groupthm_define:nnncNNn
{ ##1 } { ##1 }
@ -326,6 +351,7 @@
{ #7 } { #7 }
} }
} }
}
\clist_map_function:nN { #1 } \__groupthm_map_aux:n \clist_map_function:nN { #1 } \__groupthm_map_aux:n
} }
\__groupthm_define_multiple:nnnNNnn \__groupthm_define_multiple:nnnNNnn
@ -382,10 +408,15 @@
{ new, renew, provide, declare } { new, renew, provide, declare }
{ \__groupthm_Declarator: TheoremGroup } { \__groupthm_Declarator: TheoremGroup }
{ O{} m } { O{} m }
{
\__groupthm_lazy:n
{ {
\use:c { groupthm_#1 _group:nn } { ##1 } { ##2 } \use:c { groupthm_#1 _group:nn } { ##1 } { ##2 }
} }
}
\cs_new:Npn \groupthm_declare_group_rule:nnnn #1 #2 #3 #4 \cs_new:Npn \groupthm_declare_group_rule:nnnn #1 #2 #3 #4
{
\__groupthm_lazy:n
{ {
\str_set:Nx \l_tmpa_str { \tl_trim_spaces:n { #3 } } \str_set:Nx \l_tmpa_str { \tl_trim_spaces:n { #3 } }
\str_if_eq:VnT \l_tmpa_str { higher } \str_if_eq:VnT \l_tmpa_str { higher }
@ -404,22 +435,32 @@
\hook_gset_rule:nnVn { __groupthm / #1 } {#2} \l_tmpa_str {#4} \hook_gset_rule:nnVn { __groupthm / #1 } {#2} \l_tmpa_str {#4}
} }
} }
}
\cs_generate_variant:Nn \groupthm_declare_group_rule:nnnn { n n n x } \cs_generate_variant:Nn \groupthm_declare_group_rule:nnnn { n n n x }
\NewDocumentCommand { \DeclareTheoremGroupRule } { O{??} m m m } \NewDocumentCommand { \DeclareTheoremGroupRule } { O{??} m m m }
{
\__groupthm_lazy:n
{ {
\groupthm_declare_group_rule:nnnn {#1} {#2} {#3} {#4} \groupthm_declare_group_rule:nnnn {#1} {#2} {#3} {#4}
} }
}
\cs_new:Npn \groupthm_add_parent:nn #1 #2 \cs_new:Npn \groupthm_add_parent:nn #1 #2
{
\__groupthm_lazy:n
{ {
\__groupthm_ensure_group_exists:n { #1 } \__groupthm_ensure_group_exists:n { #1 }
\__groupthm_ensure_group_exists:n { #2 } \__groupthm_ensure_group_exists:n { #2 }
\clist_gput_left:cn { g__groupthm_parents_group__#1__clist } { #2 } \clist_gput_left:cn { g__groupthm_parents_group__#1__clist } { #2 }
} }
}
\cs_generate_variant:Nn \groupthm_add_parent:nn { n x } \cs_generate_variant:Nn \groupthm_add_parent:nn { n x }
\NewDocumentCommand { \AddTheoremGroupParent } { m m } \NewDocumentCommand { \AddTheoremGroupParent } { m m }
{
\__groupthmlazy:n
{ {
\groupthm_add_parent:nn { #1 } { #2 } \groupthm_add_parent:nn { #1 } { #2 }
} }
}
\cs_new:Npn \__groupthm_push_tmpa_seq:n #1 \cs_new:Npn \__groupthm_push_tmpa_seq:n #1
{ {
\seq_push:Nn \l_tmpa_seq { #1 } \seq_push:Nn \l_tmpa_seq { #1 }
@ -445,6 +486,8 @@
} }
} }
\cs_new:Npn \groupthm_append_to_group:nn #1 #2 \cs_new:Npn \groupthm_append_to_group:nn #1 #2
{
\__groupthm_lazy:n
{ {
\groupthm_new_group:nx { #1 } { __append__ \int_use:N \g__groupthm_append_groups_int } \groupthm_new_group:nx { #1 } { __append__ \int_use:N \g__groupthm_append_groups_int }
\groupthm_add_parent:nx { #2 } { __append__ \int_use:N \g__groupthm_append_groups_int } \groupthm_add_parent:nx { #2 } { __append__ \int_use:N \g__groupthm_append_groups_int }
@ -452,13 +495,14 @@
{ ?? } { #2 } { before } { __append__ \int_use:N \g__groupthm_append_groups_int } { ?? } { #2 } { before } { __append__ \int_use:N \g__groupthm_append_groups_int }
\int_gincr:N \g__groupthm_append_groups_int \int_gincr:N \g__groupthm_append_groups_int
} }
}
\NewDocumentCommand { \AppendToTheoremGroup } { O{} m } \NewDocumentCommand { \AppendToTheoremGroup } { O{} m }
{
\__groupthmlazy:n
{ {
\groupthm_append_to_group:nn { #1 } { #2 } \groupthm_append_to_group:nn { #1 } { #2 }
} }
\groupthm_new_group:nnnnn { all } { } { } { } { } }
\groupthm_new_group:nnnnn { starred } { } { } { } { numbered = no }
\groupthm_new_group:nnnnn { unnumbered } { } { } { } { numbered = no }
\clist_new:N \l__powerset_copied_clist \clist_new:N \l__powerset_copied_clist
\seq_new:N \l__powerset_saved_seq \seq_new:N \l__powerset_saved_seq
\cs_generate_variant:Nn \clist_remove_all:Nn { N V } \cs_generate_variant:Nn \clist_remove_all:Nn { N V }
@ -555,6 +599,8 @@
\__groupthm_wrap_multiple:nnn \__groupthm_wrap_multiple:nnn
{ new, provide } { new, provide }
{ groupthm_#1_theorem:nnn } { groupthm_#1_theorem:nnn }
{
\__groupthm_lazy:n
{ {
\__groupthm_set_normalized_keys:nnn { ##1 } { grouped ~ theorem } { ##2 } \__groupthm_set_normalized_keys:nnn { ##1 } { grouped ~ theorem } { ##2 }
\bool_if:nT { ##3 } \bool_if:nT { ##3 }
@ -576,16 +622,20 @@
\l__groupthm_thmtools_clist \l__groupthm_thmtools_clist
} }
} }
}
\__groupthm_wrap_multiple_document:nnnn \__groupthm_wrap_multiple_document:nnnn
{ new, provide } { new, provide }
{ \__groupthm_Declarator: GroupedTheorem } { \__groupthm_Declarator: GroupedTheorem }
{ s O{} m } { s O{} m }
{
\__groupthm_lazy:n
{ {
\use:c { groupthm_#1_theorem:nnn } \use:c { groupthm_#1_theorem:nnn }
{ ##2 } { ##2 }
{ ##3 } { ##3 }
{ ##1 } { ##1 }
} }
}
\cs_new:Npn \__groupthm_define_family:nnnnn #1 #2 #3 #4 #5 \cs_new:Npn \__groupthm_define_family:nnnnn #1 #2 #3 #4 #5
{ {
\clist_set:Nn \l_tmpa_clist { #2 } \clist_set:Nn \l_tmpa_clist { #2 }
@ -618,6 +668,8 @@
\__groupthm_wrap_multiple:nnn \__groupthm_wrap_multiple:nnn
{ new, provide } { new, provide }
{ groupthm_#1_family:nnn } { groupthm_#1_family:nnn }
{
\__groupthm_lazy:n
{ {
\__groupthm_set_normalized_keys:nnn { ##1 } { theorem ~ family } { ##2 } \__groupthm_set_normalized_keys:nnn { ##1 } { theorem ~ family } { ##2 }
\bool_if:nTF { ##3} \bool_if:nTF { ##3}
@ -638,17 +690,23 @@
\l__groupthm_thmtools_clist \l__groupthm_thmtools_clist
\l_tmpa_clist \l_tmpa_clist
} }
}
\__groupthm_wrap_multiple_document:nnnn \__groupthm_wrap_multiple_document:nnnn
{ new, provide } { new, provide }
{ \__groupthm_Declarator: GroupedTheoremFamily } { \__groupthm_Declarator: GroupedTheoremFamily }
{ s O{} m } { s O{} m }
{
\__groupthm_lazy:n
{ {
\use:c { groupthm_#1_family:nnn } \use:c { groupthm_#1_family:nnn }
{ ##2 } { ##2 }
{ ##3 } { ##3 }
{ ##1 } { ##1 }
} }
}
\cs_new:Npn \groupthm_add_theorem_to_group:n #1 \cs_new:Npn \groupthm_add_theorem_to_group:n #1
{
\__groupthm_lazy:n
{ {
\bool_if:NTF \l__groupthm_in_family_options_environment_bool \bool_if:NTF \l__groupthm_in_family_options_environment_bool
{ {
@ -658,6 +716,7 @@
\msg_error:nn { groupthm } { misuse ~ add ~ theorem ~ to ~ group } \msg_error:nn { groupthm } { misuse ~ add ~ theorem ~ to ~ group }
} }
} }
}
\NewDocumentCommand { \AddTheoremToGroup } { m } \NewDocumentCommand { \AddTheoremToGroup } { m }
{ {
\groupthm_add_theorem_to_group:n { #1 } \groupthm_add_theorem_to_group:n { #1 }
@ -693,6 +752,10 @@
\__groupthm_sort_group_names: \__groupthm_sort_group_names:
\end { __#1__groups_ \clist_use:Nn \l__groupthm_group_clist { _ } } \end { __#1__groups_ \clist_use:Nn \l__groupthm_group_clist { _ } }
} }
\__groupthm_cache_slow:n
{
\csname __groupthm_define_family_options:nnnn \endcsname { #1 } { #2 } { #3 } { #4 }
}
} }
\__groupthm_define_multiple:nnnNNnn \__groupthm_define_multiple:nnnNNnn
{ new, renew, provide, declare } { new, renew, provide, declare }
@ -710,6 +773,8 @@
{ new, renew, provide, declare } { new, renew, provide, declare }
{ \__groupthm_Declarator: GroupedTheoremFamilyOptions } { \__groupthm_Declarator: GroupedTheoremFamilyOptions }
{ s O{} m m m } { s O{} m m m }
{
\__groupthm_lazy:n
{ {
\keys_set:nn { groupthm / theorem ~ family ~ options } { starred ~ version } \keys_set:nn { groupthm / theorem ~ family ~ options } { starred ~ version }
\keys_set:nn { groupthm / theorem ~ family ~ options } { ##2 } \keys_set:nn { groupthm / theorem ~ family ~ options } { ##2 }
@ -737,6 +802,110 @@
\l_tmpa_clist \l_tmpa_clist
} }
} }
}
\bool_if:NTF \g__groupthm_cache_bool
{
\cs_new:Npn \__groupthm_write_auxout:n
{
\iow_now:cn { @auxout }
}
\cs_generate_variant:Nn \__groupthm_write_auxout:n { x }
\cs_new:Npn \__groupthm_dump_auxfile:n
{
\clist_gput_right:Nn \g__groupthm_dump_auxfile_clist
}
\cs_generate_variant:Nn \__groupthm_dump_auxfile:n { x }
\cs_new:Npn \__groupthm_cache_auxfile:n
{
\clist_gput_right:Nn \g__groupthm_dump_cache_clist
}
\cs_generate_variant:Nn \__groupthm_cache_auxfile:n { V }
\hook_gput_code:nnn { enddocument } { groupthm }
{
\__groupthm_benchmark_once:nn
{
Benchmarking ~ writing ~ to ~ auxfile:
}
{
\clist_map_function:NN \g__groupthm_dump_auxfile_clist
\__groupthm_write_auxout:n
\__groupthm_write_auxout:n
{
\csname tl_gput_right:cn \endcsname
{
g__groupthm_lazy_auxfile_tl
}
}
\__groupthm_write_auxout:x { \str_use:N \c_left_brace_str }
\clist_map_function:NN \g__groupthm_dump_cache_clist
\__groupthm_write_auxout:n
\__groupthm_write_auxout:x { \str_use:N \c_right_brace_str }
}
}
\__groupthm_dump_auxfile:x
{
\ExplSyntaxOn
\int_gset:Nn \exp_not:N \g__groupthm_cache_version_aux_int
{
\int_use:N \g__groupthm_cache_version_document_int
}
\ExplSyntaxOff
}
\cs_new:Npn \__groupthm_lazy:n
{
\tl_gput_right:Nn \g__groupthm_lazy_document_tl
}
\cs_set_eq:NN \__groupthm_cache:n \__groupthm_cache_auxfile:n
\cs_new:Npn \__groupthm_cache_slow:n #1
{
\tl_set:Nn \l_tmpa_tl
{
{ #1 }
}
\regex_replace_all:nnN { \cP\# } { \cO\# } \l_tmpa_tl
\__groupthm_cache_auxfile:V \l_tmpa_tl
}
\hook_gput_code:nnn { begindocument } { groupthm }
{
\cs_set_eq:NN \__groupthm_lazy:n \use:n
\int_compare:nNnTF
\g__groupthm_cache_version_aux_int < \g__groupthm_cache_version_document_int
{
\__groupthm_benchmark_once:nn
{
Benchmarking ~ declarations ~ of ~ theorems ~ from ~ document:
}
{
\tl_use:N \g__groupthm_lazy_document_tl
}
}
{
\__groupthm_benchmark_once:nn
{
Benchmarking ~ declarations ~ of ~ theorems ~ from ~ aux ~ file:
}
{
\tl_use:N \g__groupthm_lazy_auxfile_tl
}
}
}
}
{
\cs_set_eq:NN \__groupthm_cache:n \use_none:n
\cs_set_eq:NN \__groupthm_lazy:n \use:n
}
\groupthm_new_group:nnnnn { all } { } { } { } { }
\groupthm_new_group:nnnnn { starred } { } { } { } { numbered = no }
\groupthm_new_group:nnnnn { unnumbered } { } { } { } { numbered = no }
\cs_new:Npn \__groupthm_benchmark_once:nn #1
{
\iow_term:n { [groupthm] ~ #1 }
\iow_log:n { [groupthm] ~ #1 }
\benchmark_once:n
}
\endinput \endinput
%% %%
%% End of file `groupthm.sty'. %% End of file `groupthm.sty'.

198
wip/cache/mkessler-cache.sty vendored Normal file
View file

@ -0,0 +1,198 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Copyright © 2022 Maximilian Keßler
%
% This work may be distributed and/or modified
%
% 1. under the LaTeX Project Public License and/or
% 2. under the GNU General Public License
%
% Distribution under conditions of the LaTeX Project Public License,
% requires either version 1.3 of this license or (at your option)
% any later version.
% The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status \`maintained'.
%
% The Current Maintainer of this work is Maximilian Keßler.
%
%
% Distribution under the GNU General Public License requires either
% version 3 or (at your opinion) any later version.
%
% This package has been generated by PyTeX, available at
% https://github.com/kesslermaximilian/PyTeX
% and built from source file 'cache.pysty3'.
% It is STRONGLY DISCOURAGED to edit this source file directly, since local
% changes will not be versioned by Git and overwritten by the next build. Always
% edit the source file and build the package again.
%
% Build details:
% PyTeX version: v1.2.0-31-gc9bb0e8 (commit c9bb0e8)
% Source code version: v2.8.2 (commit b15dedb)
%
% This LaTeX package is free software and is dual-licensed
% under the LPPLv1.3c and the GPLv3 licenses.
% You may use it freely for your purposes.
% The latest version of the package sources can be obtained
% via GitLab under
% https://gitlab.com/latexci/packages/LatexPackages
% The latest version of the built packages can be obtained via GitLab under
% https://gitlab.com/latexci/packages/LatexPackagesBuild
% For further information see the urls above.
% Reportings of bugs, suggestions and improvements are welcome, see the README
% at the Git repository for further information.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\ProvidesExplPackage{mkessler-cache}{2022/02/03}{2.8.2}{Cache definitions of previous LaTeX runs to avoid computations}
%%%% This is just a proof of concept package,
%%%% there is possibly more room for clean-up
%%%% and / or speed-up etc.
%%% Also, the provided
%%% \DeclareCachedDocumentCommand
%%% is of course not really
%%% useful and just for demonstration
%%% purposes
\bool_new:N \g__cache_cache_bool
\int_new:N \g__cache_cache_version_document_int
\int_new:N \g__cache_cache_version_aux_int
\int_gset:Nn \g__cache_cache_version_aux_int { -1 }
\clist_new:N \g__cache_dump_auxfile_clist %% usual dump
\clist_new:N \g__cache_dump_cache_clist %% will be dumped such that it is restored as \g__cache_lazy_auxfile_tl on next run.
\tl_new:N \g__cache_lazy_document_tl
\tl_new:N \g__cache_lazy_auxfile_tl
\keys_define:nn { cache }
{
cache .bool_set:N = \g__cache_cache_bool,
cache .default:n = { true },
__cache version__ .int_set:N = \g__cache_cache_version_document_int,
cache version .meta:nn = { cache } { cache = true, __cache version__ = #1 },
cache version .default:n = { 0 },
}
\RequirePackage{l3keys2e}
\ProcessKeysOptions{cache}
% Setting up lazy execution and
% selecting of executing after reading of aux file
% if cache option has been used
\bool_if:NTF \g__cache_cache_bool
{
%% Writing things (at one go) to aux file at end of document:
\cs_new:Npn \__cache_dump_auxfile:n
{
\clist_gput_right:Nn \g__cache_dump_auxfile_clist
}
\cs_generate_variant:Nn \__cache_dump_auxfile:n { x }
\cs_new:Npn \__cache_dump_cache:n
{
\clist_gput_right:Nn \g__cache_dump_cache_clist
}
\cs_generate_variant:Nn \__cache_dump_cache:n { V }
\cs_new:Npn \__cache_write_auxout:n
{
\iow_now:cn { @auxout }
}
\cs_generate_variant:Nn \__cache_write_auxout:n { x }
%%% Handles dumping data to aux file at end of document
\hook_gput_code:nnn { enddocument } { cache }
{
\clist_map_function:NN \g__cache_dump_auxfile_clist
\__cache_write_auxout:n
\__cache_write_auxout:n
{
\csname tl_gput_right:cn \endcsname
{
g__cache_lazy_auxfile_tl
}
}
\__cache_write_auxout:x { \str_use:N \c_left_brace_str }
\clist_map_function:NN \g__cache_dump_cache_clist
\__cache_write_auxout:n
\__cache_write_auxout:x { \str_use:N \c_right_brace_str }
}
%%% Writes the current cache version into aux file
\__cache_dump_auxfile:x
{
\ExplSyntaxOn
\int_gset:Nn \exp_not:N \g__cache_cache_version_aux_int
{
\int_use:N \g__cache_cache_version_document_int
}
\ExplSyntaxOff
}
%%% Executing something lazily at beginning of document
%%% Lazy code only gets executed if auxfile version is older than document
\cs_new:Npn \__cache_lazy:n
{
\tl_gput_right:Nn \g__cache_lazy_document_tl
}
%%% Caching things. Handles writing and reading to aux file
%%% and makes code available in the next run of LaTeX
\cs_new:Npn \__cache_cache:n #1
{
\tl_set:Nn \l_tmpa_tl
{
{ #1 }
}
\regex_replace_all:nnN { \cP\# } { \cO\# } \l_tmpa_tl
\__cache_dump_cache:V \l_tmpa_tl
}
%%% This handles loading either the cached definitions
%%% from last run or executing the lazy definitions from the current run
%%% after loading the aux file
\hook_gput_code:nnn { begindocument } { cache }
{
\int_compare:nNnTF
\g__cache_cache_version_aux_int < \g__cache_cache_version_document_int
{
\tl_use:N \g__cache_lazy_document_tl
}
{
\tl_use:N \g__cache_lazy_auxfile_tl
}
}
}
{
\cs_set_eq:NN \__cache_lazy:n \use:n
\cs_set_eq:NN \__cache_cache:n \use_none:n
}
\cs_new:Npn \__cached_new_document_command:nnn #1 #2 #3
{
\NewDocumentCommand{#1}{#2}{#3}
\__cache_cache:n
{
\csname __cached_new_document_command:nnn \endcsname { #1 } { #2 } { #3 }
}
}
\NewDocumentCommand{\DeclareCachedDocumentCommand}{mmm}
{
\__cache_lazy:n
{
\__cached_new_document_command:nnn{#1}{#2}{#3}
}
}