logwarp 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,170 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[codz]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ share/python-wheels/
24
+ *.egg-info/
25
+ .installed.cfg
26
+ *.egg
27
+ MANIFEST
28
+
29
+ # PyInstaller
30
+ # Usually these files are written by a python script from a template
31
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
32
+ *.manifest
33
+ *.spec
34
+
35
+ # Installer logs
36
+ pip-log.txt
37
+ pip-delete-this-directory.txt
38
+
39
+ # Unit test / coverage reports
40
+ htmlcov/
41
+ .tox/
42
+ .nox/
43
+ .coverage
44
+ .coverage.*
45
+ .cache
46
+ nosetests.xml
47
+ coverage.xml
48
+ *.cover
49
+ *.py.cover
50
+ .hypothesis/
51
+ .pytest_cache/
52
+ cover/
53
+
54
+ # Translations
55
+ *.mo
56
+ *.pot
57
+
58
+ # Sphinx documentation
59
+ docs/_build/
60
+
61
+ # PyBuilder
62
+ .pybuilder/
63
+ target/
64
+
65
+ # Jupyter Notebook
66
+ .ipynb_checkpoints
67
+
68
+ # IPython
69
+ profile_default/
70
+ ipython_config.py
71
+
72
+ # pyenv
73
+ # For a library or package, you might want to ignore these files since the code is
74
+ # intended to run in multiple environments; otherwise, check them in:
75
+ # .python-version
76
+
77
+ # pipenv
78
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
79
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
80
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
81
+ # install all needed dependencies.
82
+ #Pipfile.lock
83
+
84
+ # UV
85
+ # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
86
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
87
+ # commonly ignored for libraries.
88
+ #uv.lock
89
+
90
+ # poetry
91
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
92
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
93
+ # commonly ignored for libraries.
94
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
95
+ #poetry.lock
96
+ #poetry.toml
97
+
98
+ # pdm
99
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
100
+ # pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
101
+ # https://pdm-project.org/en/latest/usage/project/#working-with-version-control
102
+ #pdm.lock
103
+ #pdm.toml
104
+ .pdm-python
105
+ .pdm-build/
106
+
107
+ # pixi
108
+ # Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
109
+ #pixi.lock
110
+ # Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
111
+ # in the .venv directory. It is recommended not to include this directory in version control.
112
+ .pixi
113
+
114
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
115
+ __pypackages__/
116
+
117
+ # Celery stuff
118
+ celerybeat-schedule
119
+ celerybeat.pid
120
+
121
+ # SageMath parsed files
122
+ *.sage.py
123
+
124
+ # Environments
125
+ .env
126
+ .envrc
127
+ .venv
128
+ env/
129
+ venv/
130
+ ENV/
131
+ env.bak/
132
+ venv.bak/
133
+
134
+ # Rope project settings
135
+ .ropeproject
136
+
137
+ # mypy
138
+ .mypy_cache/
139
+ .dmypy.json
140
+ dmypy.json
141
+
142
+ # Pyre type checker
143
+ .pyre/
144
+
145
+ # pytype static type analyzer
146
+ .pytype/
147
+
148
+ # Cython debug symbols
149
+ cython_debug/
150
+
151
+ # PyCharm
152
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
153
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
154
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
155
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
156
+ #.idea/
157
+
158
+ # Visual Studio Code
159
+ # Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
160
+ # that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
161
+ # and can be added to the global gitignore or merged into this file. However, if you prefer,
162
+ # you could uncomment the following to ignore the entire vscode folder
163
+ .vscode/
164
+
165
+ # Ruff stuff:
166
+ .ruff_cache/
167
+
168
+ # PyPI configuration file
169
+ .pypirc
170
+ src/logwarp/_version.py
logwarp-0.1.0/LICENSE ADDED
@@ -0,0 +1,26 @@
1
+ Copyright (C) 2026 Lukasz Tuz <lukasz@bitsandpixels.io>
2
+
3
+ Redistribution and use in source and binary forms, with or without modification,
4
+ are permitted provided that the following conditions are met:
5
+
6
+ 1. Redistributions of source code must retain the above copyright notice, this
7
+ list of conditions and the following disclaimer.
8
+
9
+ 2. Redistributions in binary form must reproduce the above copyright notice,
10
+ this list of conditions and the following disclaimer in the documentation and/or
11
+ other materials provided with the distribution.
12
+
13
+ 3. Neither the name of the copyright holder nor the names of its contributors
14
+ may be used to endorse or promote products derived from this software without
15
+ specific prior written permission.
16
+
17
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND
18
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
21
+ ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
24
+ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
logwarp-0.1.0/Makefile ADDED
@@ -0,0 +1,78 @@
1
+ # ---------------------------------------------------------------------------
2
+ # logwarp — release management
3
+ #
4
+ # VERSION STRATEGY
5
+ # The single source of truth for the version is the **git tag**.
6
+ # Tags must follow the format: v<MAJOR>.<MINOR>.<PATCH>
7
+ # hatch-vcs reads the latest tag at build/install time and writes
8
+ # src/logwarp/_version.py automatically — never edit that file by hand.
9
+ #
10
+ # TYPICAL WORKFLOW
11
+ # 1. make release-patch → bumps patch (0.1.0 → 0.1.1)
12
+ # 2. make release-minor → bumps minor (0.1.0 → 0.2.0)
13
+ # 3. make release-major → bumps major (0.1.0 → 1.0.0)
14
+ # 4. make build → produces dist/ wheel + sdist
15
+ # 5. make publish → uploads to PyPI (requires TWINE_* env vars)
16
+ # ---------------------------------------------------------------------------
17
+
18
+ PYTHON ?= .venv/bin/python
19
+ PIP ?= .venv/bin/pip
20
+ BUILD ?= .venv/bin/python -m build
21
+ TWINE ?= .venv/bin/twine
22
+
23
+ .PHONY: help version release-patch release-minor release-major build publish install dev-install
24
+
25
+ help:
26
+ @echo ""
27
+ @echo " make version — show current version"
28
+ @echo " make release-patch — tag & push a patch release (x.y.Z+1)"
29
+ @echo " make release-minor — tag & push a minor release (x.Y+1.0)"
30
+ @echo " make release-major — tag & push a major release (X+1.0.0)"
31
+ @echo " make build — build wheel + sdist into dist/"
32
+ @echo " make publish — upload dist/ to PyPI via twine"
33
+ @echo " make dev-install — pip install -e .[dev] in .venv"
34
+ @echo ""
35
+
36
+ # Show current version as reported by hatch-vcs / setuptools-scm
37
+ version:
38
+ @$(PYTHON) -c "from logwarp import __version__; print(__version__)"
39
+
40
+ # ---------------------------------------------------------------------------
41
+ # Helpers — compute the next semver tag from the latest git tag
42
+ # ---------------------------------------------------------------------------
43
+ _LATEST_TAG := $(shell git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
44
+ _VERSION := $(patsubst v%,%,$(_LATEST_TAG))
45
+ _MAJOR := $(word 1,$(subst ., ,$(_VERSION)))
46
+ _MINOR := $(word 2,$(subst ., ,$(_VERSION)))
47
+ _PATCH := $(word 3,$(subst ., ,$(_VERSION)))
48
+
49
+ release-patch: _NEXT = v$(_MAJOR).$(_MINOR).$(shell echo $$(( $(_PATCH) + 1 )))
50
+ release-minor: _NEXT = v$(_MAJOR).$(shell echo $$(( $(_MINOR) + 1 ))).0
51
+ release-major: _NEXT = v$(shell echo $$(( $(_MAJOR) + 1 ))).0.0
52
+
53
+ release-patch release-minor release-major: _guard-clean
54
+ @echo "Tagging $(_NEXT) …"
55
+ git tag -a "$(_NEXT)" -m "Release $(_NEXT)"
56
+ git push origin "$(_NEXT)"
57
+ @echo "✓ Tagged and pushed $(_NEXT)"
58
+
59
+ # Abort if the working tree is dirty
60
+ _guard-clean:
61
+ @git diff --quiet && git diff --cached --quiet || \
62
+ (echo "ERROR: working tree is dirty — commit or stash changes first." && exit 1)
63
+
64
+ # ---------------------------------------------------------------------------
65
+ # Build & publish
66
+ # ---------------------------------------------------------------------------
67
+ build:
68
+ rm -rf dist/
69
+ $(BUILD)
70
+
71
+ publish: build
72
+ $(TWINE) upload dist/*
73
+
74
+ # ---------------------------------------------------------------------------
75
+ # Dev environment
76
+ # ---------------------------------------------------------------------------
77
+ dev-install:
78
+ $(PIP) install -e ".[dev]"
logwarp-0.1.0/PKG-INFO ADDED
@@ -0,0 +1,81 @@
1
+ Metadata-Version: 2.5
2
+ Name: logwarp
3
+ Version: 0.1.0
4
+ Summary: Logwarp, log processor and analyzer.
5
+ Author-email: Lukasz Tuz <lukasz@bitsandpixels.io>
6
+ License-File: LICENSE
7
+ Classifier: Development Status :: 2 - Pre-Alpha
8
+ Classifier: License :: OSI Approved :: BSD License
9
+ Classifier: Programming Language :: Python :: 3.12
10
+ Classifier: Programming Language :: Python :: 3.13
11
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
12
+ Classifier: Topic :: Utilities
13
+ Requires-Python: >=3.12
14
+ Requires-Dist: numpy
15
+ Requires-Dist: scipy
16
+ Provides-Extra: dev
17
+ Requires-Dist: build; extra == 'dev'
18
+ Requires-Dist: hatch-vcs; extra == 'dev'
19
+ Requires-Dist: hatchling; extra == 'dev'
20
+ Requires-Dist: ipykernel; extra == 'dev'
21
+ Requires-Dist: matplotlib; extra == 'dev'
22
+ Requires-Dist: pytest; extra == 'dev'
23
+ Requires-Dist: pytest-cov; extra == 'dev'
24
+ Description-Content-Type: text/markdown
25
+
26
+ <p align="center"><image src="assets/logo.svg" height="128" alt="Logwarp" /></p>
27
+
28
+ <h1 align="center">Logwarp</h1>
29
+
30
+ <p align="center">
31
+ <strong>Log file processing library which applies DSP to your logs.</strong><br />
32
+ Visualize, filter, analyze, and find anomalies in your log files, gaining real
33
+ understanding and insights in seconds. Local-first, command line-friendly.
34
+ </p>
35
+
36
+ <p align="center"><img width="600" height="338" alt="logwarp" src="https://github.com/user-attachments/assets/94140318-326d-4c3f-9f25-0c350bc125d1" /></p>
37
+
38
+
39
+ Logwarp is a Python library developed based on decades of reading, analyzing,
40
+ correlating, and otherwise digging through log files - from simple `printf` over
41
+ serial port to gigabytes of traces.
42
+ v
43
+ Logwarp treats log files as signals carrying information, and applies good'ol
44
+ DSP to process that information. Find distinctive log lines as signal peaks,
45
+ apply low-pass filters to get rid of the noise, use FFT to find repeating
46
+ sequences of messages, and more.
47
+
48
+ ## Download
49
+
50
+ Install using pip:
51
+
52
+ ```shell
53
+ pip install logwarp
54
+ ```
55
+
56
+ ## Quick Start
57
+
58
+ Check out the [Introduction](src/docs/introduction.ipynb) for semi-interactive
59
+ guide to using Logwarp.
60
+
61
+ ## Roadmap
62
+
63
+ Also known as "things I wish I had when digging through a log file":
64
+
65
+ - [x] ~~unravel (split) log files by fixed slice of each line, by token, or by regex~~
66
+ - [x] ~~vectorization and similarity search~~
67
+ - [x] ~~peak detection (finding distinctive fragments of the file)~~
68
+ - [ ] merge (weave) log files on timestamps
69
+ - [ ] command line interface
70
+ - [ ] detection of repeating messages using FFA
71
+ - [ ] frequency analysis with FFT
72
+ - [ ] frequency filtering
73
+ - [ ] inverse FFT transform
74
+ - [ ] automatic detection of repeating blocks and sequences
75
+ - [ ] log file annotations
76
+ - [ ] automatic creation of flow diagrams from detected blocks and annotations
77
+ - [ ] similarity diff (diff the vectorized versions of the files)
78
+ - [ ] MCP server and/or plugins for agents
79
+ - [ ] GUI
80
+ - [ ] TUI
81
+ - [ ] VSCode extension, maybe?
@@ -0,0 +1,56 @@
1
+ <p align="center"><image src="assets/logo.svg" height="128" alt="Logwarp" /></p>
2
+
3
+ <h1 align="center">Logwarp</h1>
4
+
5
+ <p align="center">
6
+ <strong>Log file processing library which applies DSP to your logs.</strong><br />
7
+ Visualize, filter, analyze, and find anomalies in your log files, gaining real
8
+ understanding and insights in seconds. Local-first, command line-friendly.
9
+ </p>
10
+
11
+ <p align="center"><img width="600" height="338" alt="logwarp" src="https://github.com/user-attachments/assets/94140318-326d-4c3f-9f25-0c350bc125d1" /></p>
12
+
13
+
14
+ Logwarp is a Python library developed based on decades of reading, analyzing,
15
+ correlating, and otherwise digging through log files - from simple `printf` over
16
+ serial port to gigabytes of traces.
17
+ v
18
+ Logwarp treats log files as signals carrying information, and applies good'ol
19
+ DSP to process that information. Find distinctive log lines as signal peaks,
20
+ apply low-pass filters to get rid of the noise, use FFT to find repeating
21
+ sequences of messages, and more.
22
+
23
+ ## Download
24
+
25
+ Install using pip:
26
+
27
+ ```shell
28
+ pip install logwarp
29
+ ```
30
+
31
+ ## Quick Start
32
+
33
+ Check out the [Introduction](src/docs/introduction.ipynb) for semi-interactive
34
+ guide to using Logwarp.
35
+
36
+ ## Roadmap
37
+
38
+ Also known as "things I wish I had when digging through a log file":
39
+
40
+ - [x] ~~unravel (split) log files by fixed slice of each line, by token, or by regex~~
41
+ - [x] ~~vectorization and similarity search~~
42
+ - [x] ~~peak detection (finding distinctive fragments of the file)~~
43
+ - [ ] merge (weave) log files on timestamps
44
+ - [ ] command line interface
45
+ - [ ] detection of repeating messages using FFA
46
+ - [ ] frequency analysis with FFT
47
+ - [ ] frequency filtering
48
+ - [ ] inverse FFT transform
49
+ - [ ] automatic detection of repeating blocks and sequences
50
+ - [ ] log file annotations
51
+ - [ ] automatic creation of flow diagrams from detected blocks and annotations
52
+ - [ ] similarity diff (diff the vectorized versions of the files)
53
+ - [ ] MCP server and/or plugins for agents
54
+ - [ ] GUI
55
+ - [ ] TUI
56
+ - [ ] VSCode extension, maybe?