workmap 0.1.0__tar.gz

workmap-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,84 @@
+name: Something went wrong
+description: workmap did something you did not expect, or would not start.
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time. The four boxes below are the ones that
+        save a round trip, and none of them needs you to know anything about
+        how workmap works.
+
+        You will not break anything by filing this.
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened, and what you expected instead
+      description: >
+        Plain words are fine. If workmap printed something, paste it: it is
+        written to explain itself, so the message is usually the answer.
+      placeholder: |
+        I pressed k to quit the orphaned processes and the memory did not
+        come back. I expected the row to disappear.
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: What `workmap --version` says
+      description: Run it in Terminal and paste the line.
+      placeholder: workmap 0.1.0
+    validations:
+      required: true
+
+  - type: input
+    id: macos
+    attributes:
+      label: Your macOS version
+      description: >
+        Apple menu, then About This Mac. The number is enough.
+      placeholder: "15.5"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: automation
+    attributes:
+      label: Did you allow workmap to control Terminal?
+      description: >
+        macOS asks this the first time you run it, because reading your
+        windows means talking to Terminal. If you are not sure, look in System
+        Settings, Privacy and Security, Automation.
+      options:
+        - "Yes"
+        - "No, I declined it"
+        - "I was never asked"
+        - "I am not sure"
+    validations:
+      required: true
+
+  - type: textarea
+    id: list
+    attributes:
+      label: What `workmap list` shows
+      description: >
+        Optional, and only if it is relevant. This is the same map as the
+        interactive one, as text. It names your projects, so take out anything
+        you would rather not post.
+      render: text
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        Two things that are known, in case one of them is what you are seeing:
+
+        `o`, `O` and `organize` cannot move a window macOS is tiling. Drag the
+        window out of its tile, or turn tiling off in System Settings, under
+        Desktop and Dock.
+
+        `w` cannot close a window whose program has already exited, the ones
+        showing `[Process completed]`. Terminal ignores the request.

workmap-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,97 @@
+name: release
+
+# Publishing happens when a GitHub release is published, not on a tag push, so
+# that writing the release notes is the deliberate act and pushing a tag is
+# not. A version on PyPI can never be reused or replaced: 0.1.0 published by
+# accident is 0.1.0 for ever, and the only way forward is 0.1.1.
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    # The same runner the tests use. The wheel is pure Python and would build
+    # anywhere, but the smoke test below runs the tool, and the tool is macOS
+    # only: building somewhere it cannot run means the first machine to
+    # execute this code is a stranger's.
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+
+      - name: Check the version being released is the version in the tree
+        # A tag that disagrees with pyproject.toml publishes the wrong number
+        # under the right name, and PyPI will not let you take it back. This
+        # is the one check that has to happen before the build rather than
+        # after it.
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          want=$(sed -n 's/^version = "\(.*\)"$/\1/p' pyproject.toml | head -1)
+          if [ "$tag" != "$want" ]; then
+            echo "release tag is $GITHUB_REF_NAME and pyproject.toml says $want."
+            echo "One of them is wrong, and a wrong version cannot be undone"
+            echo "once it is on PyPI. Nothing was published."
+            exit 1
+          fi
+          echo "releasing workmap $want"
+
+      - name: Run the tests
+        # CI already runs these on every push, but a release is built from a
+        # tag, and a tag can point at a commit that was never pushed to main.
+        run: python -m unittest discover -s tests -t tests
+
+      - name: Build the sdist and the wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Install what was just built and run it
+        # Against the artefact, not the checkout. A wheel that is missing a
+        # module imports fine from the source tree beside it and fails for
+        # everyone who downloads it.
+        run: |
+          python -m venv /tmp/release-check
+          /tmp/release-check/bin/python -m pip install --quiet dist/*.whl
+          cd /   # so nothing resolves out of the checkout
+          /tmp/release-check/bin/workmap --version
+
+      - name: Hand the tested files to the job that uploads them
+        # The upload has to be the same bytes this job just ran, so the files
+        # travel rather than being built a second time. A rebuild on the other
+        # runner would publish a wheel no smoke test ever touched.
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    # Everything above has to run on macOS because it runs workmap. This job
+    # does not: it moves two files to PyPI. It is here on Linux because
+    # `pypa/gh-action-pypi-publish` is a Docker container action, and Docker
+    # actions do not run on the macOS runners. Asking it to was how the first
+    # release failed, after the tests and the build had already passed.
+    needs: verify
+    runs-on: ubuntu-latest
+    environment: pypi
+    # Trusted publishing. PyPI verifies this job's own identity through OIDC,
+    # so there is no API token stored in the repository to leak, rotate or
+    # forget about. `id-token: write` is what mints that identity, and it is
+    # the only permission raised above read. The environment name is part of
+    # what PyPI checks, so it has to stay `pypi` in both places.
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

workmap-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    # workmap drives Terminal.app, so it is tested where it runs. The suite
+    # itself stubs every OS call, so it needs no Terminal and no permissions.
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # 3.9 is the Python that ships with macOS: workmap must run on a
+        # stock machine with nothing installed. 3.14 is what `install.sh`
+        # builds the venv with when Homebrew's python is the newest one
+        # around, so it is the version most people will actually run.
+        python-version: ["3.9", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Run tests
+        run: python -m unittest discover -s tests -t tests -v
+      - name: Check the CLI starts
+        run: python -c "from workmap.cli import main; main(['--version'])"
+      - name: Check it installs and runs independently of the checkout
+        run: |
+          ./install.sh
+          # Move the source away: an install that still needs it is not one.
+          cd /
+          mv "$GITHUB_WORKSPACE" "$GITHUB_WORKSPACE-moved"
+          "$HOME/.local/bin/workmap" --version
+          mv "$GITHUB_WORKSPACE-moved" "$GITHUB_WORKSPACE"

workmap-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.terminal.lock
+.DS_Store
+dist/
+build/
+*.egg-info/