OpenPartsLibrary 0.1.0__tar.gz

openpartslibrary-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aleksander Sadowski
+
+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.

openpartslibrary-0.1.0/OpenPartsLibrary.egg-info/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: OpenPartsLibrary
+Version: 0.1.0
+Summary: Python library for creating a database of hardware components for manufacturing
+Home-page: https://github.com/alekssadowski95/OpenPartsLibrary
+Author: Aleksander Sadowski
+Author-email: aleksander.sadowski@alsado.de
+License: MIT
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: summary

openpartslibrary-0.1.0/OpenPartsLibrary.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+OpenPartsLibrary.egg-info/PKG-INFO
+OpenPartsLibrary.egg-info/SOURCES.txt
+OpenPartsLibrary.egg-info/dependency_links.txt
+OpenPartsLibrary.egg-info/top_level.txt
+openpartslibrary/__init__.py
+openpartslibrary/db.py
+openpartslibrary/models.py

openpartslibrary-0.1.0/OpenPartsLibrary.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

openpartslibrary-0.1.0/OpenPartsLibrary.egg-info/top_level.txt

@@ -0,0 +1 @@
+openpartslibrary

openpartslibrary-0.1.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: OpenPartsLibrary
+Version: 0.1.0
+Summary: Python library for creating a database of hardware components for manufacturing
+Home-page: https://github.com/alekssadowski95/OpenPartsLibrary
+Author: Aleksander Sadowski
+Author-email: aleksander.sadowski@alsado.de
+License: MIT
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: summary

openpartslibrary-0.1.0/README.md

