maps4fs 2.8.9__tar.gz → 2.9.0__tar.gz

{maps4fs-2.8.9 → maps4fs-2.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maps4fs
-Version: 2.8.9
+Version: 2.9.0
 Summary: Generate map templates for Farming Simulator from real places.
 Author-email: iwatkot <iwatkot@gmail.com>
 License: GNU Affero General Public License v3.0

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/background.py

@@ -19,6 +19,7 @@ from maps4fs.generator.component.base.component_image import ImageComponent
 from maps4fs.generator.component.base.component_mesh import MeshComponent
 from maps4fs.generator.component.dem import DEM
 from maps4fs.generator.component.texture import Texture
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 SEGMENT_LENGTH = 2
@@ -38,6 +39,7 @@ class Background(MeshComponent, ImageComponent):
             info, warning. If not provided, default logging will be used.
     """
 
+    @monitor_performance
     def preprocess(self) -> None:
         """Registers the DEMs for the background terrain."""
         self.stl_preview_path = os.path.join(self.previews_directory, "background_dem.stl")
@@ -141,6 +143,7 @@ class Background(MeshComponent, ImageComponent):
                     "Mesh processing is disabled for the game, skipping water mesh processing."
                 )
 
+    @monitor_performance
     def create_foundations(self, dem_image: np.ndarray) -> np.ndarray:
         """Creates foundations for buildings based on the DEM data.
 
@@ -246,6 +249,7 @@ class Background(MeshComponent, ImageComponent):
         )
         self.create_qgis_scripts([qgis_layer, qgis_layer_with_margin])
 
+    @monitor_performance
     def generate_obj_files(self) -> None:
         """Iterates over all dems and generates 3D obj files based on DEM data.
         If at least one DEM file is missing, the generation will be stopped at all.
@@ -328,8 +332,9 @@ class Background(MeshComponent, ImageComponent):
                 return resolution
         return Parameters.MAXIMUM_BACKGROUND_TEXTURE_SIZE
 
+    @monitor_performance
     def decimate_background_mesh(self) -> None:
-        """ ""Decimates the background mesh based on the map size."""
+        """Decimates the background mesh based on the map size."""
         if not self.assets.background_mesh or not os.path.isfile(self.assets.background_mesh):
             self.logger.warning("Background mesh not found, cannot generate i3d background.")
             return
@@ -362,6 +367,7 @@ class Background(MeshComponent, ImageComponent):
 
         self.assets.decimated_background_mesh = decimated_save_path
 
+    @monitor_performance
     def texture_background_mesh(self) -> None:
         """Textures the background mesh using satellite imagery."""
         satellite_component = self.map.get_satellite_component()
@@ -427,6 +433,7 @@ class Background(MeshComponent, ImageComponent):
             self.logger.error("Could not texture background mesh: %s", e)
             return
 
+    @monitor_performance
     def convert_background_mesh_to_i3d(self) -> bool:
         """Converts the textured background mesh to i3d format.
 
@@ -498,6 +505,7 @@ class Background(MeshComponent, ImageComponent):
         with open(file_path, "w", encoding="utf-8") as f:
             f.write(content + "\n\n" + note)
 
