OpenPartsLibrary 0.1.7__py3-none-any.whl → 0.1.9__py3-none-any.whl

openpartslibrary/cli.py

@@ -0,0 +1,51 @@
+class PartsLibraryCLI:
+    def __init__(self):
+        ''' CLI to be moved to its own object OpenPartsLibraryCLI in cli.py
+        '''
+        '''
+        command_history = []
+        while True:    
+            os.system('cls')
+            print('************************************************************') 
+            print('*  OpenPartsLibrary                                        *')
+            print('*  Aleksander Sadowski,  Nandana Gopala Krishnan (C) 2025  *')
+            print('************************************************************') 
+            pl.display()
+            commands = 'add part', 'add supplier', 'modify part', 'modify supplier', 'remove part', 'remove supplier'
+            commands_str = ''
+            for command in commands:
+                commands_str = commands_str + '[' + str(command) + '] '
+            print('Commands: ' + commands_str)
+            print('Last commands:' + str([command for command in command_history][-5:]))
+            input_cmd = input('Enter command: ')
+            command_history.append(input_cmd)
+            if input_cmd in commands:
+                if input_cmd == 'add part':
+                    pass
+                if input_cmd == 'add supplier':
+                    pass
+                if input_cmd == 'modify part':
+                    os.system('cls')
+                    print('************************************************************') 
+                    print('*  OpenPartsLibrary                                        *')
+                    print('*  Aleksander Sadowski,  Nandana Gopala Krishnan (C) 2025  *')
+                    print('************************************************************')
+                    pl.display_parts()
+                    selected_part = int(input('Enter part id: '))
+                    pass
+                if input_cmd == 'modify supplier':
+                    os.system('cls')
+                    print('************************************************************') 
+                    print('*  OpenPartsLibrary                                        *')
+                    print('*  Aleksander Sadowski,  Nandana Gopala Krishnan (C) 2025  *')
+                    print('************************************************************')
+                    print()
+                    pl.display_suppliers()
+                    selected_part = int(input('Enter supplier id: '))
+                    pass
+                if input_cmd == 'remove part':
+                    pass
+                if input_cmd == 'remove supplier':
+                    pass
+        '''
+        pass

openpartslibrary/db.py

@@ -5,7 +5,11 @@ import pandas as pd
 
 from datetime import datetime
 
-from .models import Base, Part
+from .models import Base, Part, Supplier, File, Component, ComponentComponent
+
+import uuid
+
+import os
 
 
 class PartsLibrary:
@@ -21,25 +25,96 @@ class PartsLibrary:
         self.session = self.session_factory()
 
     def display(self):
+        # Print the components table to the terminal
+        component_component_table = pd.read_sql_table(table_name="component_component", con=self.engine)
+        print('ComponentComponent:')
+        print('===================')
+        print(component_component_table)
+        print('')
+
+        # Print the components table to the terminal
+        components_table = pd.read_sql_table(table_name="components", con=self.engine)
+        print('Components:')
+        print('===========')
+        print(components_table)
+        print('')
+
+        # Print the parts table to the terminal
         part_table = pd.read_sql_table(table_name="parts", con=self.engine)
-
-        pd.set_option('display.max_columns', 8)
-        pd.set_option('display.width', 240)
-
+        print('Parts:')
+        print('======')
         print(part_table)
+        print('')
+
+        # Print the suppliers table to the terminal
+        supplier_table = pd.read_sql_table(table_name="suppliers", con=self.engine)
+        print('Suppliers:')
+        print('==========')
+        print(supplier_table)
+        print('')
+
+        # Print the files table to the terminal
+        files_table = pd.read_sql_table(table_name="files", con=self.engine)
+        print('Files:')
+        print('==========')
+        print(files_table)
+        print('')
 
     def display_reduced(self):
+        # Print the parts table to the terminal in reduced form
+        pass
+
+    def display_parts(self):
+        # Print the parts table to the terminal
         part_table = pd.read_sql_table(table_name="parts", con=self.engine)
-        reduced_part_table = part_table[["id", "number", "name", "quantity", "mass", "lead_time", "supplier", "unit_price", "currency"]]
-        pd.set_option('display.max_columns', 9)
-        pd.set_option('display.width', 200)
-        print(reduced_part_table)
-    
+        print('Parts:')
+        print('======')
+        print(part_table)
+        print('')
+
+    def display_suppliers(self):
+        # Print the suppliers table to the terminal
+        supplier_table = pd.read_sql_table(table_name="suppliers", con=self.engine)
+        print('Suppliers:')
+        print('==========')
+        print(supplier_table)
+        print('')
+
+    def display_files(self):
+        # Print the files table to the terminal
+        files_table = pd.read_sql_table(table_name="files", con=self.engine)
+        print('Files:')
+        print('==========')
+        print(files_table)
+        print('')
 
     def delete_all(self):
