feat(python): add support for creating python .venv and installing dependencies by mwbrooks · Pull Request #346 · slackapi/slack-cli

mwbrooks · 2026-02-20T19:45:55Z

Changelog

Updated the slack create and slack init commands to support creating a Python virtual environment (.venv) when it doesn't exist and installing the project's dependencies from requirements.txt and pyproject.toml.

Summary

This pull request adds support for creating a Python virtual environment when it doesn't already exist and installs the dependencies defined in requirements.txt and pyproject.toml.

Out-of-scope:

Activating the virtual environment on each Slack CLI commands. We can follow-up in another PR with that feature.

Known issues:

When a pyproject.toml doesn't include a [project] section or dependencies array, the Slack CLI will display an error. It gracefully fails by continuing with the installation process for requirements.txt. However, I think we have an opportunity to update the Slack CLI to display a "Skipped updating pyproject.toml: no dependencies array" message instead of an error. That can be handled in a follow-up PR.

Related PRs:

Preview

Example of an app with a valid pyproject.toml:

Example of an app with an incomplete pyproject.toml:

Reviewers

Example of an app with a valid pyproject.toml:

$ lack create my-test-app/
# → Select "AI Agent App"
# → Select "Bolt for Python"

# Validate output:
# → Confirm: "Created virtual environment at .venv"
# → Confirm: "Installed dependencies from pyproject.toml"
# → Confirm: "Installed dependencies from requirements.txt"
# → Confirm: No errors

# Validate .env
$ ls -al my-test-app/.venv
# → Confirm: Exists

# Test app dependencies installed
$ cd my-test-app/
$ source .venv/bin/activate
$ lack run
# → Confirm: App starts

# Clean up
$ cd ../
$ rm -rf my-test-app/

Example of an app with an incomplete pyproject.toml:

$ lack create my-test-app/
# → Select "Starter App"
# → Select "Bolt for Python"

# Validate output:
# → Confirm: "Created virtual environment at .venv"
# → Confirm: "Error updating pyproject.toml: pyproject.toml missing project section"
# → Confirm: "Installed dependencies from pyproject.toml"
# → Confirm: "Installed dependencies from requirements.txt"

# Validate .env
$ ls -al my-test-app/.venv
# → Confirm: Exists

# Test app dependencies installed
$ cd my-test-app/
$ source .venv/bin/activate
$ lack run
# → Confirm: App starts

# Clean up
$ cd ../
$ rm -rf my-test-app/

Requirements

I've read and understood the Contributing Guidelines and have done my best effort to follow them.
I've read and agree to the Code of Conduct.

Swap pip install order so pyproject.toml is installed first to set up the project package, then requirements.txt pins take precedence as the lockfile.

…for pip

codecov · 2026-02-20T23:01:21Z

Codecov Report

❌ Patch coverage is 71.60494% with 23 lines in your changes missing coverage. Please review.
✅ Project coverage is 64.77%. Comparing base (113aa42) to head (180d499).

Files with missing lines	Patch %	Lines
internal/runtime/python/python.go	71.25%	14 Missing and 9 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #346      +/-   ##
==========================================
+ Coverage   64.73%   64.77%   +0.04%     
==========================================
  Files         212      212              
  Lines       17809    17860      +51     
==========================================
+ Hits        11528    11569      +41     
- Misses       5207     5212       +5     
- Partials     1074     1079       +5

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Clarify error messages in installPyProjectToml to include "updating pyproject.toml" context, and remove early return on file update errors so pip install is attempted regardless.

mwbrooks

Comments for the kind folks 👓

mwbrooks · 2026-02-20T23:35:23Z

