mopr 0.0.10__tar.gz

mopr-0.0.10/.clang-format

@@ -0,0 +1,99 @@
+BasedOnStyle: Google
+AccessModifierOffset: -4
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignEscapedNewlines: Left
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllArgumentsOnNextLine: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+AlwaysBreakTemplateDeclarations: Yes
+BinPackArguments: false
+BinPackParameters: false
+BraceWrapping:
+  AfterClass: true
+  AfterControlStatement: Never
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: false
+  AfterObjCDeclaration: false
+  AfterStruct: true
+  AfterUnion: true
+  BeforeElse: true
+  IndentBraces: false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+BreakBeforeBinaryOperators: None
+BreakBeforeTernaryOperators: true
+BreakConstructorInitializers: BeforeComma
+ColumnLimit: 120
+CommentPragmas: '^ IWYU pragma:'
+CompactNamespaces: false
+ConstructorInitializerIndentWidth: 4
+ContinuationIndentWidth: 4
+Cpp11BracedListStyle: true
+DerivePointerAlignment: false
+DisableFormat: false
+ExperimentalAutoDetectBinPacking: false
+FixNamespaceComments: true
+ForEachMacros:
+  - foreach
+  - qForeach
+IncludeCategories:
+  - Regex:           '^<.*\.h>'
+    Priority:        1
+  - Regex:           '^<.*'
+    Priority:        2
+  - Regex:           '.*'
+    Priority:        3
+IncludeIsMainRegex: '(test|main)\.cpp'
+IndentCaseLabels: true
+IndentWidth: 4
+IndentWrappedFunctionNames: false
+JavaScriptQuotes: Leave
+#JavaScriptRegExp: false
+KeepEmptyLinesAtTheStartOfBlocks: true
+MacroBlockBegin: ''
+MacroBlockEnd: ''
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: All      # namespace 内部内容也缩进
+PenaltyBreakAssignment: 40
+PenaltyBreakBeforeFirstCallParameter: 19
+PenaltyBreakComment: 300
+PenaltyBreakFirstLessLess: 120
+PenaltyBreakString: 1000
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 60
+PointerAlignment: Right
+ReflowComments: true
+SortIncludes: true
+SortUsingDeclarations: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCpp11BracedList: false
+#SpaceBeforeCtorColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInAngles: false
+SpacesInContainerLiterals: false
+SpacesInCStyleCastParentheses: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+Standard: c++20
+TabWidth: 4
+UseTab: Never

mopr-0.0.10/.clang-tidy

