pycarlo 0.0.2__tar.gz → 0.12.64__tar.gz

pycarlo-0.12.64/.circleci/config.yml

@@ -0,0 +1,110 @@
+version: 2.1
+
+deploy_filter:
+  &deploy_filter # YAML reference for tag based filtering on deployments
+  filters:
+    tags:
+      only: /^v.*/
+    branches:
+      ignore: /.*/
+
+test_steps: &test_steps
+  steps:
+    - checkout
+    - run:
+        name: Update pip
+        command: pip install --upgrade pip
+    - run:
+        name: Run tests and checks
+        command: |
+          make install
+          make test
+
+sanity_check: &sanity_check_steps
+  steps:
+    - checkout
+    - run:
+        name: Make Sanity Check
+        command: |
+          make install
+          echo "MCD_API_ENDPOINT=https://api.getmontecarlo.com/graphql" > utils/.env
+          echo "MCD_DEFAULT_API_ID=${MCD_DEFAULT_API_ID}" >> utils/.env
+          echo "MCD_DEFAULT_API_TOKEN=${MCD_DEFAULT_API_TOKEN}" >> utils/.env
+          make sanity-check
+
+jobs:
+  run-test-3-8:
+    docker:
+      - image: python:3.8
+    <<: *test_steps
+
+  run-test-3-9:
+    docker:
+      - image: python:3.9
+    <<: *test_steps
+
+  run-test-3-10:
+    docker:
+      - image: python:3.10
+    <<: *test_steps
+
+  run-test-3-11:
+    docker:
+      - image: python:3.11
+    <<: *test_steps
+
+  run-test-3-12:
+    docker:
+      - image: python:3.12
+    <<: *test_steps
+
+  run-sanity-check:
+    docker:
+      - image: python:3.9
+    <<: *sanity_check_steps
+
+  deploy: # cci-ignore
+    docker:
+      - image: python:3.8.6
+
+    steps:
+      - checkout
+      - run:
+          name: Deploy to PyPI
+          command: make distribute
+
+workflows:
+  build:
+    jobs:
+      - run-test-3-8
+      - run-test-3-9
+      - run-test-3-10
+      - run-test-3-11
+      - run-test-3-12
+      - run-sanity-check:
+          context: mc-prod # cci-ignore
+
+  deploy: # cci-ignore
+    jobs:
+      - run-test-3-8:
+          <<: *deploy_filter
+      - run-test-3-9:
+          <<: *deploy_filter
+      - run-test-3-10:
+          <<: *deploy_filter
+      - run-test-3-11:
+          <<: *deploy_filter
+      - run-test-3-12:
+          <<: *deploy_filter
+      - run-sanity-check:
+          context: mc-prod # cci-ignore
+          <<: *deploy_filter
+      - deploy:
+          requires:
+            - run-test-3-8
+            - run-test-3-9
+            - run-test-3-10
+            - run-test-3-11
+            - run-test-3-12
+            - run-sanity-check
+          <<: *deploy_filter

pycarlo-0.12.64/.circleci/scripts/clean-generated-types-prs.sh

@@ -0,0 +1,171 @@
+#!/bin/bash
+set -euo pipefail
+
+# Colors for output
+RED='\033[1;31m'
+GREEN='\033[1;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;36m'  # Light cyan/blue
+NC='\033[0m' # No Color
+
+# Print functions
+info() {
+    echo -e "${BLUE}$1${NC}" >&2
+}
+
+success() {
+    echo -e "${GREEN}$1${NC}" >&2
+}
+
+warn() {
+    echo -e "${YELLOW}[WARNING]${NC} $1" >&2
+}
+
+error() {
+    echo -e "${RED}[ERROR]${NC} $1" >&2
+}
+
+# Function to trigger type generation workflow for a given monolith PR
+rerun_generation() {
+    local monolith_pr=$1
+    info "Triggering type generation workflow for monolith PR #$monolith_pr..."
+
+    # Get the branch name for the monolith PR
+    local monolith_branch
+    monolith_branch=$(gh pr view "$monolith_pr" --repo monte-carlo-data/monolith-django --json headRefName --jq '.headRefName' 2>/dev/null)
+
+    if [ -z "$monolith_branch" ]; then
+        error "Failed to get branch name for monolith PR #$monolith_pr"
+        return 1
+    fi
+
+    info "Found monolith branch: $monolith_branch"
+
+    # Get the latest workflow run for this branch
+    local run_id
+    run_id=$(gh run list --repo monte-carlo-data/monolith-django \
+        --workflow handle-pycarlo-schema-changes.yml \
+        --branch "$monolith_branch" \
+        --limit 1 \
+        --json databaseId \
+        --jq '.[0].databaseId' 2>/dev/null)
+
+    if [ -z "$run_id" ]; then
+        error "No workflow runs found for monolith PR #$monolith_pr (branch: $monolith_branch)"
+        return 1
+    fi
+
+    info "Found workflow run ID: $run_id"
+
+    # Rerun the workflow
+    if gh run rerun "$run_id" --repo monte-carlo-data/monolith-django; then
+        success "Successfully triggered workflow rerun for monolith PR #$monolith_pr"
+        return 0
+    else
+        error "Failed to rerun workflow for monolith PR #$monolith_pr"
+        return 1
+    fi
+}
+
+info "Checking for existing PRs with same changes as main..."
+
+# Check for clean working directory
+if ! git diff --quiet || ! git diff --cached --quiet; then
+  error "Working directory has uncommitted changes. Please commit or stash them before running this script."
+  exit 1
+fi
+
+# Get all open PRs that match our branch naming pattern
+OPEN_PRS=$(gh pr list --base main --search "update-types-from-monolith- in:title is:open" --json number,headRefName,url --jq '.[]')
+
+git fetch -q origin main
+for pr in $(echo "${OPEN_PRS}" | jq -c '.'); do
+  PR_NUMBER=$(echo "$pr" | jq -r '.number')
+  PR_BRANCH=$(echo "$pr" | jq -r '.headRefName')
+  PR_URL=$(echo "$pr" | jq -r '.url')
+  MONOLITH_PR=$(echo "$PR_BRANCH" | sed -n 's/.*update-types-from-monolith-\([0-9]*\).*/\1/p')
+
+  info "Comparing current branch with PR #$PR_NUMBER (branch: $PR_BRANCH)..."
+
+  # Check if the related monolith PR is closed/merged
+  # If so, we will go ahead and close the SDK PR because
+  # it's more likely than not no longer needed and any changes
+  # should already be in main or will get into main via one of the open ones
+  if [ -n "$MONOLITH_PR" ]; then
+    info "Checking status of monolith PR #$MONOLITH_PR..."
+    MONOLITH_STATUS=$(gh pr view "$MONOLITH_PR" --repo monte-carlo-data/monolith-django --json state --jq '.state' 2>/dev/null || echo "NOT_FOUND")
+
+    if [ "$MONOLITH_STATUS" = "CLOSED" ] || [ "$MONOLITH_STATUS" = "MERGED" ]; then
+      warn "Monolith PR #$MONOLITH_PR is $MONOLITH_STATUS. Closing SDK PR #$PR_NUMBER..."
+      gh pr close "$PR_NUMBER" --delete-branch --comment "Closing this PR as the related monolith PR #$MONOLITH_PR has been $MONOLITH_STATUS."
+      echo
+      continue
+    elif [ "$MONOLITH_STATUS" = "NOT_FOUND" ]; then
+      warn "Could not find monolith PR #$MONOLITH_PR"
+    else
+      info "Monolith PR #$MONOLITH_PR is still open ($MONOLITH_STATUS)"
+    fi
+  fi
+
+  # Fetch the PR branch and main
+  git fetch -q origin "$PR_BRANCH"
+
+  # Track whether PR should be closed
+  is_same_as_main=false
+
+  # Fetch the PR branch
+  if ! git fetch -q origin "$PR_BRANCH"; then
+    error "Failed to fetch branch $PR_BRANCH for PR #$PR_NUMBER. Skipping..."
+    continue
+  fi
+
+  # Compare PR branch with main
+  if git diff --quiet origin/"$PR_BRANCH" origin/main; then
+    info "Existing PR #$PR_NUMBER is same as main: $PR_URL"
+    is_same_as_main=true
+  else
+    # Create a temporary branch from the PR branch
+    if ! git checkout -q -b temp_"$PR_BRANCH" origin/"$PR_BRANCH" 2>/dev/null; then
+      error "Failed to checkout branch $PR_BRANCH for PR #$PR_NUMBER. Skipping..."
+      continue
+    fi
+
+    # Attempt to merge latest from main into the temporary branch
+    if git merge --quiet origin/main --no-ff -m "Merging latest from main" > /dev/null 2>&1; then
+      # Now compare with main
+      if git diff --quiet origin/main; then
+        info "PR #$PR_NUMBER is now same as main after merging: $PR_URL"
+        is_same_as_main=true
+      else
+        info "PR #$PR_NUMBER still has changes compared to main: $PR_URL"
+      fi
+    else
+      warn "Merge conflict detected for PR #$PR_NUMBER. Closing to allow fresh regeneration..."
+      # Clean up: abort the merge
+      git merge --abort
+      # Switch back to original branch and delete the temporary branch
+      git checkout -q -
+      git branch -q -D temp_"$PR_BRANCH"
+      # Close the PR
+      info "API repo PR: https://github.com/monte-carlo-data/monolith-django/pull/$MONOLITH_PR"
+      gh pr close "$PR_NUMBER" --delete-branch --comment "Closing this PR due to merge conflicts with main. Types will be regenerated on the next update."
+
+      # Rerun the workflow for the monolith PR
+      rerun_generation "$MONOLITH_PR"
+
+      continue
+    fi
+
+    # Switch back to original branch and delete the temporary branch
+    git checkout -q -
+    git branch -q -D temp_"$PR_BRANCH"
+  fi
+
+  # Close PR if it's the same as main
+  if [ "$is_same_as_main" = true ]; then
+    info "API repo PR: https://github.com/monte-carlo-data/monolith-django/pull/$MONOLITH_PR"
+    warn "Closing PR #$PR_NUMBER..."
+    gh pr close "$PR_NUMBER" --delete-branch --comment "Closing this PR as there are no remaining changes compared to current main."
+  fi
+  echo
+done

pycarlo-0.12.64/.coveragerc

@@ -0,0 +1,2 @@
+[report]
+show_missing = True

pycarlo-0.12.64/.github/workflows/release.yml

@@ -0,0 +1,66 @@
+# ******** NOTE ********
+# GitHub action libraries should be pinned to a commit hash, not a version tag, to avoid vulnerabilities.
+
+name: Make new release
+
+on:
+  push:
+    branches: [main]
+    paths: ['pycarlo/lib/schema.py']
+
+permissions:
+  # This is required for requesting the JWT
+  id-token: write
+
+  # This is required for creating a release
+  contents: write
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate GitHub token
+        id: generate_token
+        uses: tibdex/github-app-token@32691ba7c9e7063bd457bd8f2a5703138591fa58  # v1.9.0
+        with:
+          app_id: ${{ secrets.MC_GITHUB_APP_ID }}
+          private_key: ${{ secrets.MC_GITHUB_APP_PRIVATE_KEY }}
+      - name: Checkout main branch
+        uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744  # v3.6.0
+        with:
+          token: ${{ steps.generate_token.outputs.token }}
+          ref: main
+          path: python-sdk
+      - name: Get latest release tag
+        id: get_latest_release_tag
+        env:
+          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
+        working-directory: python-sdk
+        run: |
+          echo "Listing releases..."
+          LATEST_RELEASE_TAG=$(gh release list \
+            --order desc \
+            --limit 1 \
+            --json tagName \
+            --jq '.[0].tagName')
+          echo "LATEST_RELEASE_TAG='$LATEST_RELEASE_TAG'"
+          echo "latest_release_tag=$LATEST_RELEASE_TAG" >> $GITHUB_OUTPUT
+      - name: Make new release tag
+        id: make_new_release_tag
+        env:
+          LATEST_RELEASE_TAG: ${{ steps.get_latest_release_tag.outputs.latest_release_tag }}
+        run: |
+          MAJOR_MINOR=$(echo $LATEST_RELEASE_TAG | cut -f 1-2 -d . )
+          PATCH=$(echo $LATEST_RELEASE_TAG | cut -f 3 -d . )
+          NEW_PATCH=$(( $PATCH + 1 ))
+          NEW_RELEASE_TAG="$MAJOR_MINOR.$NEW_PATCH"
+          echo "NEW_RELEASE_TAG='$NEW_RELEASE_TAG'"
+          echo "new_release_tag=$NEW_RELEASE_TAG" >> $GITHUB_OUTPUT
+      - name: Create new release
+        id: create_new_release
+        env:
+          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
+          NEW_RELEASE_TAG: ${{ steps.make_new_release_tag.outputs.new_release_tag }}
+        working-directory: python-sdk
+        run: |
+          gh release create $NEW_RELEASE_TAG --generate-notes

pycarlo-0.12.64/.gitignore

@@ -0,0 +1,140 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+!pycarlo/lib/
+!tests/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/
+
+.DS_Store
+
+.ruff_cache/
+
+# used in tests/test_forgiving_enums_published.sh
+test-forgiving-enums-venv

