The Fuck

The Fuck是一款很棒的应用程序，灵感来自@liamosaur推文，它可以纠正之前控制台命令中的错误

更多示例：

➜ apt-get install vim
E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission denied)
E: Unable to lock the administration directory (/var/lib/dpkg/), are you root?

➜ fuck
sudo apt-get install vim [enter/↑/↓/ctrl+c]
[sudo] password for nvbn:
Reading package lists... Done
...

➜ git push
fatal: The current branch master has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin master


➜ fuck
git push --set-upstream origin master [enter/↑/↓/ctrl+c]
Counting objects: 9, done.
...

➜ puthon
No command 'puthon' found, did you mean:
 Command 'python' from package 'python-minimal' (main)
 Command 'python' from package 'python3' (main)
zsh: command not found: puthon

➜ fuck
python [enter/↑/↓/ctrl+c]
Python 3.4.2 (default, Oct  8 2014, 13:08:17)
...

➜ git brnch
git: 'brnch' is not a git command. See 'git --help'.

Did you mean this?
    branch

➜ fuck
git branch [enter/↑/↓/ctrl+c]
* master

➜ lein rpl
'rpl' is not a task. See 'lein help'.

Did you mean this?
         repl

➜ fuck
lein repl [enter/↑/↓/ctrl+c]
nREPL server started on port 54848 on host 127.0.0.1 - nrepl://127.0.0.1:54848
REPL-y 0.3.1
...

如果您不怕盲目运行更正后的命令，可以禁用REQUIRED_CONFIRMATION设置选项：

➜ apt-get install vim
E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission denied)
E: Unable to lock the administration directory (/var/lib/dpkg/), are you root?

➜ fuck
sudo apt-get install vim
[sudo] password for nvbn:
Reading package lists... Done
...

安装

• python (3.4+)
• pip
• python-dev

在MacOS上，您可以通过Homebrew(或Linux上的Linuxbrew)安装Fuck：

brew install thefuck

在Ubuntu/Mint上，使用以下命令安装Fuck：

sudo apt update
sudo apt install python3-dev python3-pip python3-setuptools
sudo pip3 install thefuck

在FreeBSD上，使用以下命令安装Fuck：

pkg install thefuck

在ChromeOS上，使用以下命令使用chromebrew安装Fuck：

crew install thefuck

在其他系统上，使用pip安装Fuck：

pip install thefuck

或者，您也可以使用操作系统包管理器(OS X、Ubuntu、Arch)

#建议您将此命令放在.bash_profile、.bashrc、.zshc或其他启动脚本中：

eval $(thefuck --alias)
# You can use whatever you want as an alias, like for Mondays:
eval $(thefuck --alias FUCK)

或者在您的shell配置中(bash、zsh、Fish、powershell、tcsh)

更改仅在新的shell会话中可用。要使更改立即可用，请运行source~/.bashrc(或您的shell配置文件，如.zshc)

要在没有确认的情况下运行已修复的命令，请使用–yes选项(或者简称为-y，如果您特别沮丧，则使用–hard)：

fuck --yeah

要递归修复命令直到成功，请使用-r选项：

fuck -r

Back to Contents

卸载

pip3 install thefuck --upgrade

注意：别名功能在Fuck的1.34版中已更改

它是如何工作的

要删除，请颠倒安装过程：-从您的Bash、zsh、Fish、powershell、tcsh中删除或注释别名行。shell配置-使用软件包管理器(BREW、PIP3、pkg、Crew、pip)卸载二进制文件

创建您自己的规则

The Fuck 试图将前一条命令与规则相匹配。如果找到匹配项，则使用匹配的规则创建新命令并执行。默认情况下启用以下规则：