+        print('[ INFO ] Clearing the parts library.')
+        self.session.query(ComponentComponent).delete()
+        self.session.query(Component).delete()
         self.session.query(Part).delete()
+        self.session.query(Supplier).delete()
+        self.session.query(File).delete()
         self.session.commit()
 
+        directory_to_empty = os.path.join(os.path.dirname(__file__), 'data', 'files')
+        
+        for filename in os.listdir(directory_to_empty):
+            filepath = os.path.join(directory_to_empty, filename)
+            if os.path.isfile(filepath) and filename != "README.md":
+                os.remove(filepath)
+                print(f"[ INFO ] Deleted: {filename}")
+
+    def total_value(self):
+        from decimal import Decimal
+        all_parts = self.session.query(Part).all()
+
+        total_value = Decimal(0.0)
+        for part in all_parts:
+            total_value = Decimal(total_value) + (Decimal(part.unit_price) * part.quantity)
+
+        return total_value
+
     def create_parts_from_spreadsheet(self, file_path):
         df = pd.read_excel(file_path)
 
@@ -65,7 +140,6 @@ class PartsLibrary:
                 attached_documents_reference=row.get("attached_documents_reference"),
                 lead_time=row.get("lead_time"),
                 make_or_buy=row.get("make_or_buy"),
-                supplier=row.get("supplier"),
                 manufacturer_number=row.get("manufacturer_number"),
                 unit_price=row.get("unit_price"),
                 currency=row.get("currency")
@@ -75,13 +149,70 @@ class PartsLibrary:
         self.session.add_all(parts)
         self.session.commit()
         print(f"Imported {len(parts)} parts successfully from {file_path}")
+    
+    def create_suppliers_from_spreadsheet(self, file_path):
+        self.session.query(Supplier).delete()
+        self.session.commit()
 
-    def total_value(self):
-        from decimal import Decimal
-        all_parts = self.session.query(Part).all()
+        df = pd.read_excel(file_path)
 
-        total_value = Decimal(0.0)
-        for part in all_parts:
-            total_value = Decimal(total_value) + (Decimal(part.unit_price) * part.quantity)
+        suppliers = []
+        for _, row in df.iterrows():
+            supplier = Supplier(
+                uuid=row.get("uuid", str(uuid.uuid4())),
+                name=row["name"],
+                description=row.get("description", "No description"),
+                street=row.get("street"),
+                city=row.get("city"),
+                postal_code=row.get("postal_code"),
+                house_number=row.get("house_number"),
+                country=row.get("country")   
+            )
+            suppliers.append(supplier)
 
-        return total_value
+        self.session.add_all(suppliers)
+        self.session.commit()
+        print(f"Imported {len(suppliers)} suppliers successfully from {file_path}")
+    
+    def display_suppliers_table(self):
+        from tabulate import tabulate
+        import textwrap
+        query="SELECT * FROM suppliers"
+        suppliers_table = pd.read_sql_query(sql=query, con=self.engine)
+        suppliers_table["house_number"] = suppliers_table["house_number"].astype(str)
+        suppliers_table["postal_code"] = suppliers_table["postal_code"].astype(str)
+        pd.set_option('display.max_columns', 7)
+        pd.set_option('display.width', 200)
+        print(tabulate(suppliers_table, headers='keys', tablefmt='github'))
+
+    def add_sample_suppliers(self):
+        from .models import Supplier
+        siemens = Supplier(
+            uuid=str(uuid.uuid4()),
+            name="Siemens AG",
+            description="Siemens AG is a global powerhouse focusing on the areas of electrification, automation, and digitalization. One of the world's largest producers of energy-efficient, resource-saving technologies",
+            street="Werner-von-Siemens-Straße",
+            house_number="1",
+            postal_code="80333",
+            city="Munich",
+            country="Germany",
+            date_created=datetime.utcnow(),
+            date_modified=datetime.utcnow()
+        )
+        
+        kuka = Supplier(
+            uuid=str(uuid.uuid4()),
+            name="KUKA AG",
+            description="The KUKA Group is an internationally active automation group with revenue of approximately EUR 3.7 billion and approximately 15,000 employees. As one of the world's leading providers of intelligent, resource-efficient automation solutions, KUKA offers industrial robots, autonomous mobile robots (AMR) including controllers, software, and cloud-based digital services, as well as fully networked production systems for various industries and markets, such as automotive with a focus on e-mobility and batteries, electronics, metal and plastics, consumer goods, food, e-commerce, retail, and healthcare",
+            street="Zugspitzstraße",
+            house_number="140",
+            postal_code="86165",
+            city="Augsburg",
+            country="Germany",
+            date_created=datetime.utcnow(),
+            date_modified=datetime.utcnow()
+        )
+        self.session.add(siemens)
+        self.session.add(kuka)
+        self.session.commit()
+        print("Added sample suppliers: Siemens AG and KUKA AG")

