gophish-ruby 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd6fcb4143f46dfe08b1a34bfdf23f617069080ca7ad3f8eefe8caa94af5f620
-  data.tar.gz: 4bcf7c523526d43b457ff81e3f51667bca96ccb648b21e66f0c512f2061eb517
+  metadata.gz: f41c329a32ea585c7615788ab9d678f6b5c27f48b4042ef29d403e2067bc0de3
+  data.tar.gz: 571c89d538cf07c0b6229833c8c292e4ecd518945d88d0139430b878aa4fbb9d
 SHA512:
-  metadata.gz: '0982ddde22b250a73fde2aa1c0c324226b5dde8db7e5ed1bcb4a903dbef19b4d9c00693266747a0f438e0599750b87b215a535673dc6bd084241c5862d143814'
-  data.tar.gz: 022ee40a90b95e9bc7d4470f0dc6121d95dd918312343408c24067b4c5fbde0cf9cb9dd884164e3ed86a6150a5a86d093d306c48ac7775c9f0874df89deb8ef2
+  metadata.gz: c1b6333177655bba26e21db639ddd3dfa78d6d80cc6da947313d59704489182ca24952850151ff4039aa3f747c37ddf5cbea44021dc20dbd68b42dd1b9dcf698
+  data.tar.gz: 738d6ffa6e7642af68254013a79207724fc495cce323f90c3c86dd2b8abf768aff12a3a3004636015e9852d4622c254c98e3ee18b96efa833a21ad6440a06a78

data/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.2] - 2025-09-05
+
+### Added
+
+- **Enhanced Target Management for Groups**
+  - New `#add_target(target)` method to add individual targets to existing groups
+  - New `#remove_target(target)` method to remove specific targets from groups
+  - New `#remove_target_by_email(email)` method to remove targets by email address
+  - Improved target manipulation workflow for dynamic group management
+  - Support for programmatic target list modifications without full replacement
+
+### Changed
+
+- Updated gem version to 1.1.2
+- Enhanced Group class with additional target management capabilities
+- Improved README.md with comprehensive examples of new target management methods
+- Updated API reference documentation to include new Group instance methods
+
+### Technical Details
+
+- All new methods work with existing target array structure
+- Methods maintain data integrity by working with copies of target arrays
+- Email-based removal supports both symbol and string keys for flexible target structures
+- Backward compatibility maintained with existing target management approaches
+
+### Documentation Updates
+
+- Added practical examples for add_target, remove_target, and remove_target_by_email methods
+- Updated "Managing Group Targets" section in README with new workflow examples
+- Enhanced API reference documentation with detailed method descriptions
+- Included tested code examples for all new target management functionality
+
 ## [1.0.0] - 2025-09-01
 
 ### Added

data/README.md

@@ -131,20 +131,27 @@ group = Gophish::Group.find(1)
 puts "Group: #{group.name} with #{group.targets.length} targets"
 ```
 
-#### Updating a Group
+#### Managing Group Targets
 
 ```ruby
 # Update group attributes
 group = Gophish::Group.find(1)
 group.name = "Updated Group Name"
 