• adb_unknown_command – fixes misspelled commands like adb logcta;
• ag_literal – adds -Q to ag when suggested;
• aws_cli – fixes misspelled commands like aws dynamdb scan;
• az_cli – fixes misspelled commands like az providers;
• cargo – runs cargo build instead of cargo;
• cargo_no_command – fixes wrongs commands like cargo buid;
• cat_dir – replaces cat with ls when you try to cat a directory;
• cd_correction – spellchecks and correct failed cd commands;
• cd_cs – changes cs to cd;
• cd_mkdir – creates directories before cd’ing into them;
• cd_parent – changes cd.. to cd ..;
• chmod_x – add execution bit;
• choco_install – append common suffixes for chocolatey packages;
• composer_not_command – fixes composer command name;
• conda_mistype – fixes conda commands;
• cp_create_destination – creates a new directory when you attempt to cp or mv to a non existent one
• cp_omitting_directory – adds -a when you cp directory;
• cpp11 – adds missing -std=c++11 to g++ or clang++;
• dirty_untar – fixes tar x command that untarred in the current directory;
• dirty_unzip – fixes unzip command that unzipped in the current directory;
• django_south_ghost – adds --delete-ghost-migrations to failed because ghosts django south migration;
• django_south_merge – adds --merge to inconsistent django south migration;
• docker_login – executes a docker login and repeats the previous command;
• docker_not_command – fixes wrong docker commands like docker tags;
• docker_image_being_used_by_container &dash removes the container that is using the image before removing the image;
• dry – fixes repetitions like git git push;
• fab_command_not_found – fix misspelled fabric commands;
• fix_alt_space – replaces Alt+Space with Space character;
• fix_file – opens a file with an error in your $EDITOR;
• gem_unknown_command – fixes wrong gem commands;
• git_add – fixes “pathspec ‘foo’ did not match any file(s) known to git.”;
• git_add_force – adds --force to git add <pathspec>... when paths are .gitignore’d;
• git_bisect_usage – fixes git bisect strt, git bisect goood, git bisect rset, etc. when bisecting;
• git_branch_delete – changes git branch -d to git branch -D;
• git_branch_delete_checked_out – changes git branch -d to git checkout master && git branch -D when trying to delete a checked out branch;
• git_branch_exists – offers git branch -d foo, git branch -D foo or git checkout foo when creating a branch that already exists;
• git_branch_list – catches git branch list in place of git branch and removes created branch;
• git_branch_flag_0_to_flag_dash_v – undoes git branch 0v and runs git branch -v in its place;
• git_checkout – fixes branch name or creates new branch;
• git_clone_git_clone – replaces git clone git clone ... with git clone ...
• git_commit_amend – offers git commit --amend after previous commit;
• git_commit_reset – offers git reset HEAD~ after previous commit;
• git_diff_no_index – adds --no-index to previous git diff on untracked files;
• git_diff_staged – adds --staged to previous git diff with unexpected output;
• git_fix_stash – fixes git stash commands (misspelled subcommand and missing save);
• git_flag_after_filename – fixes fatal: bad flag '...' after filename
• git_help_aliased – fixes git help <alias> commands replacing with the aliased command;
• git_hook_bypass – adds --no-verify flag previous to git am, git commit, or git push command;
• git_lfs_mistype – fixes mistyped git lfs <command> commands;
• git_merge – adds remote to branch names;
• git_merge_unrelated – adds --allow-unrelated-histories when required
• git_not_command – fixes wrong git commands like git brnch;
• git_pull – sets upstream before executing previous git pull;
• git_pull_clone – clones instead of pulling when the repo does not exist;
• git_pull_uncommitted_changes – stashes changes before pulling and pops them afterwards;
• git_push – adds --set-upstream origin $branch to previous failed git push;
• git_push_different_branch_names – fixes pushes when local branch name does not match remote branch name;
• git_push_pull – runs git pull when push was rejected;
• git_push_without_commits – Creates an initial commit if you forget and only git add ., when setting up a new project;
• git_rebase_no_changes – runs git rebase --skip instead of git rebase --continue when there are no changes;
• git_remote_delete – replaces git remote delete remote_name with git remote remove remote_name;
• git_rm_local_modifications – adds -f or --cached when you try to rm a locally modified file;
• git_rm_recursive – adds -r when you try to rm a directory;
• git_rm_staged – adds -f or --cached when you try to rm a file with staged changes
• git_rebase_merge_dir – offers git rebase (--continue | --abort | --skip) or removing the .git/rebase-merge dir when a rebase is in progress;
• git_remote_seturl_add – runs git remote add when git remote set_url on nonexistent remote;
• git_stash – stashes your local modifications before rebasing or switching branch;
• git_stash_pop – adds your local modifications before popping stash, then resets;
• git_tag_force – adds --force to git tag <tagname> when the tag already exists;
• git_two_dashes – adds a missing dash to commands like git commit -amend or git rebase -continue;
• go_run – appends .go extension when compiling/running Go programs;
• go_unknown_command – fixes wrong go commands, for example go bulid;
• gradle_no_task – fixes not found or ambiguous gradle task;
• gradle_wrapper – replaces gradle with ./gradlew;
• grep_arguments_order – fixes grep arguments order for situations like grep -lir . test;
• grep_recursive – adds -r when you try to grep directory;
• grunt_task_not_found – fixes misspelled grunt commands;
• gulp_not_task – fixes misspelled gulp tasks;
• has_exists_script – prepends ./ when script/binary exists;
• heroku_multiple_apps – add --app <app> to heroku commands like heroku pg;
• heroku_not_command – fixes wrong heroku commands like heroku log;
• history – tries to replace command with the most similar command from history;
• hostscli – tries to fix hostscli usage;
• ifconfig_device_not_found – fixes wrong device names like wlan0 to wlp2s0;
• java – removes .java extension when running Java programs;
• javac – appends missing .java when compiling Java files;
• lein_not_task – fixes wrong lein tasks like lein rpl;
• long_form_help – changes -h to --help when the short form version is not supported
• ln_no_hard_link – catches hard link creation on directories, suggest symbolic link;
• ln_s_order – fixes ln -s arguments order;
• ls_all – adds -A to ls when output is empty;
• ls_lah – adds -lah to ls;
• man – changes manual section;
• man_no_space – fixes man commands without spaces, for example mandiff;
• mercurial – fixes wrong hg commands;
• missing_space_before_subcommand – fixes command with missing space like npminstall;
• mkdir_p – adds -p when you try to create a directory without a parent;
• mvn_no_command – adds clean package to mvn;
• mvn_unknown_lifecycle_phase – fixes misspelled life cycle phases with mvn;
• npm_missing_script – fixes npm custom script name in npm run-script <script>;
• npm_run_script – adds missing run-script for custom npm scripts;
• npm_wrong_command – fixes wrong npm commands like npm urgrade;
• no_command – fixes wrong console commands, for example vom/vim;
• no_such_file – creates missing directories with mv and cp commands;
• omnienv_no_such_command – fixes wrong commands for goenv, nodenv, pyenv and rbenv (eg.: pyenv isntall or goenv list);
• open – either prepends http:// to address passed to open or create a new file or directory and passes it to open;
• pip_install – fixes permission issues with pip install commands by adding --user or prepending sudo if necessary;
• pip_unknown_command – fixes wrong pip commands, for example pip instatl/pip install;
• php_s – replaces -s by -S when trying to run a local php server;
• port_already_in_use – kills process that bound port;
• prove_recursively – adds -r when called with directory;
• python_command – prepends python when you try to run non-executable/without ./ python script;
• python_execute – appends missing .py when executing Python files;
• python_module_error – fixes ModuleNotFoundError by trying to pip install that module;
• quotation_marks – fixes uneven usage of ' and " when containing args’;
• path_from_history – replaces not found path with a similar absolute path from history;
• rails_migrations_pending – runs pending migrations;
• react_native_command_unrecognized – fixes unrecognized react-native commands;
• remove_shell_prompt_literal – remove leading shell prompt symbol $, common when copying commands from documentations;
• remove_trailing_cedilla – remove trailing cedillas ç, a common typo for European keyboard layouts;
• rm_dir – adds -rf when you try to remove a directory;
• scm_correction – corrects wrong scm like hg log to git log;
• sed_unterminated_s – adds missing ‘/’ to sed‘s s commands;
• sl_ls – changes sl to ls;
• ssh_known_hosts – removes host from known_hosts on warning;
• sudo – prepends sudo to the previous command if it failed because of permissions;
• sudo_command_from_user_path – runs commands from users $PATH with sudo;
• switch_lang – switches command from your local layout to en;
• systemctl – correctly orders parameters of confusing systemctl;
• terraform_init.py – run terraform init before plan or apply;
• test.py – runs py.test instead of test.py;
• touch – creates missing directories before “touching”;
• tsuru_login – runs tsuru login if not authenticated or session expired;
• tsuru_not_command – fixes wrong tsuru commands like tsuru shell;
• tmux – fixes tmux commands;
• unknown_command – fixes hadoop hdfs-style “unknown command”, for example adds missing ‘-‘ to the command on hdfs dfs ls;
• unsudo – removes sudo from previous command if a process refuses to run on superuser privilege.
• vagrant_up – starts up the vagrant instance;
• whois – fixes whois command;
• workon_doesnt_exists – fixes virtualenvwrapper env name os suggests to create new.
• yarn_alias – fixes aliased yarn commands like yarn ls;
• yarn_command_not_found – fixes misspelled yarn commands;
• yarn_command_replaced – fixes replaced yarn commands;
• yarn_help – makes it easier to open yarn documentation;

