🎉 Added initial stubs and package structure

Author: allRisc

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@v6
+
+      - name: Setup Python
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run Linting
+        run: uv run ruff check .
+
+      - name: Run Type Checking
+        run: uv run mypy src
+
+      - name: Run Unit Tests
+        run: uv run pytest -v
+
+      - name: Test Package Build
+        run: uv build

.github/workflows/release.yml

@@ -0,0 +1,95 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - '*.*.*'
+
+jobs:
+  tests:
+    uses: allrisc/stubs-pyslang/.github/workflows/ci.yml@main
+
+  build:
+    name: Build Distro
+    runs-on: ubuntu-latest
+    needs: tests
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build
+        run: uv build
+
+      - name: Store the distro packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/stubs-pyslang
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distro packages
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish Distro to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Sign the Python Distro ans Upload to GitHub Releases
+
+    needs:
+      - publish-to-pypi
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+    - name: Download all the distros
+      uses: actions/download-artifact@v5
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Sign the dists with Sigstore
+      uses: sigstore/[email protected]
+      with:
+        inputs: >-
+          ./dist/*.tar.gz
+          ./dist/*.whl
+
+    - name: Create GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      run: >-
+        gh release create
+        '${{ github.ref_name }}'
+        --repo '${{ github.repository }}'
+        --notes ""
+
+    - name: Upload artifact signatures to GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      # Upload to GitHub Release using the `gh` CLI.
+      # `dist/` contains the built packages, and the
+      # sigstore-produced signatures and certificates.
+      run: >-
+        gh release upload
+        '${{ github.ref_name }}' dist/**
+        --repo '${{ github.repository }}'

.python-version

@@ -0,0 +1 @@
+3.13

README.md

@@ -1,2 +1,9 @@
-# stubs-pyslang
-A Python Stubs Library for the excellent pyslang SystemVerilog library
+# Typing Stubs for pyslang
+This is a [typing stub package](https://typing.python.org/en/latest/tutorials/external_libraries.html)
+for the [`pyslang`](https://github.com/MikePopoloski/slang) package.
+It can be used by type checkers to check code that uses `pyslang`.
+This version of `stubs-pyslang` aims to provide accurate annotations for `pyslang==9.0.*`.
+
+
+This package was tested with the following type checkers:
+* [mypy](https://github.com/python/mypy/)