snapmark 2.0.0__tar.gz

snapmark-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Federico Sidraschi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

snapmark-2.0.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: snapmark
+Version: 2.0.0
+Summary: Python library for automated DXF file marking and manipulation
+Author: serg_you_lin
+License: MIT
+Project-URL: Homepage, https://github.com/serg-you-lin/snapmark
+Project-URL: Repository, https://github.com/serg-you-lin/snapmark
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ezdxf>=1.0.0
+Dynamic: license-file
+
+# SnapMark
+SnapMark is a Python-based tool designed to apply customizable markings to DXF files using a flexible sequence logic. It leverages the ezdxf library to manipulate DXF files and supports operations like adding counters, alignment, character scaling, and more.
+
+## Features
+Automatic DXF file scanning and processing
+
+Flexible character sequencing (e.g., counters, file-based naming, custom patterns)
+
+Text scaling, alignment, and positioning
+
+Modular structure for extending operations
+
+Easy integration into existing workflows
+
+# Quick Start
+## 1. Clone the repository:
+
+```bash
+git clone https://github.com/serg-you-lin/snapmark.git
+```
+## 2. Install the dependencies:
+
+
+```bash
+pip install -r requirements.txt
+```
+## 3.Run the example:
+
+```bash
+python examples/run_example.py
+```
+The script will process the sample DXF files located in examples/input/ and save the marked versions to a new folder (e.g., examples/input_Marked/).
+
+## Parameters:
+### Object:
+suffix: adding suffix on both new file and new folder.
+
+### AddMark operation:
+sequence: text put on file.
+layer: choose layer where put the text
+min_char/max_char: minimum/maximum heigth of text
+align: part f file where mark is located ('r'->right, 'l'->left, 'c'->center)
+start_y: minimum place for text on y axis
+down to: allowing text toi be smaller if does not fit while min_char. 
+
+### Sequence:
+You can built a fix sequence or concatenate your sequence by file name, folder name, etc.
+
+## Other features
+### CountHoles
+```bash
+ToMark.add_operation(CountHoles(find_circle_by_radius(max_diam=5.2, min_diam=4.8)))
+```
+In this example, you can count all holes between 4.8 and 5.2 mm diameter in all files on a folder. Total and partial result.
+
+### AddX
+```bash
+ToMark.add_operation(AddX(find_circle_by_radius(min_diam=2, max_diam=15), size=15, delete_hole=True, layer='Marcatura'))
+```
+In this example, all holes between 2 and 15 mm will be substituite from a 'X' sign of 15mm, on 'Marcatura' layer. Holes will been deleted.
+
+# Project Structure
+```bash
+SnapMark/
+│
+├── snapmark/                # Main package
+│   ├── snapmark.py          # Main module combining logic
+│   ├── operations/          # Marking operations
+│   ├── sequence/            # Sequence logic
+│   ├── checking/            # Input validation
+│   └── __init__.
+```
+
+## License
+MIT License — feel free to use, modify, and share with attribution.
+
+## Contributions
+Pull requests are welcome! If you find issues or have suggestions, please open an issue in the repository.
+
+## Author
+Federico Sidraschi https://www.linkedin.com/in/federico-sidraschi-059a961b9/

snapmark-2.0.0/README.md

