memoryguard 1.0.0__tar.gz

memoryguard-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+        include:
+          - os: macos-latest
+            python-version: '3.11'
+          - os: windows-latest
+            python-version: '3.11'
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+        pip install pytest pytest-asyncio pytest-cov
+    
+    - name: Run tests
+      run: pytest tests/ -v --tb=short
+      continue-on-error: false
+    
+    - name: Run tests with coverage
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      run: pytest tests/ --cov=memoryguard --cov-report=xml --cov-report=term-missing --cov-fail-under=80
+    
+    - name: Upload coverage
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false
+        verbose: true
+
+  lint:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        pip install black flake8 mypy
+        pip install -e ".[dev]"
+    
+    - name: Check formatting with black
+      run: black --check memoryguard/ tests/ || true
+    
+    - name: Lint with flake8
+      run: flake8 memoryguard/ tests/ --max-line-length=100 --extend-ignore=E203,W503 || true
+    
+    - name: Type check with mypy
+      run: mypy memoryguard/ || true
+
+  memory-check:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        pip install -e ".[all]"
+    
+    - name: Run basic memory tests
+      run: |
+        python -c "
+        from memoryguard import MemoryGuard
+        guard = MemoryGuard()
+        print('✅ MemoryGuard imports successfully')
+        
+        # Basic test
+        guard.check_memory('test')
+        print('✅ Basic memory check works')
+        
+        # Generate report
+        report_path = guard.generate_report('memory-report.json')
+        print(f'✅ Report generated: {report_path}')
+        "
+    
+    - name: Upload memory report
+      uses: actions/upload-artifact@v4
+      with:
+        name: memory-report
+        path: memory-report.json
+        if-no-files-found: ignore

memoryguard-1.0.0/.github/workflows/coverage-badge.yml

@@ -0,0 +1,38 @@
+name: Coverage Badge
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        pip install -e ".[dev]"
+        pip install pytest pytest-asyncio pytest-cov coverage-badge
+    
+    - name: Run tests with coverage
+      run: |
+        pytest tests/ --cov=memoryguard --cov-report=xml --cov-report=term
+    
+    - name: Generate coverage badge
+      run: |
+        coverage-badge -o coverage.svg -f
+    
+    - name: Commit badge
+      run: |
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+        git add coverage.svg
+        git diff --quiet && git diff --staged --quiet || git commit -m "Update coverage badge"
+        git push

memoryguard-1.0.0/.github/workflows/docker.yml

@@ -0,0 +1,58 @@
+name: Docker
+
+on:
+  push:
+    branches: [ main ]
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
+    
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+    
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+    
+    - name: Log in to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ${{ env.REGISTRY }}
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Extract metadata
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+        tags: |
+          type=ref,event=branch
+          type=ref,event=pr
+          type=semver,pattern={{version}}
+          type=semver,pattern={{major}}.{{minor}}
+          type=semver,pattern={{major}}
+          type=sha
+    
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: true
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
+        platforms: linux/amd64,linux/arm64

memoryguard-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,105 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        pip install -e ".[dev]"
+        pip install pytest pytest-asyncio pytest-cov
+    
+    - name: Run tests with coverage
+      run: pytest tests/ --cov=memoryguard --cov-report=xml --cov-fail-under=80
+    
+    - name: Upload coverage
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check package
+      run: twine check dist/*
+    
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+  publish-pypi:
+    needs: [test, build]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/memoryguard
+    permissions:
+      id-token: write
+    
+    steps:
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+    
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        skip-existing: true
+
+  github-release:
+    needs: [test, build]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+    
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      with:
+        files: dist/*
+        generate_release_notes: true
+        draft: false
+        prerelease: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

memoryguard-1.0.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# MemoryGuard specific
+memory-report.json
+*.memory.log

memoryguard-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to MemoryGuard
+
+Thank you for your interest in contributing to MemoryGuard! 🎉
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork
+3. Install in development mode:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Development Workflow
+
+### Running Tests
+
+```bash
+# All tests
+make test
+
+# With coverage
+make test-coverage
+
+# Specific test
+pytest tests/test_memoryguard.py::TestMemoryGuard::test_memory_check -v
+```
+
+### Code Style
+
+We use:
+- **black** for formatting
+- **flake8** for linting
+- **mypy** for type checking
+
+```bash
+# Format code
+make format
+
+# Check style
+make lint
+```
+
+### Before Submitting
+
+1. Run all tests
+2. Run linters
+3. Update documentation if needed
+4. Add tests for new features
+
+## Pull Request Process
+
+1. Create a feature branch
+2. Make your changes
+3. Add tests
+4. Update README if needed
+5. Submit PR with clear description
+
+## Code Guidelines
+
+- Follow PEP 8
+- Add type hints
+- Write docstrings
+- Keep functions focused
+- Add tests for new features
+
+## Reporting Issues
+
+When reporting bugs, please include:
+- Python version
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+
+## Questions?
+
+Open an issue or discussion - we're happy to help!

memoryguard-1.0.0/Dockerfile

@@ -0,0 +1,32 @@
+# MemoryGuard Docker Image
+# Usage: docker run -v $(pwd):/app ghcr.io/shadd0wtaka/memoryguard python -c "from memoryguard import MemoryGuard; ..."
+
+FROM python:3.11-slim
+
+LABEL maintainer="SHAdd0WTAka"
+LABEL description="MemoryGuard - Modular Python Memory Monitoring"
+LABEL org.opencontainers.image.source="https://github.com/SHAdd0WTAka/memoryguard"
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    valgrind \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY pyproject.toml README.md ./
+COPY memoryguard/ ./memoryguard/
+
+# Install the package
+RUN pip install --no-cache-dir -e ".[all]"
+
+# Create non-root user
+RUN useradd -m -u 1000 memoryguard && \
+    chown -R memoryguard:memoryguard /app
+USER memoryguard
+
+# Default command
+CMD ["python", "-c", "from memoryguard import MemoryGuard, __version__; print(f'MemoryGuard v{__version__} ready!')"]

memoryguard-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MemoryGuard Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

memoryguard-1.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include MANIFEST.in
+recursive-include examples *.py
+recursive-include tests *.py

memoryguard-1.0.0/Makefile

@@ -0,0 +1,55 @@
+.PHONY: help install install-dev test test-coverage lint format clean build publish
+
+help:
+	@echo "MemoryGuard - Available Commands:"
+	@echo ""
+	@echo "  install        Install package"
+	@echo "  install-dev    Install with dev dependencies"
+	@echo "  test           Run tests"
+	@echo "  test-coverage  Run tests with coverage"
+	@echo "  lint           Run linters"
+	@echo "  format         Format code with black"
+	@echo "  clean          Clean build artifacts"
+	@echo "  build          Build package"
+	@echo "  publish        Publish to PyPI"
+	@echo "  demo           Run demo"
+
+install:
+	pip install -e .
+
+install-dev:
+	pip install -e ".[dev]"
+	pip install -e ".[dashboard]"
+
+test:
+	pytest tests/ -v
+
+test-coverage:
+	pytest tests/ --cov=memoryguard --cov-report=term-missing
+
+lint:
+	flake8 memoryguard/ tests/
+	mypy memoryguard/
+
+format:
+	black memoryguard/ tests/ examples/
+	isort memoryguard/ tests/ examples/
+
+clean:
+	rm -rf build/
+	rm -rf dist/
+	rm -rf *.egg-info/
+	rm -rf .pytest_cache/
+	rm -rf .mypy_cache/
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+
+build: clean
+	python -m build
+
+publish: build
+	twine check dist/*
+	twine upload dist/*
+
+demo:
+	python examples/demo.py