@@ -0,0 +1,147 @@
+# Generated from CLion Inspection settings
+---
+Checks: '-*,
+bugprone-argument-comment,
+bugprone-assert-side-effect,
+bugprone-bad-signal-to-kill-thread,
+bugprone-branch-clone,
+bugprone-copy-constructor-init,
+bugprone-dangling-handle,
+bugprone-dynamic-static-initializers,
+bugprone-fold-init-type,
+bugprone-forward-declaration-namespace,
+bugprone-forwarding-reference-overload,
+bugprone-inaccurate-erase,
+bugprone-incorrect-roundings,
+bugprone-integer-division,
+bugprone-lambda-function-name,
+bugprone-macro-parentheses,
+bugprone-macro-repeated-side-effects,
+bugprone-misplaced-operator-in-strlen-in-alloc,
+bugprone-misplaced-pointer-arithmetic-in-alloc,
+bugprone-misplaced-widening-cast,
+bugprone-move-forwarding-reference,
+bugprone-multiple-statement-macro,
+bugprone-no-escape,
+bugprone-parent-virtual-call,
+bugprone-posix-return,
+bugprone-reserved-identifier,
+bugprone-sizeof-container,
+bugprone-sizeof-expression,
+bugprone-spuriously-wake-up-functions,
+bugprone-string-constructor,
+bugprone-string-integer-assignment,
+bugprone-string-literal-with-embedded-nul,
+bugprone-suspicious-enum-usage,
+bugprone-suspicious-include,
+bugprone-suspicious-memset-usage,
+bugprone-suspicious-missing-comma,
+bugprone-suspicious-semicolon,
+bugprone-suspicious-string-compare,
+bugprone-suspicious-memory-comparison,
+bugprone-suspicious-realloc-usage,
+bugprone-swapped-arguments,
+bugprone-terminating-continue,
+bugprone-throw-keyword-missing,
+bugprone-too-small-loop-variable,
+bugprone-undefined-memory-manipulation,
+bugprone-undelegated-constructor,
+bugprone-unhandled-self-assignment,
+bugprone-unused-raii,
+bugprone-unused-return-value,
+bugprone-use-after-move,
+bugprone-virtual-near-miss,
+cert-dcl21-cpp,
+cert-dcl58-cpp,
+cert-err34-c,
+cert-err52-cpp,
+cert-err60-cpp,
+cert-flp30-c,
+cert-msc50-cpp,
+cert-msc51-cpp,
+cert-str34-c,
+cppcoreguidelines-interfaces-global-init,
+cppcoreguidelines-narrowing-conversions,
+cppcoreguidelines-pro-type-member-init,
+cppcoreguidelines-pro-type-static-cast-downcast,
+cppcoreguidelines-slicing,
+google-default-arguments,
+google-explicit-constructor,
+google-runtime-operator,
+hicpp-exception-baseclass,
+hicpp-multiway-paths-covered,
+misc-misplaced-const,
+misc-new-delete-overloads,
+misc-no-recursion,
+misc-non-copyable-objects,
+misc-throw-by-value-catch-by-reference,
+misc-unconventional-assign-operator,
+misc-uniqueptr-reset-release,
+modernize-avoid-bind,
+modernize-concat-nested-namespaces,
+modernize-deprecated-headers,
+modernize-deprecated-ios-base-aliases,
+modernize-loop-convert,
+modernize-make-shared,
+modernize-make-unique,
+modernize-pass-by-value,
+modernize-raw-string-literal,
+modernize-redundant-void-arg,
+modernize-replace-auto-ptr,
+modernize-replace-disallow-copy-and-assign-macro,
+modernize-replace-random-shuffle,
+modernize-return-braced-init-list,
+modernize-shrink-to-fit,
+modernize-unary-static-assert,
+modernize-use-auto,
+modernize-use-bool-literals,
+modernize-use-emplace,
+modernize-use-equals-default,
+modernize-use-equals-delete,
+modernize-use-nodiscard,
+modernize-use-noexcept,
+modernize-use-nullptr,
+modernize-use-override,
+modernize-use-transparent-functors,
+modernize-use-uncaught-exceptions,
+mpi-buffer-deref,
+mpi-type-mismatch,
+openmp-use-default-none,
+performance-faster-string-find,
+performance-for-range-copy,
+performance-implicit-conversion-in-loop,
+performance-inefficient-algorithm,
+performance-inefficient-string-concatenation,
+performance-inefficient-vector-operation,
+performance-move-const-arg,
+performance-move-constructor-init,
+performance-no-automatic-move,
+performance-noexcept-move-constructor,
+performance-trivially-destructible,
+performance-type-promotion-in-math-fn,
+performance-unnecessary-copy-initialization,
+performance-unnecessary-value-param,
+portability-simd-intrinsics,
+readability-avoid-const-params-in-decls,
+readability-const-return-type,
+readability-container-size-empty,
+readability-convert-member-functions-to-static,
+readability-delete-null-pointer,
+readability-deleted-default,
+readability-inconsistent-declaration-parameter-name,
+readability-make-member-function-const,
+readability-misleading-indentation,
+readability-misplaced-array-index,
+readability-non-const-parameter,
+readability-redundant-control-flow,
+readability-redundant-declaration,
+readability-redundant-function-ptr-dereference,
+readability-redundant-smartptr-get,
+readability-redundant-string-cstr,
+readability-redundant-string-init,
+readability-simplify-subscript-expr,
+readability-static-accessed-through-instance,
+readability-static-definition-in-anonymous-namespace,
+readability-string-compare,
+readability-uniqueptr-delete-release,
+readability-use-anyofallof'