+    @monitor_performance
     def convert_water_mesh_to_i3d(self) -> bool:
         """Converts the line-based water mesh to i3d format.
 
@@ -730,6 +738,7 @@ class Background(MeshComponent, ImageComponent):
         cv2.imwrite(colored_dem_path, dem_data_colored)
         return colored_dem_path
 
+    @monitor_performance
     def create_background_textures(self) -> None:
         """Creates background textures for the map."""
         layers_schema = self.map.texture_schema
@@ -782,6 +791,7 @@ class Background(MeshComponent, ImageComponent):
 
         cv2.imwrite(self.water_resources_path, background_image)
 
+    @monitor_performance
     def subtraction(self) -> None:
         """Subtracts the water depth from the DEM data where the water resources are located."""
         if not self.water_resources_path:
@@ -967,6 +977,7 @@ class Background(MeshComponent, ImageComponent):
         mesh = trimesh.Trimesh(vertices=vertices, faces=faces, process=False)
         return mesh
 
+    @monitor_performance
     def generate_water_resources_obj(self) -> None:
         """Generates 3D obj files based on water resources data."""
         self.logger.debug("Starting water resources generation...")
@@ -1033,6 +1044,7 @@ class Background(MeshComponent, ImageComponent):
 
         self.plane_from_np(elevated_water, elevated_save_path, include_zeros=False)
 
+    @monitor_performance
     def flatten_roads(self) -> None:
         """Flattens the roads in the DEM data by averaging the height values along the road polylines."""
         if not self.not_resized_path or not os.path.isfile(self.not_resized_path):

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/config.py

@@ -10,6 +10,7 @@ import numpy as np
 import maps4fs.generator.utils as mfsutils
 from maps4fs.generator.component.base.component_image import ImageComponent
 from maps4fs.generator.component.base.component_xml import XMLComponent
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 # Defines coordinates for country block on the license plate texture.
@@ -120,6 +121,7 @@ class Config(XMLComponent, ImageComponent):
 
         self.create_qgis_scripts(layers)
 
+    @monitor_performance
     def _adjust_fog(self) -> None:
         """Adjusts the fog settings in the environment XML file based on the DEM and height scale."""
         self.logger.debug("Adjusting fog settings based on DEM and height scale...")
@@ -231,6 +233,7 @@ class Config(XMLComponent, ImageComponent):
 
         return dem_maximum_meter, dem_minimum_meter
 
+    @monitor_performance
     def _set_overview(self) -> None:
         """Generates and sets the overview image for the map."""
         try:
@@ -347,6 +350,7 @@ class Config(XMLComponent, ImageComponent):
             "HR",
         }
 
+    @monitor_performance
     def update_license_plates(self):
         """Updates license plates for the specified country."""
         try:
@@ -565,6 +569,7 @@ class Config(XMLComponent, ImageComponent):
         self.save_tree(tree, xml_path=i3d_path)
         self.logger.debug("Updated licensePlatesPL.i3d texture reference to: %s", filename)
 
+    @monitor_performance
     def _generate_license_plate_texture(
         self,
         license_plates_directory: str,

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/dem.py

@@ -9,6 +9,7 @@ from pydtmdl import DTMProvider
 
 import maps4fs.generator.config as mfscfg
 from maps4fs.generator.component.base.component_image import ImageComponent
+from maps4fs.generator.monitor import monitor_performance
 
 
 # pylint: disable=R0903, R0902
@@ -115,6 +116,7 @@ class DEM(ImageComponent):
         except Exception as e:
             self.logger.warning("Failed to update DEM info: %s.", e)
 
+    @monitor_performance
     def process(self) -> None:
         """Reads DTM file, crops it to map size, normalizes and blurs it,
         saves to map directory."""
@@ -190,6 +192,7 @@ class DEM(ImageComponent):
         if self.rotation:
             self.rotate_dem()
 
+    @monitor_performance
     def normalize_data(self, data: np.ndarray, height_scale_value: int) -> np.ndarray:
         """Normalize DEM data to 16-bit unsigned integer range (0 to 65535).
 
@@ -209,6 +212,7 @@ class DEM(ImageComponent):
         )
         return normalized_data
 
+    @monitor_performance
     def determine_height_scale(self, data: np.ndarray) -> int:
         """Determine height scale value using ceiling.
 
@@ -261,6 +265,7 @@ class DEM(ImageComponent):
         )
         return data
 
+    @monitor_performance
     def apply_multiplier(self, data: np.ndarray) -> np.ndarray:
         """Apply multiplier to DEM data.
 
@@ -283,6 +288,7 @@ class DEM(ImageComponent):
         )
         return multiplied_data
 
