inventree-app/lib/inventree/part.dart

import "dart:io";

import "package:inventree/api.dart";
import "package:inventree/inventree/stock.dart";
import "package:inventree/inventree/company.dart";
import "package:flutter/cupertino.dart";
import "package:inventree/l10.dart";

import "model.dart";

class InvenTreePartCategory extends InvenTreeModel {

  @override
  String get URL => "part/category/";

  @override
  Map<String, dynamic> formFields() {

    return {
      "name": {},
      "description": {},
      "parent": {}
    };
  }

  @override
  Map<String, String> defaultListFilters() {
    var filters = new Map<String, String>();

    filters["active"] = "true";
    filters["cascade"] = "false";

    return filters;
  }

  String get pathstring => (jsondata["pathstring"] ?? "") as String;

  String get parentpathstring {
    // TODO - Drive the refactor tractor through this
    List<String> psplit = pathstring.split("/");

    if (psplit.length > 0) {
      psplit.removeLast();
    }

    String p = psplit.join("/");

    if (p.isEmpty) {
      p = L10().partCategoryTopLevel;
    }

    return p;
  }

  int get partcount => (jsondata["parts"] ?? 0) as int;

  InvenTreePartCategory() : super();

  InvenTreePartCategory.fromJson(Map<String, dynamic> json) : super.fromJson(json);

  @override
  InvenTreeModel createFromJson(Map<String, dynamic> json) {
    var cat = InvenTreePartCategory.fromJson(json);

    // TODO ?

    return cat;
  }
}


class InvenTreePartTestTemplate extends InvenTreeModel {

  @override
  String get URL => "part/test-template/";

  String get key => (jsondata["key"] ?? "") as String;

  String get testName => (jsondata["test_name"] ?? "") as String;

  bool get required => (jsondata["required"] ?? false) as bool;

  bool get requiresValue => (jsondata["requires_value"] ?? false) as bool;

  bool get requiresAttachment => (jsondata["requires_attachment"] ?? false) as bool;

  InvenTreePartTestTemplate() : super();

  InvenTreePartTestTemplate.fromJson(Map<String, dynamic> json) : super.fromJson(json);

  @override
  InvenTreeModel createFromJson(Map<String, dynamic> json) {
    var template = InvenTreePartTestTemplate.fromJson(json);

    return template;
  }

  bool passFailStatus() {

    var result = latestResult();

    if (result == null) {
      return false;
    }

    return result.result;
  }

  // List of test results associated with this template
  List<InvenTreeStockItemTestResult> results = [];

  // Return the most recent test result recorded against this template
  InvenTreeStockItemTestResult? latestResult() {
    if (results.isEmpty) {
      return null;
    }

    return results.last;
  }

}


class InvenTreePart extends InvenTreeModel {

  @override
  String get URL => "part/";

  @override
  Map<String, dynamic> formFields() {
    return {
      "name": {},
      "description": {},
      "IPN": {},
      "revision": {},
      "keywords": {},
      "link": {},

      // Parent category
      "category": {
      },

      "units": {},

      // Checkbox fields
      "active": {},
      "assembly": {},
      "component": {},
      "purchaseable": {},
      "salable": {},
      "trackable": {},
      "is_template": {},
      "virtual": {},
    };
  }

  @override
  Map<String, String> defaultListFilters() {
    return {
      "cascade": "false",
      "active": "true",
    };
  }

  @override
  Map<String, String> defaultGetFilters() {
    return {
      "category_detail": "true",   // Include category detail information
    };
  }

  // Cached list of stock items
  List<InvenTreeStockItem> stockItems = [];

  int get stockItemCount => stockItems.length;

  // Request stock items for this part
  Future<void> getStockItems(BuildContext context, {bool showDialog=false}) async {

    await InvenTreeStockItem().list(
      filters: {
        "part": "${pk}",
        "in_stock": "true",
      },
    ).then((var items) {
      stockItems.clear();

      for (var item in items) {
        if (item is InvenTreeStockItem) {
          stockItems.add(item);
        }
      }
    });
  }

  int get supplierCount => (jsondata["suppliers"] ?? 0) as int;

  // Request supplier parts for this part
  Future<List<InvenTreeSupplierPart>> getSupplierParts() async {
    List<InvenTreeSupplierPart> _supplierParts = [];

    final parts = await InvenTreeSupplierPart().list(
        filters: {
          "part": "${pk}",
        }
    );

    for (var result in parts) {
      if (result is InvenTreeSupplierPart) {
        _supplierParts.add(result);
      }
    }

    return _supplierParts;
  }


  // Cached list of test templates
  List<InvenTreePartTestTemplate> testingTemplates = [];

  int get testTemplateCount => testingTemplates.length;

