profileinsight 0.0.1__tar.gz

profileinsight-0.0.1/.github/workflows/build.yml

@@ -0,0 +1,39 @@
+# Builds the package on every push and pull request, and publishes it to PyPI when a tag v* is pushed.
+# Publishing uses PyPI trusted publishing: PyPI accepts this workflow (build.yml in profileinsight/profileinsight)
+# by its OpenID Connect identity, so no API token is stored in the repository.
+name: build
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

profileinsight-0.0.1/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+.venv/

profileinsight-0.0.1/AGENTS.md

@@ -0,0 +1,39 @@
+# Instructions for AI agents
+
+These rules apply to every AI agent working in this repository. They override any default behavior of the agent or its tooling.
+
+## 1. Identity and attribution
+
+- Never change the git author or committer name or email in any way. This covers global, system, and repository config, environment variables, and command-line flags.
+- Never mention an AI agent, tool, or model in commit messages, trailers, co-author lines, contributor lists, documentation, code, or any other file. This includes Claude Code, Codex, and any specific model name.
+
+## 2. Commits and pushes
+
+- Never commit or push unless the user explicitly asks for it in the current request.
+- Without such a request, leave all changes uncommitted, however much work was done.
+- Before any commit, show the user the proposed commit message and the list of changed files. Ask the user to read and understand the changes themselves before approving.
+
+## 3. No fallbacks
+
+- All imports go at the top of a file. Never import inside functions or conditional branches, and never wrap an import in try/except.
+- Code must not switch to a fallback implementation when the environment lacks something. A fallback hides the problem instead of solving it; fail loudly instead.
+
+## 4. Minimal code
+
+- Keep every file as short and simple as possible so that a human can read and understand it.
+- Do not build complex engineering without explicit user approval. When a task seems to need it, stop, describe simpler alternatives, and let the user decide.
+
+## 5. No traces of history
+
+- Code, documents, and every other file must read as if they had always been this way.
+- Do not write comments or text such as "previously...", "changed to...", "now uses...", "fixed...", or "updated...". Describe what is, not what was.
+
+## 6. File headers
+
+- Every code file starts with a header comment, above everything else, that carefully introduces the file: its purpose and the design idea behind it.
+- The header covers every public component of the file: every publicly visible function, class, and method, each with its interface, the principles it follows, and an example of how to use it. None may be left out.
+- Keep the header in step with the file: whenever the file changes, update its header.
+
+## 7. Language
+
+- Everything in this repository must be in English only: code, comments, documents, file names, data labels, and figures. No Chinese or any other language.

profileinsight-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 profileinsight
+
+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.

profileinsight-0.0.1/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.5
+Name: profileinsight
+Version: 0.0.1
+Summary: Find why your GPU job is slow from its profile.
+Project-URL: Homepage, https://github.com/profileinsight/profileinsight
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Topic :: System :: Benchmark
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ProfileInsight
+
+Find why your GPU job is slow from its profile.
+
+ProfileInsight is in an early stage. The current release, 0.0.1, contains no analysis yet.
+
+## Install
+
+```
+pip install profileinsight
+```
+
+## Release
+
+Pushing a tag `v<version>` that matches `version` in `pyproject.toml` builds the package and publishes it to PyPI through trusted publishing (`.github/workflows/build.yml`).

profileinsight-0.0.1/README.md

@@ -0,0 +1,15 @@
+# ProfileInsight
+
+Find why your GPU job is slow from its profile.
+
+ProfileInsight is in an early stage. The current release, 0.0.1, contains no analysis yet.
+
+## Install
+
+```
+pip install profileinsight
+```
+
+## Release
+
+Pushing a tag `v<version>` that matches `version` in `pyproject.toml` builds the package and publishes it to PyPI through trusted publishing (`.github/workflows/build.yml`).

profileinsight-0.0.1/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "profileinsight"
+version = "0.0.1"
+description = "Find why your GPU job is slow from its profile."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = ["Development Status :: 1 - Planning", "Topic :: System :: Benchmark"]
+
+[project.urls]
+Homepage = "https://github.com/profileinsight/profileinsight"

profileinsight-0.0.1/src/profileinsight/__init__.py

@@ -0,0 +1,10 @@
+"""ProfileInsight: find why a GPU job is slow from its profile.
+
+The package is in an early stage and holds no analysis yet; it exists so that the name and the release path are in place.
+
+Public components
+    __version__   str, the package version, kept equal to `version` in pyproject.toml.
+                  Example: `import profileinsight; print(profileinsight.__version__)` prints `0.0.1`.
+"""
+
+__version__ = "0.0.1"