openpartslibrary/models.py

@@ -1,17 +1,62 @@
-from sqlalchemy import Column, Integer, String, Float, DateTime, Numeric, Enum
-from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy import Column, Integer, String, Float, DateTime, Numeric, Enum, ForeignKey, UniqueConstraint
+from sqlalchemy.orm import DeclarativeBase, relationship, backref
 from datetime import datetime
 
-import uuid
 
 class Base(DeclarativeBase):
   pass
 
+class ComponentComponent(Base):
+    __tablename__ = 'component_component'
+
+    id = Column(Integer, primary_key=True)
+
+    parent_component_id = Column(Integer, ForeignKey("components.id"), nullable=False)
+    child_component_id = Column(Integer, ForeignKey("components.id"), nullable=False)
+
+    __table_args__ = (UniqueConstraint("parent_component_id", "child_component_id", name="uq_parent_child"),)
+
+    def __repr__(self):
+        return f"<ComponentComponent(id={self.id}, parent_component_id={self.parent_component_id}, child_component_id={self.child_component_id})>"
+
+class Component(Base):
+    __tablename__ = 'components'
+
+    id = Column(Integer, primary_key=True)
+    uuid = Column(String(32), unique=True, nullable=False)
+    name = Column(String(200), nullable=False)
+
+    part = relationship('Part', back_populates='component', uselist=False)
+
+    # children: Components that this component is parent of
+    children = relationship(
+        "Component",
+        secondary="component_component",
+        primaryjoin=id == ComponentComponent.parent_component_id,
+        secondaryjoin=id == ComponentComponent.child_component_id,
+        backref=backref("parents", lazy="joined"),
+        lazy="joined",
+    )
+
+class File(Base):
+    __tablename__ = 'files'
+
+    id = Column(Integer, primary_key=True)
+    uuid = Column(String(32), unique=True, nullable=False)
+    name = Column(String(200), nullable=False)
+    description = Column(String(1000))
+    date_created = Column(DateTime, default=datetime.utcnow)
+    date_modified = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    part_id = Column(ForeignKey('parts.id'))
+    part = relationship('Part', back_populates='cad_reference')
+
+
 class Part(Base):
     __tablename__ = 'parts'
 
     id = Column(Integer, primary_key=True)
-    uuid = Column(String(32), unique=True, nullable=False, default=str(uuid.uuid4()))
+    uuid = Column(String(32), unique=True, nullable=False)
     number = Column(String(50), nullable=False)
     name = Column(String(200), nullable=False)
     description = Column(String(1000), default="No description")
@@ -26,46 +71,83 @@ class Part(Base):
     dimension_y = Column(Float)
     dimension_z = Column(Float)
     quantity = Column(Integer, default=0)
-    cad_reference = Column(String(200))
     attached_documents_reference = Column(String(200))
     lead_time = Column(Integer)
     make_or_buy = Column(Enum('make', 'buy', name='make_or_buy_enum'))
-    supplier = Column(String(100))
     manufacturer_number = Column(String(100))
     unit_price = Column(Numeric(10, 2))
     currency = Column(String(3))
 
+    cad_reference = relationship('File', back_populates='part', uselist=False)
+
+    supplier_id = Column(ForeignKey('suppliers.id'))
+    supplier = relationship('Supplier', back_populates='parts')
+
+    component_id = Column(ForeignKey('components.id'))
+    component = relationship('Component', back_populates='part')
+
     def __repr__(self):
         return f"<Part(id={self.id}, number={self.number}, name={self.name})>"
 
     def to_dict(self):
         return {column.name: getattr(self, column.name) for column in self.__table__.columns}
-
-
+    
 class Supplier(Base):
     __tablename__ = 'suppliers'
 
     id = Column(Integer, primary_key=True)
     uuid = Column(String(32), unique=True, nullable=False)
     name = Column(String(200), nullable=False)
-    description = Column(String(1000))
+    description = Column(String(1000), default="No description")                        
+    street = Column(String(200))
+    house_number = Column(String(20))
+    postal_code = Column(String(20))
+    city = Column(String(100))
+    country = Column(String(100))
     date_created = Column(DateTime, default=datetime.utcnow)
     date_modified = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
 
