Skip to content

Knowledge Base

Jump to bottom
grisun0 edited this page Oct 17, 2026 · 3 revisions

Polyglot Codebase Knowledge Graph

Generated offline by readmenator. 11 files, 194 symbols, 65 imports. Supports C, C++, Python, Go, Rust, JS/TS, Java, C#, Shell, PHP, Dart, GDScript, Nim, ASM, Ruby, Swift, Kotlin, Scala, Lua, Elixir. No LLMs. No tokens. Pure static analysis. See more here

Start here: Statistics Dashboard for scope, God Nodes for blast radius, Architecture Reference for per-file API. Agents: prefer readmenator-agent/INDEX.md + SYMBOLS.md.

Wiki: prefer readmenator-wiki/index.md for progressive disclosure: one synthesis page per community, connections.json with EXTRACTED vs INFERRED confidence, queries.md log, REPORT.md audit.

Confidence: EXTRACTED = parsed from source, INFERRED = heuristic bridge, AMBIGUOUS = reported, never hidden. See readmenator-wiki/REPORT.md.

Total Files Parsed: 11 | Total Symbols Extracted: 194 | Total Imports: 65 | Resolved Imports: 9

Table of Contents

  1. Statistics Dashboard
  2. Architectural Layers
  3. Architecture Overview
  4. Execution Flows
  5. Ranked Context
  6. God Nodes
  7. Community Analysis
  8. Suggested Questions
  9. Force-Graph Explorer
  10. Corpus Analytics
  11. Taint Propagation Map
  12. Hotspot Analysis
  13. Change Impact Analysis
  14. Architecture Violations
  15. Suggested Linting Rules
  16. Concept Graph
  17. Query Recipes
  18. Structural Knowledge Map
  19. UML Class Diagram
  20. Code Property Graph
  21. Architecture Reference

Statistics Dashboard

Metric Value
Total Files 11
Total Symbols 194
Total Imports 65
Call Edges 1128
Inheritance Edges 4
Languages 2
Avg Symbols/File 17.6
Avg Imports/File 5.9
Resolved Imports 9

Top Files by Import Count (Fan-Out)

File Imports Symbols Language
lazyown_infinitestorage.py 20 84 py
tools.py 11 11 py
test_integration.py 9 16 py
mcp_server.py 8 13 py
test_zip.py 5 16 py
test_frames.py 3 13 py
test_security.py 3 18 py
test_error_correction.py 2 10 py
test_protocols.py 2 12 py
wsgi_app.py 2 1 py

Architectural Layers

Auto-detected from path patterns, naming conventions, and imported frameworks.

Layer Files
testing 6
utility 4
presentation 1

utility

presentation

testing

  • test_error_correction.py (py, 10 symbols)
  • test_frames.py (py, 13 symbols)
  • test_integration.py (py, 16 symbols)
  • test_protocols.py (py, 12 symbols)
  • test_security.py (py, 18 symbols)
  • test_zip.py (py, 16 symbols)

Architecture Overview

2 components stacked in 1 dependency tiers (weighted Eades-Lin-Smyth ordering: arrows point from dependent to dependency, top to bottom). Labels are import counts, thick arrows the top quartile; 0 transitively implied edges are omitted. Dashed red arrows are upward dependencies: the smallest set of imports that closes every cycle and breaks the layering. Cyan components hold entry points. Interactive version: readmenator-apidocs/index.html#/flows.

flowchart TB
    classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
    subgraph lane_0["Tier 1"]
        direction LR
        n_d__root_["(root)<br/>1 files, 0 symbols<br/>Core / utility"]:::default
        n_c0["root<br/>4 files, 109 symbols<br/>Core / utility"]:::default
    end
Loading

Execution Flows

Entry points are scored from __main__ guards, main functions, entry-style names and files, and call-graph sources. Each flow walks resolved calls in call-site order (depth <= 4, <= 40 steps); numbers give the call order, dashed arrows revisit an already expanded callee, red arrows are recursion. Interactive version with zoom and per-node docs: readmenator-apidocs/index.html#/flows.

lazyown_infinitestorage.CLIRunner.run

lazyown_infinitestorage.py:729, score 18: entry-style name run.

Control flow:

flowchart TB
    classDef decision fill:#1e1b4b,stroke:#a78bfa,color:#ede9fe;
    classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
    classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
    n_s1(["start lazyown_infinitestorage.CLIRunner.run"]):::entry
    n_s2{"args.gui?"}:::decision
    n_s3(["return after run(), GUIRunner()<br/>PyQt5 graphical user interface for LazyOwnInf..."]):::entry
    n_s4{"args.serve?"}:::decision
    n_s5(["return after run(), WebRunner()<br/>Flask web server interface for LazyOwnInfinit..."]):::entry
    n_s6{"not args.mode?"}:::decision
    n_s7{"args.mode == 'test'?"}:::decision
    n_s8(["return after run_tests()<br/>Executes built-in round-trip tests for both p..."]):::entry
    n_s9{"args.mode == 'encode'?"}:::decision
    n_s10{"not args.input or not args.output or (not args.frame_size)?"}:::decision
    n_s11["encode()<br/>Encodes a file into a video using the specifi..."]:::default
    n_s12{"args.mode == 'decode'?"}:::decision
    n_s13{"not args.input or not args.output?"}:::decision
    n_s14["decode()<br/>Decodes a video back into the original file u..."]:::default
    n_s15{"args.mode == 'zip-to-video'?"}:::decision
    n_s16{"not args.zip_source or not args.output or (not args.frame..."}:::decision
    n_s17["zip_to_video()<br/>Zip a file or directory then encode the archi..."]:::default
    n_s18{"args.mode == 'video-to-zip'?"}:::decision
    n_s19{"not args.input or not args.zip_output_dir?"}:::decision
    n_s20["video_to_zip()<br/>Decode a video to a zip archive then extract..."]:::default
    n_s21(["end"]):::entry
    n_s1 --> n_s2
    n_s2 -->|"yes"| n_s3
    n_s2 -->|"no"| n_s4
    n_s4 -->|"yes"| n_s5
    n_s4 -->|"no"| n_s6
    n_s6 -->|"yes"| n_s7
    n_s6 -->|"no"| n_s7
    n_s7 -->|"yes"| n_s8
    n_s7 -->|"no"| n_s9
    n_s9 -->|"yes"| n_s10
    n_s10 -->|"yes"| n_s11
    n_s10 -->|"no"| n_s11
    n_s9 -->|"no"| n_s12
    n_s12 -->|"yes"| n_s13
    n_s13 -->|"yes"| n_s14
    n_s13 -->|"no"| n_s14
    n_s12 -->|"no"| n_s15
    n_s15 -->|"yes"| n_s16
    n_s16 -->|"yes"| n_s17
    n_s16 -->|"no"| n_s17
    n_s15 -->|"no"| n_s18
    n_s18 -->|"yes"| n_s19
    n_s19 -->|"yes"| n_s20
    n_s19 -->|"no"| n_s20
    n_s11 --> n_s21
    n_s14 --> n_s21
    n_s17 --> n_s21
    n_s20 --> n_s21
    n_s18 -->|"no"| n_s21
Loading

Call tree:

flowchart LR
    classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
    classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
    n_lazyown_infinitestorage_py__run["lazyown_infinitestorage.CLIRunner.run<br/>lazyown_infinitestorage.py:729"]:::entry
    n_lazyown_infinitestorage_py__GUIRunner["lazyown_infinitestorage.GUIRunner<br/>PyQt5 graphical user interface for LazyOwnInf...<br/>lazyown_infinitestorage.py:802"]:::default
    n_lazyown_infinitestorage_py__WebRunner["lazyown_infinitestorage.WebRunner<br/>Flask web server interface for LazyOwnInfinit...<br/>lazyown_infinitestorage.py:949"]:::default
    n_lazyown_infinitestorage_py__run_tests["lazyown_infinitestorage.run_tests<br/>Executes built-in round-trip tests for both p...<br/>lazyown_infinitestorage.py:1072"]:::default
    n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig<br/>Centralized immutable configuration constants...<br/>lazyown_infinitestorage.py:72"]:::default
    n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage<br/>Main orchestrator for encoding and decoding f...<br/>lazyown_infinitestorage.py:527"]:::default
    n_lazyown_infinitestorage_py__encode["lazyown_infinitestorage.LazyOwnInfiniteStorage.encode<br/>Encodes a file into a video using the specifi...<br/>lazyown_infinitestorage.py:544"]:::default
    n_lazyown_infinitestorage_py__validate_file_path["lazyown_infinitestorage.SecurityValidator.validate_file_path<br/>Resolves and validates an absolute file path.<br/>lazyown_infinitestorage.py:162"]:::default
    n_lazyown_infinitestorage_py__validate_size["lazyown_infinitestorage.SecurityValidator.validate_size<br/>Ensures the file size is within acceptable li...<br/>lazyown_infinitestorage.py:172"]:::default
    n_lazyown_infinitestorage_py___validate_encoding_parameters["lazyown_infinitestorage.LazyOwnInfiniteStorage._validate_...<br/>lazyown_infinitestorage.py:578"]:::default
    n_lazyown_infinitestorage_py__bits_to_frames["lazyown_infinitestorage.FrameEncoder.bits_to_frames<br/>Yields grayscale frames from a bit string.<br/>lazyown_infinitestorage.py:256"]:::default
    n_lazyown_infinitestorage_py___create_frame["lazyown_infinitestorage.FrameEncoder._create_frame<br/>lazyown_infinitestorage.py:271"]:::default
    n_lazyown_infinitestorage_py__encode_video["lazyown_infinitestorage.FFmpegPipeline.encode_video<br/>Encodes a generator of frames into a video fi...<br/>lazyown_infinitestorage.py:374"]:::default
    n_lazyown_infinitestorage_py__decode["lazyown_infinitestorage.LazyOwnInfiniteStorage.decode<br/>Decodes a video back into the original file u...<br/>lazyown_infinitestorage.py:567"]:::default
    n_lazyown_infinitestorage_py___detect_protocol["lazyown_infinitestorage.LazyOwnInfiniteStorage._detect_pr...<br/>lazyown_infinitestorage.py:588"]:::default
    n_lazyown_infinitestorage_py__get_video_info["lazyown_infinitestorage.FFmpegPipeline.get_video_info<br/>Retrieves native resolution and metadata from...<br/>lazyown_infinitestorage.py:319"]:::default
    n_lazyown_infinitestorage_py__extract_raw_frames["lazyown_infinitestorage.FFmpegPipeline.extract_raw_frames<br/>Extracts raw grayscale frames from a video fi...<br/>lazyown_infinitestorage.py:401"]:::default
    n_lazyown_infinitestorage_py__extract_bits_from_raw_frames["lazyown_infinitestorage.FrameDecoder.extract_bits_from_ra...<br/>Extracts a bit string from rawvideo grayscale...<br/>lazyown_infinitestorage.py:287"]:::default
    n_lazyown_infinitestorage_py__decode_data["lazyown_infinitestorage.ErrorCorrector.decode_data<br/>Decodes a Hamming(8,4) encoded byte sequence...<br/>lazyown_infinitestorage.py:208"]:::default
    n_lazyown_infinitestorage_py___decode_legacy["lazyown_infinitestorage.LazyOwnInfiniteStorage._decode_le...<br/>lazyown_infinitestorage.py:621"]:::default
    n_lazyown_infinitestorage_py__unpack_459["lazyown_infinitestorage.LegacyProtocolHandler.unpack<br/>lazyown_infinitestorage.py:459"]:::default
    n_lazyown_infinitestorage_py___decode_secure["lazyown_infinitestorage.LazyOwnInfiniteStorage._decode_se...<br/>lazyown_infinitestorage.py:634"]:::default
    n_lazyown_infinitestorage_py__unpack_499["lazyown_infinitestorage.SecureProtocolHandler.unpack<br/>lazyown_infinitestorage.py:499"]:::default
    n_lazyown_infinitestorage_py__run -->|"1"| n_lazyown_infinitestorage_py__GUIRunner
    n_lazyown_infinitestorage_py__run -->|"2"| n_lazyown_infinitestorage_py__WebRunner
    n_lazyown_infinitestorage_py__run -->|"3"| n_lazyown_infinitestorage_py__run_tests
    n_lazyown_infinitestorage_py__run_tests -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
    n_lazyown_infinitestorage_py__run_tests -->|"2"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
    n_lazyown_infinitestorage_py__run_tests -->|"3"| n_lazyown_infinitestorage_py__encode
    n_lazyown_infinitestorage_py__encode -->|"1"| n_lazyown_infinitestorage_py__validate_file_path
    n_lazyown_infinitestorage_py__encode -->|"2"| n_lazyown_infinitestorage_py__validate_size
    n_lazyown_infinitestorage_py__encode -->|"3"| n_lazyown_infinitestorage_py___validate_encoding_parameters
    n_lazyown_infinitestorage_py__encode -->|"4"| n_lazyown_infinitestorage_py__bits_to_frames
    n_lazyown_infinitestorage_py__bits_to_frames -->|"1"| n_lazyown_infinitestorage_py___create_frame
    n_lazyown_infinitestorage_py__encode -->|"5"| n_lazyown_infinitestorage_py__encode_video
    n_lazyown_infinitestorage_py__run_tests -->|"4"| n_lazyown_infinitestorage_py__decode
    n_lazyown_infinitestorage_py__decode -.-> n_lazyown_infinitestorage_py__validate_file_path
    n_lazyown_infinitestorage_py__decode -->|"1"| n_lazyown_infinitestorage_py___detect_protocol
    n_lazyown_infinitestorage_py___detect_protocol -->|"1"| n_lazyown_infinitestorage_py__get_video_info
    n_lazyown_infinitestorage_py___detect_protocol -->|"2"| n_lazyown_infinitestorage_py__extract_raw_frames
    n_lazyown_infinitestorage_py___detect_protocol -->|"3"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
    n_lazyown_infinitestorage_py___detect_protocol -->|"4"| n_lazyown_infinitestorage_py__decode_data
    n_lazyown_infinitestorage_py__decode -->|"2"| n_lazyown_infinitestorage_py___decode_legacy
    n_lazyown_infinitestorage_py___decode_legacy -->|"1"| n_lazyown_infinitestorage_py__extract_raw_frames
    n_lazyown_infinitestorage_py___decode_legacy -->|"2"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
    n_lazyown_infinitestorage_py___decode_legacy -->|"3"| n_lazyown_infinitestorage_py__unpack_459
    n_lazyown_infinitestorage_py__decode -->|"3"| n_lazyown_infinitestorage_py___decode_secure
    n_lazyown_infinitestorage_py___decode_secure -->|"1"| n_lazyown_infinitestorage_py__extract_raw_frames
    n_lazyown_infinitestorage_py___decode_secure -->|"2"| n_lazyown_infinitestorage_py__extract_bits_from_raw_frames
    n_lazyown_infinitestorage_py___decode_secure -->|"3"| n_lazyown_infinitestorage_py__unpack_499