+    @monitor_performance
     def resize_to_output(self, data: np.ndarray) -> np.ndarray:
         """Resize DEM data to the output resolution.
 
@@ -296,6 +302,7 @@ class DEM(ImageComponent):
 
         return resampled_data
 
+    @monitor_performance
     def rotate_dem(self) -> None:
         """Rotate DEM image."""
         self.logger.debug("Rotating DEM image by %s degrees.", self.rotation)

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/grle.py

@@ -12,6 +12,7 @@ from tqdm import tqdm
 from maps4fs.generator.component.base.component_image import ImageComponent
 from maps4fs.generator.component.base.component_xml import XMLComponent
 from maps4fs.generator.component.layer import Layer
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 # This value sums up the pixel value of the basic area type to convert it from "No Water" to "Near Water".
@@ -98,6 +99,7 @@ class GRLE(ImageComponent, XMLComponent):
 
         return grle_schema
 
+    @monitor_performance
     def process(self) -> None:
         """Generates InfoLayer PNG files based on the GRLE schema."""
         grle_schema = self._read_grle_schema()
@@ -134,6 +136,7 @@ class GRLE(ImageComponent, XMLComponent):
             self._process_environment()
             self._process_indoor()
 
+    @monitor_performance
     def previews(self) -> list[str]:
         """Returns a list of paths to the preview images (empty list).
         The component does not generate any preview images so it returns an empty list.
@@ -173,6 +176,7 @@ class GRLE(ImageComponent, XMLComponent):
 
         return preview_paths
 
+    @monitor_performance
     def overlay_fields(self, farmlands_np: np.ndarray) -> np.ndarray | None:
         """Overlay fields on the farmlands preview image.
 
@@ -200,6 +204,7 @@ class GRLE(ImageComponent, XMLComponent):
         # use fields_np as base layer and overlay farmlands_np on top of it with 50% alpha blending.
         return cv2.addWeighted(fields_np, 0.5, farmlands_np, 0.5, 0)
 
+    @monitor_performance
     def _add_farmlands(self) -> None:
         """Adds farmlands to the InfoLayer PNG file."""
         farmlands = []
@@ -297,6 +302,7 @@ class GRLE(ImageComponent, XMLComponent):
 
         self.preview_paths["farmlands"] = info_layer_farmlands_path
 
+    @monitor_performance
     def _add_plants(self) -> None:
         """Adds plants to the InfoLayer PNG file."""
         grass_layer = self.map.get_texture_layer(by_usage="grass")
@@ -399,6 +405,7 @@ class GRLE(ImageComponent, XMLComponent):
 
         self.logger.debug("Updated density map for fruits saved in %s.", density_map_fruit_path)
 
+    @monitor_performance
     def create_island_of_plants(self, image: np.ndarray, count: int) -> np.ndarray:
         """Create an island of plants in the image.
 
@@ -495,6 +502,7 @@ class GRLE(ImageComponent, XMLComponent):
         image_np[:, -1] = 0  # Right side
         return image_np
 
+    @monitor_performance
     def _process_environment(self) -> None:
         info_layer_environment_path = self.game.get_environment_path(self.map_directory)
         if not info_layer_environment_path or not os.path.isfile(info_layer_environment_path):
@@ -554,6 +562,7 @@ class GRLE(ImageComponent, XMLComponent):
         self.logger.debug("Environment InfoLayer PNG file saved: %s.", info_layer_environment_path)
         self.preview_paths["environment"] = info_layer_environment_path
 
+    @monitor_performance
     def get_resized_weight(
         self, layer: Layer, resize_to: int, dilations: int = 3
     ) -> np.ndarray | None:

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/i3d.py

@@ -13,6 +13,7 @@ import numpy as np
 from tqdm import tqdm
 
 from maps4fs.generator.component.base.component_xml import XMLComponent
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 NODE_ID_STARTING_VALUE = 2000
@@ -112,6 +113,7 @@ class I3d(XMLComponent):
 
         self.save_tree(tree)
 
+    @monitor_performance
     def _add_splines(self) -> None:
         """Adds splines to the map I3D file."""
         splines_i3d_path = self.game.splines_file_path(self.map_directory)
@@ -240,6 +242,7 @@ class I3d(XMLComponent):
 
         self.assets.splines = splines_i3d_path
 
