[CLI] Butler commands TBI (#5032)

This PR adds the `butler.py` commands to the `casp` CLI, but leaves it
marked as "To be implemented".

These changes are intended to serve as a roadmap for further
implementation. Since the commands in `butler.py` need to be validated
before migrating to the new CLI, it's crucial to establish a structure
and expectations around which commands should be included in `casp`.
This will serve as a reminder that these commands should be incorporated
into the CLI.

Those commands are:
- [ ] bootstrap           
- [ ] py_unittest         
- [ ] js_unittest         
- [ ] format              
- [ ] lint                
- [ ] package             
- [ ] deploy              
- [ ] run_server          
- [ ] run                 
- [ ] run_bot             
- [ ] remote              
- [ ] clean_indexes       
- [ ] create_config       
- [ ] integration_tests   
- [ ] weights             
- [x] reproduce

Author: PauloVLB

cli/casp/src/casp/commands/bootstrap.py

@@ -0,0 +1,26 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Bootstrap command."""
+
+import click
+
+
+@click.command(
+    name='bootstrap',
+    help=('Install all required dependencies for running an appengine, a bot,'
+          'and a mapreduce locally.'))
+def cli():
+  """Install all required dependencies for running an appengine, a bot,
+  and a mapreduce locally."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/clean_indexes.py

@@ -0,0 +1,23 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Clean indexes command."""
+
+import click
+
+
+@click.command(
+    name='clean_indexes', help='Clean up undefined indexes (in index.yaml).')
+def cli():
+  """Clean up undefined indexes (in index.yaml)."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/create_config.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Create config command."""
+
+import click
+
+
+@click.command(name='create_config', help='Create a new deployment config.')
+def cli():
+  """Create a new deployment config."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/deploy.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Deploy command."""
+
+import click
+
+
+@click.command(name='deploy', help='Deploy to Appengine')
+def cli():
+  """Deploy to Appengine"""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/format.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Format command."""
+
+import click
+
+
+@click.command(name='format', help='Format changed code in current branch.')
+def cli():
+  """Format changed code in current branch."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/integration_tests.py

@@ -0,0 +1,23 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Integration tests command."""
+
+import click
+
+
+@click.command(
+    name='integration_tests', help='Run end-to-end integration tests.')
+def cli():
+  """Run end-to-end integration tests."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/js_unittest.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Js unittest command."""
+
+import click
+
+
+@click.command(name='js_unittest', help='Run Javascript unit tests.')
+def cli():
+  """Run Javascript unit tests."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/lint.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Lint command."""
+
+import click
+
+
+@click.command(name='lint', help='Lint changed code in current branch.')
+def cli():
+  """Lint changed code in current branch."""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/package.py

@@ -0,0 +1,23 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Package command."""
+
+import click
+
+
+@click.command(
+    name='package', help='Package clusterfuzz with a staging revision')
+def cli():
+  """Package clusterfuzz with a staging revision"""
+  click.echo('To be implemented...')

cli/casp/src/casp/commands/py_unittest.py

@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Py unittest command."""
+
+import click
+
+
+@click.command(name='py_unittest', help='Run Python unit tests.')
+def cli():
+  """Run Python unit tests."""
+  click.echo('To be implemented...')