@@ -0,0 +1,131 @@
+# OpenPartsLibrary
+**OpenPartsLibrary** is a Python library designed to serve as a centralized parts database for Bill of Materials (BOM), Product Data Management (PDM), and Product Lifecycle Management (PLM) systems. It provides structured data models and APIs for managing components, part metadata, sourcing, and lifecycle states. OpenPartsLibrary streamlines integration with engineering workflows, enabling consistent part usage and traceability across design and manufacturing processes.
+
+## Quickstart
+
+Install the openpartslibrary via pip
+```console
+pip install openpartslibrary
+```
+
+A minimal OpenPartsLibrary application looks something like this:
+```python 
+from openpartslibrary.db import PartsLibrary
+
+pl = PartsLibrary()
+
+pl.display()
+```
+
+This will give you the following output, loading all the integrated parts of the library:
+```console
+      id                              uuid     number               name  ...                supplier manufacturer_number unit_price currency
+0      1  7dd559e06e1044c9b66e4a61df1072b6  SCRW-1000   Screw Type A 5mm  ...          Acme Fasteners          MFG-625535       0.86      EUR
+1      2  ced16afd527e483db362f44d6fcedd82  SCRW-1001   Screw Type A 5mm  ...  In-House Manufacturing          MFG-807818       4.02      EUR
+2      3  e3f8a20ab4974e45bca023a31c50e862  SCRW-1002   Screw Type C 2mm  ...   Precision Screws Ltd.          MFG-543204       4.13      EUR
+3      4  7115fbc429594f09881181a3503b62db  SCRW-1003   Screw Type B 3mm  ...  In-House Manufacturing          MFG-916662       3.52      EUR
+4      5  8381dfa595854aa78b9d373d8a3f3f63  SCRW-1004   Screw Type A 1mm  ...  In-House Manufacturing          MFG-742978       0.38      EUR
+..   ...                               ...        ...                ...  ...                     ...                 ...        ...      ...
+115  116  67f3f0ec88974cdc8e9ac4eea5cf1351  SCRW-1115   Screw Type B 1mm  ...  In-House Manufacturing          MFG-406022       3.95      EUR
+116  117  a685e7b7135f48579a34ca45cf6baafe  SCRW-1116  Screw Type B 10mm  ...  In-House Manufacturing          MFG-230904       2.99      EUR
+117  118  c5c256a8a8b04972ab87ef84110f7d5a  SCRW-1117   Screw Type A 4mm  ...                  BoltCo          MFG-343539       0.23      EUR
+118  119  2b9eda46cb8b45e093c084a437f01ba2  SCRW-1118   Screw Type B 1mm  ...   Precision Screws Ltd.          MFG-247256       4.28      EUR
+119  120  39a71a5ed7224ee0bf5e919870ebe0a3  SCRW-1119   Screw Type D 4mm  ...                 HexTech          MFG-293100       2.06      EUR
+
+[120 rows x 24 columns]
+```
+
+## Working with the parts library
+
+Creating a new part in the library:
+```python 
+from openpartslibrary.models import Part
+
+new_part = Part(
+            number='SCRW-2001',
+            name='Screw Type Z (Special) M5x14',
+            description='A special kind of screw for safety switches',
+            revision="1",
+            lifecycle_state="In Work",
+            owner='Max Mustermann',
+            material='Steel',
+            mass=0.03,
+            dimension_x=0.02,
+            dimension_y=0.005,
+            dimension_z=0.005,
+            quantity=100,
+            cad_reference='CAD REFERENCE',
+            attached_documents_reference='DOCUMENTS REFERENCE',
+            lead_time=10,
+            make_or_buy='make',
+            supplier='In-House Manufacturing',
+            manufacturer_number='MFN-100001',
+            unit_price=0.45,
+            currency='EUR'
+        )
+pl.session.add(new_part)
+pl.session.commit()
+pl.display_reduced()
+```
+
+Loading a part from the library:
+```python 
+part = pl.session.query(Part).filter(Part.number == 'SCRW-1002').first()
+print(part)
+```
+
+Modifying a part from the library:
+```python 
+part = pl.session.query(Part).filter(Part.number == 'SCRW-2001').first()
+part.quantity -= 10
+pl.session.commit()
+pl.display_reduced()
+```
+
+Deleting a part from the library:
+```python 
+part = pl.session.query(Part).filter(Part.number == 'SCRW-1003').delete()
+pl.session.commit()
+pl.display_reduced()
+```
+
+Getting the total value of all parts in the library:
+```python 
+print('Total value of all parts in the library: ' + str(pl.total_value()) + ' EUR')
+```
+
+Creating parts from a parts list in a Excel-spreadsheet (*.xlsx). Take note, that the spreadsheet needs to implement the schema specified in this repository:
+```python 
+pl.create_parts_from_spreadsheet('C:/Users/Work/Documents/Github/OpenPartsLibrary/openpartslibrary/sample/parts_data_sample.xlsx')
+```
+
+## Part schema
+This table outlines the `Part` properties used in the OpenPartsLibrary.
+
+| Property | Description |
+|----------|-------------|
+| `number` | Unique identifier for the part, often alphanumeric (e.g., `"MTR-12345"`). |
+| `name` | Descriptive name of the part, typically used for display and search. |
+| `description` | Detailed explanation of what the part is and its intended function. |
+| `revision` | Version or iteration of the part (e.g., `"6"`). |
+| `lifecycle_state` | Current status in the engineering lifecycle, like `"In Work"`, `"Released"`, `"Obsolete"`. |
+| `owner` | Responsible person for the part. |
+| `date_created` | Timestamp of when the part was first created in the system. |
+| `date_modified` | Timestamp of the most recent update to the part. |
+| `material` | The material from which the part is made (e.g., `"Aluminum 6061"`, `"ABS"`). |
+| `mass` | Mass of the part, in kilograms. |
+| `dimensions_x` | Length of the part along the X-axis, in millimeters. |
+| `dimensions_y` | Width of the part along the Y-axis, in millimeters. |
+| `dimensions_z` | Height of the part along the Z-axis, in millimeters. |
+| `quantity` | Number of units of this part that are available. |
+| `cad_file_reference` | Reference to the associated 3D CAD file (e.g. *.FCStd). |
+| `attached_documents_reference` | References to external documents (e.g., datasheets, certifications). |
+| `lead_time` | Expected procurement time, in days. |
+| `make_or_buy` | Indicates whether the part is manufactured internally (`"Make"`) or externally sourced (`"Buy"`). |
+| `supplier` | Preferred supplier or vendor name. |
+| `manufacturer_number` | Vendor-specific identifier for the part, if purchased externally. |
+| `unit_price` | Cost per individual unit of the part (e.g., `12.75`). |
+| `currency` | Currency of the unit price (e.g., `EUR`). |
+
+
+`id` and `uuid` will also be used internally, but database users does not have to worry about those.