-# Add new targets
-group.targets << {
+# Add a single target
+new_target = {
   first_name: "New",
   last_name: "User",
   email: "new.user@company.com",
   position: "Intern"
 }
+group.add_target(new_target)
+
+# Remove a specific target
+group.remove_target(new_target)
+
+# Remove a target by email address
+group.remove_target_by_email("old.user@company.com")
 
 if group.save
   puts "Group updated successfully"
@@ -885,6 +892,9 @@ Each target in the `targets` array should have:
 **Instance Methods:**
 
 - `#import_csv(csv_data)` - Import targets from CSV data
+- `#add_target(target)` - Add a single target to the group
+- `#remove_target(target)` - Remove a specific target from the group
+- `#remove_target_by_email(email)` - Remove a target by email address
 
 #### `Gophish::Template`
 

data/docs/API_REFERENCE.md

@@ -343,6 +343,82 @@ group.import_csv(csv_data)
 puts group.targets.length  # => 2
 ```
 
+##### `#add_target(target)`
+
+Add a single target to the group.
+
+**Parameters:**
+
+- `target` (Hash) - Target hash with required fields (first_name, last_name, email, position)
+
+**Returns:** Void
+
+**Side Effects:**
+
+- Adds target to the current `targets` array
+- Marks `targets` attribute as changed
+
+**Example:**
+
+```ruby
+group = Gophish::Group.find(1)
+new_target = {
+  first_name: "Alice",
+  last_name: "Cooper",
+  email: "alice@example.com",
+  position: "Developer"
+}
+group.add_target(new_target)
+puts group.targets.length  # Increased by 1
+```
+
+##### `#remove_target(target)`
+
+Remove a specific target from the group.
+
+**Parameters:**
+
+- `target` (Hash) - Target hash to remove (must match exactly)
+
+**Returns:** Void
+
+**Side Effects:**
+
+- Removes matching target from `targets` array
+- Marks `targets` attribute as changed if target was found
+
+**Example:**
+
+```ruby
+group = Gophish::Group.find(1)
+target_to_remove = group.targets.first
+group.remove_target(target_to_remove)
+```
+
+##### `#remove_target_by_email(email)`
+
+Remove a target by email address.
+
+**Parameters:**
+
+- `email` (String) - Email address of target to remove
+
+**Returns:** Void
+
+**Side Effects:**
+
+- Removes target(s) with matching email from `targets` array
+- Marks `targets` attribute as changed if any targets were removed
+- Supports both symbol and string keys in target hashes
+
+**Example:**
+
+```ruby
+group = Gophish::Group.find(1)
+group.remove_target_by_email("user@example.com")
+puts "Removed target with email: user@example.com"
+```
+
 #### Usage Examples
 
 ##### Create a Group
@@ -377,17 +453,47 @@ end
 group = Gophish::Group.find(1)
 group.name = "Updated Marketing Team"
 
-# Add new target
-group.targets << {
+# Add new target using the add_target method
+new_target = {
   first_name: "Carol",
   last_name: "Brown",
   email: "carol@company.com",
   position: "Marketing Intern"
 }
+group.add_target(new_target)
 
 group.save
 ```
 
+##### Managing Individual Targets
+
+```ruby
+group = Gophish::Group.find(1)
+
+# Add a single target
+group.add_target({
+  first_name: "David",
+  last_name: "Wilson",
+  email: "david@company.com",
+  position: "Designer"
+})
+
+# Remove a specific target (exact match required)
+target_to_remove = group.targets.find { |t| t[:email] == "old@company.com" }
+group.remove_target(target_to_remove) if target_to_remove
+
+# Remove target by email address (more convenient)
+group.remove_target_by_email("user@company.com")
+
+# Save all changes
+if group.save
+  puts "Group targets updated successfully"
+  puts "Current target count: #{group.targets.length}"
+else
+  puts "Failed to update group: #{group.errors.full_messages}"
+end
+```
+
 ##### Import from CSV
 
 ```ruby

data/docs/EXAMPLES.md

@@ -91,12 +91,12 @@ group = Gophish::Group.find(1)
 original_name = group.name
 
 group.name = "Updated Engineering Team"
-group.targets << {
+group.add_target({
   first_name: "Charlie",
   last_name: "New",
   email: "charlie@company.com",
   position: "Junior Developer"
-}
+})
 
 if group.save
   puts "✓ Updated group from '#{original_name}' to '#{group.name}'"
@@ -106,6 +106,50 @@ else
 end
 ```
 
+### Managing Individual Targets
+
+```ruby
+# Advanced target management example
+group = Gophish::Group.find(1)
+puts "Starting with #{group.targets.length} targets"
+
+# Add multiple targets individually
+new_hires = [
+  { first_name: "Sarah", last_name: "Johnson", email: "sarah@company.com", position: "UX Designer" },
+  { first_name: "Mike", last_name: "Chen", email: "mike@company.com", position: "Backend Developer" },
+  { first_name: "Lisa", last_name: "Davis", email: "lisa@company.com", position: "Product Manager" }
+]
+
+new_hires.each do |hire|
+  group.add_target(hire)
+  puts "Added: #{hire[:first_name]} #{hire[:last_name]}"
+end
+
+# Remove a specific target by exact match
+target_to_remove = group.targets.find { |t| t[:email] == "former.employee@company.com" }
+if target_to_remove
+  group.remove_target(target_to_remove)
+  puts "Removed target: #{target_to_remove[:email]}"
+end
+
+# Remove targets by email (more convenient)
+departing_employees = ["john.doe@company.com", "jane.smith@company.com"]
+departing_employees.each do |email|
+  group.remove_target_by_email(email)
+  puts "Removed by email: #{email}"
+end
+
+# Save all changes
+if group.save
+  puts "✓ Target management completed"
+  puts "  Final target count: #{group.targets.length}"
+  puts "  Added #{new_hires.length} new hires"
+  puts "  Removed #{departing_employees.length + (target_to_remove ? 1 : 0)} former employees"
+else
+  puts "✗ Failed to save changes: #{group.errors.full_messages}"
+end
+```
+
 ### Deleting Groups
 
 ```ruby
@@ -3114,7 +3158,7 @@ end
 # Usage
 group = Gophish::Group.find(1)
 group.name = "Updated Team Name"
-group.targets << { first_name: "New", last_name: "Person", email: "new@company.com", position: "Intern" }
+group.add_target({ first_name: "New", last_name: "Person", email: "new@company.com", position: "Intern" })
 
 GroupChangeTracker.log_and_save(group)
 ```

data/docs/GETTING_STARTED.md

@@ -740,17 +740,83 @@ end
 group = Gophish::Group.find(1)
 group.name = "Updated Group Name"
 
-# Add new targets
-group.targets << {
+# Add new targets using the add_target method
+new_employee = {
   first_name: "New",
   last_name: "Employee",
   email: "new.employee@company.com",
   position: "Intern"
 }
+group.add_target(new_employee)
 
 group.save
 ```
 
+#### Managing Individual Targets
+
+The SDK provides convenient methods for managing individual targets within groups:
+
+```ruby
+group = Gophish::Group.find(1)
+puts "Current targets: #{group.targets.length}"
+
+# Add a single target
+group.add_target({
+  first_name: "Alice",
+  last_name: "Johnson",
+  email: "alice@company.com",
+  position: "Developer"
+})
+
+# Remove a specific target (exact match required)
+target_to_remove = group.targets.find { |t| t[:email] == "old.employee@company.com" }
+group.remove_target(target_to_remove) if target_to_remove
+
+# Remove target by email address (more convenient)
+group.remove_target_by_email("departed.employee@company.com")
+
+# Save all changes
+if group.save
+  puts "✓ Group updated successfully"
+  puts "  New target count: #{group.targets.length}"
+else
+  puts "✗ Failed to update group:"
+  group.errors.full_messages.each { |error| puts "  - #{error}" }
+end
+```
+
+#### Bulk Target Management Example
+
+```ruby
+# Example: Manage a department reorganization
+group = Gophish::Group.find(1)
+
+# Add new hires
+new_hires = [
+  { first_name: "John", last_name: "Smith", email: "john.smith@company.com", position: "Junior Developer" },
+  { first_name: "Jane", last_name: "Doe", email: "jane.doe@company.com", position: "Senior Analyst" },
+  { first_name: "Bob", last_name: "Wilson", email: "bob.wilson@company.com", position: "Project Manager" }
+]
+
+new_hires.each { |hire| group.add_target(hire) }
+
+# Remove departing employees
+departing_emails = ["old.employee1@company.com", "old.employee2@company.com"]
+departing_emails.each { |email| group.remove_target_by_email(email) }
+
+# Update group name to reflect changes
+group.name = "#{group.name} - Updated #{Date.today}"
+
+if group.save
+  puts "✓ Department reorganization complete"
+  puts "  Final target count: #{group.targets.length}"
+  puts "  Added #{new_hires.length} new employees"
+  puts "  Removed #{departing_emails.length} former employees"
+else
+  puts "✗ Update failed: #{group.errors.full_messages}"
+end
+```
+
 ### Deleting Groups
 
 ```ruby

data/lib/gophish/group.rb

@@ -24,6 +24,21 @@ module Gophish
       self.targets = targets_array
     end
 
+    def add_target(target)
+      current_targets = targets || []
+      self.targets = current_targets + [target]
+    end
+
+    def remove_target(target)
+      current_targets = targets || []
+      self.targets = current_targets.reject { |t| t == target }
+    end
+
+    def remove_target_by_email(email)
+      current_targets = targets || []
+      self.targets = current_targets.reject { |t| (t[:email] || t['email']) == email }
+    end
+
     private
 
     def validate_targets_structure

data/lib/gophish/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gophish
-  VERSION = '1.1.1'
+  VERSION = '1.1.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gophish-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors:
 - Eli Sebastian Herrera Aguilar
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-04 00:00:00.000000000 Z
+date: 2025-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty