How ebzych/amphimixis works
Project type and purpose
• Amphimixis is a Python-based CLI tool whose goal is to automate project builds and profile application performance across platforms.
• It is not a web app or microservice ecosystem; rather it is a developer-tool suite composed of distinct functional modules.
File structure
• Top-level files and directories:
• ci/: shell scripts driving CI checks (black, mypy, pylint).
• pyproject.toml: Python packaging and dependency configuration.
• src/main.py: CLI entrypoint.
• src/{analyzer, builder, configurator, profiler, shell, general}: functional subpackages.
• Each subpackage encapsulates one concern:
• configurator: environment setup.
• shell: abstracts local vs SSH command execution.
• builder: invokes Make or CMake.
• analyzer: inspects project for CI, tests, benchmarks, dependencies.
• profiler: runs perf or flamegraph and gathers metrics.
• general: logging, coloring, shared utilities.
README for additional insights
• Amphimixis workflows:
a) A target project.
b) Configure environment.
c) Build with multiple systems.
d) Profile performance.
e) Compare results across platforms (local or remote via SSH).
Details
• Of the six subpackages as its own block.
• Strategy switch inside Shell Handler (local vs SSH).
• Data flow: configuration parameters → build commands → profiling data → analysis output.
• Do not overwhelm with file-level detail; group files by module.