+    @monitor_performance
     def _add_fields(self) -> None:
         """Adds fields to the map I3D file."""
         tree = self.get_tree()
@@ -498,6 +501,7 @@ class I3d(XMLComponent):
 
         return choice(trees_by_leaf_type)
 
+    @monitor_performance
     def _add_forests(self) -> None:
         """Adds forests to the map I3D file."""
         tree_schema = self._read_tree_schema()

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/satellite.py

@@ -9,6 +9,7 @@ from pygmdl import save_image
 
 import maps4fs.generator.config as mfscfg
 from maps4fs.generator.component.base.component_image import ImageComponent
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 
@@ -49,6 +50,7 @@ class Satellite(ImageComponent):
             info, warning. If not provided, default logging will be used.
     """
 
+    @monitor_performance
     def process(self) -> None:
         """Downloads the satellite images for the map."""
         self.image_paths = []
@@ -126,6 +128,7 @@ class Satellite(ImageComponent):
 
         return tasks
 
+    @monitor_performance
     def previews(self) -> list[str]:
         """Returns the paths to the preview images.
 

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/component/texture.py

@@ -7,10 +7,10 @@ import os
 import shutil
 import warnings
 from collections import defaultdict
-from time import perf_counter
 from typing import Any, Callable, Generator, Optional
 
 import cv2
+import geopandas as gpd
 import numpy as np
 import osmnx as ox
 import pandas as pd
@@ -21,6 +21,7 @@ from tqdm import tqdm
 
 from maps4fs.generator.component.base.component_image import ImageComponent
 from maps4fs.generator.component.layer import Layer
+from maps4fs.generator.monitor import monitor_performance
 from maps4fs.generator.settings import Parameters
 
 
@@ -186,6 +187,7 @@ class Texture(ImageComponent):
         for layer in self.layers:
             self.assets[layer.name] = layer.path(self._weights_dir)
 
+    @monitor_performance
     def add_borders(self) -> None:
         """Iterates over all the layers and picks the one which have the border propety defined.
         Borders are distance from the edge of the map on each side (top, right, bottom, left).
@@ -272,6 +274,7 @@ class Texture(ImageComponent):
                 return layer
         return None
 
+    @monitor_performance
     def merge_into(self) -> None:
         """Merges the content of layers into their target layers."""
         for layer in self.layers:
@@ -298,6 +301,7 @@ class Texture(ImageComponent):
                     cv2.imwrite(layer.path(self._weights_dir), np.zeros_like(layer_image))
                     self.logger.debug("Cleared layer %s.", layer.name)
 
+    @monitor_performance
     def rotate_textures(self) -> None:
         """Rotates textures of the layers which have tags."""
         if self.rotation:
@@ -320,6 +324,7 @@ class Texture(ImageComponent):
                         "Skipping rotation of layer %s because it has no tags.", layer.name
                     )
 
+    @monitor_performance
     def scale_textures(self) -> None:
         """Resizes all the textures to the map output size."""
         if not self.map.output_size:
@@ -364,6 +369,7 @@ class Texture(ImageComponent):
         ]
         return {attr: getattr(self, attr, None) for attr in useful_attributes}
 
+    @monitor_performance
     def _prepare_weights(self):
         self.logger.debug("Starting preparing weights from %s layers.", len(self.layers))
 
@@ -428,6 +434,7 @@ class Texture(ImageComponent):
             ),
         )
 
+    @monitor_performance
     def draw(self) -> None:
         """Iterates over layers and fills them with polygons from OSM data."""
         layers = self.layers_by_priority()
@@ -546,6 +553,7 @@ class Texture(ImageComponent):
                 }
                 info_layer_data[f"{layer.info_layer}_polylines"].append(linestring_entry)  # type: ignore
 
+    @monitor_performance
     def dissolve(self) -> None:
         """Dissolves textures of the layers with tags into sublayers for them to look more
         natural in the game.
@@ -791,35 +799,47 @@ class Texture(ImageComponent):
         ox_settings.use_cache = self.map.texture_settings.use_cache
         ox_settings.requests_timeout = 30
 
