feature: Count Instructions in a Circuits via count()

[sim-eng-ii]

Problem Addressed with This PR

This PR addresses issue #1235 by introducing two methods: counting instructions within a circuit and returning the number of times a gate appears in a circuit. Therefore, there is flexibility in which method to use.

Description of changes:

A new count() method was added in file \src\braket\circuits\circuit.py under the Circuit class:

• count("cnot") returns an int
• count() with no argument returns a Counter of all operator names and frequency.

Testing done:

Testing was achieved by adding two test functions that can be run via:

tox -e unit-tests -- test/unit_tests/braket/circuits/test_circuit.py -k count -v -s

ruff was used to format both Circuit.py and test_circuit.py

Merge Checklist

Put an x in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your pull request.

General

• [ x] I have read the CONTRIBUTING doc
• [x ] I used the PR title format described in CONTRIBUTING
• [x ] I have updated any necessary documentation, including READMEs and API docs (if appropriate)

Tests

• [ x] I have added tests that prove my fix is effective or that my feature works (if appropriate)
• [x ] I have checked that my tests are not configured for a specific region or account (if appropriate)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Cursor was used to navigate the folder structure and identify where the relevant files were.

[sim-eng-ii]

I will fix the errors. thank you

[sim-eng-ii]

it should be fixed now

[sim-eng-ii]

There were some issues with tests regarding from_ir(), which should be resolved now! thank you @aniksd-braket