Over the last year or so I have been playing with concept for an app which would assist people who are planning to hike The Laraptina Trail in the Northern Territory, AU.
The remote and arid trail traverses 230KM of the West Macdonnell ranges. Water, food and gear must be planned according to the length, terrain and facilities available in each of the 12 sections.
Water is the top priority for anyone venturing out to this trail:
- it is scarce: semi-permanent waterholes exist but cannot be relied upon. Hikers rely on the tank water maintained by rangers at each of the trailheads.
- it is heavy: Daily intake requirements are variable but an average 5LT is a reasonable estimate. 1LT = 1KG. The ability to augment water supply with (treated) surface water would significantly reduce pack weight.
One of my main hopes for this app is to provide a way for hikers to report the current conditions along the trail - especially those which relate to surface water. These reports would allow hikers to plan their water accordingly, and potentially achieve pack-weight efficiences.
🚀 So when my SIT771 studies asked for a rocket-powered OO app built in C# I chose to do this.
- Consolidate my data and ideas for this app which have been distributed across multiple other platforms and databases.
- Build a section of the class libray.
The public interface of the Model allows the following Predicate<T> types to be passed in when querying the model:
Predicate<Place>Predicate<CampSite>Predicate<TrailSite>Predicate<Facility>
This allows the Model to remain relatively uncluttered and flexible, whilst I work on the required functionality in the Controller.
The AppDelegates class is a repository for some pre-made predicates which are called at will by the Controller.
Additionally, the Controller exposes a method which allows the view to pass in a custom predicate - for cases where a specific and otherwise unavailable result set is required (see below).
git clone https://github.com/burntsugar/WestMacsAppCoreCS.git
WestMacsApp
|
--- WestMacsApp.sln
|
+-- WestMacsAppCore/
|
+-- WestMacsAppCore.Test/
A handful of features can be seen running in the demo.
dotnet run --project WestMacsAppCore
Using inline anonymous functions, you can pass your own predicates to query Place(s) in the model.
As shown in DemoView.cs, the function returns a predicate for Place(s) with ground elevation greater than 1000 meters. The predicate is then passed to the controller.
Predicate<Place> q = ((p) =>
{
return p.Elevation > 1000;
});
List<Place> places = _controller.customQuery(q);
places.ForEach((p) =>
{
printDemoLines($"{p.Elevation} MTR: {p.ToString()}");
});TTD comprehensive test coverage. See the test case documentation in the WestMacsAppCore.Tests project.
dotnet test
View sorted lists of places which contain water. Lists are sorted from east to west.
GetPlacesWithWaterSource() -> List<Place>: all places having some kind of water source.GetPlacesWithTankWater() -> List<Place>: all places having tank water.GetCampSitesWithWaterSource() -> List<CampSite>: all camp sites having some kind of water source.GetCampSitesWithTankWater() -> List<CampSite>: all camp sites having tank water.GetCampSitesWithTapWater() -> List<CampSite>: all camp sites having tap water.GetTrailSitesWithWaterSource() -> List<PlTrailSiteace>: all trail sites having some kind of water source.GetTrailSitesWithTankWater() -> List<TrailSite>: all trail sites having tank water.
This build relies upon a .json data file which has been compiled from my initial databases. It represents a portion of the collection.
XML documentation is built with the project and I am hoping to implement DocFX once it becomes mature enough to manage with .NET Core on MacOS (currently problematic 👿).
🤔 Maybe you know how to solve the problem? See my stackoverflow question.
See the Issues log for a list of TODO.
rrr@burntsugar.rocks