Loading

lazyown_infinitestorage (__main__)

lazyown_infinitestorage.py:1128, score 8: if __name__ == "__main__" guard.

Call tree:

flowchart LR
    classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
    classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
    n_lazyown_infinitestorage_py___main_["lazyown_infinitestorage (__main__)<br/>lazyown_infinitestorage.py"]:::entry
    n_lazyown_infinitestorage_py__main["lazyown_infinitestorage.main<br/>Entry point for LazyOwnInfiniteStorage.<br/>lazyown_infinitestorage.py:1120"]:::default
    n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage<br/>Main orchestrator for encoding and decoding f...<br/>lazyown_infinitestorage.py:527"]:::default
    n_lazyown_infinitestorage_py__CLIRunner["lazyown_infinitestorage.CLIRunner<br/>Command-line interface runner for LazyOwnInfi...<br/>lazyown_infinitestorage.py:723"]:::default
    n_lazyown_infinitestorage_py__run["lazyown_infinitestorage.CLIRunner.run<br/>lazyown_infinitestorage.py:729"]:::default
    n_lazyown_infinitestorage_py__GUIRunner["lazyown_infinitestorage.GUIRunner<br/>PyQt5 graphical user interface for LazyOwnInf...<br/>lazyown_infinitestorage.py:802"]:::default
    n_lazyown_infinitestorage_py__WebRunner["lazyown_infinitestorage.WebRunner<br/>Flask web server interface for LazyOwnInfinit...<br/>lazyown_infinitestorage.py:949"]:::default
    n_lazyown_infinitestorage_py__run_tests["lazyown_infinitestorage.run_tests<br/>Executes built-in round-trip tests for both p...<br/>lazyown_infinitestorage.py:1072"]:::default
    n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig<br/>Centralized immutable configuration constants...<br/>lazyown_infinitestorage.py:72"]:::default
    n_lazyown_infinitestorage_py__encode["lazyown_infinitestorage.LazyOwnInfiniteStorage.encode<br/>Encodes a file into a video using the specifi...<br/>lazyown_infinitestorage.py:544"]:::default
    n_lazyown_infinitestorage_py__decode["lazyown_infinitestorage.LazyOwnInfiniteStorage.decode<br/>Decodes a video back into the original file u...<br/>lazyown_infinitestorage.py:567"]:::default
    n_lazyown_infinitestorage_py___main_ -->|"1"| n_lazyown_infinitestorage_py__main
    n_lazyown_infinitestorage_py__main -->|"1"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
    n_lazyown_infinitestorage_py__main -->|"2"| n_lazyown_infinitestorage_py__CLIRunner
    n_lazyown_infinitestorage_py__main -->|"3"| n_lazyown_infinitestorage_py__run
    n_lazyown_infinitestorage_py__run -->|"1"| n_lazyown_infinitestorage_py__GUIRunner
    n_lazyown_infinitestorage_py__run -->|"2"| n_lazyown_infinitestorage_py__WebRunner
    n_lazyown_infinitestorage_py__run -->|"3"| n_lazyown_infinitestorage_py__run_tests
    n_lazyown_infinitestorage_py__run_tests -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
    n_lazyown_infinitestorage_py__run_tests -.-> n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
    n_lazyown_infinitestorage_py__run_tests -->|"2"| n_lazyown_infinitestorage_py__encode
    n_lazyown_infinitestorage_py__run_tests -->|"3"| n_lazyown_infinitestorage_py__decode
Loading

mcp_server (__main__)

mcp_server.py:335, score 8: if __name__ == "__main__" guard.

Call tree:

flowchart LR
    classDef default fill:#111827,stroke:#38bdf8,color:#e5e7eb;
    classDef entry fill:#0e7490,stroke:#22d3ee,color:#ecfeff,stroke-width:2px;
    classDef external fill:#1a1530,stroke:#a78bfa,color:#ede9fe;
    n_mcp_server_py___main_["mcp_server (__main__)<br/>mcp_server.py"]:::entry
    n_lazyown_infinitestorage_py__LazyOwnConfig["lazyown_infinitestorage.LazyOwnConfig<br/>Centralized immutable configuration constants...<br/>lazyown_infinitestorage.py:72"]:::external
    n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage["lazyown_infinitestorage.LazyOwnInfiniteStorage<br/>Main orchestrator for encoding and decoding f...<br/>lazyown_infinitestorage.py:527"]:::external
    n_mcp_server_py__main["mcp_server.main<br/>Entry point for the LazyOwnInfiniteStorage MC...<br/>mcp_server.py:330"]:::default
    n_mcp_server_py___run["mcp_server._run<br/>mcp_server.py:302"]:::default
    n_mcp_server_py___main_ -->|"1"| n_lazyown_infinitestorage_py__LazyOwnConfig
    n_mcp_server_py___main_ -->|"2"| n_lazyown_infinitestorage_py__LazyOwnInfiniteStorage
    n_mcp_server_py___main_ -->|"3"| n_mcp_server_py__main
    n_mcp_server_py__main -->|"1"| n_mcp_server_py___run
Loading

Cross-file sequence:

sequenceDiagram
    autonumber
    participant p_mcp_server_py as mcp_server.py
    participant p_lazyown_infinitestorage_py as lazyown_infinitestorage.py
    p_mcp_server_py->>p_lazyown_infinitestorage_py: LazyOwnConfig()
    p_mcp_server_py->>p_lazyown_infinitestorage_py: LazyOwnInfiniteStorage()
Loading

Ranked Context

Files ranked by composite score for the current query context. The ranking combines Personalized PageRank (query relevance), global authority, test coverage, documentation coverage, and code freshness. Model: v1.0.

Rank File Composite PPR Authority Test Doc
1 lazyown_infinitestorage.py 0.3697 0.4901 0.4901 0.00 0.51
2 wsgi_app.py 0.2368 0.0567 0.0567 0.00 2.00
3 tools.py 0.1277 0.0567 0.0567 0.00 0.91
4 install.sh 0.1000 0.0000 0.0000 0.00 1.00
5 test_zip.py 0.0681 0.0567 0.0567 0.00 0.31
6 test_protocols.py 0.0618 0.0567 0.0567 0.00 0.25
7 test_frames.py 0.0599 0.0567 0.0567 0.00 0.23
8 test_error_correction.py 0.0568 0.0567 0.0567 0.00 0.20
9 test_integration.py 0.0556 0.0567 0.0567 0.00 0.19
10 test_security.py 0.0535 0.0567 0.0567 0.00 0.17

God Nodes

Most architecturally central files ranked by combined import/export degree and symbol richness.

File Score Connections PageRank
lazyown_infinitestorage.py 26.4 0.4901
test_security.py 3.8 0.0567
test_integration.py 3.6 0.0567
test_zip.py 3.6 0.0567
mcp_server.py 3.3 0.0000
test_frames.py 3.3 0.0567
test_protocols.py 3.2 0.0567
tools.py 3.1 0.0567
test_error_correction.py 3.0 0.0567
wsgi_app.py 2.1 0.0567

Community Analysis

Files grouped by import-based community detection. Cohesion measures how tightly connected each community is internally.

root (Cohesion: 1.00)

10 files in this community:

  • lazyown_infinitestorage.py (py, 84 symbols)
  • mcp_server.py (py, 13 symbols)
  • tools.py (py, 11 symbols)
  • test_error_correction.py (py, 10 symbols)
  • test_frames.py (py, 13 symbols)
  • test_integration.py (py, 16 symbols)
  • test_protocols.py (py, 12 symbols)
  • test_security.py (py, 18 symbols)
  • test_zip.py (py, 16 symbols)
  • wsgi_app.py (py, 1 symbols)

Suggested Questions

Auto-generated exploration prompts based on graph structure:

  • What does lazyown_infinitestorage.py depend on, and what depends on it? (9 connections)
  • What does test_security.py depend on, and what depends on it? (1 connections)
  • What does test_integration.py depend on, and what depends on it? (1 connections)
  • How are the 10 files in 'root' related to each other?
  • What is LazyOwnConfig in lazyown_infinitestorage.py and how is it used?

Force-Graph Explorer

Heterogeneous explorer payload (files, communities, layers, externals) rendered with force-graph physics, stable family colors, log2 node sizing, and convex-hull community overlays. Open readmenator-maps/graph-force.html (linked from the maps gallery) or run explorer.

  • Nodes: 47 (community: 1, external: 32, file: 11, layer: 3)
  • Edges: 86

Corpus Analytics

Attribution funnel and distributions for the explorer dashboard.

  • Files: 11 | With symbols: 10 | Attributed: 10 | God nodes: 10 | Symbols: 194

  • Layer testing: 6 files

  • Layer utility: 4 files

  • Layer presentation: 1 files

  • Language py: 10 files

  • Language sh: 1 files

Taint Propagation Map

Taint analysis traces how dangerous imports propagate through the codebase via transitive dependencies. Source files import dangerous modules directly; sink files receive the danger indirectly.

Taint Sources: 3 | Taint Sinks: 3 | Propagation Paths: 5

  • lazyown_infinitestorage.py imports subprocess (0 hop to lazyown_infinitestorage.py) [high] Path: lazyown_infinitestorage.py
  • tools.py imports subprocess (0 hop to tools.py) [high] Path: tools.py
  • tools.py imports subprocess (1 hop to lazyown_infinitestorage.py) [high] Path: tools.py -> lazyown_infinitestorage.py
  • test_integration.py imports subprocess (0 hop to test_integration.py) [high] Path: test_integration.py
  • test_integration.py imports subprocess (1 hop to lazyown_infinitestorage.py) [high] Path: test_integration.py -> lazyown_infinitestorage.py

