refactor: allocation calculations

[weibullguy]

Does this PR introduce a breaking change?

• [ ] Yes
• [X] No

Describe the purpose of this pull request.

This PR refactors the Allocation calculations.

Describe how this was implemented.

Ran code through ChatGPT.

Describe any particular area(s) reviewers should focus on.

None

Provide any other pertinent information.

Pull Request Checklist

• Code Style

  • [x] Code is following code style guidelines.

• Static Checks

  • [x] Failing static checks are only applicable to code outside the scope of this PR.

• Tests

  • [x] At least one test for all newly created functions/methods?

• Chores

  • [x] Issue(s) have been raised for problem areas outside the scope of this PR. These problem areas have been decorated with an ISSUE: # comment.

Summary by Sourcery

Refactor allocation calculations to enhance code clarity and error handling, and update tests to align with these changes.

Enhancements:

• Refactor allocation calculation methods to improve code readability and maintainability by extracting common value calculations and consolidating error handling.
• Introduce a helper function _send_pubsub_message to streamline the sending of failure messages via pubsub.
• Refactor the do_allocate_reliability function to use a dictionary for method selection, simplifying the allocation method dispatch logic.

Tests:

• Update integration tests to reflect changes in error message formats for allocation methods.
• Add new integration tests recommended by ChatGPT to validate successful goal calculations and reliability allocations.

[sourcery-ai[bot]]

Reviewer's Guide by Sourcery

This pull request refactors the allocation calculations in the RAMSTK project. The main changes include improved error handling, code organization, and the introduction of helper functions to reduce code duplication. The refactoring aims to make the code more maintainable and easier to understand.

Class diagram for refactored allocation calculations

classDiagram
    direction TB
    class Allocation {
        +Dict _calculate_agree_apportionment(float parent_goal, Dict attributes)
        +Dict _calculate_arinc_apportionment(float parent_goal, Dict attributes)
        +Dict _calculate_equal_apportionment(float parent_goal, Dict attributes)
        +Dict _calculate_foo_apportionment(float parent_goal, int cum_weight, Dict attributes)
        +Dict do_allocate_reliability(float parent_goal, int cumulative_weight, **attributes)
        +Dict _calculate_common_values(Dict attributes)
        +void _send_pubsub_message(string message_type, string message)
    }
    Allocation --> PubSub : uses
    class PubSub {
        +void sendMessage(string message_type, string error_message)
    }

File-Level Changes

Change	Details	Files
Refactored allocation calculation functions	Introduced _calculate_common_values() function to extract and calculate common values Simplified error handling using a new _send_pubsub_message() function Reduced code duplication in calculation functions Updated error messages to be more concise and informative	src/ramstk/analyses/allocation.py
Improved code organization in do_allocate_reliability()	Replaced if-elif chain with a dictionary of allocation methods Simplified default case handling	src/ramstk/analyses/allocation.py
Updated test cases to reflect new error messages	Modified assertion messages in test functions Added new tests recommended by ChatGPT for better coverage	tests/analyses/allocation_calc_integration_test.py

---

Tips and commands

#### Interacting with Sourcery - **Trigger a new review:** Comment `@sourcery-ai review` on the pull request. - **Continue discussions:** Reply directly to Sourcery's review comments. - **Generate a GitHub issue from a review comment:** Ask Sourcery to create an issue from a review comment by replying to it. - **Generate a pull request title:** Write `@sourcery-ai` anywhere in the pull request title to generate a title at any time. - **Generate a pull request summary:** Write `@sourcery-ai summary` anywhere in the pull request body to generate a PR summary at any time. You can also use this command to specify where the summary should be inserted. #### Customizing Your Experience Access your [dashboard](https://app.sourcery.ai) to: - Enable or disable review features such as the Sourcery-generated pull request summary, the reviewer's guide, and others. - Change the review language. - Add, remove or edit custom review instructions. - Adjust other review settings. #### Getting Help - [Contact our support team](mailto:support@sourcery.ai) for questions or feedback. - Visit our [documentation](https://docs.sourcery.ai) for detailed guides and information. - Keep in touch with the Sourcery team by following us on [X/Twitter](https://x.com/SourceryAI), [LinkedIn](https://www.linkedin.com/company/sourcery-ai/) or [GitHub](https://github.com/sourcery-ai).