-class File(Base):
-    __tablename__ = 'files'
+    parts = relationship(Part)
+    
+    def to_dict(self):
+        return {column.name: getattr(self, column.name) for column in self.__table__.columns}
+
+class Adress(Base):
+    __tablename__ = 'adresses'
 
     id = Column(Integer, primary_key=True)
     uuid = Column(String(32), unique=True, nullable=False)
-    name = Column(String(200), nullable=False)
-    description = Column(String(1000))
-    date_created = Column(DateTime, default=datetime.utcnow)
-    date_modified = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+    street = Column(String(200))
+    house_number = Column(String(20))
+    postal_code = Column(String(20))
+    city = Column(String(100))
+    country = Column(String(100))
+    
+
+'''
+Relationship tables
+'''
 
-class NumberRange(Base):
-    __tablename__ = 'number_ranges'
+class PartSupplier(Base):
+    __tablename__ = 'part_supplier'
 
     id = Column(Integer, primary_key=True)
-    name = Column(String(200), nullable=False)
-    description = Column(String(1000))
-    date_created = Column(DateTime, default=datetime.utcnow)
+
+class PartFile(Base):
+    __tablename__ = 'part_file'
+
+    id = Column(Integer, primary_key=True)
+
+class SupplierAdress(Base):
+    __tablename__ = 'supplier_adress'
+
+    id = Column(Integer, primary_key=True)
+
+class SupplierFile(Base):
+    __tablename__ = 'supplier_file'
+
+    id = Column(Integer, primary_key=True)
+
+
+
+    

{openpartslibrary-0.1.7.dist-info → openpartslibrary-0.1.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: OpenPartsLibrary
-Version: 0.1.7
+Version: 0.1.9
 Summary: Python library for creating a database of hardware components for manufacturing
 Home-page: https://github.com/alekssadowski95/OpenPartsLibrary
 Author: Aleksander Sadowski
@@ -130,6 +130,8 @@ Creating parts from a parts list in a Excel-spreadsheet (*.xlsx). Take note, tha
 ```python 
 pl.create_parts_from_spreadsheet('C:/Users/Work/Documents/Github/OpenPartsLibrary/openpartslibrary/sample/parts_data_sample.xlsx')
 ```
+## Database structure
+<img src="./openpartslibrary/images/Database-structure-openpartslibrary.png" width="100%" alt="OpenPartsLibrary database structure"></img>
 
 ## Part schema
 This table outlines the `Part` properties used in the OpenPartsLibrary.

openpartslibrary-0.1.9.dist-info/RECORD

@@ -0,0 +1,9 @@
+openpartslibrary/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+openpartslibrary/cli.py,sha256=4QZi-Gub33jWsUPnVmIv2N_iq8fd9WTGePscLwMujHY,2614
+openpartslibrary/db.py,sha256=pW2QtaluIEqVUMDU3kj7EUSE-WzfH9Q3BtiUdy1Fnjo,8572
+openpartslibrary/models.py,sha256=tadjKKi-ChLaqwYM96biZ2DiRSiaszrX5e76dhFHKGQ,5163
+openpartslibrary-0.1.9.dist-info/licenses/LICENSE,sha256=d0dlaVkR5u5bZVrTL-FmUyCoiu3o87Vc-MF1X-NYSXA,1076
+openpartslibrary-0.1.9.dist-info/METADATA,sha256=SkqvSZ2uM2qdgmBwFl50TUyjPiGH5n7_W_pXlBslXTA,7814
+openpartslibrary-0.1.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+openpartslibrary-0.1.9.dist-info/top_level.txt,sha256=-26qZ2PdH7UxxjYQmnXDViKaFDd5Mb5e_Xp__WDTdKQ,17
+openpartslibrary-0.1.9.dist-info/RECORD,,

openpartslibrary-0.1.7.dist-info/RECORD

@@ -1,8 +0,0 @@
-openpartslibrary/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-openpartslibrary/db.py,sha256=FYyQuFdJZzERniBOyWQNCuRQ_v8ZrzgXhjHUbKY1tTk,3157
-openpartslibrary/models.py,sha256=yVnyV0f7hSoTG30f1UVugeLNKLkk4osDEVUU2zIUQYk,2649
-openpartslibrary-0.1.7.dist-info/licenses/LICENSE,sha256=d0dlaVkR5u5bZVrTL-FmUyCoiu3o87Vc-MF1X-NYSXA,1076
-openpartslibrary-0.1.7.dist-info/METADATA,sha256=pO47xQvLlmLRkLqxYhGycAWGKX2hw3LtogeqTbLNs7U,7653
-openpartslibrary-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-openpartslibrary-0.1.7.dist-info/top_level.txt,sha256=-26qZ2PdH7UxxjYQmnXDViKaFDd5Mb5e_Xp__WDTdKQ,17
-openpartslibrary-0.1.7.dist-info/RECORD,,