Move the searching from Traits into Class based to allow for the dropping of the all() method and search functionality

[RoadSigns]

Pull Request Description

Change to how we are structing the data

This Pull Request has changed the application from using Traits and using Classes, this allows us to create a tree like structure so when it comes to searching for specific locations we can go down the branches of the tree to location it as long it's lower down the tree.
Tree Data Structure

Reading of the JSON files

When it comes to getting the information this is done when creating the Uganda object for the first time and we store the information in memory. This allows us to access the information quickly since we won't be required to do multiple reads every time we want to access the information.

Since we aren't changing the state of the tree structure we are just creating copies of branches that we want. We only need to read the file when we create the object for the first time and we won't have to worry about the information since the Objects are immutable.

Testing

Since now we have Classes instead of Traits we can now test each section without the need to call the JSON data since they are just newly created objects with fake data.

PHPStan

Previously we was unable to go above PHPStan Level 1 when it came to static analyzing with the new changes we can now support Level 9.
PHPStan Level

The Ability to get specific types of location data from any level

When doing the refactor I saw the issue of #4 and made it possible to access all of the information for each branch of the data.

So for the issue ticket we are now able to complete this by doing the following $uganda->district('Bugweri')->subCounties();
This will return you an array of SubCounty objects that are from the District object of Bugweri.

The dropping of the all()

Previously all methods had to end with all() to get the information. Using this new approach we are getting the information from methods that are self descriptive.

Type (Feature, Fix, Config, etc)

• Bug fix 🐞
  • Resolving the Issue Fetch all subcounties in a particular district #4
  • Resolving the Issue Remove chaining dependability on the all method. #6
• New feature ✨
  • The ability to access all Geographical information for every specific type of Geographical location
• Breaking change 🔩
  • Removal of the Geo class and now called Uganda
• This change requires a documentation update 📙
  • All of the new ways of accessing the information has been added to the README.md
• Improvement 🌠
• Refactor 🔄
• Add Test Specs 🚦
  • All new tests have been added to cover the new classes

Tests

Tests have been written to match the new flow of the package

Tests configurations and running:

• PHP Unit

vendor/bin/phpunit

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[RoadSigns]

@kusaasira Bit of a big Pull Request but if you have any questions please get in touch!

[kusaasira]

This is great @RoadSigns . You keep "deeply" refactoring on each PR! This is more than a PR though 😅. Great work there.

[kusaasira]

Great work @RoadSigns . I see the positive impact of PHPStan though.