openpartslibrary-0.1.0/openpartslibrary/db.py

@@ -0,0 +1,87 @@
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker
+
+import pandas as pd
+
+from datetime import datetime
+
+from .models import Base, Part
+
+
+class PartsLibrary:
+    def __init__(self):
+        import os
+        sqlite_path = os.path.join(os.path.dirname(__file__), 'data', 'parts.db') 
+        print(sqlite_path)
+        self.engine = create_engine('sqlite:///' + sqlite_path)
+
+        Base.metadata.create_all(self.engine)
+
+        self.session_factory = sessionmaker(bind=self.engine)
+        self.session = self.session_factory()
+
+    def display(self):
+        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(part_table)
+
+    def display_reduced(self):
+        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)
+    
+
+    def delete_all(self):
+        self.session.query(Part).delete()
+        self.session.commit()
+
+    def create_parts_from_spreadsheet(self, file_path):
+        df = pd.read_excel(file_path)
+
+        parts = []
+        for _, row in df.iterrows():
+            part = Part(
+                uuid=row["uuid"],
+                number=row["number"],
+                name=row["name"],
+                description=row.get("description", "No description"),
+                revision=str(row.get("revision", "1")),
+                lifecycle_state=row.get("lifecycle_state", "In Work"),
+                owner=row.get("owner", "system"),
+                date_created=row.get("date_created", datetime.utcnow()),
+                date_modified=row.get("date_modified", datetime.utcnow()),
+                material=row.get("material"),
+                mass=row.get("mass"),
+                dimension_x=row.get("dimension_x"),
+                dimension_y=row.get("dimension_y"),
+                dimension_z=row.get("dimension_z"),
+                quantity=row.get("quantity", 0),
+                cad_reference=row.get("cad_reference"),
+                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")
+            )
+            parts.append(part)
+
+        self.session.add_all(parts)
+        self.session.commit()
+        print(f"Imported {len(parts)} parts successfully from {file_path}")
+
+    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

openpartslibrary-0.1.0/openpartslibrary/models.py

@@ -0,0 +1,71 @@
+from sqlalchemy import Column, Integer, String, Float, DateTime, Numeric, Enum
+from sqlalchemy.orm import DeclarativeBase
+from datetime import datetime
+
+import uuid
+
+class Base(DeclarativeBase):
+  pass
+
+class Part(Base):
+    __tablename__ = 'parts'
+
+    id = Column(Integer, primary_key=True)
+    uuid = Column(String(32), unique=True, nullable=False, default=str(uuid.uuid4()))
+    number = Column(String(50), nullable=False)
+    name = Column(String(200), nullable=False)
+    description = Column(String(1000), default="No description")
+    revision = Column(String(10), default="1")
+    lifecycle_state = Column(String(50), default="In Work")
+    owner = Column(String(100), default="system")
+    date_created = Column(DateTime, default=datetime.utcnow)
+    date_modified = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+    material = Column(String(100))
+    mass = Column(Float)
+    dimension_x = Column(Float)
+    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))
+
+    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))
+    date_created = Column(DateTime, default=datetime.utcnow)
+    date_modified = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+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)
+
+class NumberRange(Base):
+    __tablename__ = 'number_ranges'
+
+    id = Column(Integer, primary_key=True)
+    name = Column(String(200), nullable=False)
+    description = Column(String(1000))
+    date_created = Column(DateTime, default=datetime.utcnow)

openpartslibrary-0.1.0/setup.cfg

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

openpartslibrary-0.1.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup
+
+setup(
+    name='OpenPartsLibrary',
+    version='0.1.0',    
+    description='Python library for creating a database of hardware components for manufacturing',
+    url='https://github.com/alekssadowski95/OpenPartsLibrary',
+    author='Aleksander Sadowski',
+    author_email='aleksander.sadowski@alsado.de',
+    license='MIT',
+    packages=['openpartslibrary'],
+    install_requires=[''],
+
+    classifiers=[
+        'Development Status :: 1 - Planning',
+        'Intended Audience :: Science/Research',
+        'License :: OSI Approved :: MIT License',  
+        'Programming Language :: Python :: 3'
+    ],
+)