+        objects = self.fetch_osm_data(tags)
+        if objects is None or objects.empty:
+            self.logger.debug("No objects found for tags: %s.", tags)
+            return
+
+        self.logger.debug("Fetched %s elements for tags: %s.", len(objects), tags)
+
+        method = self.linestrings_generator if yield_linestrings else self.polygons_generator
+
+        yield from method(objects, width, is_fieds)
+
+    @monitor_performance
+    def fetch_osm_data(self, tags: dict[str, str | list[str] | bool]) -> gpd.GeoDataFrame | None:
+        """Fetches OSM data for given tags.
+
+        Arguments:
+            tags (dict[str, str | list[str] | bool]): Dictionary of tags to search for.
+
+        Returns:
+            gpd.GeoDataFrame | None: GeoDataFrame with OSM objects or None if no objects found.
+        """
         try:
             if self.map.custom_osm is not None:
                 with warnings.catch_warnings():
                     warnings.simplefilter("ignore", FutureWarning)
                     objects = ox.features_from_xml(self.map.custom_osm, tags=tags)
             else:
-                before_fetch = perf_counter()
                 objects = ox.features_from_bbox(bbox=self.new_bbox, tags=tags)
-                after_fetch = perf_counter()
-                fetched_in = after_fetch - before_fetch
-                self.logger.info(
-                    "Fetched OSMNX objects for tags: %s in %.2f seconds.", tags, fetched_in
-                )
         except Exception as e:
             self.logger.debug("Error fetching objects for tags: %s. Error: %s.", tags, e)
-            return
-        self.logger.debug("Fetched %s elements for tags: %s.", len(objects), tags)
+            return None
 
-        method = self.linestrings_generator if yield_linestrings else self.polygons_generator
-
-        yield from method(objects, width, is_fieds)
+        return objects
 
     def linestrings_generator(
-        self, objects: pd.core.frame.DataFrame, *args, **kwargs
+        self, objects: gpd.GeoDataFrame, *args, **kwargs
     ) -> Generator[list[tuple[int, int]], None, None]:
         """Generator which yields lists of point coordinates which represent LineStrings from OSM.
 
         Arguments:
-            objects (pd.core.frame.DataFrame): Dataframe with OSM objects.
+            objects (gpd.GeoDataFrame): GeoDataFrame with OSM objects.
 
         Yields:
             Generator[list[tuple[int, int]], None, None]: List of point coordinates.
@@ -865,6 +885,7 @@ class Texture(ImageComponent):
             polygon_np = self._to_np(polygon)
             yield polygon_np
 
+    @monitor_performance
     def previews(self) -> list[str]:
         """Invokes methods to generate previews. Returns list of paths to previews.
 

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/map.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import json
 import os
 import shutil
+from time import perf_counter
 from typing import Any, Generator
 
 from pydtmdl import DTMProvider
@@ -14,8 +15,13 @@ import maps4fs.generator.config as mfscfg
 import maps4fs.generator.utils as mfsutils
 from maps4fs.generator.component import Background, Component, Layer, Satellite, Texture
 from maps4fs.generator.game import Game
+from maps4fs.generator.monitor import PerformanceMonitor, performance_session
 from maps4fs.generator.settings import GenerationSettings, MainSettings, SharedSettings
-from maps4fs.generator.statistics import send_advanced_settings, send_main_settings
+from maps4fs.generator.statistics import (
+    send_advanced_settings,
+    send_main_settings,
+    send_performance_report,
+)
 from maps4fs.logger import Logger
 
 
