{"owner":"google","repo":"clusterfuzz","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Agent Instructions\n\nThis document provides instructions for agents on how to perform common development tasks in this repository.\n\n## Initial Setup\n\nThis project uses `asdf` to manage tool versions. Before you can install the project's dependencies, you need to install and configure `asdf`.\n\n### 1. Install `asdf`\n\nFirst, make sure you have `git` and `curl` installed. Then, clone the `asdf` repository:\n\n```bash\ngit clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0\n```\n\n### 2. Configure Your Shell\n\nAdd `asdf` to your shell's startup file. For `bash`, run:\n\n```bash\necho -e \"\\n. \\\"$HOME/.asdf/asdf.sh\\\"\" >> ~/.bashrc\n```\n\nThen, source your `.bashrc` to apply the changes to your current session:\n\n```bash\nsource ~/.bashrc\n```\n\n### 3. Install `asdf` Plugins and Tools\n\nNow, from the root of this project, run the following commands to install the necessary `asdf` plugins and the tools specified in the `.tool-versions` file:\n\n```bash\nasdf plugin add python\nasdf plugin add gcloud https://github.com/jthegedus/asdf-gcloud\nasdf install\n```\n\n### 4. Install `pipenv`\n\nOnce `asdf` has installed the correct python version, you need to install `pipenv`:\n\n```bash\npython -m pip install pipenv\n```\n\n### 5. Install Project Dependencies\n\nNow you are ready to install the project's dependencies. Run the following command from the root of the repository:\n\n```bash\n./local/install_deps.bash\n```\n\n## Using Butler\nBefore each time you use the `butler.py` script, verify that you are inside the virtual environment, if not activate it by running `python -m pipenv shell`, or pre append any `python butler.py` call with\n`pipenv run`\n\nFor instance:\n```bash\npipenv run python butler.py lint\n```\nIs the same as running\n```bash\npython butler.py lint\n```\nif you are inside a virtual environment.\n\n## Testing\n\nTo run all unit tests, execute the following commands:\n\n```bash\npython butler.py py_unittest -t appengine -m\npython butler.py py_unittest -t core -m\n```\n\nThe `-m` flag runs the tests in parallel, which is recommended.\n\n### Running a single test file\n\nTo run a single test file, you can use the `-p` or `--pattern` flag. For example, to run the tests in `deploy_test.py`, you can use the following command:\n\n```bash\npython butler.py py_unittest -t core -p deploy_test.py\n```\n\n## Linting\n\nTo check the code for style and linting issues, run the following command:\n\n```bash\npython butler.py lint\n```\n\nThis will lint the changed code in your current branch.\n\n## Formatting\n\nTo automatically format the code to match the project's style guidelines, run:\n\n```bash\npython butler.py format\n```\n\nThis will format the changed code in your current branch.\nIt's possible to get into a state where linting and formatting contradict each other. In this case, STOP, the human will fix it.\n"},"files":{"AGENTS.md":"# Agent Instructions\n\nThis document provides instructions for agents on how to perform common development tasks in this repository.\n\n## Initial Setup\n\nThis project uses `asdf` to manage tool versions. Before you can install the project's dependencies, you need to install and configure `asdf`.\n\n### 1. Install `asdf`\n\nFirst, make sure you have `git` and `curl` installed. Then, clone the `asdf` repository:\n\n```bash\ngit clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0\n```\n\n### 2. Configure Your Shell\n\nAdd `asdf` to your shell's startup file. For `bash`, run:\n\n```bash\necho -e \"\\n. \\\"$HOME/.asdf/asdf.sh\\\"\" >> ~/.bashrc\n```\n\nThen, source your `.bashrc` to apply the changes to your current session:\n\n```bash\nsource ~/.bashrc\n```\n\n### 3. Install `asdf` Plugins and Tools\n\nNow, from the root of this project, run the following commands to install the necessary `asdf` plugins and the tools specified in the `.tool-versions` file:\n\n```bash\nasdf plugin add python\nasdf plugin add gcloud https://github.com/jthegedus/asdf-gcloud\nasdf install\n```\n\n### 4. Install `pipenv`\n\nOnce `asdf` has installed the correct python version, you need to install `pipenv`:\n\n```bash\npython -m pip install pipenv\n```\n\n### 5. Install Project Dependencies\n\nNow you are ready to install the project's dependencies. Run the following command from the root of the repository:\n\n```bash\n./local/install_deps.bash\n```\n\n## Using Butler\nBefore each time you use the `butler.py` script, verify that you are inside the virtual environment, if not activate it by running `python -m pipenv shell`, or pre append any `python butler.py` call with\n`pipenv run`\n\nFor instance:\n```bash\npipenv run python butler.py lint\n```\nIs the same as running\n```bash\npython butler.py lint\n```\nif you are inside a virtual environment.\n\n## Testing\n\nTo run all unit tests, execute the following commands:\n\n```bash\npython butler.py py_unittest -t appengine -m\npython butler.py py_unittest -t core -m\n```\n\nThe `-m` flag runs the tests in parallel, which is recommended.\n\n### Running a single test file\n\nTo run a single test file, you can use the `-p` or `--pattern` flag. For example, to run the tests in `deploy_test.py`, you can use the following command:\n\n```bash\npython butler.py py_unittest -t core -p deploy_test.py\n```\n\n## Linting\n\nTo check the code for style and linting issues, run the following command:\n\n```bash\npython butler.py lint\n```\n\nThis will lint the changed code in your current branch.\n\n## Formatting\n\nTo automatically format the code to match the project's style guidelines, run:\n\n```bash\npython butler.py format\n```\n\nThis will format the changed code in your current branch.\nIt's possible to get into a state where linting and formatting contradict each other. In this case, STOP, the human will fix it.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Agent Instructions\n\nThis document provides instructions for agents on how to perform common development tasks in this repository.\n\n## Initial Setup\n\nThis project uses `asdf` to manage tool versions. Before you can install the project's dependencies, you need to install and configure `asdf`.\n\n### 1. Install `asdf`\n\nFirst, make sure you have `git` and `curl` installed. Then, clone the `asdf` repository:\n\n```bash\ngit clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0\n```\n\n### 2. Configure Your Shell\n\nAdd `asdf` to your shell's startup file. For `bash`, run:\n\n```bash\necho -e \"\\n. \\\"$HOME/.asdf/asdf.sh\\\"\" >> ~/.bashrc\n```\n\nThen, source your `.bashrc` to apply the changes to your current session:\n\n```bash\nsource ~/.bashrc\n```\n\n### 3. Install `asdf` Plugins and Tools\n\nNow, from the root of this project, run the following commands to install the necessary `asdf` plugins and the tools specified in the `.tool-versions` file:\n\n```bash\nasdf plugin add python\nasdf plugin add gcloud https://github.com/jthegedus/asdf-gcloud\nasdf install\n```\n\n### 4. Install `pipenv`\n\nOnce `asdf` has installed the correct python version, you need to install `pipenv`:\n\n```bash\npython -m pip install pipenv\n```\n\n### 5. Install Project Dependencies\n\nNow you are ready to install the project's dependencies. Run the following command from the root of the repository:\n\n```bash\n./local/install_deps.bash\n```\n\n## Using Butler\nBefore each time you use the `butler.py` script, verify that you are inside the virtual environment, if not activate it by running `python -m pipenv shell`, or pre append any `python butler.py` call with\n`pipenv run`\n\nFor instance:\n```bash\npipenv run python butler.py lint\n```\nIs the same as running\n```bash\npython butler.py lint\n```\nif you are inside a virtual environment.\n\n## Testing\n\nTo run all unit tests, execute the following commands:\n\n```bash\npython butler.py py_unittest -t appengine -m\npython butler.py py_unittest -t core -m\n```\n\nThe `-m` flag runs the tests in parallel, which is recommended.\n\n### Running a single test file\n\nTo run a single test file, you can use the `-p` or `--pattern` flag. For example, to run the tests in `deploy_test.py`, you can use the following command:\n\n```bash\npython butler.py py_unittest -t core -p deploy_test.py\n```\n\n## Linting\n\nTo check the code for style and linting issues, run the following command:\n\n```bash\npython butler.py lint\n```\n\nThis will lint the changed code in your current branch.\n\n## Formatting\n\nTo automatically format the code to match the project's style guidelines, run:\n\n```bash\npython butler.py format\n```\n\nThis will format the changed code in your current branch.\nIt's possible to get into a state where linting and formatting contradict each other. In this case, STOP, the human will fix it.\n","category":"root","tokens":696}]}