internal/runtime/python/python.go

 	if !exists {
 		err := fmt.Errorf("pyproject.toml missing project section")
-		return fmt.Sprintf("Error: %s", err), err
+		return fmt.Sprintf("Error updating pyproject.toml: %s", err), err


note: Improving error messages when there is an error adding slack-cli-hooks to pyproject.toml.

Route createVirtualEnvironment and runPipInstall through HookExecutor instead of os/exec, matching the npm runtime pattern. This makes the functions testable with the mock filesystem. Also add missing AddDefaultMocks call, remove stale test cases, and fix assertion strings.

mwbrooks · 2026-02-21T00:25:32Z

internal/runtime/python/python.go

+	hookScript := hooks.HookScript{
+		Name:    "CreateVirtualEnvironment",
+		Command: fmt.Sprintf("%s -m venv .venv", getPythonExecutable()),
+	}
+	stdout := bytes.Buffer{}
+	hookExecOpts := hooks.HookExecOpts{
+		Hook:      hookScript,
+		Stdout:    &stdout,
+		Directory: projectDirPath,
+	}
+	_, err := hookExecutor.Execute(ctx, hookExecOpts)


note: While it's verbose, we use the hookExecutor so that we can mock the exec calls during tests. This is how we also handle npm install.

mwbrooks added 5 commits February 20, 2026 10:24

feat(python): add support for creating and activating venv

9d6e1d9

fix(python): install pyproject.toml before requirements.txt

665e23c

Swap pip install order so pyproject.toml is installed first to set up the project package, then requirements.txt pins take precedence as the lockfile.

chore(cmd): remove venv detail from init command description

9008d02

fix(python): use correct python executable on Windows for venv creation

51030ee

chore(python): add comment explaining venv activation is unnecessary …

6e6ba42

…for pip

mwbrooks self-assigned this Feb 20, 2026

mwbrooks added enhancement M-T: A feature request for new functionality semver:minor Use on pull requests to describe the release version increment area:bolt-python Related to github.com/slackapi/bolt-python changelog Use on updates to be included in the release notes labels Feb 20, 2026

mwbrooks added this to the Next Release milestone Feb 20, 2026

mwbrooks added 4 commits February 20, 2026 14:04

chore(python): fix gofmt formatting in python_test.go

cf35c5c

chore(python): move venv creation message to debug output

bff1d8c

chore(python): move dependency install messages to debug output

b0f0050

chore(python): shorten install success messages and highlight filenames

e641b20

fix(python): improve error handling for dependency file updates

4324103

Clarify error messages in installPyProjectToml to include "updating pyproject.toml" context, and remove early return on file update errors so pip install is attempted regardless.

mwbrooks changed the title ~~feat(python): add support for creating and activating venv~~ feat(python): add support for creating a python .venv Feb 20, 2026

mwbrooks changed the title ~~feat(python): add support for creating a python .venv~~ feat(python): update 'create' and 'init' commands to support creating a python .venv Feb 20, 2026

mwbrooks changed the title ~~feat(python): update 'create' and 'init' commands to support creating a python .venv~~ feat(python): update 'create' and 'init' to support creating a python .venv Feb 20, 2026

mwbrooks changed the title ~~feat(python): update 'create' and 'init' to support creating a python .venv~~ feat(python): update 'create' and 'init' to support creating and installing python .venv Feb 20, 2026

mwbrooks changed the title ~~feat(python): update 'create' and 'init' to support creating and installing python .venv~~ feat(python): add support for creating python .venv and installing dependencies Feb 20, 2026

test: remove skipped test

3a76ba8

mwbrooks commented Feb 20, 2026

View reviewed changes

mwbrooks commented Feb 21, 2026

View reviewed changes

mwbrooks marked this pull request as ready for review February 21, 2026 00:33

mwbrooks requested a review from a team as a code owner February 21, 2026 00:33

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

feat(python): add support for creating python .venv and installing dependencies#346

feat(python): add support for creating python .venv and installing dependencies#346
mwbrooks wants to merge 12 commits intomainfrom
mwbrooks-python-venv

mwbrooks commented Feb 20, 2026 •

edited

Loading

Uh oh!

codecov bot commented Feb 20, 2026 •

edited

Loading

Uh oh!

mwbrooks left a comment

Uh oh!

mwbrooks Feb 20, 2026

Uh oh!

mwbrooks Feb 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Comments

Conversation

mwbrooks commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changelog

Summary

Preview

Reviewers

Requirements

Uh oh!

codecov bot commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

mwbrooks left a comment

Choose a reason for hiding this comment

Uh oh!

mwbrooks Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

mwbrooks Feb 21, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

mwbrooks commented Feb 20, 2026 •

edited

Loading

codecov bot commented Feb 20, 2026 •

edited

Loading