@@ -203,51 +209,76 @@ class Map:
         Yields:
             Generator[str, None, None]: Component names.
         """
-        self.logger.debug(
-            "Starting map generation. Game code: %s. Coordinates: %s, size: %s. Rotation: %s.",
-            self.game.code,
-            self.coordinates,
-            self.size,
-            self.rotation,
-        )
-        for game_component in self.game.components:
-            component = game_component(
-                self.game,
-                self,
+        with performance_session() as session_id:
+            self.logger.info(
+                "Starting map generation. Game code: %s. Coordinates: %s, size: %s. Rotation: %s.",
+                self.game.code,
                 self.coordinates,
                 self.size,
-                self.rotated_size,
                 self.rotation,
-                self.map_directory,
-                self.logger,
-                texture_custom_schema=self.texture_custom_schema,  # type: ignore
-                tree_custom_schema=self.tree_custom_schema,  # type: ignore
             )
-            self.components.append(component)
-
-            yield component.__class__.__name__
-
-            try:
-                component.process()
-                component.commit_generation_info()
-            except Exception as e:
-                self.logger.error(
-                    "Error processing or committing generation info for component %s: %s",
-                    component.__class__.__name__,
-                    e,
+            generation_start = perf_counter()
+
+            for game_component in self.game.components:
+                component = game_component(
+                    self.game,
+                    self,
+                    self.coordinates,
+                    self.size,
+                    self.rotated_size,
+                    self.rotation,
+                    self.map_directory,
+                    self.logger,
+                    texture_custom_schema=self.texture_custom_schema,  # type: ignore
+                    tree_custom_schema=self.tree_custom_schema,  # type: ignore
                 )
-                self._update_main_settings({"error": str(e)})
-                raise e
+                self.components.append(component)
+
+                yield component.__class__.__name__
+
+                try:
+                    component_start = perf_counter()
+                    component.process()
+                    component_finish = perf_counter()
+                    self.logger.info(
+                        "Component %s processed in %.2f seconds.",
+                        component.__class__.__name__,
+                        component_finish - component_start,
+                    )
+                    component.commit_generation_info()
+                except Exception as e:
+                    self.logger.error(
+                        "Error processing or committing generation info for component %s: %s",
+                        component.__class__.__name__,
+                        e,
+                    )
+                    self._update_main_settings({"error": str(e)})
+                    raise e
+
+            generation_finish = perf_counter()
+            self.logger.info(
+                "Map generation completed in %.2f seconds.",
+                generation_finish - generation_start,
+            )
 
-        self._update_main_settings({"completed": True})
+            self._update_main_settings({"completed": True})
 
-        self.logger.debug(
-            "Map generation completed. Game code: %s. Coordinates: %s, size: %s. Rotation: %s.",
-            self.game.code,
-            self.coordinates,
-            self.size,
-            self.rotation,
-        )
+            self.logger.info(
+                "Map generation completed. Game code: %s. Coordinates: %s, size: %s. Rotation: %s.",
+                self.game.code,
+                self.coordinates,
+                self.size,
+                self.rotation,
+            )
+
+        session_json = PerformanceMonitor().get_session_json(session_id)
+        if session_json:
+            report_filename = "performance_report.json"
+            with open(
+                os.path.join(self.map_directory, report_filename), "w", encoding="utf-8"
+            ) as file:
+                json.dump(session_json, file, indent=4)
+            send_performance_report(session_json)
 
     def _update_main_settings(self, data: dict[str, Any]) -> None:
         """Update main settings with provided data.

maps4fs-2.9.0/maps4fs/generator/monitor.py

