msiltop 0.2.0__tar.gz

msiltop-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,100 @@
+name: 🧪 CI Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🐍 Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: ⚡ Install UV
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: 🔨 Build package
+        run: |
+          uv build
+          echo "✅ Package built successfully"
+          ls -la dist/
+
+      - name: 🧪 Test package build
+        run: |
+          echo "🧪 Testing package functionality..."
+
+          # Test help command works
+          sudo uv run msiltop --help
+          echo "✅ Help command works"
+
+          # Test package can be imported
+          uv run python -c "import msiltop.msiltop; print('✅ Package imports successfully')"
+
+          # Test CLI entry point exists
+          if command -v msiltop >/dev/null 2>&1 || uv run which msiltop >/dev/null 2>&1; then
+            echo "✅ CLI entry point found"
+          else
+            echo "⚠️  CLI entry point not in PATH (expected in development)"
+          fi
+
+      - name: 📦 Test wheel installation
+        run: |
+          echo "🧪 Testing wheel installation..."
+
+          # Create test environment and install wheel
+          python -m venv test_wheel
+          source test_wheel/bin/activate
+
+          # Install the built wheel
+          pip install dist/*.whl
+
+          # Test import in clean environment
+          python -c "import msiltop.msiltop; print('✅ Wheel installs and imports correctly')"
+
+          # Clean up
+          deactivate
+          rm -rf test_wheel
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: ⚡ Install UV
+        uses: astral-sh/setup-uv@v6
+
+      - name: 🔍 Check package metadata
+        run: |
+          echo "🔍 Checking package configuration..."
+
+          # Validate pyproject.toml syntax
+          python -c "import tomllib; tomllib.load(open('pyproject.toml', 'rb'))" 2>/dev/null && echo "✅ pyproject.toml syntax valid" || echo "❌ pyproject.toml syntax invalid"
+
+          # Check required fields exist
+          uv run python -c "import tomllib; config = tomllib.load(open('pyproject.toml', 'rb')); project = config.get('project', {}); required = ['name', 'version', 'description', 'authors']; [print(f'✅ {field}: {project[field]}') for field in required if field in project]; exit(1) if not all(field in project for field in required) else print('✅ All required package metadata present')"
+
+      - name: 🔍 Validate dependencies
+        run: |
+          echo "🔍 Checking dependencies..."
+          uv lock --check-hash || echo "⚠️  Lock file may need updating"
+          echo "✅ Dependencies check complete"

msiltop-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,296 @@
+name: 🚀 Release to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump_type:
+        description: "Type of version bump"
+        required: true
+        default: "patch"
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+      create_github_release:
+        description: "Create GitHub release"
+        required: true
+        default: true
+        type: boolean
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      contents: write
+      id-token: write # For PyPI trusted publishing
+
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: ⚡ Install UV
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: 📝 Calculate new version
+        id: version
+        run: |
+          BUMP_TYPE="${{ github.event.inputs.bump_type }}"
+          echo "Bump type: $BUMP_TYPE"
+
+          # Get current version from pyproject.toml
+          CURRENT_VERSION=$(grep "version = \".*\"" pyproject.toml | sed -n 's/version = "\(.*\)"/\1/p')
+          echo "Current version: $CURRENT_VERSION"
+
+          # Split version into components
+          IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+
+          # Calculate new version based on bump type
+          case $BUMP_TYPE in
+            "major")
+              MAJOR=$((MAJOR + 1))
+              MINOR=0
+              PATCH=0
+              ;;
+            "minor")
+              MINOR=$((MINOR + 1))
+              PATCH=0
+              ;;
+            "patch")
+              PATCH=$((PATCH + 1))
+              ;;
+            *)
+              echo "❌ Invalid bump type: $BUMP_TYPE"
+              exit 1
+              ;;
+          esac
+
+          NEW_VERSION="$MAJOR.$MINOR.$PATCH"
+          echo "New version will be: $NEW_VERSION"
+
+          # Store versions for later use
+          echo "CURRENT_VERSION=$CURRENT_VERSION" >> $GITHUB_ENV
+          echo "NEW_VERSION=$NEW_VERSION" >> $GITHUB_ENV
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+
+      - name: 📝 Update version in pyproject.toml (local only)
+        run: |
+          # Update version in pyproject.toml locally (don't commit yet)
+          sed -i "s/version = \".*\"/version = \"$NEW_VERSION\"/" pyproject.toml
+
+          # Verify the version was updated
+          grep "version = \"$NEW_VERSION\"" pyproject.toml || exit 1
+          echo "✅ Version updated locally from $CURRENT_VERSION to $NEW_VERSION"
+
+      - name: 🧹 Clean previous builds
+        run: |
+          rm -rf dist/
+          rm -rf build/
+          rm -rf *.egg-info/
+          echo "✅ Cleaned previous builds"
+
+      - name: 🔨 Build package
+        run: |
+          uv build
+          echo "✅ Package built successfully"
+
+          # List build artifacts
+          echo "📦 Build artifacts:"
+          ls -la dist/
+
+      - name: 🧪 Test build
+        run: |
+          echo "🧪 Testing package build..."
+
+          # Test that the package can be imported and help works
+          uv run msiltop --help
+
+          # Verify the version in the built package
+          if ls dist/msiltop-${NEW_VERSION}-*.whl 1> /dev/null 2>&1; then
+            echo "✅ Wheel file with correct version found"
+          else
+            echo "❌ Wheel file with version $NEW_VERSION not found"
+            ls dist/
+            exit 1
+          fi
+
+          if ls dist/msiltop-${NEW_VERSION}.tar.gz 1> /dev/null 2>&1; then
+            echo "✅ Source distribution with correct version found"
+          else
+            echo "❌ Source distribution with version $NEW_VERSION not found"  
+            ls dist/
+            exit 1
+          fi
+
+      - name: 📦 Publish to PyPI
+        id: pypi_publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true
+          verbose: true
+
+      - name: ✅ Verify PyPI publication
+        id: verify_pypi
+        run: |
+          echo "⏳ Waiting for PyPI to update..."
+          sleep 30
+
+          # Check if package is available on PyPI
+          for i in {1..10}; do
+            if pip index versions msiltop | grep -q "$NEW_VERSION"; then
+              echo "✅ Package version $NEW_VERSION found on PyPI"
+              echo "pypi_verified=true" >> $GITHUB_OUTPUT
+              break
+            else
+              echo "⏳ Attempt $i: Package not yet available, waiting..."
+              sleep 30
+            fi
+            
+            if [ $i -eq 10 ]; then
+              echo "❌ Package not found on PyPI after 5 minutes"
+              echo "pypi_verified=false" >> $GITHUB_OUTPUT
+              exit 1
+            fi
+          done
+
+      - name: 🧪 Test PyPI installation
+        if: steps.verify_pypi.outputs.pypi_verified == 'true'
+        run: |
+          echo "🧪 Testing installation from PyPI..."
+
+          # Create a fresh virtual environment and test installation
+          python -m venv test_env
+          source test_env/bin/activate
+
+          # Install from PyPI
+          pip install "msiltop==$NEW_VERSION"
+
+          # Test that it works
+          echo "Testing msiltop --help (without sudo in CI)"
+          python -c "import msiltop.msiltop as mt; print('✅ Package imports successfully')"
+
+          # Clean up
+          deactivate
+          rm -rf test_env
+          echo "✅ PyPI installation test passed"
+
+      - name: 🏷️ Create and push git tag
+        if: steps.verify_pypi.outputs.pypi_verified == 'true'
+        id: git_tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Commit version change
+          git add pyproject.toml
+          git commit -m "🔖 Bump version to $NEW_VERSION"
+
+          # Create and push tag
+          git tag "v$NEW_VERSION"
+          git push origin main
+          git push origin "v$NEW_VERSION"
+          echo "✅ Git tag v$NEW_VERSION created and pushed"
+          echo "git_tagged=true" >> $GITHUB_OUTPUT
+
+      - name: 📋 Generate release notes
+        if: steps.git_tag.outputs.git_tagged == 'true'
+        run: |
+          cat > release_notes.md << EOF
+          # MSILTOP v$NEW_VERSION
+
+          ## 🚀 What's New
+
+          This release includes improvements and updates to MSILTOP.
+
+          ## 📦 Installation
+
+          \`\`\`bash
+          # Install or upgrade via pip
+          pip install msiltop --upgrade
+
+          # Install or upgrade via UV  
+          uv add msiltop
+
+          # Run directly with UV (on macOS, use sudo)
+          sudo uv run msiltop
+          \`\`\`
+
+          ## 🔧 System Requirements
+
+          - **Hardware:** Apple Silicon Mac (M1, M2, M3, M4+)
+          - **OS:** macOS Monterey (12.0) or later
+          - **Python:** 3.8+ (automatically managed with UV)
+          - **Privileges:** Root access required for powermetrics
+
+          ## 🏷️ Package Information
+
+          - **PyPI:** https://pypi.org/project/msiltop/$NEW_VERSION/
+          - **Wheel:** \`msiltop-$NEW_VERSION-py3-none-any.whl\`
+          - **Source:** \`msiltop-$NEW_VERSION.tar.gz\`
+
+          ---
+
+          **Full Changelog:** https://github.com/pratikdevnani/msiltop/compare/v$(git describe --tags --abbrev=0 HEAD~1)...v$NEW_VERSION
+          EOF
+
+      - name: 🎉 Create GitHub Release
+        if: ${{ github.event.inputs.create_github_release == 'true' && steps.git_tag.outputs.git_tagged == 'true' }}
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: v${{ env.NEW_VERSION }}
+          name: "MSILTOP v${{ env.NEW_VERSION }}"
+          body_path: release_notes.md
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+          draft: false
+          prerelease: false
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 🎊 Release Summary
+        if: steps.git_tag.outputs.git_tagged == 'true'
+        run: |
+          echo "## 🎉 Release v$NEW_VERSION Complete! " >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### ✅ Completed Tasks" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Calculated new version ($NEW_VERSION) from ${{ github.event.inputs.bump_type }} bump" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Updated version in pyproject.toml" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Built distribution packages" >> $GITHUB_STEP_SUMMARY  
+          echo "- [x] Tested package build" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Published to PyPI" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Verified PyPI publication" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Tested PyPI installation" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Created and pushed git tag v$NEW_VERSION" >> $GITHUB_STEP_SUMMARY
+          echo "- [x] Created GitHub release" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 🔗 Links" >> $GITHUB_STEP_SUMMARY
+          echo "- **PyPI Package:** https://pypi.org/project/msiltop/$NEW_VERSION/" >> $GITHUB_STEP_SUMMARY
+          echo "- **GitHub Release:** https://github.com/pratikdevnani/msiltop/releases/tag/v$NEW_VERSION" >> $GITHUB_STEP_SUMMARY
+          echo "- **Install Command:** \`pip install msiltop==$NEW_VERSION\`" >> $GITHUB_STEP_SUMMARY
+
+      - name: ❌ Failure Summary
+        if: failure()
+        run: |
+          echo "## ❌ Release v$NEW_VERSION Failed" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "The release process encountered an error. Check the logs above for details." >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          if [[ "${{ steps.pypi_publish.outcome }}" == "success" ]]; then
+            echo "⚠️ **Note:** Package was successfully published to PyPI but git tagging failed." >> $GITHUB_STEP_SUMMARY
+            echo "You may need to manually create the git tag or handle the published package." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "✅ No changes were committed to git since PyPI publication failed." >> $GITHUB_STEP_SUMMARY
+          fi

msiltop-0.2.0/.gitignore

@@ -0,0 +1,136 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# idea
+.idea/
+
+
+.venv/
+.vscode/

msiltop-0.2.0/.whitesource

@@ -0,0 +1,12 @@
+{
+  "scanSettings": {
+    "baseBranches": []
+  },
+  "checkRunSettings": {
+    "vulnerableCheckRunConclusionLevel": "failure",
+    "displayMode": "diff"
+  },
+  "issueSettings": {
+    "minSeverityLevel": "LOW"
+  }
+}