How do I add SwiftSoup to my Swift project?

To add SwiftSoup to your Swift project, you can use Swift Package Manager, CocoaPods, or Carthage, which are popular dependency managers for Swift and Objective-C projects. Below are the steps for each method:

Swift Package Manager

Swift Package Manager (SPM) is integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

To add SwiftSoup using SPM, follow these steps:

1. Open your Swift project in Xcode.
2. Go to File > Add Packages....
3. In the search bar, type the SwiftSoup repository URL: https://github.com/scinfu/SwiftSoup.git.
4. Choose the version you want to integrate into your project (usually the most recent one).
5. Click Add Package.

Alternatively, you can manually add the dependency to your Package.swift file:

// swift-tools-version:5.x

import PackageDescription

let package = Package(
    name: "YourProjectName",
    dependencies: [
        .package(url: "https://github.com/scinfu/SwiftSoup.git", from: "2.3.2")
    ],
    targets: [
        .target(
            name: "YourProjectName",
            dependencies: ["SwiftSoup"]),
        .testTarget(
            name: "YourProjectNameTests",
            dependencies: ["YourProjectName", "SwiftSoup"]),
    ]
)

Replace "2.3.2" with the most recent version or the version you want to use.

CocoaPods

CocoaPods is a dependency manager for Swift and Objective-C projects that automates the process of integrating third-party libraries.

To add SwiftSoup using CocoaPods:

1. Install CocoaPods if you haven’t already. Open Terminal and run:

   sudo gem install cocoapods
   

2. Navigate to your project directory in Terminal and run:

   pod init
   

   This will create a Podfile in your project directory.

3. Open the Podfile with a text editor and specify SwiftSoup as a dependency:

   # Uncomment the next line to define a global platform for your project
   # platform :ios, '9.0'
   
   target 'YourProjectName' do
     # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
     # use_frameworks!
   
     # Pods for YourProjectName
     pod 'SwiftSoup'
   end
   

4. Save the Podfile and run the following command in Terminal:

   pod install
   

   This will install SwiftSoup and create an .xcworkspace file.

5. Open the .xcworkspace file in Xcode to start working on your project with SwiftSoup integrated.

Carthage

Carthage is another dependency manager that builds your dependencies and provides you with binary frameworks.

To add SwiftSoup using Carthage:

1. Install Carthage if you haven’t already. You can use Homebrew:

   brew install carthage
   

2. In your project's root directory, create a file named Cartfile and add SwiftSoup to it:

   github "scinfu/SwiftSoup"
   

3. Run Carthage to build the framework:

   carthage update --platform iOS
   

   Replace iOS with the appropriate platform if necessary.

4. Once the build is complete, open your project in Xcode and navigate to the "General" settings of your target.

5. Drag the built SwiftSoup.framework from the Carthage/Build folder into the "Frameworks, Libraries, and Embedded Content" section in Xcode.

Remember to choose the method that best fits your project requirements and workflow. After adding SwiftSoup to your project, you can start using it by importing the module in your Swift files:

import SwiftSoup

Now you should be able to parse and manipulate HTML content using SwiftSoup in your Swift project.