Back to Contents

默认情况下，仅在特定平台上启用以下规则：

• apt_get – installs app from apt if it not installed (requires python-commandnotfound / python3-commandnotfound);
• apt_get_search – changes trying to search using apt-get with searching using apt-cache;
• apt_invalid_operation – fixes invalid apt and apt-get calls, like apt-get isntall vim;
• apt_list_upgradable – helps you run apt list --upgradable after apt update;
• apt_upgrade – helps you run apt upgrade after apt list --upgradable;
• brew_cask_dependency – installs cask dependencies;
• brew_install – fixes formula name for brew install;
• brew_reinstall – turns brew install <formula> into brew reinstall <formula>;
• brew_link – adds --overwrite --dry-run if linking fails;
• brew_uninstall – adds --force to brew uninstall if multiple versions were installed;
• brew_unknown_command – fixes wrong brew commands, for example brew docto/brew doctor;
• brew_update_formula – turns brew update <formula> into brew upgrade <formula>;
• dnf_no_such_command – fixes mistyped DNF commands;
• nixos_cmd_not_found – installs apps on NixOS;
• pacman – installs app with pacman if it is not installed (uses yay or yaourt if available);
• pacman_invalid_option – replaces lowercase pacman options with uppercase.
• pacman_not_found – fixes package name with pacman, yay or yaourt.
• yum_invalid_operation – fixes invalid yum calls, like yum isntall vim;