pycarlo-0.12.64/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-format
+        name: ruff format
+        entry: ruff
+        language: system
+        types: [python]
+        pass_filenames: true
+        args: [format]
+        exclude: ^(pycarlo/lib/schema\.py|tests/data/schema_original\.py)$
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: ruff
+        language: system
+        types: [python]
+        pass_filenames: true
+        args: [check, --fix, --exit-non-zero-on-fix]
+        exclude: ^(pycarlo/lib/schema\.py|tests/data/schema_original\.py)$
+  - repo: local
+    hooks:
+      - id: pyright
+        name: pyright
+        entry: pyright
+        language: system
+        types: [python]
+        pass_filenames: true
+        args: [--level, error]
+        exclude: ^(pycarlo/lib/schema\.py|tests/data/schema_original\.py)$

pycarlo-0.12.64/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contribution Guidelines
+
+This is primarily for Monte Carlo developers. External contributions are welcome, but you may want
+to reach out though support first to discuss your proposed changes.
+
+## Setting up for development
+
+```sh
+make install-dev
+```
+
+This will create a virtual environment, install dependencies, and set up pre-commit hooks.
+
+## Updating Typed Schema to Match GraphQL API
+
+The schema is automatically kept up-to-date by our CI pipeline when changes are merged to the API
+repo. You typically don't need to run `make generate` unless you're testing or debugging an issue
+locally.
+
+If you do need to manually update the schema for testing on your development machine, use
+`make generate`. This will fetch the latest schema from the API and regenerate the Python types,
+including any customizations.
+
+## Schema Customizations
+
+The generated `schema.py` is automatically modified during the build process to apply the following
+customizations. See [pycarlo/lib/README.md](pycarlo/lib/README.md) for more details. If you need to
+make additional customizations, you need to do so through that process.
+
+## Testing
+
+`make test` can be used to run all tests locally. CircleCI manages testing for deployment.
+
+## Releases
+
+Our CI pipeline is configured to automatically update the schema and run tests when changes are
+merged to the default branch in our API repo. It will also automatically deploy a new versioned
+release.
+
+### Custom Releases
+
+If you need to make a custom release, create a PR against `main`.
+
+When ready to release after merging, create a new
+[Github release](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository)
+with a tag using semantic versioning (e.g. `v0.42.0`) and CircleCI will test and publish to PyPI.
+Note that an existing version will not be deployed.

pycarlo-0.12.64/Makefile

