mirror of https://github.com/vee1e/mitmproxy - An interactive TLS-capable intercepting HTTP proxy for penet
Find a file
Antoine James Tournepiche 35bcadd5e1
docs: Enhance homebrew installation command for Brewfile users (#7566)
* docs: Add --cask in brew install command

# Motivation

As a Brewfile user, the current installation command in the documentation
does not tell me that mitmproxy is a Cask, which is a bit of an
inconvenience due to how Brewfile works.

Adding a formulae in a Brewfile is done by adding the line `brew "<formulae>"`
while adding a cask in a Brewfile is done by adding the line `cask "<cask>"`

Contrarily to the behavior of the brew install command, adding a formulae line
in the Brewfile will not check for a Cask if the formulae does not exist: it
will just fail.

# Impact

The brew install command currently works by first checking if a "mitmproxy"
formulae exists in the homebrew repository, then after finding out there is
none, it checks for a "mitmproxy" cask in the homebrew repository.

Adding the explicit `--cask` argument allows to skip the unnecessary
formulae existence check, while being more convenient for Brewfile users.

# TL;DR

Adding the explicit `--cask` argument is useful to Brewfile users in such
that they directly know that mitmproxy is a Cask, while not impacting users
copy-pasting the command directly in their terminal (while also avoiding an
unwanted check for a corresponding formulae before the cask installation).

* [autofix.ci] apply automated fixes

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
2025-02-19 23:02:15 +01:00
.github work around cloudflare bugs 2025-02-06 01:33:17 +01:00
docs docs: Enhance homebrew installation command for Brewfile users (#7566) 2025-02-19 23:02:15 +01:00
examples Update ruff requirement from <=0.8.6,>=0.5.0 to >=0.5.0,<=0.9.4 (#7528) 2025-02-01 23:21:33 +00:00
mitmproxy reopen main for development 2025-02-17 12:03:20 +00:00
release Add proxy mode docs for tun mode (#7558) 2025-02-15 18:11:43 +05:30
test Ensure export output has no surrogates (#7562) 2025-02-16 13:10:45 +01:00
web Ensure that all mitmweb options have help text. (#7563) 2025-02-16 21:46:30 +00:00
.gitattributes
.gitignore fix display of error messages on early shutdown (#6719) 2024-03-07 20:41:26 +00:00
CHANGELOG.md docs: Enhance homebrew installation command for Brewfile users (#7566) 2025-02-19 23:02:15 +01:00
codecov.yml
CONTRIBUTING.md CONTRIBUTING.md: temporarily remove --cov 2023-12-02 08:37:37 +07:00
LICENSE
MANIFEST.in
pyproject.toml bump mitmproxy_rs (#7564) 2025-02-17 12:01:12 +00:00
README.md Remove Links to Slack Workspace (#6560) 2023-12-19 12:20:43 +00:00
SECURITY.md

mitmproxy

Continuous Integration Status Codacy Badge autofix.ci: enabled Coverage Status Latest Version Supported Python versions

mitmproxy is an interactive, SSL/TLS-capable intercepting proxy with a console interface for HTTP/1, HTTP/2, and WebSockets.

mitmdump is the command-line version of mitmproxy. Think tcpdump for HTTP.

mitmweb is a web-based interface for mitmproxy.

Installation

The installation instructions are here. If you want to install from source, see CONTRIBUTING.md.

Documentation & Help

General information, tutorials, and precompiled binaries can be found on the mitmproxy website.

mitmproxy.org

The documentation for mitmproxy is available on our website:

mitmproxy documentation stable mitmproxy documentation dev

If you have questions on how to use mitmproxy, please use GitHub Discussions!

mitmproxy discussions

Contributing

As an open source project, mitmproxy welcomes contributions of all forms.

Dev Guide