mopr-0.0.10/.clangd

@@ -0,0 +1,8 @@
+# clangd 配置：编译数据库来自 Ninja 旁路目录
+#
+# VS 生成器不产出 compile_commands.json，故另建 Ninja 目录（build/ninja-debug）
+# 专供 clangd 使用；其复用 debug-dynamic 的 conan 依赖，无需单独安装。
+# 切换/新增依赖后需在 x64 开发环境下重跑一次 configure 刷新（见 BUILDING.md）。
+
+CompileFlags:
+  CompilationDatabase: build/ninja-debug

mopr-0.0.10/.editorconfig

@@ -0,0 +1,34 @@
+# 顶层配置（对所有文件生效）
+root = true
+
+[*]  # 所有文件
+charset = utf-8  # 编码
+end_of_line = lf  # 换行符（Linux/macOS风格）
+insert_final_newline = true  # 文件末尾保留空行
+trim_trailing_whitespace = true  # 删除行尾空格
+
+# 针对 Windows 批处理文件的配置
+[*.{bat,cmd}]
+charset = gbk  # 编码
+end_of_line = crlf  # 强制使用 CRLF（Windows 风格）
+trim_trailing_whitespace = false  # 避免破坏批处理命令中的空格
+insert_final_newline = true  # 文件末尾保留空行（可选）
+
+# Python 文件特定配置
+[*.py]
+indent_style = space  # 缩进风格：空格
+indent_size = 4  # 缩进大小：4空格（符合PEP 8）
+max_line_length = 120  # 行长度限制（可自定义）
+
+# 测试文件可能允许稍长行宽
+[*/tests/*.py]
+max_line_length = 160
+
+# 配置文件（如YAML/JSON）
+[*.{yml,yaml,json}]
+indent_style = space
+indent_size = 2  # 通常为2空格
+
+# Markdown文件
+[*.md]
+trim_trailing_whitespace = false  # 允许行尾空格（用于换行）

mopr-0.0.10/.gitattributes

@@ -0,0 +1,15 @@
+*.bat text working-tree-encoding=GBK eol=crlf
+*.py text eol=lf
+*.go text eol=lf
+*.rs text eol=lf
+*.java text eol=lf
+*.ps1 text eol=lf
+*.json text eol=lf
+*.toml text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.cmake text eol=lf
+*.cpp text eol=lf
+*.h text eol=lf
+*.proto text eol=lf

mopr-0.0.10/.gitignore

@@ -0,0 +1,199 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# Test data
+data/
+
+# Python
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+_version.py
+MANIFEST
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv / pipenv / poetry / pdm
+#.python-version
+Pipfile.lock
+#poetry.lock
+#pdm.lock
+#.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Environments
+.env
+.env.*
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Ruff
+.ruff_cache/
+
+# Rust
+
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these files, which require debugging symbols
+*.pdb
+
+# Go
+
+# Binaries for programs and plugins (generic ones already covered above)
+*.exe~
+
+# Test binary, built with `go test -c`
+*.test
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work
+go.work.sum
+
+# Java
+
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see https://www.java.com/en/download/help/error_hotspot.html
+hs_err_pid*
+replay_pid*
+
+# --- conan/CMake 2 工程专属（追加规则，以下来自 conan install / cmake 产物） ---
+
+# conan install 生成的本机用户级预设（机器相关，不提交）
+CMakeUserPresets.json
+
+# 仓库根的 compile_commands.json 软链（指向 build/Release 下由 CMake 导出的产物）
+compile_commands.json

mopr-0.0.10/.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug mopr（debug-dynamic）",
+            "type": "cppvsdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/build/debug-dynamic/Debug/mopr.exe",
+            "args": [
+                "100000000"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal",
+            "preLaunchTask": "mopr: build (debug-dynamic)",
+            "stopAtEntry": false,
+            "environment": []
+        }
+    ]
+}

mopr-0.0.10/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "C_Cpp.intelliSenseEngine": "disabled",
+    "cmake.configureOnOpen": false,
+    "cmake.useCMakePresets": "never",
+    "cmake.buildDirectory": "${workspaceFolder}/build/debug-dynamic",
+    "cmake.buildType": "Debug"
+}

mopr-0.0.10/.vscode/tasks.json

@@ -0,0 +1,55 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "conan install (debug-dynamic)",
+            "type": "shell",
+            "command": "conan install . -s build_type=Debug -s compiler.runtime=dynamic --build=missing",
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": []
+        },
+        {
+            "label": "cmake configure (debug-dynamic)",
+            "type": "shell",
+            "command": "cmake --preset debug-dynamic",
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "dependsOn": [
+                "conan install (debug-dynamic)"
+            ],
+            "dependsOrder": "sequence",
+            "problemMatcher": []
+        },
+        {
+            "label": "mopr: build (debug-dynamic)",
+            "type": "shell",
+            "command": "cmake --build --preset debug-dynamic",
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "dependsOn": [
+                "cmake configure (debug-dynamic)"
+            ],
+            "dependsOrder": "sequence",
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "problemMatcher": [
+                "$msCompile"
+            ]
+        },
+        {
+            "label": "refresh clangd db (ninja-debug)",
+            "type": "shell",
+            "command": "powershell -NoProfile -ExecutionPolicy Bypass -File refresh-clangd.ps1",
+            "options": {
+                "cwd": "${workspaceFolder}"
+            },
+            "problemMatcher": []
+        }
+    ]
+}

mopr-0.0.10/AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md — 仓库协作规范
+
+本文件面向在本仓库工作的自动化 Agent 与协作者，列出必须遵守的约定。遇到与本文件冲突的做法时，以本文件为准。
+
+## 语言与版本要求
+
+mopr 是单仓多语言库（monolibrary），同一语义将来可能有多种语言实现。各语言最低版本由本项目独立维护，不要求与同系列 `quant1x` 仓库同步：
+
+| 语言 | 最低版本 | 说明 |
+| --- | --- | --- |
+| Python | 3.12+ | 3.12.x |
+| Go | 1.27+ | 1.27.x |
+| Rust | 1.98.0+ | 2024 edition |
+| C++ | C++20 | GCC 13+ / Clang 17+ / MSVC 14.3+ |
+
+- 编写各语言实现时，不得使用低于上表基线的语言特性与 API（含第三方依赖的最低版本要求）。
+- 版本基线变更由本项目独立评估；README.md「语言与版本要求」为对外文档，两者保持一致。
+- 当前仓库以 C++20 + MSVC v143 + CMake/Conan 2 为主验证。
+
+## git 提交规范
+
+### 1. 提交信息规范（含上级仓库约定）
+
+以下约定与上级 `quant1x` 仓库的提交规范保持一致：
+
+- **提交标题与正文必须使用中文**，准确说明本次变更内容；必要时可保留英文术语（如 `fmt`、`VcpkgEnabled`、`conan_toolchain`）作为对象标识。
+- **主题统一模板**：`<type>[<language>]：<summary>`（注意冒号为全角 `：`）。
+  - `<type>` 取值：`feat`（新特性）、`fix`（修复）、`refactor`（重构）、`perf`（性能）、`docs`（文档）、`test`（测试）、`chore`（例行维护）。
+  - `<language>` 取值：`python`、`c++`、`rust`、`go`、`multi`。mopr 是单仓多语言库（monolibrary），同一语义将来可能有多种语言实现，必须如实标注；本仓库当前以 `c++` 为主。多语言组合用半角逗号 `,` 分隔并按语义顺序书写（如 `python,c++`、`c++,rust`、`python,c++,rust,go`）——注意 `c++` 自身含 `+`，不用 `+` 连接以免出现 `c+++rust` 这类难读形式；变更仅涉及构建/工具/文档等不含代码语言的杂项时，标注其影响的实现语言，或使用 `multi`。
+  - **主题禁止仅写空泛描述**（如 `update` / `optimize` / `fix` 这类无对象的词），必须指明对象与语言，例如：
+    - `fix[c++]：修正 conan 静态运行时链接被 vcpkg 集成劫持的问题`
+    - `feat[c++]：重构 conan/cmake 多配置构建体系`
+    - `docs[c++]：更新 BUILDING.md 构建矩阵`
+- **正文**在标题后空一行，以 `- ` 分条列出要点；**跨语言同步改动**（本仓库如引入 `c++,rust` 等）正文必须补充：
+  1. 变更概述；
+  2. 涉及语言与文件范围；
+  3. 语义一致性说明；
+  4. 验证方式/测试命令。
+
+  ```
+  feat[c++]：新增按 build_type/runtime 分目录的构建布局
+
+  - conanfile.layout 按 build_type 与 compiler.runtime 推导独立目录
+  - 验证：conan install . --build=missing && cmake --preset release-dynamic
+  ```
+
+- **提交信息不得包含版本号、Git Tag 或发布相关信息**；tag 与版本号管理如另有工具负责（如 [autochangelog](https://gitee.com/quant1x/autochangelog)），不得手动干预。
+- 提交前必须逐项核对清单（Checklist）：
+  - [ ] 主题是否符合 `type[language]：summary` 模板？
+  - [ ] `type` 是否真实反映本次变更类型？
+  - [ ] `language` 是否准确标注本次涉及的开发语言，未标注或误标注视为不合规？
+  - [ ] 标题是否避免空泛描述、明确对象和影响？
+  - [ ] 正文是否包含要点（跨语言时含变更概述、文件范围、语义一致性、验证方式）？
+  - [ ] 是否未包含版本号 / Git Tag / 发布相关字符串？
+  - [ ] 是否以中文为主，能按语言维度快速过滤和回溯？
+
+  任一项未满足，必须在提交前修正，不能直接提交。
+
+### 2. Windows 下提交信息的字符集约定（重要）
+
+**背景**：Windows PowerShell 下在命令行内直接内嵌中文提交信息，会因 GBK/UTF-8 编码错乱导致解析失败（报错形如"字符串缺少终止符"或中文乱码），且此类失败发生在命令解析阶段，`&&` 前序命令（如 `git add`）也不会执行。
+
+**标准做法**：涉及中文的提交信息不得直接写入命令行参数，必须按以下流程执行：
+
+1. 用工具（write_to_file）将提交信息写入 UTF-8 编码的临时文件，例如 `<仓库根>/.git/commit-msg.tmp`（放在 `.git/` 内，不污染工作树）：
+   ```
+   chore: 中文标题
+
+   - 正文要点一
+   - 正文要点二
+   ```
+2. 依次执行暂存与提交：
+   ```
+   git add <文件>
+   git commit -F .git/commit-msg.tmp
+   ```
+3. 提交成功后删除临时文件：
+   ```
+   Remove-Item .git/commit-msg.tmp
+   ```
+
+**推论**：任何需要在 Windows 命令行传递的中文内容（提交信息、`-m` 参数、脚本输入等）都应优先改用文件传递（`-F`、`--file` 等参数），规避编码问题。
+
+### 3. 其他
+
+- 除非用户明确要求，不得执行 `git commit`、`git push`、`git rebase` 等写操作。
+- 不做破坏性 git 操作（`push --force`、`reset --hard` 等）。
+- tag 与版本号管理如另有工具负责（如 [autochangelog](https://gitee.com/quant1x/autochangelog)），不得手动干预。
+- autochangelog 安装方法见 [BUILDING.md](BUILDING.md)「版本发布（autochangelog）」。