@@ -0,0 +1,81 @@
+# SnapMark
+SnapMark is a Python-based tool designed to apply customizable markings to DXF files using a flexible sequence logic. It leverages the ezdxf library to manipulate DXF files and supports operations like adding counters, alignment, character scaling, and more.
+
+## Features
+Automatic DXF file scanning and processing
+
+Flexible character sequencing (e.g., counters, file-based naming, custom patterns)
+
+Text scaling, alignment, and positioning
+
+Modular structure for extending operations
+
+Easy integration into existing workflows
+
+# Quick Start
+## 1. Clone the repository:
+
+```bash
+git clone https://github.com/serg-you-lin/snapmark.git
+```
+## 2. Install the dependencies:
+
+
+```bash
+pip install -r requirements.txt
+```
+## 3.Run the example:
+
+```bash
+python examples/run_example.py
+```
+The script will process the sample DXF files located in examples/input/ and save the marked versions to a new folder (e.g., examples/input_Marked/).
+
+## Parameters:
+### Object:
+suffix: adding suffix on both new file and new folder.
+
+### AddMark operation:
+sequence: text put on file.
+layer: choose layer where put the text
+min_char/max_char: minimum/maximum heigth of text
+align: part f file where mark is located ('r'->right, 'l'->left, 'c'->center)
+start_y: minimum place for text on y axis
+down to: allowing text toi be smaller if does not fit while min_char. 
+
+### Sequence:
+You can built a fix sequence or concatenate your sequence by file name, folder name, etc.
+
+## Other features
+### CountHoles
+```bash
+ToMark.add_operation(CountHoles(find_circle_by_radius(max_diam=5.2, min_diam=4.8)))
+```
+In this example, you can count all holes between 4.8 and 5.2 mm diameter in all files on a folder. Total and partial result.
+
+### AddX
+```bash
+ToMark.add_operation(AddX(find_circle_by_radius(min_diam=2, max_diam=15), size=15, delete_hole=True, layer='Marcatura'))
+```
+In this example, all holes between 2 and 15 mm will be substituite from a 'X' sign of 15mm, on 'Marcatura' layer. Holes will been deleted.
+
+# Project Structure
+```bash
+SnapMark/
+│
+├── snapmark/                # Main package
+│   ├── snapmark.py          # Main module combining logic
+│   ├── operations/          # Marking operations
+│   ├── sequence/            # Sequence logic
+│   ├── checking/            # Input validation
+│   └── __init__.
+```
+
+## License
+MIT License — feel free to use, modify, and share with attribution.
+
+## Contributions
+Pull requests are welcome! If you find issues or have suggestions, please open an issue in the repository.
+
+## Author
+Federico Sidraschi https://www.linkedin.com/in/federico-sidraschi-059a961b9/

