Add random circuit algo

[ykharkov]

Description of changes:
Added random circuit generator, that takes the number of qubits, number of gates and maximum number of operands for each gate as an input.

This PR reimplements the feature proposed in #122
by @Morcu, created in a fork repo.

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

• I have read the CONTRIBUTING doc
• I used the commit message format described in CONTRIBUTING
• I have updated any necessary documentation, including READMEs and API docs (if appropriate)

Tests

• I have added tests that prove my fix is effective or that my feature works (if appropriate)
• 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.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (d240d09) to head (657a96b).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #139   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           26        29    +3     
  Lines         1028      1053   +25     
  Branches       181       185    +4     
=========================================
+ Hits          1028      1053   +25     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[rmshaffer]

Added a few comments. Overall I am not sure that the current implementation is actually useful for anything.

Also, I believe these two comments from the original PR still apply:

• Random circuit function #122 (comment)
• Random circuit function #122 (comment)

[rmshaffer]

This seems like it should work for now, but in case these constructors get more args added in the future, it is likely more robust to check the actual class ... something like:

num_params = (
    3 if issubclass(gate_class, TripleAngledGate) else
    2 if issubclass(gate_class, DoubleAngledGate) else
    1 if issubclass(gate_class, AngledGate) else
    0
)

[ykharkov]

Braket SDK doesn't have DoubleAngled or TripleAngled classes, unfortunately. The existing code should work fine.

[rmshaffer]

Looking good! A few more minor comments, nothing too critical.

Also note that #140 is adding a summary table to the README - if that gets merged first, then a link to this random_circuit function should probably also be added to that summary table.