Hotspot Analysis

Files ranked by combined complexity (symbol count) and centrality (connection count). High-scoring files are architecturally critical and may need refactoring attention.

File Complexity Centrality Combined Symbols Connections
lazyown_infinitestorage.py 1.000 1.000 1.000 84 29
wsgi_app.py 0.012 0.103 0.067 1 3
tools.py 0.131 0.414 0.301 11 12
install.sh 0.000 0.000 0.000 0 0
test_zip.py 0.191 0.207 0.200 16 6
test_protocols.py 0.143 0.103 0.119 12 3
test_frames.py 0.155 0.138 0.145 13 4
test_error_correction.py 0.119 0.103 0.110 10 3
test_integration.py 0.191 0.345 0.283 16 10
test_security.py 0.214 0.138 0.169 18 4
mcp_server.py 0.155 0.310 0.248 13 9

Concept Graph

Semantic second-brain layer: nouns are concept nodes, verbs are edges. Each noun maps atomically to a file set (EXTRACTED); each verb aggregates structural imports, calls, and inherits into consumes, invokes, extends, depends_on, or bridges (INFERRED).

50 concepts, 100 relations.

Concept Files Mentions
setup 7 14
protocol 6 23
bit 6 17
lazy 6 17
own 6 17
encode 6 16
specification 6 13
video 5 33
decode 5 17
extract 5 16
infinite 5 14
storage 5 14
files 5 6
zip 4 42
file 4 25
frame 4 15
security 4 12
roundtrip 4 11
create 4 9
secure 4 9
filename 4 8
get 4 7
size 4 7
original 4 5
bytes 4 4
unit 4 4
error 3 13
path 3 13
data 3 11
web 3 11

Verb Edges

Source Verb Target Strength Evidence
setup depends_on back 1.00 6
setup depends_on bit 1.00 6
setup depends_on blocks 1.00 6
setup depends_on bytes 1.00 6
setup depends_on correction 1.00 6
setup depends_on create 1.00 6
setup depends_on data 1.00 6
setup depends_on decode 1.00 6
setup depends_on encode 1.00 6
setup depends_on encoded 1.00 6
setup depends_on encodes 1.00 6
setup depends_on entry 1.00 6
setup depends_on error 1.00 6
setup depends_on extract 1.00 6
setup depends_on file 1.00 6
setup depends_on filename 1.00 6
setup depends_on files 1.00 6
setup depends_on frame 1.00 6
setup depends_on frames 1.00 6
setup depends_on get 1.00 6
setup depends_on hamming 1.00 6
setup depends_on infinite 1.00 6
setup depends_on lazy 1.00 6
setup depends_on legacy 1.00 6
setup depends_on original 1.00 6
setup depends_on own 1.00 6
setup depends_on path 1.00 6
setup depends_on pipeline 1.00 6
setup depends_on point 1.00 6
setup depends_on protocol 1.00 6

Dialectic Prompts

  • Thesis: back centralizes 3 files; Antithesis: blocks pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: create pulls 4 files with 2 shared (Jaccard 0.40); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: decode pulls 5 files with 3 shared (Jaccard 0.60); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: encode pulls 6 files with 3 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: encoded pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: encodes pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: error pulls 3 files with 2 shared (Jaccard 0.50); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: extract pulls 5 files with 2 shared (Jaccard 0.33); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: file pulls 4 files with 3 shared (Jaccard 0.75); Synthesis: should they merge, split by layer, or keep bridges explicit?
  • Thesis: back centralizes 3 files; Antithesis: files pulls 5 files with 3 shared (Jaccard 0.60); Synthesis: should they merge, split by layer, or keep bridges explicit?

Change Impact Analysis

Files sorted by how many other files would be affected if they changed. High-impact files should be changed with caution.

File Direct Dependents Transitive Dependents Total Impact
lazyown_infinitestorage.py 9 0 9
install.sh 0 0 0
mcp_server.py 0 0 0
tools.py 0 0 0
test_error_correction.py 0 0 0
test_frames.py 0 0 0
test_integration.py 0 0 0
test_protocols.py 0 0 0
test_security.py 0 0 0
test_zip.py 0 0 0
wsgi_app.py 0 0 0

Architecture Violations

Violations of architectural layer rules detected in the import graph. 6 strict violations, 0 warnings.

Source Source Layer Target Target Layer Description Severity
test_error_correction.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict
test_frames.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict
test_integration.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict
test_protocols.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict
test_security.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict
test_zip.py testing lazyown_infinitestorage.py presentation testing must not import presentation strict

Suggested Linting Rules

Automatically suggested linting and security rules based on patterns detected in the codebase. These can be exported as Semgrep rules using the --export-rules flag.

Rule ID Severity Description Language Matches
RM001 info Large number of functions in py: 165 total py 165
RM002 info Print statement found (consider logging instead) python 8

Query Recipes

Example queries you can run against this knowledge base using the ranking engine:

# Find files most relevant to a concept
readmenator query "Where is the import resolver implemented?"

# Rank files by relevance to a topic
readmenator query "How does documentation generation work?"

# Explain why a file ranks highly
readmenator query "explain readmenator/_documentation.py"

# Trace dependency paths with ranked context
readmenator query "path from CLI to exporter"

The ranking model uses the following signals:

  • Personalized PageRank (45% weight): query-specific relevance via seed propagation
  • Global Authority (20% weight): structural importance via standard PageRank
  • Test Coverage (15% weight): fraction of symbols referenced in test files
  • Doc Coverage (10% weight): presence of docstrings and file-level docs
  • Freshness (10% weight): recent modification activity

Results include score decomposition and justification paths for each ranked item.

Structural Knowledge Map

Note: The visual graph below has been intelligently pruned to the top 300 most relevant nodes to prevent rendering crashes. Full details of all files are documented in the Architecture Reference.

graph LR
    classDef mod fill:#1e1e1e,stroke:#ff6666,stroke-width:2px,color:#fff;
    classDef cls fill:#2d2d2d,stroke:#4ec9b0,stroke-width:2px,color:#fff;
    classDef fn fill:#333,stroke:#dcdcaa,stroke-width:1px,color:#dcdcaa;
    classDef ext fill:#111,stroke:#666,stroke-dasharray:5 5,color:#aaa;
    subgraph community_0 ["root"]
    lazyown_infinitestorage_py["lazyown_infinitestorage.py (py)"]
    class lazyown_infinitestorage_py mod;
    lazyown_infinitestorage_py_LazyOwnConfig["LazyOwnConfig"]
    class lazyown_infinitestorage_py_LazyOwnConfig cls;
    lazyown_infinitestorage_py --> lazyown_infinitestorage_py_LazyOwnConfig
    lazyown_infinitestorage_py_SecurityValidator["SecurityValidator"]
    class lazyown_infinitestorage_py_SecurityValidator cls;
    lazyown_infinitestorage_py --> lazyown_infinitestorage_py_SecurityValidator
    lazyown_infinitestorage_py_ErrorCorrector["ErrorCorrector"]
    class lazyown_infinitestorage_py_ErrorCorrector cls;
    lazyown_infinitestorage_py --> lazyown_infinitestorage_py_ErrorCorrector
    lazyown_infinitestorage_py_FrameEncoder["FrameEncoder"]
    class lazyown_infinitestorage_py_FrameEncoder cls;
    lazyown_infinitestorage_py --> lazyown_infinitestorage_py_FrameEncoder
    lazyown_infinitestorage_py_FrameDecoder["FrameDecoder"]
    class lazyown_infinitestorage_py_FrameDecoder cls;
    lazyown_infinitestorage_py --> lazyown_infinitestorage_py_FrameDecoder
    skill_lazyown_infinitestorage_tools_py["tools.py (py)"]
    class skill_lazyown_infinitestorage_tools_py mod;
    tests_test_integration_py["test_integration.py (py)"]
    class tests_test_integration_py mod;
    mcp_server_py["mcp_server.py (py)"]
    class mcp_server_py mod;
    tests_test_zip_py["test_zip.py (py)"]
    class tests_test_zip_py mod;
    tests_test_security_py["test_security.py (py)"]
    class tests_test_security_py mod;
    tests_test_frames_py["test_frames.py (py)"]
    class tests_test_frames_py mod;
    tests_test_protocols_py["test_protocols.py (py)"]
    class tests_test_protocols_py mod;
    tests_test_error_correction_py["test_error_correction.py (py)"]
    class tests_test_error_correction_py mod;
    wsgi_app_py["wsgi_app.py (py)"]
    class wsgi_app_py mod;
    install_sh["install.sh (sh)"]
    class install_sh mod;
    end
    lazyown_infinitestorage_py ~~~ tests_test_frames_py
    skill_lazyown_infinitestorage_tools_py ~~~ tests_test_protocols_py
    tests_test_integration_py ~~~ tests_test_error_correction_py
    mcp_server_py ~~~ wsgi_app_py
    mcp_server_py -- resolved_imports --> lazyown_infinitestorage_py
    skill_lazyown_infinitestorage_tools_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_error_correction_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_frames_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_integration_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_protocols_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_security_py -- resolved_imports --> lazyown_infinitestorage_py
    tests_test_zip_py -- resolved_imports --> lazyown_infinitestorage_py
    wsgi_app_py -- resolved_imports --> lazyown_infinitestorage_py
    ext_argparse["argparse"]
    class ext_argparse ext;
    lazyown_infinitestorage_py -.->|imports| ext_argparse
    ext_binascii["binascii"]
    class ext_binascii ext;
    lazyown_infinitestorage_py -.->|imports| ext_binascii
    ext_math["math"]
    class ext_math ext;
    lazyown_infinitestorage_py -.->|imports| ext_math
    ext_os["os"]
    class ext_os ext;
    lazyown_infinitestorage_py -.->|imports| ext_os
    ext_re["re"]
    class ext_re ext;
    lazyown_infinitestorage_py -.->|imports| ext_re
    ext_struct["struct"]
    class ext_struct ext;
    lazyown_infinitestorage_py -.->|imports| ext_struct
    ext_subprocess["subprocess"]
    class ext_subprocess ext;
    lazyown_infinitestorage_py -.->|imports| ext_subprocess
    ext_sys["sys"]
    class ext_sys ext;
    lazyown_infinitestorage_py -.->|imports| ext_sys
    ext_tempfile["tempfile"]
    class ext_tempfile ext;
    lazyown_infinitestorage_py -.->|imports| ext_tempfile
    ext_hashlib["hashlib"]
    class ext_hashlib ext;
    lazyown_infinitestorage_py -.->|imports| ext_hashlib
    ext_random["random"]
    class ext_random ext;
    lazyown_infinitestorage_py -.->|imports| ext_random
    ext_shutil["shutil"]
    class ext_shutil ext;
    lazyown_infinitestorage_py -.->|imports| ext_shutil
    ext_zipfile["zipfile"]
    class ext_zipfile ext;
    lazyown_infinitestorage_py -.->|imports| ext_zipfile
    ext_typing["typing"]
    class ext_typing ext;
    lazyown_infinitestorage_py -.->|imports| ext_typing
    ext_numpy["numpy"]
    class ext_numpy ext;
    lazyown_infinitestorage_py -.->|imports| ext_numpy
    ext_cv2["cv2"]
    class ext_cv2 ext;
    lazyown_infinitestorage_py -.->|imports| ext_cv2
    ext_flask["flask"]
    class ext_flask ext;
    lazyown_infinitestorage_py -.->|imports| ext_flask
    ext_PyQt5_QtWidgets["PyQt5.QtWidgets"]
    class ext_PyQt5_QtWidgets ext;
    lazyown_infinitestorage_py -.->|imports| ext_PyQt5_QtWidgets
    ext_PyQt5_QtCore["PyQt5.QtCore"]
    class ext_PyQt5_QtCore ext;
    lazyown_infinitestorage_py -.->|imports| ext_PyQt5_QtCore
    ext_json["json"]
    class ext_json ext;
    lazyown_infinitestorage_py -.->|imports| ext_json
    ext_asyncio["asyncio"]
    class ext_asyncio ext;
    mcp_server_py -.->|imports| ext_asyncio
    mcp_server_py -.->|imports| ext_os
    mcp_server_py -.->|imports| ext_sys
    mcp_server_py -.->|imports| ext_typing
    ext_lazyown_infinitestorage["lazyown_infinitestorage"]
    class ext_lazyown_infinitestorage ext;
    mcp_server_py -.->|imports| ext_lazyown_infinitestorage
    ext_mcp_server["mcp.server"]
    class ext_mcp_server ext;
    mcp_server_py -.->|imports| ext_mcp_server
    ext_mcp_server_stdio["mcp.server.stdio"]
    class ext_mcp_server_stdio ext;
    mcp_server_py -.->|imports| ext_mcp_server_stdio