以下命令与Fuck捆绑在一起，但默认情况下不启用：

• git_push_force – adds --force-with-lease to a git push (may conflict with git_push_pull);
• rm_root – adds --no-preserve-root to rm -rf / command.

设置

要添加您自己的规则，请在~/.config/TheMASH/Rules中创建一个名为your-Rule-name.py的文件。规则文件必须包含两个函数：

match(command: Command) -> bool
get_new_command(command: Command) -> str | list[str]

此外，规则可以包含可选函数：

side_effect(old_command: Command, fixed_command: str) -> None

规则还可以包含可选变量Enabled_by_Default、Requires_Output和Priority

命令有三个属性：script、output和script_part。您的规则不应更改命令

规则API在3.0中发生了更改：要访问规则的设置，请使用Fuck.conf导入设置将其导入

Settings是一个特殊的对象，它由~/.config/the妈的/settings.py和env中的值组合而成(参见下面的更多内容)

使用sudo运行脚本的一个简单示例规则：

def match(command):
    return ('permission denied' in command.output.lower()
            or 'EACCES' in command.output)


def get_new_command(command):
    return 'sudo {}'.format(command.script)

# Optional:
enabled_by_default = True

def side_effect(command, fixed_command):
    subprocess.call('chmod 777 .', shell=True)

priority = 1000  # Lower first, default is 1000

requires_output = True

更多规则示例、用于规则的实用程序函数、特定于应用程序/操作系统的帮助器

带规则的第三方包