  // Request test templates from the serve
  Future<void> getTestTemplates() async {

    InvenTreePartTestTemplate().list(
      filters: {
        "part": "${pk}",
      },
    ).then((var templates) {

      testingTemplates.clear();

      for (var t in templates) {
        if (t is InvenTreePartTestTemplate) {
          testingTemplates.add(t);
        }
      }
    });
  }

    // Get the number of stock on order for this Part
    double get onOrder => double.tryParse(jsondata["ordering"].toString()) ?? 0;

    String get onOrderString {

      if (onOrder == onOrder.toInt()) {
        return onOrder.toInt().toString();
      } else {
        return onOrder.toString();
      }
    }

    // Get the stock count for this Part
    double get inStock => double.tryParse(jsondata["in_stock"].toString()) ?? 0;

    String get inStockString {

      String q = inStock.toString();

      if (inStock == inStock.toInt()) {
        q = inStock.toInt().toString();
      }

      if (units.isNotEmpty) {
        q += " ${units}";
      }

      return q;
    }

    String get units => (jsondata["units"] ?? "") as String;

    // Get the number of units being build for this Part
    double get building => double.tryParse(jsondata["building"].toString()) ?? 0;

    // Get the number of BOM items in this Part (if it is an assembly)
    int get bomItemCount => (jsondata["bom_items"] ?? 0) as int;

    // Get the number of BOMs this Part is used in (if it is a component)
    int get usedInCount => (jsondata["used_in"] ?? 0) as int;

    bool get isAssembly => (jsondata["assembly"] ?? false) as bool;

    bool get isComponent => (jsondata["component"] ?? false) as bool;

    bool get isPurchaseable => (jsondata["purchaseable"] ?? false) as bool;

    bool get isSalable => (jsondata["salable"] ?? false) as bool;

    bool get isActive => (jsondata["active"] ?? false) as bool;

    bool get isVirtual => (jsondata["virtual"] ?? false) as bool;

    bool get isTrackable => (jsondata["trackable"] ?? false) as bool;

    // Get the IPN (internal part number) for the Part instance
    String get IPN => (jsondata["IPN"] ?? "") as String;

    // Get the revision string for the Part instance
    String get revision => (jsondata["revision"] ?? "") as String;

    // Get the category ID for the Part instance (or "null" if does not exist)
    int get categoryId => (jsondata["category"] ?? -1) as int;

    // Get the category name for the Part instance
    String get categoryName {
      // Inavlid category ID
      if (categoryId <= 0) return "";

      if (!jsondata.containsKey("category_detail")) return "";

      return (jsondata["category_detail"]?["name"] ?? "") as String;
    }

    // Get the category description for the Part instance
    String get categoryDescription {
      // Invalid category ID
      if (categoryId <= 0) return "";

      if (!jsondata.containsKey("category_detail")) return "";

      return (jsondata["category_detail"]?["description"] ?? "") as String;
    }
    // Get the image URL for the Part instance
    String get _image  => (jsondata["image"] ?? "") as String;

    // Get the thumbnail URL for the Part instance
    String get _thumbnail => (jsondata["thumbnail"] ?? "") as String;

    // Return the fully-qualified name for the Part instance
    String get fullname {

      String fn = (jsondata["full_name"] ?? "") as String;

      if (fn.isNotEmpty) return fn;

      List<String> elements = [];

      if (IPN.isNotEmpty) elements.add(IPN);

      elements.add(name);

      if (revision.isNotEmpty) elements.add(revision);

      return elements.join(" | ");
    }

    // Return a path to the image for this Part
    String get image {
      // Use thumbnail as a backup
      String img = _image.isNotEmpty ? _image : _thumbnail;

      return img.isNotEmpty ? img : InvenTreeAPI.staticImage;
    }

    // Return a path to the thumbnail for this part
    String get thumbnail {
      // Use image as a backup
      String img = _thumbnail.isNotEmpty ? _thumbnail : _image;

      return img.isNotEmpty ? img : InvenTreeAPI.staticThumb;
    }

    Future<bool> uploadImage(File image) async {
      // Upload file against this part
      final APIResponse response = await InvenTreeAPI().uploadFile(
        url,
        image,
        method: "PATCH",
        name: "image",
      );

      return response.successful();
    }

    // Return the "starred" status of this part
    bool get starred => (jsondata["starred"] ?? false) as bool;

    InvenTreePart() : super();

  InvenTreePart.fromJson(Map<String, dynamic> json) : super.fromJson(json) {
    // TODO
  }

  @override
  InvenTreeModel createFromJson(Map<String, dynamic> json) {

    var part = InvenTreePart.fromJson(json);

    return part;
  }
}


class InvenTreePartAttachment extends InvenTreeAttachment {

  InvenTreePartAttachment() : super();

  @override
  String get URL => "part/attachment/";

  InvenTreePartAttachment.fromJson(Map<String, dynamic> json) : super.fromJson(json);

  @override
  InvenTreeModel createFromJson(Map<String, dynamic> json) {
    return InvenTreePartAttachment.fromJson(json);
  }

}