boxxy

boxxy

BoxXy（Case-Sensitive）は、Linuxアプリケーションを誤動作し、シンリンクなしでファイルとディレクトリを適切な場所に置くことを強制するためのツールです！

BoxXyは、Amyware Discord Serverの一部です。

あなたが私が作っているものが好きなら、パトレオンで私をサポートすることを検討してください：

Linuxのみ！ BoxXyは、機能にLinuxネームスペースを使用します。

たとえば、tmuxを検討してください。 configを~/.tmux.confに配置したいと考えています。 BoxXyを使用すると、その構成を代わりに~/.config/tmux/tmux.confに配置できます。

 # ~/.config/boxxy/boxxy.yaml
rules :
- name : " redirect tmux config from ~/.tmux.conf to ~/.config/tmux/tmux.conf "
  target : " ~/.tmux.conf "
  rewrite : " ~/.config/tmux/tmux.conf "
  mode : " file " 

メンテナンスステータス

私は健康上の理由でオープンソースプロジェクトを維持することから休憩中です。 PRSは引き続き受け入れられ、問題は引き続き検討されますが、これがいつ発生するかについての約束はありません。

モチベーション

私は最近、AWS CLIを使用しなければなりませんでした。データを~/.awsで保存したいのですが、 $HOMEを乱雑にしたくありません。 BoxXyは、そのデータをどこかに優しく適切に配置するように強制することができます。

特徴

• 任意のプログラムをボックスにし、そのファイル/ディレクトリをあなたが望む場所に置くように強制します
• コンテキスト依存のボクシング、つまり、構成に応じて異なるディレクトリに異なるルールが適用されます
• 最小限のオーバーヘッド
• ルールの書き換え以外で不変のオプトインFS、つまり、ルールで指定したファイル/ディレクトリのみが書き込み可能です
• 0.5.0 ：Boxxyは、Homedirをスキャンして、あなたのためのルールを自動的に提案できます！
• 0.6.0 ：BoxXyはProject- boxxy.yamlファイルを使用し、 .envファイルをロードできます。
• 0.6.1 ：boxxyルールはenv varsを注入できます：
• 0.7.2 ：Boxxyは、 --daemonフラグを使用してBoxxedプロセスを背景にフォークできます。
• 0.8.0 ：Boxxyは、Command Lineでルールを--ruleで渡し、 --no-configで構成ファイルをロードすることを無効にすることができます。
• 0.8.2 ：適切にアピメージを実行する方法を説明してください：

潜在的な欠点

• 新しいプロジェクト、0.xyには、これらすべての警告が付属しています
• コンテナ内でsudoを使用できません（＃6を参照）
• 主に私のユースケースについてテストされました

使用の例

git:(mistress) | ▶  cat ~ /.config/boxxy/boxxy.yaml
rules:
- name: " Store AWS CLI config in ~/.config/aws "
  target: " ~/.aws "
  rewrite: " ~/.config/aws "

git:(mistress) | ▶  boxxy aws configure
 INFO  boxxy > loaded 1 rules
 INFO  boxxy::enclosure > applying rule ' Store AWS CLI config in ~/.config/aws '
 INFO  boxxy::enclosure > redirect: ~ /.aws - > ~ /.config/aws
 INFO  boxxy::enclosure > boxed " aws " ♥
AWS Access Key ID [ **************** d]: a
AWS Secret Access Key [ **************** c]: b
Default region name [b]: c
Default output format [a]: d
git:(mistress) | ▶  ls ~ /.aws
git:(mistress) | ▶  ls ~ /.config/aws
config  credentials
git:(mistress) | ▶  cat ~ /.config/aws/config
[default]
region = c
output = d
git:(mistress) | ▶

推奨される使用

• alias aws="boxxy aws" （他のツールの場合は繰り返し）
• コンテキストを使用して、プロジェクト構成をディスク上に分離します
• ドットファイル！
• Symlinksの使用をやめてください!!!
• コードを書くときにDEV構成ファイルはもうありません

要件

BoxXyはnewuidmapする必要がありますが、これはすべての分布にデフォルトで含まれていません。インストールするには：

高山：

$ apk add shadow-uidmap

Debian / Ubuntu：

$ apt install uidmap

Rhel / Fedora：

$ yum install shadow-utils

構成

boxxy構成ファイルは~/.config/boxxy/boxxy.yamlに存在します。何も存在しない場合、空のものがあなたのために作成されます。

 rules :
# The name of the rule. User-friendly name for your reference
- name : " redirect aws-cli from ~/.aws to ~/.config/aws "
  # The target of the rule, ie the file/directory that will be shadowed by the
  # rewrite.
  target : " ~/.aws "
  # The rewrite of the rule, ie the file/directory that will be used instead of
  # the target.
  rewrite : " ~/.config/aws "
- name : " use different k8s configs when in ~/Projects/my-cool-startup "
  target : " ~/.kube/config "
  rewrite : " ~/Projects/my-cool-startup/.kube/config "
  # The context for the rule. Any paths listed in the context are paths where
  # this rule will apply. If no context is specified, the rule applies
  # globally.
  context :
  - " ~/Projects/my-cool-startup "
  # The mode of this rule, either `directory` or `file`. `directory` is the
  # default. Must be specified for the correct behaviour when the target is a
  # file. Required because the target file/directory may not exist yet.
  mode : " file "
  # The list of commands that this rule applies to. If no commands are
  # specified, the rule applies to all programs run with boxxy.
  only :
  - " kubectl "

構文

 rules :
- name : " any valid string " # required
  target : " path " # required
  rewrite : " path " # required
  context : # optional
  - " path "
  - " path "
  mode : " directory | file " # optional
  only : # optional
  - " binary name "
  - " binary name "
  env : # optional
    KEY : " value " 

現像

1. 事前コミットのセットアップ： pre-commit install
2. cargo buildを確認してください
3. ことをしてください！
4. あなたが選んだコマンドでテストしてください、例。 cargo run -- ls -lah ~/.config

どのように機能しますか？

• /TMPで一時ディレクトリを作成します
• 新しいユーザー/マウントネームスペースを設定します
• bind-mount / to tmpディレクトリ
• ターゲットプログラムがそれらを使用できるように、バインドマウントルールがRWをマウントします
• Remount / ro
• 走る！

クレジット

• fixtures/helloworld-appimage-x86_84.AppImage ：https：//github.com/clonedrepos/hello-world-appimage