Loading

UML Class Diagram

Auto-generated Mermaid class diagrams from parsed class-level symbols, split into groups of at most 6 classes so each diagram stays readable. Per-module class diagrams with exact members live in readmenator-apidocs/modules/.

lazyown_infinitestorage.py

classDiagram
  direction LR
  class lazyown_infinitestorage_py_LazyOwnConfig {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_SecurityValidator {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_ErrorCorrector {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_FrameEncoder {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_FrameDecoder {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_FFmpegPipeline {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_ProtocolHandler {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_LegacyProtocolHandler {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_SecureProtocolHandler {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_LazyOwnInfiniteStorage {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_CLIRunner {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_Worker {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_GUIRunner {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_GUIRunner {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_WebRunner {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
  class lazyown_infinitestorage_py_WebRunner {
    <<class>>
    +run_tests()
    +main()
    +__init__(self, config)
    +validate_file_path(self, file_path, must_exist)
    +validate_size(self, size)
    +sanitize_filename(self, filename)
    +validate_extension(self, file_path, allowed_extensions)
    +__init__(self, config)
    +encode_data(self, data)
    +decode_data(self, data)
  }
Loading

tests/test_error_correction.py, tests/test_frames.py, tests/test_integration.py 

classDiagram
  direction LR
  class test_error_correction_py_TestErrorCorrector {
    <<class>>
    +setup(self)
    +test_encode_data_doubles_length(self)
    +test_decode_data_reverses_encoding(self)
    +test_decode_data_with_single_bit_error(self)
    +test_decode_data_rejects_odd_length(self)
    +test_encode_nibble_all_values(self)
    +test_decode_nibble_all_values(self)
    +test_roundtrip_various_inputs(self, data)
    +test_single_bit_error_per_nibble(self, nibble)
  }
  class test_frames_py_TestFrameEncoder {
    <<class>>
    +setup(self)
    +test_bits_to_frames_yields_correct_number_of_frames(self)
    +test_each_frame_has_correct_dimensions(self)
    +test_bit_one_produces_white_block(self)
    +test_bit_zero_produces_black_block(self)
    +test_padding_zeros_fill_incomplete_frame(self)
    +setup(self)
    +test_extract_bits_from_empty_raises(self)
    +test_extract_bits_from_raw_frames_basic(self)
    +test_extract_bits_respects_expected_bits(self)
  }
  class test_frames_py_TestFrameDecoder {
    <<class>>
    +setup(self)
    +test_bits_to_frames_yields_correct_number_of_frames(self)
    +test_each_frame_has_correct_dimensions(self)
    +test_bit_one_produces_white_block(self)
    +test_bit_zero_produces_black_block(self)
    +test_padding_zeros_fill_incomplete_frame(self)
    +setup(self)
    +test_extract_bits_from_empty_raises(self)
    +test_extract_bits_from_raw_frames_basic(self)
    +test_extract_bits_respects_expected_bits(self)
  }
  class test_integration_py_TestEncodeDecodeRoundtrip {
    <<class>>
    +setup(self)
    +test_secure_protocol_roundtrip(self)
    +test_legacy_protocol_roundtrip(self)
    +test_secure_protocol_resilient_to_resolution_change(self)
    +test_protocol_auto_detection_prefers_secure(self)
    +test_empty_file_roundtrip(self)
    +test_large_file_roundtrip(self)
    +setup(self)
    +test_index_get(self)
    +test_encode_upload(self)
  }
  class test_integration_py_TestWebRunner {
    <<class>>
    +setup(self)
    +test_secure_protocol_roundtrip(self)
    +test_legacy_protocol_roundtrip(self)
    +test_secure_protocol_resilient_to_resolution_change(self)
    +test_protocol_auto_detection_prefers_secure(self)
    +test_empty_file_roundtrip(self)
    +test_large_file_roundtrip(self)
    +setup(self)
    +test_index_get(self)
    +test_encode_upload(self)
  }
Loading

tests/test_protocols.py, tests/test_security.py 

classDiagram
  direction LR
  class test_protocols_py_TestLegacyProtocolHandler {
    <<class>>
    +setup(self)
    +test_pack_includes_end_marker(self)
    +test_unpack_strips_end_marker(self)
    +test_unpack_with_trailing_zeros(self)
    +setup(self)
    +test_pack_produces_bit_string(self)
    +test_unpack_recovers_original_data(self)
    +test_unpack_detects_corrupted_header(self)
    +test_unpack_detects_corrupted_payload(self)
    +test_roundtrip_various_sizes(self, size)
  }
  class test_protocols_py_TestSecureProtocolHandler {
    <<class>>
    +setup(self)
    +test_pack_includes_end_marker(self)
    +test_unpack_strips_end_marker(self)
    +test_unpack_with_trailing_zeros(self)
    +setup(self)
    +test_pack_produces_bit_string(self)
    +test_unpack_recovers_original_data(self)
    +test_unpack_detects_corrupted_header(self)
    +test_unpack_detects_corrupted_payload(self)
    +test_roundtrip_various_sizes(self, size)
  }
  class test_security_py_TestLazyOwnConfig {
    <<class>>
    +test_magic_bytes_are_valid(self)
    +test_protocol_versions_are_distinct(self)
    +test_default_values_within_bounds(self)
    +test_header_offsets_are_consistent(self)
    +test_max_file_size_is_reasonable(self)
    +setup(self)
    +test_validate_file_path_resolves_absolute(self)
    +test_validate_file_path_rejects_traversal(self)
    +test_validate_file_path_must_exist_when_required(self)
    +test_validate_size_rejects_oversized_files(self)
  }
  class test_security_py_TestSecurityValidator {
    <<class>>
    +test_magic_bytes_are_valid(self)
    +test_protocol_versions_are_distinct(self)
    +test_default_values_within_bounds(self)
    +test_header_offsets_are_consistent(self)
    +test_max_file_size_is_reasonable(self)
    +setup(self)
    +test_validate_file_path_resolves_absolute(self)
    +test_validate_file_path_rejects_traversal(self)
    +test_validate_file_path_must_exist_when_required(self)
    +test_validate_size_rejects_oversized_files(self)
  }
Loading

tests/test_zip.py

classDiagram
  direction LR
  class test_zip_py_TestZipRoundtrip {
    <<class>>
    +setup(self)
    +_make_source_dir(self, tmpdir)
    +test_zip_to_video_roundtrip_secure(self)
    +test_create_and_extract_zip_roundtrip(self)
    +setup(self)
    +test_extract_zip_blocks_path_traversal(self)
    +test_extract_zip_blocks_uncompressed_bomb(self)
    +setup(self)
    +test_encode_rejects_output_path_traversal(self)
    +setup(self)
  }
  class test_zip_py_TestZipSecurity {
    <<class>>
    +setup(self)
    +_make_source_dir(self, tmpdir)
    +test_zip_to_video_roundtrip_secure(self)
    +test_create_and_extract_zip_roundtrip(self)
    +setup(self)
    +test_extract_zip_blocks_path_traversal(self)
    +test_extract_zip_blocks_uncompressed_bomb(self)
    +setup(self)
    +test_encode_rejects_output_path_traversal(self)
    +setup(self)
  }
  class test_zip_py_TestEncodeOutputValidation {
    <<class>>
    +setup(self)
    +_make_source_dir(self, tmpdir)
    +test_zip_to_video_roundtrip_secure(self)
    +test_create_and_extract_zip_roundtrip(self)
    +setup(self)
    +test_extract_zip_blocks_path_traversal(self)
    +test_extract_zip_blocks_uncompressed_bomb(self)
    +setup(self)
    +test_encode_rejects_output_path_traversal(self)
    +setup(self)
  }
  class test_zip_py_TestSecurityValidatorUnchanged {
    <<class>>
    +setup(self)
    +_make_source_dir(self, tmpdir)
    +test_zip_to_video_roundtrip_secure(self)
    +test_create_and_extract_zip_roundtrip(self)
    +setup(self)
    +test_extract_zip_blocks_path_traversal(self)
    +test_extract_zip_blocks_uncompressed_bomb(self)
    +setup(self)
    +test_encode_rejects_output_path_traversal(self)
    +setup(self)
  }
Loading

Code Property Graph

Machine-readable Code Property Graph (CPG) in JSON-LD format. This block allows AI agents to parse the full structural graph without additional file reads. Compatible with GraphRAG pipelines.

{"@context": "https://schema.org", "analysis": {"communities": [{"cohesion": 1.0, "id": 0, "label": "root", "size": 10}], "god_nodes": [{"node_id": "lazyown_infinitestorage.py", "score": 26.4}, {"node_id": "tests/test_security.py", "score": 3.8}, {"node_id": "tests/test_integration.py", "score": 3.6}, {"node_id": "tests/test_zip.py", "score": 3.6}, {"node_id": "mcp_server.py", "score": 3.3}, {"node_id": "tests/test_frames.py", "score": 3.3}, {"node_id": "tests/test_protocols.py", "score": 3.2}, {"node_id": "skill_lazyown_infinitestorage/tools.py", "score": 3.1}, {"node_id": "tests/test_error_correction.py", "score": 3.0}, {"node_id": "wsgi_app.py", "score": 2.1}], "surprising_connections": []}, "edges": [{"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "argparse"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "binascii"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "math"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "re"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "struct"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "hashlib"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "random"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "shutil"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "zipfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "numpy"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "cv2"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "flask"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "PyQt5.QtWidgets"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "PyQt5.QtCore"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "lazyown_infinitestorage.py", "target": "json"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "asyncio"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.server"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.server.stdio"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "mcp_server.py", "target": "mcp.types"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "sys"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "time"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "typing"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.common.by"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.support.ui"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.support"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "selenium.webdriver.chrome.service"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_error_correction.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_error_correction.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "numpy"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_frames.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "hashlib"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "random"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "subprocess"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "io"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_integration.py", "target": "io"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_protocols.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_protocols.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_security.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "tempfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "zipfile"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "pytest"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "tests/test_zip.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "wsgi_app.py", "target": "os"}, {"confidence": "EXTRACTED", "relation": "imports", "source": "wsgi_app.py", "target": "lazyown_infinitestorage"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "mcp_server.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "skill_lazyown_infinitestorage/tools.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_error_correction.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_frames.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_integration.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_protocols.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_security.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "tests/test_zip.py", "target": "lazyown_infinitestorage.py"}, {"confidence": "EXTRACTED", "relation": "resolved_imports", "source": "wsgi_app.py", "target": "lazyown_infinitestorage.py"}], "generator": "readmenator", "metadata": {"edge_count": 1206, "file_count": 11, "language_count": 2, "symbol_count": 194}, "nodes": [{"doc": "Verificar si Python está instalado", "id": "install.sh", "kind": "module", "label": "install.sh", "language": "sh", "sha256": "c907d80fd6734993", "symbol_count": 0, "symbols": []}, {"doc": "LazyOwnInfiniteStorage - Production-grade file-to-video encoder/decoder.", "id": "lazyown_infinitestorage.py", "kind": "module", "label": "lazyown_infinitestorage.py", "language": "py", "sha256": "293fde059fe53e04", "symbol_count": 84, "symbols": [{"doc": "Centralized immutable configuration constants for LazyOwnInfiniteStorage.", "kind": "class", "line": 72, "name": "LazyOwnConfig", "signature": "class LazyOwnConfig"}, {"doc": "Validates file paths and inputs to prevent path traversal and abuse.", "kind": "class", "line": 156, "name": "SecurityValidator", "signature": "class SecurityValidator"}, {"doc": "Implements Hamming(8,4) extended error correction for byte streams.", "kind": "class", "line": 192, "name": "ErrorCorrector", "signature": "class ErrorCorrector"}, {"doc": "Encodes bit strings into numpy grayscale frames.", "kind": "class", "line": 250, "name": "FrameEncoder", "signature": "class FrameEncoder"}, {"doc": "Decodes grayscale frames into bit strings.", "kind": "class", "line": 281, "name": "FrameDecoder", "signature": "class FrameDecoder"}, {"doc": "Manages FFmpeg subprocess communication without intermediate frame files.", "kind": "class", "line": 313, "name": "FFmpegPipeline", "signature": "class FFmpegPipeline"}, {"doc": "Abstract base for encoding and decoding protocol implementations.", "kind": "class", "line": 436, "name": "ProtocolHandler", "signature": "class ProtocolHandler"}, {"doc": "Implements the original v1 protocol with filename-based resolution and end marker.", "kind": "class", "line": 448, "name": "LegacyProtocolHandler", "signature": "class LegacyProtocolHandler(ProtocolHandler)"}, {"doc": "Implements the v2 protocol with structured headers, CRC32, and Hamming error correction.", "kind": "class", "line": 473, "name": "SecureProtocolHandler", "signature": "class SecureProtocolHandler(ProtocolHandler)"}, {"doc": "Main orchestrator for encoding and decoding files to and from video.", "kind": "class", "line": 527, "name": "LazyOwnInfiniteStorage", "signature": "class LazyOwnInfiniteStorage"}, {"doc": "Command-line interface runner for LazyOwnInfiniteStorage.", "kind": "class", "line": 723, "name": "CLIRunner", "signature": "class CLIRunner"}, {"doc": "Executes built-in round-trip tests for both protocols.", "kind": "function", "line": 1072, "name": "run_tests", "signature": "def run_tests()"}, {"doc": "Entry point for LazyOwnInfiniteStorage.", "kind": "function", "line": 1120, "name": "main", "signature": "def main()"}, {"kind": "method", "line": 159, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Resolves and validates an absolute file path.", "kind": "method", "line": 162, "name": "validate_file_path", "signature": "def validate_file_path(self, file_path, must_exist)"}, {"doc": "Ensures the file size is within acceptable limits.", "kind": "method", "line": 172, "name": "validate_size", "signature": "def validate_size(self, size)"}, {"doc": "Sanitizes a filename to remove unsafe characters.", "kind": "method", "line": 177, "name": "sanitize_filename", "signature": "def sanitize_filename(self, filename)"}, {"doc": "Ensures the file extension is in the allowed set.", "kind": "method", "line": 185, "name": "validate_extension", "signature": "def validate_extension(self, file_path, allowed_extensions)"}, {"kind": "method", "line": 195, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Encodes a byte sequence using Hamming(8,4) correction.", "kind": "method", "line": 198, "name": "encode_data", "signature": "def encode_data(self, data)"}, {"doc": "Decodes a Hamming(8,4) encoded byte sequence with single-bit error correction.", "kind": "method", "line": 208, "name": "decode_data", "signature": "def decode_data(self, data)"}, {"kind": "method", "line": 219, "name": "_encode_nibble", "signature": "def _encode_nibble(self, nibble)"}, {"kind": "method", "line": 230, "name": "_decode_nibble", "signature": "def _decode_nibble(self, byte_val)"}, {"kind": "method", "line": 253, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Yields grayscale frames from a bit string.", "kind": "method", "line": 256, "name": "bits_to_frames", "signature": "def bits_to_frames(self, bit_string, frame_width, frame_height, block_size)"}, {"kind": "method", "line": 271, "name": "_create_frame", "signature": "def _create_frame(self, bits, width, height, block_size, blocks_per_row)"}, {"kind": "method", "line": 284, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Extracts a bit string from rawvideo grayscale bytes.", "kind": "method", "line": 287, "name": "extract_bits_from_raw_frames", "signature": "def extract_bits_from_raw_frames(self, raw_bytes, width, height, block_size, expected_bits)"}, {"kind": "method", "line": 316, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Retrieves native resolution and metadata from a video file.", "kind": "method", "line": 319, "name": "get_video_info", "signature": "def get_video_info(self, input_path)"}, {"doc": "Retrieves video metadata via ffprobe (no cv2 dependency).", "kind": "method", "line": 335, "name": "_get_video_info_ffprobe", "signature": "def _get_video_info_ffprobe(self, input_path)"}, {"doc": "Extracts custom lazyown metadata from a video file using ffprobe.", "kind": "method", "line": 355, "name": "get_metadata", "signature": "def get_metadata(self, input_path)"}, {"doc": "Encodes a generator of frames into a video file via FFmpeg stdin.", "kind": "method", "line": 374, "name": "encode_video", "signature": "def encode_video(self, frame_generator, output_path, frame_width, frame_height, fps)"}, {"doc": "Extracts raw grayscale frames from a video file via FFmpeg stdout.", "kind": "method", "line": 401, "name": "extract_raw_frames", "signature": "def extract_raw_frames(self, input_path, target_width, target_height, max_frames)"}, {"doc": "Packs raw data into a bit string.", "kind": "method", "line": 439, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"doc": "Unpacks a bit string into raw data.", "kind": "method", "line": 443, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 451, "name": "__init__", "signature": "def __init__(self, config)"}, {"kind": "method", "line": 454, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"kind": "method", "line": 459, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 476, "name": "__init__", "signature": "def __init__(self, config, corrector)"}, {"kind": "method", "line": 480, "name": "pack", "signature": "def pack(self, data, frame_width, frame_height, block_size, fps)"}, {"kind": "method", "line": 499, "name": "unpack", "signature": "def unpack(self, bit_string, block_size)"}, {"kind": "method", "line": 530, "name": "__init__", "signature": "def __init__(self, config)"}, {"doc": "Return a WebRunner for WSGI or local web server use.", "kind": "method", "line": 540, "name": "create_web_runner", "signature": "def create_web_runner(self)"}, {"doc": "Encodes a file into a video using the specified protocol.", "kind": "method", "line": 544, "name": "encode", "signature": "def encode(self, input_path, output_path, frame_width, frame_height, fps, block_size, protocol_version)"}, {"doc": "Decodes a video back into the original file using the specified protocol.", "kind": "method", "line": 567, "name": "decode", "signature": "def decode(self, input_path, output_path, block_size, protocol_version)"}, {"kind": "method", "line": 578, "name": "_validate_encoding_parameters", "signature": "def _validate_encoding_parameters(self, frame_width, frame_height, fps, block_size)"}, {"kind": "method", "line": 588, "name": "_detect_protocol", "signature": "def _detect_protocol(self, input_path, block_size)"}, {"kind": "method", "line": 621, "name": "_decode_legacy", "signature": "def _decode_legacy(self, input_path, output_path, block_size)"}, {"kind": "method", "line": 634, "name": "_decode_secure", "signature": "def _decode_secure(self, input_path, output_path, block_size)"}, {"doc": "Return True if target path resolves inside directory (zip slip protection).", "kind": "method", "line": 647, "name": "_is_within_directory", "signature": "def _is_within_directory(self, directory, target)"}, {"doc": "Create a zip archive from a file or directory. Returns the output zip path.", "kind": "method", "line": 653, "name": "create_zip", "signature": "def create_zip(self, source_path, output_zip)"}, {"doc": "Safely extract a zip archive into output_dir (blocks zip slip). Returns output_dir.", "kind": "method", "line": 672, "name": "extract_zip", "signature": "def extract_zip(self, zip_path, output_dir)"}, {"doc": "Zip a file or directory then encode the archive to video. Returns the video path.", "kind": "method", "line": 693, "name": "zip_to_video", "signature": "def zip_to_video(self, source_path, output_video, frame_width, frame_height, fps, block_size, protocol_version)"}, {"doc": "Decode a video to a zip archive then extract it into output_dir. Returns output_dir.", "kind": "method", "line": 707, "name": "video_to_zip", "signature": "def video_to_zip(self, input_video, output_dir, block_size, protocol_version)"}, {"kind": "method", "line": 726, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 729, "name": "run", "signature": "def run(self)"}, {"doc": "Background worker thread for non-blocking GUI operations.", "kind": "class", "line": 783, "name": "Worker", "signature": "class Worker(QThread)"}, {"doc": "PyQt5 graphical user interface for LazyOwnInfiniteStorage.", "kind": "class", "line": 802, "name": "GUIRunner", "signature": "class GUIRunner(QWidget)"}, {"doc": "Stub GUI runner when PyQt5 is unavailable.", "kind": "class", "line": 938, "name": "GUIRunner", "signature": "class GUIRunner"}, {"doc": "Flask web server interface for LazyOwnInfiniteStorage.", "kind": "class", "line": 949, "name": "WebRunner", "signature": "class WebRunner"}, {"doc": "Stub web runner when Flask is unavailable.", "kind": "class", "line": 1062, "name": "WebRunner", "signature": "class WebRunner"}, {"kind": "method", "line": 789, "name": "__init__", "signature": "def __init__(self, func)"}, {"kind": "method", "line": 795, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 805, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 811, "name": "_init_ui", "signature": "def _init_ui(self)"}, {"kind": "method", "line": 879, "name": "_change_mode", "signature": "def _change_mode(self)"}, {"kind": "method", "line": 890, "name": "_browse_input", "signature": "def _browse_input(self)"}, {"kind": "method", "line": 900, "name": "_start", "signature": "def _start(self)"}, {"kind": "method", "line": 923, "name": "_on_finished", "signature": "def _on_finished(self, message)"}, {"kind": "method", "line": 928, "name": "_on_error", "signature": "def _on_error(self, message)"}, {"kind": "method", "line": 933, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 941, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 944, "name": "run", "signature": "def run(self)"}, {"kind": "method", "line": 952, "name": "__init__", "signature": "def __init__(self, storage)"}, {"doc": "Create directories and validate environment.", "kind": "method", "line": 963, "name": "run_setup", "signature": "def run_setup(self)"}, {"kind": "method", "line": 969, "name": "_setup_routes", "signature": "def _setup_routes(self)"}, {"kind": "method", "line": 1057, "name": "run", "signature": "def run(self, host, port)"}, {"kind": "method", "line": 1065, "name": "__init__", "signature": "def __init__(self, storage)"}, {"kind": "method", "line": 1068, "name": "run", "signature": "def run(self, host, port)"}, {"kind": "function", "line": 974, "name": "_validate_upload", "signature": "def _validate_upload(input_file, action)"}, {"kind": "function", "line": 992, "name": "index", "signature": "def index()"}, {"kind": "function", "line": 1037, "name": "download", "signature": "def download(filename)"}, {"kind": "function", "line": 1045, "name": "add_security_headers", "signature": "def add_security_headers(response)"}]}, {"doc": "Model Context Protocol server for LazyOwnInfiniteStorage.  Exposes stdio tools so an agent can run the full zip -> video pipeline and the inverse video -> zip pipeline with easy to remember English commands.", "id": "mcp_server.py", "kind": "module", "label": "mcp_server.py", "language": "py", "sha256": "9323cf445c33e917", "symbol_count": 13, "symbols": [{"kind": "function", "line": 62, "name": "_parse_frame_size", "signature": "def _parse_frame_size(value)"}, {"kind": "function", "line": 69, "name": "_protocol_value", "signature": "def _protocol_value(protocol)"}, {"kind": "function", "line": 79, "name": "_tool_zip_to_video", "signature": "def _tool_zip_to_video(arguments)"}, {"kind": "function", "line": 107, "name": "_tool_video_to_zip", "signature": "def _tool_video_to_zip(arguments)"}, {"kind": "function", "line": 131, "name": "_tool_encode", "signature": "def _tool_encode(arguments)"}, {"kind": "function", "line": 157, "name": "_tool_decode", "signature": "def _tool_decode(arguments)"}, {"kind": "function", "line": 179, "name": "_tool_create_zip", "signature": "def _tool_create_zip(arguments)"}, {"kind": "function", "line": 191, "name": "_tool_extract_zip", "signature": "def _tool_extract_zip(arguments)"}, {"kind": "function", "line": 213, "name": "_build_tools", "signature": "def _build_tools()"}, {"kind": "function", "line": 302, "name": "_run", "signature": "def _run()"}, {"doc": "Entry point for the LazyOwnInfiniteStorage MCP stdio server.", "kind": "function", "line": 330, "name": "main", "signature": "def main()"}, {"kind": "function", "line": 310, "name": "list_tools", "signature": "def list_tools()"}, {"kind": "function", "line": 314, "name": "call_tool", "signature": "def call_tool(name, arguments)"}]}, {"doc": "MCP tools for LazyOwnInfiniteStorage integration.", "id": "skill_lazyown_infinitestorage/tools.py", "kind": "module", "label": "tools.py", "language": "py", "sha256": "720a1ff01052ba14", "symbol_count": 11, "symbols": [{"kind": "function", "line": 34, "name": "_parse_frame_size", "signature": "def _parse_frame_size(frame_size_str)"}, {"kind": "function", "line": 42, "name": "_protocol_value", "signature": "def _protocol_value(protocol)"}, {"doc": "Encode a file into a video using LazyOwnInfiniteStorage.", "kind": "function", "line": 52, "name": "lazyown_infinitestorage_encode", "signature": "def lazyown_infinitestorage_encode(params)"}, {"doc": "Decode a video back into the original file using LazyOwnInfiniteStorage.", "kind": "function", "line": 105, "name": "lazyown_infinitestorage_decode", "signature": "def lazyown_infinitestorage_decode(params)"}, {"doc": "Zip a file or directory then encode the archive into a video (zip -> video).", "kind": "function", "line": 149, "name": "lazyown_zip_to_video", "signature": "def lazyown_zip_to_video(params)"}, {"doc": "Decode a video into a zip archive then extract it (video -> zip -> files).", "kind": "function", "line": 195, "name": "lazyown_video_to_zip", "signature": "def lazyown_video_to_zip(params)"}, {"doc": "Create a zip archive from a file or directory.", "kind": "function", "line": 236, "name": "lazyown_create_zip", "signature": "def lazyown_create_zip(params)"}, {"doc": "Safely extract a zip archive into a directory (blocks zip slip).", "kind": "function", "line": 268, "name": "lazyown_extract_zip", "signature": "def lazyown_extract_zip(params)"}, {"doc": "Upload a video to YouTube using browser automation.", "kind": "function", "line": 299, "name": "lazyown_infinitestorage_upload_to_youtube", "signature": "def lazyown_infinitestorage_upload_to_youtube(params)"}, {"doc": "Get a tool by name.", "kind": "function", "line": 453, "name": "get_tool", "signature": "def get_tool(name)"}, {"doc": "List all available tools.", "kind": "function", "line": 457, "name": "list_tools", "signature": "def list_tools()"}]}, {"doc": "Unit tests for ErrorCorrector Hamming(8,4) implementation.", "id": "tests/test_error_correction.py", "kind": "module", "label": "test_error_correction.py", "language": "py", "sha256": "b873018e8d2792f4", "symbol_count": 10, "symbols": [{"doc": "Specification: ErrorCorrector encodes bytes into Hamming(8,4) and corrects single-bit errors.", "kind": "class", "line": 7, "name": "TestErrorCorrector", "signature": "class TestErrorCorrector"}, {"kind": "method", "line": 11, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 15, "name": "test_encode_data_doubles_length", "signature": "def test_encode_data_doubles_length(self)"}, {"kind": "method", "line": 20, "name": "test_decode_data_reverses_encoding", "signature": "def test_decode_data_reverses_encoding(self)"}, {"kind": "method", "line": 26, "name": "test_decode_data_with_single_bit_error", "signature": "def test_decode_data_with_single_bit_error(self)"}, {"kind": "method", "line": 33, "name": "test_decode_data_rejects_odd_length", "signature": "def test_decode_data_rejects_odd_length(self)"}, {"kind": "method", "line": 37, "name": "test_encode_nibble_all_values", "signature": "def test_encode_nibble_all_values(self)"}, {"kind": "method", "line": 42, "name": "test_decode_nibble_all_values", "signature": "def test_decode_nibble_all_values(self)"}, {"kind": "method", "line": 49, "name": "test_roundtrip_various_inputs", "signature": "def test_roundtrip_various_inputs(self, data)"}, {"kind": "method", "line": 55, "name": "test_single_bit_error_per_nibble", "signature": "def test_single_bit_error_per_nibble(self, nibble)"}]}, {"doc": "Unit tests for FrameEncoder and FrameDecoder.", "id": "tests/test_frames.py", "kind": "module", "label": "test_frames.py", "language": "py", "sha256": "4d1ebb4f001ebc51", "symbol_count": 13, "symbols": [{"doc": "Specification: FrameEncoder converts bit strings into grayscale frames.", "kind": "class", "line": 8, "name": "TestFrameEncoder", "signature": "class TestFrameEncoder"}, {"doc": "Specification: FrameDecoder extracts bit strings from rawvideo grayscale bytes.", "kind": "class", "line": 54, "name": "TestFrameDecoder", "signature": "class TestFrameDecoder"}, {"kind": "method", "line": 12, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 16, "name": "test_bits_to_frames_yields_correct_number_of_frames", "signature": "def test_bits_to_frames_yields_correct_number_of_frames(self)"}, {"kind": "method", "line": 28, "name": "test_each_frame_has_correct_dimensions", "signature": "def test_each_frame_has_correct_dimensions(self)"}, {"kind": "method", "line": 33, "name": "test_bit_one_produces_white_block", "signature": "def test_bit_one_produces_white_block(self)"}, {"kind": "method", "line": 38, "name": "test_bit_zero_produces_black_block", "signature": "def test_bit_zero_produces_black_block(self)"}, {"kind": "method", "line": 43, "name": "test_padding_zeros_fill_incomplete_frame", "signature": "def test_padding_zeros_fill_incomplete_frame(self)"}, {"kind": "method", "line": 58, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 62, "name": "test_extract_bits_from_empty_raises", "signature": "def test_extract_bits_from_empty_raises(self)"}, {"kind": "method", "line": 66, "name": "test_extract_bits_from_raw_frames_basic", "signature": "def test_extract_bits_from_raw_frames_basic(self)"}, {"kind": "method", "line": 74, "name": "test_extract_bits_respects_expected_bits", "signature": "def test_extract_bits_respects_expected_bits(self)"}, {"kind": "method", "line": 82, "name": "test_extract_bits_from_resized_frame", "signature": "def test_extract_bits_from_resized_frame(self)"}]}, {"doc": "Integration tests for full encode/decode roundtrip and web interface.", "id": "tests/test_integration.py", "kind": "module", "label": "test_integration.py", "language": "py", "sha256": "404ebe41024c52b1", "symbol_count": 16, "symbols": [{"doc": "Specification: Files encoded to video and decoded back must be bit-identical.", "kind": "class", "line": 18, "name": "TestEncodeDecodeRoundtrip", "signature": "class TestEncodeDecodeRoundtrip"}, {"doc": "Specification: Web interface accepts uploads, encodes/decodes, and serves downloads.", "kind": "class", "line": 131, "name": "TestWebRunner", "signature": "class TestWebRunner"}, {"kind": "method", "line": 22, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 26, "name": "test_secure_protocol_roundtrip", "signature": "def test_secure_protocol_roundtrip(self)"}, {"kind": "method", "line": 44, "name": "test_legacy_protocol_roundtrip", "signature": "def test_legacy_protocol_roundtrip(self)"}, {"kind": "method", "line": 62, "name": "test_secure_protocol_resilient_to_resolution_change", "signature": "def test_secure_protocol_resilient_to_resolution_change(self)"}, {"kind": "method", "line": 83, "name": "test_protocol_auto_detection_prefers_secure", "signature": "def test_protocol_auto_detection_prefers_secure(self)"}, {"kind": "method", "line": 96, "name": "test_empty_file_roundtrip", "signature": "def test_empty_file_roundtrip(self)"}, {"kind": "method", "line": 110, "name": "test_large_file_roundtrip", "signature": "def test_large_file_roundtrip(self)"}, {"kind": "method", "line": 135, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 142, "name": "test_index_get", "signature": "def test_index_get(self)"}, {"kind": "method", "line": 147, "name": "test_encode_upload", "signature": "def test_encode_upload(self)"}, {"kind": "method", "line": 167, "name": "test_decode_upload", "signature": "def test_decode_upload(self)"}, {"kind": "method", "line": 193, "name": "test_security_headers_present", "signature": "def test_security_headers_present(self)"}, {"kind": "method", "line": 199, "name": "test_download_not_found", "signature": "def test_download_not_found(self)"}, {"kind": "method", "line": 203, "name": "test_missing_file_error", "signature": "def test_missing_file_error(self)"}]}, {"doc": "Unit tests for LegacyProtocolHandler and SecureProtocolHandler.", "id": "tests/test_protocols.py", "kind": "module", "label": "test_protocols.py", "language": "py", "sha256": "89ccde9df4c3c4a4", "symbol_count": 12, "symbols": [{"doc": "Specification: Legacy v1 protocol packs data with end-marker, unpacks by filename resolution.", "kind": "class", "line": 7, "name": "TestLegacyProtocolHandler", "signature": "class TestLegacyProtocolHandler"}, {"doc": "Specification: Secure v2 protocol packs data with header, CRC32, and Hamming correction.", "kind": "class", "line": 35, "name": "TestSecureProtocolHandler", "signature": "class TestSecureProtocolHandler"}, {"kind": "method", "line": 11, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 15, "name": "test_pack_includes_end_marker", "signature": "def test_pack_includes_end_marker(self)"}, {"kind": "method", "line": 21, "name": "test_unpack_strips_end_marker", "signature": "def test_unpack_strips_end_marker(self)"}, {"kind": "method", "line": 27, "name": "test_unpack_with_trailing_zeros", "signature": "def test_unpack_with_trailing_zeros(self)"}, {"kind": "method", "line": 39, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 44, "name": "test_pack_produces_bit_string", "signature": "def test_pack_produces_bit_string(self)"}, {"kind": "method", "line": 49, "name": "test_unpack_recovers_original_data", "signature": "def test_unpack_recovers_original_data(self)"}, {"kind": "method", "line": 55, "name": "test_unpack_detects_corrupted_header", "signature": "def test_unpack_detects_corrupted_header(self)"}, {"kind": "method", "line": 66, "name": "test_unpack_detects_corrupted_payload", "signature": "def test_unpack_detects_corrupted_payload(self)"}, {"kind": "method", "line": 80, "name": "test_roundtrip_various_sizes", "signature": "def test_roundtrip_various_sizes(self, size)"}]}, {"doc": "Unit tests for LazyOwnConfig and SecurityValidator.", "id": "tests/test_security.py", "kind": "module", "label": "test_security.py", "language": "py", "sha256": "11b1f9c609ab39e0", "symbol_count": 18, "symbols": [{"doc": "Specification: Configuration constants are centralized and immutable.", "kind": "class", "line": 9, "name": "TestLazyOwnConfig", "signature": "class TestLazyOwnConfig"}, {"doc": "Specification: SecurityValidator prevents path traversal, validates sizes and extensions.", "kind": "class", "line": 37, "name": "TestSecurityValidator", "signature": "class TestSecurityValidator"}, {"kind": "method", "line": 12, "name": "test_magic_bytes_are_valid", "signature": "def test_magic_bytes_are_valid(self)"}, {"kind": "method", "line": 15, "name": "test_protocol_versions_are_distinct", "signature": "def test_protocol_versions_are_distinct(self)"}, {"kind": "method", "line": 18, "name": "test_default_values_within_bounds", "signature": "def test_default_values_within_bounds(self)"}, {"kind": "method", "line": 24, "name": "test_header_offsets_are_consistent", "signature": "def test_header_offsets_are_consistent(self)"}, {"kind": "method", "line": 31, "name": "test_max_file_size_is_reasonable", "signature": "def test_max_file_size_is_reasonable(self)"}, {"kind": "method", "line": 41, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 45, "name": "test_validate_file_path_resolves_absolute", "signature": "def test_validate_file_path_resolves_absolute(self)"}, {"kind": "method", "line": 50, "name": "test_validate_file_path_rejects_traversal", "signature": "def test_validate_file_path_rejects_traversal(self)"}, {"kind": "method", "line": 54, "name": "test_validate_file_path_must_exist_when_required", "signature": "def test_validate_file_path_must_exist_when_required(self)"}, {"kind": "method", "line": 58, "name": "test_validate_size_rejects_oversized_files", "signature": "def test_validate_size_rejects_oversized_files(self)"}, {"kind": "method", "line": 62, "name": "test_validate_size_accepts_maximum", "signature": "def test_validate_size_accepts_maximum(self)"}, {"kind": "method", "line": 65, "name": "test_sanitize_filename_strips_unsafe_characters", "signature": "def test_sanitize_filename_strips_unsafe_characters(self)"}, {"kind": "method", "line": 70, "name": "test_sanitize_filename_preserves_safe_characters", "signature": "def test_sanitize_filename_preserves_safe_characters(self)"}, {"kind": "method", "line": 74, "name": "test_sanitize_filename_fallback", "signature": "def test_sanitize_filename_fallback(self)"}, {"kind": "method", "line": 77, "name": "test_validate_extension_accepts_allowed", "signature": "def test_validate_extension_accepts_allowed(self)"}, {"kind": "method", "line": 81, "name": "test_validate_extension_rejects_disallowed", "signature": "def test_validate_extension_rejects_disallowed(self)"}]}, {"doc": "Tests for zip pipeline and security hardening in LazyOwnInfiniteStorage.", "id": "tests/test_zip.py", "kind": "module", "label": "test_zip.py", "language": "py", "sha256": "73da10b1b4a96b56", "symbol_count": 16, "symbols": [{"doc": "Specification: zip -> video -> zip must recover the original files bit-identical.", "kind": "class", "line": 12, "name": "TestZipRoundtrip", "signature": "class TestZipRoundtrip"}, {"doc": "Specification: Zip extraction blocks zip slip and zip bombs.", "kind": "class", "line": 67, "name": "TestZipSecurity", "signature": "class TestZipSecurity"}, {"doc": "Specification: The final encoded output path is validated, not just the requested one.", "kind": "class", "line": 100, "name": "TestEncodeOutputValidation", "signature": "class TestEncodeOutputValidation"}, {"doc": "Specification: Existing security validator behavior is preserved.", "kind": "class", "line": 118, "name": "TestSecurityValidatorUnchanged", "signature": "class TestSecurityValidatorUnchanged"}, {"kind": "method", "line": 16, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 20, "name": "_make_source_dir", "signature": "def _make_source_dir(self, tmpdir)"}, {"kind": "method", "line": 33, "name": "test_zip_to_video_roundtrip_secure", "signature": "def test_zip_to_video_roundtrip_secure(self)"}, {"kind": "method", "line": 53, "name": "test_create_and_extract_zip_roundtrip", "signature": "def test_create_and_extract_zip_roundtrip(self)"}, {"kind": "method", "line": 71, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 75, "name": "test_extract_zip_blocks_path_traversal", "signature": "def test_extract_zip_blocks_path_traversal(self)"}, {"kind": "method", "line": 88, "name": "test_extract_zip_blocks_uncompressed_bomb", "signature": "def test_extract_zip_blocks_uncompressed_bomb(self)"}, {"kind": "method", "line": 104, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 108, "name": "test_encode_rejects_output_path_traversal", "signature": "def test_encode_rejects_output_path_traversal(self)"}, {"kind": "method", "line": 122, "name": "setup", "signature": "def setup(self)"}, {"kind": "method", "line": 126, "name": "test_rejects_traversal", "signature": "def test_rejects_traversal(self)"}, {"kind": "method", "line": 130, "name": "test_sanitizes_filename", "signature": "def test_sanitizes_filename(self)"}]}, {"doc": "WSGI entry point for LazyOwnInfiniteStorage web server.", "id": "wsgi_app.py", "kind": "module", "label": "wsgi_app.py", "language": "py", "sha256": "6be8aa9c5729c17a", "symbol_count": 1, "symbols": [{"doc": "Factory function returning a gunicorn-compatible Flask application.", "kind": "function", "line": 7, "name": "get_wsgi_app", "signature": "def get_wsgi_app()"}]}], "type": "CodePropertyGraph", "version": "1.0"}

Architecture Reference

PY (10 files)

lazyown_infinitestorage.py

Path: lazyown_infinitestorage.py File Doc: LazyOwnInfiniteStorage - Production-grade file-to-video encoder/decoder.

Classes:

  • LazyOwnConfig (line 72) class LazyOwnConfig - Centralized immutable configuration constants for LazyOwnInfiniteStorage.
  • SecurityValidator (line 156) class SecurityValidator - Validates file paths and inputs to prevent path traversal and abuse.
  • ErrorCorrector (line 192) class ErrorCorrector - Implements Hamming(8,4) extended error correction for byte streams.
  • FrameEncoder (line 250) class FrameEncoder - Encodes bit strings into numpy grayscale frames.
  • FrameDecoder (line 281) class FrameDecoder - Decodes grayscale frames into bit strings.
  • FFmpegPipeline (line 313) class FFmpegPipeline - Manages FFmpeg subprocess communication without intermediate frame files.
  • ProtocolHandler (line 436) class ProtocolHandler - Abstract base for encoding and decoding protocol implementations.
  • LegacyProtocolHandler (line 448) class LegacyProtocolHandler(ProtocolHandler) - Implements the original v1 protocol with filename-based resolution and end marker.
  • SecureProtocolHandler (line 473) class SecureProtocolHandler(ProtocolHandler) - Implements the v2 protocol with structured headers, CRC32, and Hamming error correction.
  • LazyOwnInfiniteStorage (line 527) class LazyOwnInfiniteStorage - Main orchestrator for encoding and decoding files to and from video.
  • CLIRunner (line 723) class CLIRunner - Command-line interface runner for LazyOwnInfiniteStorage.
  • Worker (line 783) class Worker(QThread) - Background worker thread for non-blocking GUI operations.
  • GUIRunner (line 802) class GUIRunner(QWidget) - PyQt5 graphical user interface for LazyOwnInfiniteStorage.
  • GUIRunner (line 938) class GUIRunner - Stub GUI runner when PyQt5 is unavailable.
  • WebRunner (line 949) class WebRunner - Flask web server interface for LazyOwnInfiniteStorage.
  • WebRunner (line 1062) class WebRunner - Stub web runner when Flask is unavailable.

Functions:

  • run_tests (line 1072) def run_tests() - Executes built-in round-trip tests for both protocols.
  • main (line 1120) def main() - Entry point for LazyOwnInfiniteStorage.
  • _validate_upload (line 974) def _validate_upload(input_file, action)
  • index (line 992) def index()
  • download (line 1037) def download(filename)
  • add_security_headers (line 1045) def add_security_headers(response)

Methods:

  • __init__ (line 159) def __init__(self, config)
  • validate_file_path (line 162) def validate_file_path(self, file_path, must_exist) - Resolves and validates an absolute file path.
  • validate_size (line 172) def validate_size(self, size) - Ensures the file size is within acceptable limits.
  • sanitize_filename (line 177) def sanitize_filename(self, filename) - Sanitizes a filename to remove unsafe characters.
  • validate_extension (line 185) def validate_extension(self, file_path, allowed_extensions) - Ensures the file extension is in the allowed set.
  • __init__ (line 195) def __init__(self, config)
  • encode_data (line 198) def encode_data(self, data) - Encodes a byte sequence using Hamming(8,4) correction.
  • decode_data (line 208) def decode_data(self, data) - Decodes a Hamming(8,4) encoded byte sequence with single-bit error correction.
  • _encode_nibble (line 219) def _encode_nibble(self, nibble)
  • _decode_nibble (line 230) def _decode_nibble(self, byte_val)
  • __init__ (line 253) def __init__(self, config)
  • bits_to_frames (line 256) def bits_to_frames(self, bit_string, frame_width, frame_height, block_size) - Yields grayscale frames from a bit string.
  • _create_frame (line 271) def _create_frame(self, bits, width, height, block_size, blocks_per_row)
  • __init__ (line 284) def __init__(self, config)
  • extract_bits_from_raw_frames (line 287) def extract_bits_from_raw_frames(self, raw_bytes, width, height, block_size, expected_bits) - Extracts a bit string from rawvideo grayscale bytes.
  • __init__ (line 316) def __init__(self, config)
  • get_video_info (line 319) def get_video_info(self, input_path) - Retrieves native resolution and metadata from a video file.
  • _get_video_info_ffprobe (line 335) def _get_video_info_ffprobe(self, input_path) - Retrieves video metadata via ffprobe (no cv2 dependency).
  • get_metadata (line 355) def get_metadata(self, input_path) - Extracts custom lazyown metadata from a video file using ffprobe.
  • encode_video (line 374) def encode_video(self, frame_generator, output_path, frame_width, frame_height, fps) - Encodes a generator of frames into a video file via FFmpeg stdin.
  • extract_raw_frames (line 401) def extract_raw_frames(self, input_path, target_width, target_height, max_frames) - Extracts raw grayscale frames from a video file via FFmpeg stdout.
  • pack (line 439) def pack(self, data, frame_width, frame_height, block_size, fps) - Packs raw data into a bit string.
  • unpack (line 443) def unpack(self, bit_string, block_size) - Unpacks a bit string into raw data.
  • __init__ (line 451) def __init__(self, config)
  • pack (line 454) def pack(self, data, frame_width, frame_height, block_size, fps)
  • unpack (line 459) def unpack(self, bit_string, block_size)
  • __init__ (line 476) def __init__(self, config, corrector)
  • pack (line 480) def pack(self, data, frame_width, frame_height, block_size, fps)
  • unpack (line 499) def unpack(self, bit_string, block_size)
  • __init__ (line 530) def __init__(self, config)
  • create_web_runner (line 540) def create_web_runner(self) - Return a WebRunner for WSGI or local web server use.
  • encode (line 544) def encode(self, input_path, output_path, frame_width, frame_height, fps, block_size, protocol_version) - Encodes a file into a video using the specified protocol.
  • decode (line 567) def decode(self, input_path, output_path, block_size, protocol_version) - Decodes a video back into the original file using the specified protocol.
  • _validate_encoding_parameters (line 578) def _validate_encoding_parameters(self, frame_width, frame_height, fps, block_size)
  • _detect_protocol (line 588) def _detect_protocol(self, input_path, block_size)
  • _decode_legacy (line 621) def _decode_legacy(self, input_path, output_path, block_size)
  • _decode_secure (line 634) def _decode_secure(self, input_path, output_path, block_size)
  • _is_within_directory (line 647) def _is_within_directory(self, directory, target) - Return True if target path resolves inside directory (zip slip protection).
  • create_zip (line 653) def create_zip(self, source_path, output_zip) - Create a zip archive from a file or directory. Returns the output zip path.
  • extract_zip (line 672) def extract_zip(self, zip_path, output_dir) - Safely extract a zip archive into output_dir (blocks zip slip). Returns output_dir.
  • zip_to_video (line 693) def zip_to_video(self, source_path, output_video, frame_width, frame_height, fps, block_size, protocol_version) - Zip a file or directory then encode the archive to video. Returns the video path.
  • video_to_zip (line 707) def video_to_zip(self, input_video, output_dir, block_size, protocol_version) - Decode a video to a zip archive then extract it into output_dir. Returns output_dir.
  • __init__ (line 726) def __init__(self, storage)
  • run (line 729) def run(self)
  • __init__ (line 789) def __init__(self, func)
  • run (line 795) def run(self)
  • __init__ (line 805) def __init__(self, storage)
  • _init_ui (line 811) def _init_ui(self)
  • _change_mode (line 879) def _change_mode(self)
  • _browse_input (line 890) def _browse_input(self)
  • _start (line 900) def _start(self)
  • _on_finished (line 923) def _on_finished(self, message)
  • _on_error (line 928) def _on_error(self, message)
  • run (line 933) def run(self)
  • __init__ (line 941) def __init__(self, storage)
  • run (line 944) def run(self)
  • __init__ (line 952) def __init__(self, storage)
  • run_setup (line 963) def run_setup(self) - Create directories and validate environment.
  • _setup_routes (line 969) def _setup_routes(self)
  • run (line 1057) def run(self, host, port)
  • __init__ (line 1065) def __init__(self, storage)
  • run (line 1068) def run(self, host, port)

mcp_server.py

Path: mcp_server.py File Doc: Model Context Protocol server for LazyOwnInfiniteStorage. Exposes stdio tools so an agent can run the full zip -> video pipeline and the inverse video -> zip pipeline with easy to remember English commands.

Functions:

  • _parse_frame_size (line 62) def _parse_frame_size(value)
  • _protocol_value (line 69) def _protocol_value(protocol)
  • _tool_zip_to_video (line 79) def _tool_zip_to_video(arguments)
  • _tool_video_to_zip (line 107) def _tool_video_to_zip(arguments)
  • _tool_encode (line 131) def _tool_encode(arguments)
  • _tool_decode (line 157) def _tool_decode(arguments)
  • _tool_create_zip (line 179) def _tool_create_zip(arguments)
  • _tool_extract_zip (line 191) def _tool_extract_zip(arguments)
  • _build_tools (line 213) def _build_tools()
  • _run (line 302) def _run()
  • main (line 330) def main() - Entry point for the LazyOwnInfiniteStorage MCP stdio server.
  • list_tools (line 310) def list_tools()
  • call_tool (line 314) def call_tool(name, arguments)

tools.py

Path: skill_lazyown_infinitestorage/tools.py File Doc: MCP tools for LazyOwnInfiniteStorage integration.

Functions:

  • _parse_frame_size (line 34) def _parse_frame_size(frame_size_str)
  • _protocol_value (line 42) def _protocol_value(protocol)
  • lazyown_infinitestorage_encode (line 52) def lazyown_infinitestorage_encode(params) - Encode a file into a video using LazyOwnInfiniteStorage.
  • lazyown_infinitestorage_decode (line 105) def lazyown_infinitestorage_decode(params) - Decode a video back into the original file using LazyOwnInfiniteStorage.
  • lazyown_zip_to_video (line 149) def lazyown_zip_to_video(params) - Zip a file or directory then encode the archive into a video (zip -> video).
  • lazyown_video_to_zip (line 195) def lazyown_video_to_zip(params) - Decode a video into a zip archive then extract it (video -> zip -> files).
  • lazyown_create_zip (line 236) def lazyown_create_zip(params) - Create a zip archive from a file or directory.
  • lazyown_extract_zip (line 268) def lazyown_extract_zip(params) - Safely extract a zip archive into a directory (blocks zip slip).
  • lazyown_infinitestorage_upload_to_youtube (line 299) def lazyown_infinitestorage_upload_to_youtube(params) - Upload a video to YouTube using browser automation.
  • get_tool (line 453) def get_tool(name) - Get a tool by name.
  • list_tools (line 457) def list_tools() - List all available tools.

test_error_correction.py

Path: tests/test_error_correction.py File Doc: Unit tests for ErrorCorrector Hamming(8,4) implementation.

Classes:

  • TestErrorCorrector (line 7) class TestErrorCorrector - Specification: ErrorCorrector encodes bytes into Hamming(8,4) and corrects single-bit errors.

Methods:

  • setup (line 11) def setup(self)
  • test_encode_data_doubles_length (line 15) def test_encode_data_doubles_length(self)
  • test_decode_data_reverses_encoding (line 20) def test_decode_data_reverses_encoding(self)
  • test_decode_data_with_single_bit_error (line 26) def test_decode_data_with_single_bit_error(self)
  • test_decode_data_rejects_odd_length (line 33) def test_decode_data_rejects_odd_length(self)
  • test_encode_nibble_all_values (line 37) def test_encode_nibble_all_values(self)
  • test_decode_nibble_all_values (line 42) def test_decode_nibble_all_values(self)
  • test_roundtrip_various_inputs (line 49) def test_roundtrip_various_inputs(self, data)
  • test_single_bit_error_per_nibble (line 55) def test_single_bit_error_per_nibble(self, nibble)

test_frames.py

Path: tests/test_frames.py File Doc: Unit tests for FrameEncoder and FrameDecoder.

Classes:

  • TestFrameEncoder (line 8) class TestFrameEncoder - Specification: FrameEncoder converts bit strings into grayscale frames.
  • TestFrameDecoder (line 54) class TestFrameDecoder - Specification: FrameDecoder extracts bit strings from rawvideo grayscale bytes.

Methods:

  • setup (line 12) def setup(self)
  • test_bits_to_frames_yields_correct_number_of_frames (line 16) def test_bits_to_frames_yields_correct_number_of_frames(self)
  • test_each_frame_has_correct_dimensions (line 28) def test_each_frame_has_correct_dimensions(self)
  • test_bit_one_produces_white_block (line 33) def test_bit_one_produces_white_block(self)
  • test_bit_zero_produces_black_block (line 38) def test_bit_zero_produces_black_block(self)
  • test_padding_zeros_fill_incomplete_frame (line 43) def test_padding_zeros_fill_incomplete_frame(self)
  • setup (line 58) def setup(self)
  • test_extract_bits_from_empty_raises (line 62) def test_extract_bits_from_empty_raises(self)
  • test_extract_bits_from_raw_frames_basic (line 66) def test_extract_bits_from_raw_frames_basic(self)
  • test_extract_bits_respects_expected_bits (line 74) def test_extract_bits_respects_expected_bits(self)
  • test_extract_bits_from_resized_frame (line 82) def test_extract_bits_from_resized_frame(self)

test_integration.py

Path: tests/test_integration.py File Doc: Integration tests for full encode/decode roundtrip and web interface.

Classes:

  • TestEncodeDecodeRoundtrip (line 18) class TestEncodeDecodeRoundtrip - Specification: Files encoded to video and decoded back must be bit-identical.
  • TestWebRunner (line 131) class TestWebRunner - Specification: Web interface accepts uploads, encodes/decodes, and serves downloads.

Methods:

  • setup (line 22) def setup(self)
  • test_secure_protocol_roundtrip (line 26) def test_secure_protocol_roundtrip(self)
  • test_legacy_protocol_roundtrip (line 44) def test_legacy_protocol_roundtrip(self)
  • test_secure_protocol_resilient_to_resolution_change (line 62) def test_secure_protocol_resilient_to_resolution_change(self)
  • test_protocol_auto_detection_prefers_secure (line 83) def test_protocol_auto_detection_prefers_secure(self)
  • test_empty_file_roundtrip (line 96) def test_empty_file_roundtrip(self)
  • test_large_file_roundtrip (line 110) def test_large_file_roundtrip(self)
  • setup (line 135) def setup(self)
  • test_index_get (line 142) def test_index_get(self)
  • test_encode_upload (line 147) def test_encode_upload(self)
  • test_decode_upload (line 167) def test_decode_upload(self)
  • test_security_headers_present (line 193) def test_security_headers_present(self)
  • test_download_not_found (line 199) def test_download_not_found(self)
  • test_missing_file_error (line 203) def test_missing_file_error(self)

test_protocols.py

Path: tests/test_protocols.py File Doc: Unit tests for LegacyProtocolHandler and SecureProtocolHandler.

Classes:

  • TestLegacyProtocolHandler (line 7) class TestLegacyProtocolHandler - Specification: Legacy v1 protocol packs data with end-marker, unpacks by filename resolution.
  • TestSecureProtocolHandler (line 35) class TestSecureProtocolHandler - Specification: Secure v2 protocol packs data with header, CRC32, and Hamming correction.

Methods:

  • setup (line 11) def setup(self)
  • test_pack_includes_end_marker (line 15) def test_pack_includes_end_marker(self)
  • test_unpack_strips_end_marker (line 21) def test_unpack_strips_end_marker(self)
  • test_unpack_with_trailing_zeros (line 27) def test_unpack_with_trailing_zeros(self)
  • setup (line 39) def setup(self)
  • test_pack_produces_bit_string (line 44) def test_pack_produces_bit_string(self)
  • test_unpack_recovers_original_data (line 49) def test_unpack_recovers_original_data(self)
  • test_unpack_detects_corrupted_header (line 55) def test_unpack_detects_corrupted_header(self)
  • test_unpack_detects_corrupted_payload (line 66) def test_unpack_detects_corrupted_payload(self)
  • test_roundtrip_various_sizes (line 80) def test_roundtrip_various_sizes(self, size)

test_security.py

Path: tests/test_security.py File Doc: Unit tests for LazyOwnConfig and SecurityValidator.

Classes:

  • TestLazyOwnConfig (line 9) class TestLazyOwnConfig - Specification: Configuration constants are centralized and immutable.
  • TestSecurityValidator (line 37) class TestSecurityValidator - Specification: SecurityValidator prevents path traversal, validates sizes and extensions.

Methods:

  • test_magic_bytes_are_valid (line 12) def test_magic_bytes_are_valid(self)
  • test_protocol_versions_are_distinct (line 15) def test_protocol_versions_are_distinct(self)
  • test_default_values_within_bounds (line 18) def test_default_values_within_bounds(self)
  • test_header_offsets_are_consistent (line 24) def test_header_offsets_are_consistent(self)
  • test_max_file_size_is_reasonable (line 31) def test_max_file_size_is_reasonable(self)
  • setup (line 41) def setup(self)
  • test_validate_file_path_resolves_absolute (line 45) def test_validate_file_path_resolves_absolute(self)
  • test_validate_file_path_rejects_traversal (line 50) def test_validate_file_path_rejects_traversal(self)
  • test_validate_file_path_must_exist_when_required (line 54) def test_validate_file_path_must_exist_when_required(self)
  • test_validate_size_rejects_oversized_files (line 58) def test_validate_size_rejects_oversized_files(self)
  • test_validate_size_accepts_maximum (line 62) def test_validate_size_accepts_maximum(self)
  • test_sanitize_filename_strips_unsafe_characters (line 65) def test_sanitize_filename_strips_unsafe_characters(self)
  • test_sanitize_filename_preserves_safe_characters (line 70) def test_sanitize_filename_preserves_safe_characters(self)
  • test_sanitize_filename_fallback (line 74) def test_sanitize_filename_fallback(self)
  • test_validate_extension_accepts_allowed (line 77) def test_validate_extension_accepts_allowed(self)
  • test_validate_extension_rejects_disallowed (line 81) def test_validate_extension_rejects_disallowed(self)

test_zip.py

Path: tests/test_zip.py File Doc: Tests for zip pipeline and security hardening in LazyOwnInfiniteStorage.

Classes:

  • TestZipRoundtrip (line 12) class TestZipRoundtrip - Specification: zip -> video -> zip must recover the original files bit-identical.
  • TestZipSecurity (line 67) class TestZipSecurity - Specification: Zip extraction blocks zip slip and zip bombs.
  • TestEncodeOutputValidation (line 100) class TestEncodeOutputValidation - Specification: The final encoded output path is validated, not just the requested one.
  • TestSecurityValidatorUnchanged (line 118) class TestSecurityValidatorUnchanged - Specification: Existing security validator behavior is preserved.

Methods:

  • setup (line 16) def setup(self)
  • _make_source_dir (line 20) def _make_source_dir(self, tmpdir)
  • test_zip_to_video_roundtrip_secure (line 33) def test_zip_to_video_roundtrip_secure(self)
  • test_create_and_extract_zip_roundtrip (line 53) def test_create_and_extract_zip_roundtrip(self)
  • setup (line 71) def setup(self)
  • test_extract_zip_blocks_path_traversal (line 75) def test_extract_zip_blocks_path_traversal(self)
  • test_extract_zip_blocks_uncompressed_bomb (line 88) def test_extract_zip_blocks_uncompressed_bomb(self)
  • setup (line 104) def setup(self)
  • test_encode_rejects_output_path_traversal (line 108) def test_encode_rejects_output_path_traversal(self)
  • setup (line 122) def setup(self)
  • test_rejects_traversal (line 126) def test_rejects_traversal(self)
  • test_sanitizes_filename (line 130) def test_sanitizes_filename(self)

wsgi_app.py

Path: wsgi_app.py File Doc: WSGI entry point for LazyOwnInfiniteStorage web server.

Functions:

  • get_wsgi_app (line 7) def get_wsgi_app() - Factory function returning a gunicorn-compatible Flask application.

SH (1 files)

install.sh

Path: install.sh File Doc: Verificar si Python está instalado

No symbols extracted

Generated offline by readmenator from commit d4b6ed81f514. Edits here are overwritten by readmenator . --rebuild.

Start

Wiki

Agent Docs

Recipes

Clone this wiki locally