snapmark-2.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "snapmark"
+version = "2.0.0"
+description = "Python library for automated DXF file marking and manipulation"
+readme = "README.md"
+authors = [{name = "serg_you_lin"}]
+license = {text = "MIT"}
+requires-python = ">=3.8"
+dependencies = [
+    "ezdxf>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/serg-you-lin/snapmark"
+Repository = "https://github.com/serg-you-lin/snapmark"
+
+[tool.setuptools.packages.find]
+include = ["snapmark*"]
+exclude = ["dev*", "examples*"]

snapmark-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

snapmark-2.0.0/snapmark/__init__.py

@@ -0,0 +1,165 @@
+"""
+SnapMark - Library for marking and manipulating DXF files.
+
+Basic Usage:
+    import snapmark as sm
+    
+    # Quick mark by file name
+    sm.mark_by_name("Examples/Input")
+    
+    # Mark folder
+    sm.Operation.process_folder("folder", mark)
+    
+    # Multiple pipeline example
+    manager = sm.IterationManager("folder")
+    manager.add_operation(
+        sm.Aligner(),
+        sm.AddMark(sequence),
+        sm.CountHoles(sm.find_circle_by_radius(5, 10))
+    )
+    manager.execute()
+"""
+
+# ========== CORE: Main operations ==========
+from .operations.basic_operations import (
+    Operation,
+    AddMark,
+    SubstituteCircle,
+    AddX,
+    RemoveCircle,
+    RemoveLayer,
+    PrintLayers,
+)
+
+from .operations.counter import (
+    Counter,
+    CountFiles,
+    CountHoles,
+)
+
+from .operations.aligner import Aligner
+
+# ========== SEQUENCE (NEW SYSTEM) ==========
+from .sequence.sequence_system import (
+    SequenceBuilder,
+    from_file_name,
+    from_splitted_text
+)
+
+# ========== SEQUENCE (OLD - DEPRECATED) ==========
+from .sequence.sequence_legacy import (
+    Conc,
+    FixSeq,
+)
+
+# ========== SHORTCUTS ========== 
+from .shortcuts import (
+    mark_by_name,
+    mark_by_splitted_text,
+    mark_with_sequence,
+    quick_count_holes,
+    single_file_pipeline,  
+    restore_backup
+)
+
+
+# ========== ITERATION MANAGER ==========
+from .core import IterationManager, iteration_manager  # iteration_manager = alias legacy
+
+# ========== UTILITIES ==========
+from .utils.backup_manager import BackupManager
+from .utils.helpers import (
+    count_holes,
+    find_all_circles,
+    find_circle_by_radius,
+)
+
+# ========== CHECKING/SEARCH ==========
+from .checking.checking import (
+    find_spec_holes,
+    find_circle_centers,
+    find_longer_entity,
+    print_layers as print_document_layers,
+    print_entities,
+)
+
+
+# ========== METADATA ==========
+__version__ = "2.0.0"
+__author__ = "serg_you_lin"
+__all__ = [
+    # Shortcuts (main API)
+    'mark_by_name',
+    'mark_by_splitted_text',
+    'mark_with_sequence',
+    'quick_count_holes',
+    'single_file_pipeline',
+    'restore_backup',
+    
+    # Sequence Builder
+    'SequenceBuilder',
+    'from_file_name',
+    'from_file_part',
+
+    # Operations
+    'Operation',
+    'AddMark',
+    'AddCircle',
+    'SubstituteCircle',
+    'AddX',
+    'RemoveCircle',
+    'RemoveLayer',
+    'PrintLayers',
+    'Counter',
+    'CountFiles',
+    'CountHoles',
+    'Aligner',
+    
+    # Manager
+    'IterationManager',
+    'iteration_manager',  # Alias legacy
+    
+    # Utils
+    'BackupManager',
+    'count_holes',
+    'mult_campana',
+    'find_all_circles',
+    'find_circle_by_radius',
+    
+    # Checking
+    'find_spec_holes',
+    'find_circle_centers',
+    'find_longer_entity',
+    'print_document_layers',
+    'print_entities',
+
+    # DEPRECATED (manteinence to backward compatibility)
+    'Conc',
+    'FixSeq',
+]
+
+
+
+# ========== DEPRECATION WARNINGS ==========
+
+def __getattr__(name):
+    """
+    Manages import of deprecated functions with warning.
+    """
+    import warnings
+    
+    deprecated = {
+        'select_files': 'Use file_pattern in process_folder() instead',
+        'iter_on_a_folder': 'Use Operation.process_folder() or IterationManager',
+    }
+    
+    if name in deprecated:
+        warnings.warn(
+            f"{name} is deprecated. {deprecated[name]}",
+            DeprecationWarning,
+            stacklevel=2
+        )
+        # Per ora solleva errore (funzioni rimosse)
+        raise AttributeError(f"Deprecated removed function: {name}")
+    
+    raise AttributeError(f"module 'snapmark' has no attribute '{name}'")

snapmark-2.0.0/snapmark/checking/checking.py

@@ -0,0 +1,183 @@
+import sys
+import os
+import ezdxf
+from snapmark.mark_algorithm.mark_algorithm import *
+from snapmark.entities.add_entities import *
+
+
+# Print the names of the layers
+def print_layers(doc):
+    # print("Layers:")
+    for layer in doc.layers:
+        print(layer.dxf.name)
+        return print(layer.dxf.name)
+    
+def find_spec_holes(doc, diametro_minimo=0, diametro_massimo=float('inf')):
+    """
+    Searches for specific holes in a document based on diameter range.
+    
+    Args:
+        doc: The document containing the entities to search.
+        diametro_minimo: Minimum diameter of the holes to find (default: 0).
+        diametro_massimo: Maximum diameter of the holes to find (default: infinity).
+    
+    Returns:
+        A list of circular entities that match the specified diameter range.
+    """
+    holes = []  # List to store circular entities
+
+    msp = doc.modelspace()  # Access the model space of the drawing
+
+    # Iterate through all entities in the model space
+    for entity in msp.query('CIRCLE'):  # Filter only entities of type circle
+        diameter = entity.dxf.radius * 2  # Calculate the diameter of the circle
+        if diametro_minimo <= diameter <= diametro_massimo:
+            holes.append(entity)
+            # Add the circular entity to the list if it falls within the diameter range
+        
+    return holes
+
+# # Cerca fori specifici
+# def find_spec_holes(doc, diametro_minimo=0, diametro_massimo=float('inf')):
+#     holes = []  # Lista per memorizzare le entità circolari
+
+#     msp = doc.modelspace()  # Accedi al modello spaziale del disegno
+
+#     # Itera attraverso tutte le entità nel modello spaziale
+#     for entity in msp.query('CIRCLE'):  # Filtra solo le entità di tipo cerchio
+#         diametro = entity.dxf.radius * 2  # Calcola il diametro del cerchio
+#         if diametro_minimo <= diametro <= diametro_massimo:
+#             holes.append(entity)
+#             # print(entity)# Aggiungi l'entità circolare alla lista se rientra nel range di diametri
+        
+#     return holes
+
+def find_entities(file_path, entity_type):
+    """Return a list of DXF entities of the given type from the specified file."""
+    # Load DXF file using ezdxf
+    doc = ezdxf.readfile(file_path)
+    
+    # extract entities from model
+    msp = doc.modelspace()
+
+    entities = []
+
+    # Iterate through all entities of the specified type
+    for entity in msp.query(entity_type):
+        entities.append(entity)
+
+    return entities
+
+def print_entities(msp):
+    for e in msp.query():
+        print(e)
+
+
+
+# def find_longer_entity(entities):
+
+#     lato_piu_lungo = None
+#     lunghezza_lato_piu_lungo = 0
+#     lato_piu_lungo_is_sotto = True
+#     minimum_point = float('inf')
+#     # Itera tutte le linee nel modello
+#     for entity in entities:
+#         minimum_point = min(entity.dxf.start.y, entity.dxf.end.y, minimum_point)      
+#         # Calcola la lunghezza della linea utilizzando il teorema di Pitagora
+#         lunghezza = ((entity.dxf.start.x - entity.dxf.end.x) ** 2 + (entity.dxf.start.y - entity.dxf.end.y) ** 2) ** 0.5
+#         # Se la lunghezza della linea è maggiore della lunghezza massima finora trovata, aggiornala
+#         if lunghezza > lunghezza_lato_piu_lungo:
+#             lunghezza_lato_piu_lungo = lunghezza
+#             lato_piu_lungo = entity
+    
+#     # Controllare che il lato più lungo sia una linea perimetrale
+#     if min(lato_piu_lungo.dxf.start.y, lato_piu_lungo.dxf.end.y) > minimum_point:
+#         lato_piu_lungo_is_sotto = False
+    
+#     return lato_piu_lungo, lato_piu_lungo_is_sotto
+
+
+def find_longer_entity(entities):
+    """
+    Finds the longest entity among the given entities and checks if it is below a certain minimum point.
+    
+    Args:
+        entities: A list of entities to evaluate.
+    
+    Returns:
+        A tuple containing the longest entity and a boolean indicating if it is below the minimum point.
+    """
+    
+    longest_side = None
+    longest_side_length = 0
+    longest_side_is_below = True
+    minimum_point = float('inf')
+    
+    # Iterate through all the lines in the model
+    for entity in entities:
+        minimum_point = min(entity.dxf.start.y, entity.dxf.end.y, minimum_point)      
+        # Calculate the length of the line using the Pythagorean theorem
+        length = ((entity.dxf.start.x - entity.dxf.end.x) ** 2 + (entity.dxf.start.y - entity.dxf.end.y) ** 2) ** 0.5
+        # If the length of the line is greater than the maximum length found so far, update it
+        if length > longest_side_length:
+            longest_side_length = length
+            longest_side = entity
+    
+    # Check if the longest side is a perimeter line
+    if min(longest_side.dxf.start.y, longest_side.dxf.end.y) > minimum_point:
+        longest_side_is_below = False
+    
+    return longest_side, longest_side_is_below
+
+
+
+def find_circle_centers(holes_list):
+    """
+    Finds the centers of circles from a list of holes.
+    
+    Args:
+        holes_list: A list of circular entities representing holes.
+    
+    Returns:
+        A list of tuples containing the (x, y) coordinates of the circle centers.
+    """
+    centers = []  # List to store the centers of the circles
+
+    # Iterate through the circular entities in the holes_list
+    for circle in holes_list:  # Use the list passed as an argument
+        center_x = circle.dxf.center.x  # Extract the x coordinate of the circle's center
+        center_y = circle.dxf.center.y  # Extract the y coordinate of the circle's center
+        centers.append((center_x, center_y))  # Add the x and y coordinates of the center to the list
+        
+    return centers
+
+
+def find_circle_centers_2(doc):
+    """
+    Searches for circles in a document and detects their centers.
+    
+    Args:
+        doc: The document containing the entities to search.
+    
+    Returns:
+        A list of tuples containing the (x, y) coordinates of the circle centers.
+    """
+    centers = []  # List to store the centers of the circles
+
+    msp = doc.modelspace()  # Access the model space of the drawing
+
+    # Iterate through all entities in the model space
+    for circle in msp.query('CIRCLE'):  # Filter only entities of type circle
+        center_x = circle.dxf.center.x  # Extract the x coordinate of the circle's center
+        center_y = circle.dxf.center.y  # Extract the y coordinate of the circle's center
+        centers.append((center_x, center_y))  # Add the x and y coordinates of the center to the list
+        
+    return centers
+
+
+def change_layer(entities, new_layer):
+    for entity in entities:
+        entity.set_dxf_attrib('layer', new_layer)
+
+
+