use strict;
use base qw(Exporter);
-our @EXPORT = qw(create_part create_service create_assembly create_assortment);
+our @EXPORT_OK = qw(new_part new_service new_assembly new_assortment);
+our %EXPORT_TAGS = (ALL => \@EXPORT_OK);
use SL::DB::Part;
use SL::DB::Unit;
use SL::DB::Buchungsgruppe;
-sub create_part {
+sub new_part {
my (%params) = @_;
my $part = SL::DB::Part->new_part(
return $part;
}
-sub create_service {
+sub new_service {
my (%params) = @_;
my $part = SL::DB::Part->new_service(
return $part;
}
-sub create_assembly {
+sub new_assembly {
my (%params) = @_;
- my @parts;
- my $partnumber = delete $params{part1number} || 'ap1';
- my $part1 = SL::Dev::Part::create_part(partnumber => $partnumber,
- description => 'Testpart',
- )->save;
- push(@parts, $part1);
-
- my $number_of_parts = delete $params{number_of_parts} || 3;
-
- for my $i ( 2 .. $number_of_parts ) {
- my $part = $parts[0]->clone_and_reset;
- $part->partnumber( $partnumber . " " . $i );
- $part->description( ($part->description // '') . " " . $i );
- $part->save;
- push(@parts, $part);
+ my $assnumber = delete $params{assnumber};
+ my $base_partnumber = delete $params{partnumber} || 'ap';
+
+ my $assembly_items = [];
+
+ if ( $params{assembly_items} ) {
+ $assembly_items = delete $params{assembly_items};
+ } else {
+ for my $i ( 1 .. delete $params{number_of_parts} || 3) {
+ my $part = new_part(partnumber => "$base_partnumber $i",
+ description => "Testpart $i",
+ )->save;
+ push( @{$assembly_items}, SL::DB::Assembly->new(parts_id => $part->id,
+ qty => 1,
+ position => $i,
+ ));
+ }
}
- my $assnumber = delete $params{assnumber} || 'as1';
my $assembly = SL::DB::Part->new_assembly(
partnumber => $assnumber,
description => 'Test Assembly',
sellprice => '10',
lastcost => '5',
+ assemblies => $assembly_items,
buchungsgruppen_id => _default_buchungsgruppe()->id,
unit => _default_unit()->name
);
-
- foreach my $part ( @parts ) {
- $assembly->add_assemblies( SL::DB::Assembly->new(parts_id => $part->id, qty => 1, bom => 1) );
- }
$assembly->assign_attributes( %params );
return $assembly;
}
-sub create_assortment {
+sub new_assortment {
my (%params) = @_;
+ my $assnumber = delete $params{assnumber};
+ my $base_partnumber = delete $params{partnumber} || 'ap';
+
my $assortment_items = [];
+
if ( $params{assortment_items} ) {
- $assortment_items = $params{assortment_items};
+ $assortment_items = delete $params{assortment_items};
} else {
- # no assortment items were passed, create a part, clone it several times
- # and add to assortment as assortment_items
- my @parts;
- my $part1 = SL::Dev::Part::create_part(partnumber => 'sp1',
- description => 'Testpart assortment',
- )->save;
- push(@parts, $part1);
-
- my $number_of_parts = delete $params{number_of_parts} || 3;
-
- for my $i ( 2 .. $number_of_parts ) {
- my $part = $parts[0]->clone_and_reset;
- $part->partnumber( ($part->partnumber // '') . " " . $i );
- $part->description( ($part->description // '') . " " . $i );
- $part->save;
- push(@parts, $part);
- }
- my $position = 0;
- foreach my $part ( @parts ) {
+ for my $i ( 1 .. delete $params{number_of_parts} || 3) {
+ my $part = new_part(partnumber => "$base_partnumber $i",
+ description => "Testpart $i",
+ )->save;
push( @{$assortment_items}, SL::DB::AssortmentItem->new(parts_id => $part->id,
qty => 1,
- position => $position++,
- charge => 1,
+ position => $i,
unit => $part->unit,
));
}
}
my $assortment = SL::DB::Part->new_assortment(
- partnumber => 'as1',
+ partnumber => $assnumber,
description => 'Test Assortment',
sellprice => '10',
lastcost => '5',
SL::Dev::Part - create part objects for testing, with minimal defaults
+=head1 SYNOPSIS
+
+ use SL::Dev::Part qw(new_part new_assembly new_service new_assortment);
+
+ # simple default objects
+ my $part = new_part()->save;
+ my $assembly = new_assembly()->save;
+ my $service = new_service()->save;
+ my $assortment = new_assortment()->save;
+
+ # pass additional params to the generated object
+ # see individual functions for special parameters
+ my $part = new_part(
+ partnumber => 'Test 001',
+ warehouse_id => $bin->warehouse->id,
+ bin_id => $bin->id,
+ );
+
=head1 FUNCTIONS
-=head2 C<create_part %PARAMS>
+=head2 C<new_part %PARAMS>
Creates a new part (part_type = part).
-Minimal usage, default values, without saving to database:
+=head2 C<new_service %PARAMS>
+
+Creates a new service (part_type = service).
+
+=head2 C<new_assembly %PARAMS>
- my $part = SL::Dev::Part::create_part();
+Create a new assembly (part_type = assembly).
-Create a test part with a default warehouse and bin and save it:
+Special params:
- my $wh = SL::Dev::Inventory::create_warehouse_and_bins()->save;
- my $part1 = SL::Dev::Part::create_part(partnumber => 'a123',
- description => 'Testpart 1',
- warehouse_id => $wh->id,
- bin_id => $wh->bins->[0]->id,
- )->save;
+=over 2
-=head2 C<create_service %PARAMS>
+=item * C<number_of_parts>
-Creates a new service (part_type = service).
+The number of automatically created assembly parts.
-Minimal usage, default values, without saving to database:
+=item * C<assnumber>
- my $part = SL::Dev::Part::create_service();
+the partnumber of the assembly
-=head2 C<create_assembly %PARAMS>
+=item * C<partnumber>
-Create a new assembly (part_type = assembly).
+the partnumber of the first assembly part to be created
+
+=back
By default 3 parts (p1, p2, p3) are created and saved as an assembly (as1).
- my $assembly = SL::Dev::Part::create_assembly->save;
+Create a new assembly with 10 parts, the assembly gets partnumber 'Ass1' and the
+parts get partnumbers 'Testpart 1' to 'Testpart 10':
-Create a new assembly with 10 parts:
+ my $assembly = SL::Dev::Part::new_assembly(
+ number_of_parts => 10,
+ partnumber => 'Testpart',
+ assnumber => 'Ass1'
+ )->save;
- my $assembly = SL::Dev::Part::create_assembly(number_of_parts => 10)->save;
+Create an assembly with specific parts:
-=head2 C<create_assortment %PARAMS>
+ my $assembly_item_1 = SL::DB::Assembly->new( parts_id => $part1->id, qty => 3, position => 1);
+ my $assembly_item_2 = SL::DB::Assembly->new( parts_id => $part2->id, qty => 3, position => 2);
+ my $assembly_part = new_assembly(
+ assnumber => 'Assembly 1',
+ description => 'Assembly test',
+ sellprice => $part1->sellprice + $part2->sellprice,
+ assembly_items => [ $assembly_item_1, $assembly_item_2 ],
+ );
+
+=head2 C<new_assortment %PARAMS>
Create a new assortment (part_type = assortment).
-By default 3 parts (p1, p2, p3) are created and saved as an assortment.
+Special params:
+
+=over 2
- my $assortment = SL::Dev::Part::create_assortment->save;
+=item * C<number_of_parts>
+
+The number of automatically created assembly parts.
+
+=item * C<assnumber>
+
+the partnumber of the assortment
+
+=item * C<partnumber>
+
+the partnumber of the first assembly part to be created
+
+=back
+
+By default 3 parts (p1, p2, p3) are created and saved as an assortment.
Create a new assortment with 10 automatically created parts using the
number_of_parts param:
- my $assortment = SL::Dev::Part::create_assortment(number_of_parts => 10)->save;
+ my $assortment = new_assortment(number_of_parts => 10)->save;
Create an assortment with a certain name and pass some assortment_item Objects
from newly created parts:
- my $part1 = SL::Dev::Part::create_part( sellprice => '7.77')->save;
- my $part2 = SL::Dev::Part::create_part( sellprice => '6.66')->save;
+ my $part1 = new_part(sellprice => 7.77)->save;
+ my $part2 = new_part(sellprice => 6.66)->save;
my $assortment_item_1 = SL::DB::AssortmentItem->new( parts_id => $part1->id, qty => 3, unit => $part1->unit, position => 1);
my $assortment_item_2 = SL::DB::AssortmentItem->new( parts_id => $part2->id, qty => 3, unit => $part2->unit, position => 2);
- my $assortment_part = SL::Dev::Part::create_assortment( partnumber => 'Assortment 1',
- description => 'assortment test',
- sellprice => '0',
- part_type => 'assortment',
- assortment_items => [ $assortment_item_1, $assortment_item_2 ],
- )->save;
+ my $assortment_part = SL::Dev::Part::new_assortment(
+ assnumber => 'Assortment 1',
+ description => 'assortment test',
+ sellprice => (3*$part1->sellprice + 3*$part2->sellprice),
+ lastcost => (3*$part1->lastcost + 3*$part2->lastcost),
+ assortment_items => [ $assortment_item_1, $assortment_item_2 ],
+ )->save;
=head1 TODO