可以在文件$XDG_CONFIG_HOME/the他妈的/settings.py($XDG_CONFIG_HOME默认为~/.config)中更改几个Fuck参数：

• rules – list of enabled rules, by default thefuck.const.DEFAULT_RULES;
• exclude_rules – list of disabled rules, by default [];
• require_confirmation – requires confirmation before running new command, by default True;
• wait_command – the max amount of time in seconds for getting previous command output;
• no_colors – disable colored output;
• priority – dict with rules priorities, rule with lower priority will be matched first;
• debug – enables debug output, by default False;
• history_limit – the numeric value of how many history commands will be scanned, like 2000;
• alter_history – push fixed command to history, by default True;
• wait_slow_command – max amount of time in seconds for getting previous command output if it in slow_commands list;
• slow_commands – list of slow commands;
• num_close_matches – the maximum number of close matches to suggest, by default 3.
• excluded_search_path_prefixes – path prefixes to ignore when searching for commands, by default [].

settings.py的一个示例：

rules = ['sudo', 'no_command']
exclude_rules = ['git_push']
require_confirmation = True
wait_command = 10
no_colors = False
priority = {'sudo': 100, 'no_command': 9999}
debug = False
history_limit = 9999
wait_slow_command = 20
slow_commands = ['react-native', 'gradle']
num_close_matches = 5

或通过环境变量：

• THEFUCK_RULES – list of enabled rules, like DEFAULT_RULES:rm_root or sudo:no_command;
• THEFUCK_EXCLUDE_RULES – list of disabled rules, like git_pull:git_push;
• THEFUCK_REQUIRE_CONFIRMATION – require confirmation before running new command, true/false;
• THEFUCK_WAIT_COMMAND – the max amount of time in seconds for getting previous command output;
• THEFUCK_NO_COLORS – disable colored output, true/false;
• THEFUCK_PRIORITY – priority of the rules, like no_command=9999:apt_get=100,
  rule with lower priority will be matched first;
• THEFUCK_DEBUG – enables debug output, true/false;
• THEFUCK_HISTORY_LIMIT – how many history commands will be scanned, like 2000;
• THEFUCK_ALTER_HISTORY – push fixed command to history true/false;
• THEFUCK_WAIT_SLOW_COMMAND – the max amount of time in seconds for getting previous command output if it in slow_commands list;
• THEFUCK_SLOW_COMMANDS – list of slow commands, like lein:gradle;
• THEFUCK_NUM_CLOSE_MATCHES – the maximum number of close matches to suggest, like 5.
• THEFUCK_EXCLUDED_SEARCH_PATH_PREFIXES – path prefixes to ignore when searching for commands, by default [].

例如：

export THEFUCK_RULES='sudo:no_command'
export THEFUCK_EXCLUDE_RULES='git_pull:git_push'
export THEFUCK_REQUIRE_CONFIRMATION='true'
export THEFUCK_WAIT_COMMAND=10
export THEFUCK_NO_COLORS='false'
export THEFUCK_PRIORITY='no_command=9999:apt_get=100'
export THEFUCK_HISTORY_LIMIT='2000'
export THEFUCK_NUM_CLOSE_MATCHES='5'

Back to Contents

实验即时模式

如果您希望制定一组特定的非公共规则，但仍希望与其他人共享这些规则，请创建一个名为TheMASH_CONTRIB_*的包，其结构如下：

thefuck_contrib_foo
  thefuck_contrib_foo
    rules
      __init__.py
      *third-party rules*
    __init__.py
    *third-party-utils*
  setup.py

操蛋将在规则模块中查找规则

Back to Contents

发展中

Fuck的默认行为需要时间来重新运行先前的命令。在即时模式下，Fuck通过使用脚本记录输出，然后读取日志来节省时间

目前，即时模式仅支持带有bash或zsh的Python3。为了正常工作，还需要禁用zsh的自动更正功能

要启用即时模式，请向.bashrc、.bash_profile或.zshc中的别名初始化添加–enable-explementation-instant-mode

请参阅CONTRIBUTING.md

eval $(thefuck --alias --enable-experimental-instant-mode)