@@ -0,0 +1,108 @@
+"""Module for performance monitoring during map generation."""
+
+import functools
+import threading
+import uuid
+from collections import defaultdict
+from contextlib import contextmanager
+from time import perf_counter
+from typing import Callable, Generator
+
+from maps4fs.generator.utils import Singleton
+
+_local = threading.local()
+
+
+def get_current_session() -> str | None:
+    """Get the current session name from thread-local storage."""
+    return getattr(_local, "current_session", None)
+
+
+@contextmanager
+def performance_session(session_id: str | None = None) -> Generator[str, None, None]:
+    """Context manager for performance monitoring session.
+
+    Arguments:
+        session_id (str, optional): Custom session ID. If None, generates UUID.
+    """
+    if session_id is None:
+        session_id = str(uuid.uuid4())
+
+    _local.current_session = session_id
+
+    try:
+        yield session_id
+    finally:
+        _local.current_session = None
+
+
+class PerformanceMonitor(metaclass=Singleton):
+    """Singleton class for monitoring performance metrics."""
+
+    def __init__(self) -> None:
+        self.sessions: dict[str, dict[str, dict[str, float]]] = defaultdict(
+            lambda: defaultdict(lambda: defaultdict(float))
+        )
+
+    def add_record(self, session: str, component: str, function: str, time_taken: float) -> None:
+        """Add a performance record.
+
+        Arguments:
+            session (str): The session name.
+            component (str): The component/class name.
+            function (str): The function/method name.
+            time_taken (float): Time taken in seconds.
+        """
+        self.sessions[session][component][function] += time_taken
+
+    def get_session_json(self, session: str) -> dict[str, dict[str, float]]:
+        """Get performance data for a session in JSON-serializable format.
+
+        Arguments:
+            session (str): The session name.
+
+        Returns:
+            dict[str, dict[str, float]]: Performance data.
+        """
+        return self.sessions.get(session, {})
+
+
+def monitor_performance(func: Callable) -> Callable:
+    """Decorator to monitor performance of methods/functions.
+
+    Arguments:
+        func (callable) -- The function to be monitored.
+
+    Returns:
+        callable -- The wrapped function with performance monitoring.
+    """
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        if args and hasattr(args[0], "__class__"):
+            class_name = args[0].__class__.__name__
+        elif args and hasattr(args[0], "__name__"):
+            class_name = args[0].__name__
+        elif "." in func.__qualname__:
+            class_name = func.__qualname__.split(".")[0]
+        else:
+            class_name = None
+
+        function_name = func.__name__
+
+        start = perf_counter()
+        result = func(*args, **kwargs)
+        end = perf_counter()
+        time_taken = round(end - start, 5)
+
+        session_name = get_current_session()
+
+        try:
+            if session_name and time_taken > 0.001 and class_name:
+                PerformanceMonitor().add_record(session_name, class_name, function_name, time_taken)
+        except Exception:
+            pass
+
+        return result
+
+    return wrapper

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/statistics.py

@@ -80,3 +80,13 @@ def send_survey(data: dict[str, Any]) -> None:
     """
     endpoint = f"{STATS_HOST}/receive_survey"
     post(endpoint, data)
+
+
+def send_performance_report(data: dict[str, Any]) -> None:
+    """Send performance report to the statistics server.
+
+    Arguments:
+        data (dict[str, Any]): The performance report data to send.
+    """
+    endpoint = f"{STATS_HOST}/receive_performance_report"
+    post(endpoint, data)

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs/generator/utils.py

@@ -158,3 +158,14 @@ def dump_json(filename: str, directory: str, data: dict[Any, Any] | Any | None)
     save_path = os.path.join(directory, filename)
     with open(save_path, "w", encoding="utf-8") as file:
         json.dump(data, file, indent=4)
+
+
+class Singleton(type):
+    """A metaclass for creating singleton classes."""
+
+    _instances: dict[Any, Any] = {}
+
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super().__call__(*args, **kwargs)
+        return cls._instances[cls]

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maps4fs
-Version: 2.8.9
+Version: 2.9.0
 Summary: Generate map templates for Farming Simulator from real places.
 Author-email: iwatkot <iwatkot@gmail.com>
 License: GNU Affero General Public License v3.0

{maps4fs-2.8.9 → maps4fs-2.9.0}/maps4fs.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ maps4fs/generator/__init__.py
 maps4fs/generator/config.py
 maps4fs/generator/game.py
 maps4fs/generator/map.py
+maps4fs/generator/monitor.py
 maps4fs/generator/qgis.py
 maps4fs/generator/settings.py
 maps4fs/generator/statistics.py

{maps4fs-2.8.9 → maps4fs-2.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "maps4fs"
-version = "2.8.9"
+version = "2.9.0"
 description = "Generate map templates for Farming Simulator from real places."
 authors = [{name = "iwatkot", email = "iwatkot@gmail.com"}]
 license = {text = "GNU Affero General Public License v3.0"}