@@ -0,0 +1,135 @@
+.PHONY: default clean install install-dev pip-install generate generate-local retrieve-schema transform-schema format-schema update-test-schema customize-schema env-check-venv test sanity-check
+.SILENT: generate generate-local # Prevent echoing of any tokens
+
+PACKAGE_NAME=pycarlo
+ENVIRONMENT_NAME=venv
+MCD_URL=https://api.getmontecarlo.com/graphql
+
+# Schema generator util
+SCHEMA_GEN_UTIL=utils/generate.py
+SANITY_CHECK_UTIL=utils/sanity.py
+ENV_UTIL=utils/env.sh
+ENV_FILE=utils/.env
+SAMPLE_ENV_FILE=utils/sample.env
+
+# Generated schema destinations
+SCHEMA_FROM_INTROSPECTION=$(PACKAGE_NAME)/lib/schema.json
+SCHEMA_PY=$(PACKAGE_NAME)/lib/schema.py
+SCHEMA_TEST_DATA=tests/data/schema_original.py
+
+default:
+	@echo "Refer to CONTRIBUTING.md for details on common tasks."
+
+clean:
+	@echo "Cleaning up existing build artifacts..."; \
+	rm -rf $(ENVIRONMENT_NAME) build dist $(PACKAGE_NAME).egg-info .coverage nosetests.xml
+
+pip-install:
+	@echo "\nInstalling Python package in editable mode..."; \
+	pip install --editable .
+
+install: clean
+ifeq ("$(wildcard $(ENV_FILE))","")
+	@echo "\nCreating env file from sample..."; \
+	cp $(SAMPLE_ENV_FILE) $(ENV_FILE)
+endif
+	@echo "\nCreating virtual environment..."; \
+	python3 -m venv $(ENVIRONMENT_NAME);
+	@echo "\nInstalling dependencies..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	pip install -r requirements-dev.txt; \
+	$(MAKE) pip-install; \
+	pip show $(PACKAGE_NAME)
+
+# Full development setup = install + pre-commit hooks
+install-dev: install
+	@echo "\nInstalling pre-commit hooks..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	pre-commit install; \
+	echo ""; \
+	echo "\033[0;32m✅ Development environment ready!\033[0m"; \
+	echo "\nActivate with: . $(ENVIRONMENT_NAME)/bin/activate"
+
+sanity-check: env-check-venv
+	@echo "\nRunning sanity checks..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	sh $(ENV_UTIL) python $(SANITY_CHECK_UTIL); \
+
+# Requires .env or profile credentials setup before usage.
+retrieve-schema:
+	@echo "\nRetrieving latest schema..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	sh $(ENV_UTIL) python $(SCHEMA_GEN_UTIL) $(MCD_URL) $(SCHEMA_FROM_INTROSPECTION);
+
+# Expects $(SCHEMA_FROM_INTROSPECTION) to already exist.
+transform-schema:
+	@echo "\nGenerating Python types from schema.json..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	sgqlc-codegen schema --docstrings $(SCHEMA_FROM_INTROSPECTION) $(SCHEMA_PY);
+
+format-schema:
+	@echo "\nFormatting Python code..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	ruff format $(SCHEMA_PY);
+
+update-test-schema:
+	@echo "\nUpdating test data with original schema..."; \
+	mkdir -p tests/data; \
+	cp $(SCHEMA_PY) $(SCHEMA_TEST_DATA);
+
+customize-schema:
+	@echo "\nApplying schema customizations..."; \
+	if [ "$$(uname)" = "Darwin" ]; then \
+		sed -i '' 's/class Connection(sgqlc.types.relay.Connection):/class Connection(sgqlc.types.Type):/g' $(SCHEMA_PY); \
+		sed -i '' 's/import sgqlc.types$$/import sgqlc.types\nimport pycarlo.lib.types/g' $(SCHEMA_PY); \
+		sed -i '' 's/class \([A-Za-z0-9_]*\)(sgqlc.types.Enum):/class \1(pycarlo.lib.types.Enum):/g' $(SCHEMA_PY); \
+	else \
+		sed -i 's/class Connection(sgqlc.types.relay.Connection):/class Connection(sgqlc.types.Type):/g' $(SCHEMA_PY); \
+		sed -i 's/import sgqlc.types$$/import sgqlc.types\nimport pycarlo.lib.types/g' $(SCHEMA_PY); \
+		sed -i 's/class \([A-Za-z0-9_]*\)(sgqlc.types.Enum):/class \1(pycarlo.lib.types.Enum):/g' $(SCHEMA_PY); \
+	fi; \
+	echo "*************"; \
+	echo "The following schema customizations have been applied:"; \
+	echo "  1. Changed 'class Connection(sgqlc.types.relay.Connection)' to 'class Connection(sgqlc.types.Type)'"; \
+	echo "  2. Changed all Enum classes to use 'pycarlo.lib.types.Enum' for backward compatibility"; \
+	echo "*************"; \
+
+env-check-venv:
+	@if [ ! -d "$(ENVIRONMENT_NAME)" ]; then \
+		echo "\033[0;31m❌ Error: Virtual environment not found. Please run 'make install' first.\033[0m"; \
+		exit 1; \
+	fi
+
+# Generate schema from existing schema.json (skip retrieval).
+# Used by CI when schema.json is already provided.
+generate-local: env-check-venv transform-schema format-schema update-test-schema customize-schema
+	@echo "\n\033[0;32m✅ Schema generation complete!\033[0m";
+
+# Requires .env or profile credentials setup before usage.
+generate: env-check-venv retrieve-schema generate-local
+
+test: env-check-venv
+	@echo "\nRunning tests..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	export DEBUG=True; \
+	pytest --durations=5 ./tests; \
+	echo ""; \
+	echo "Linting and formatting..."; \
+	ruff check .; \
+	ruff format --check .; \
+	echo ""; \
+	echo "Type checking..."; \
+	pyright .
+	@echo "\n\033[0;32m✅ All tests and checks passed!\033[0m";
+
+# this is only used by CI. See circleci/config.yml:
+distribute: install
+	@echo "\nInstalling dependencies..."; \
+	. $(ENVIRONMENT_NAME)/bin/activate; \
+	pip install -r requirements-ci.txt; \
+	echo "\nRunning setup..."; \
+	python setup.py sdist bdist_wheel; \
+	echo "\nChecking distribution..."; \
+	twine check dist/*; \
+	echo "\nUploading distribution to PyPI..."; \
+	twine upload --non-interactive dist/*