{"id":13462663,"url":"https://github.com/FelixHerrmann/swift-multipart-formdata","last_synced_at":"2025-03-25T05:32:09.017Z","repository":{"id":38785511,"uuid":"441998886","full_name":"FelixHerrmann/swift-multipart-formdata","owner":"FelixHerrmann","description":"Build multipart/form-data type-safe in Swift.","archived":false,"fork":false,"pushed_at":"2024-09-08T18:29:07.000Z","size":101,"stargazers_count":30,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T01:03:18.650Z","etag":null,"topics":["dsl","multipart-formdata","resultbuilder","swift","swiftpackage"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FelixHerrmann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-26T22:55:25.000Z","updated_at":"2024-09-07T20:26:27.000Z","dependencies_parsed_at":"2023-02-12T17:00:41.120Z","dependency_job_id":"eeada355-8810-4b80-b829-d5ba471b108e","html_url":"https://github.com/FelixHerrmann/swift-multipart-formdata","commit_stats":{"total_commits":52,"total_committers":3,"mean_commits":"17.333333333333332","dds":"0.34615384615384615","last_synced_commit":"c734010849c59735ef9e4061754eb2cea567d2e9"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixHerrmann%2Fswift-multipart-formdata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixHerrmann%2Fswift-multipart-formdata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixHerrmann%2Fswift-multipart-formdata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixHerrmann%2Fswift-multipart-formdata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FelixHerrmann","download_url":"https://codeload.github.com/FelixHerrmann/swift-multipart-formdata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407462,"owners_count":20610226,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dsl","multipart-formdata","resultbuilder","swift","swiftpackage"],"created_at":"2024-07-31T13:00:18.419Z","updated_at":"2025-03-25T05:32:08.687Z","avatar_url":"https://github.com/FelixHerrmann.png","language":"Swift","funding_links":[],"categories":["Swift","Network API"],"sub_categories":[],"readme":"# MultipartFormData\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FFelixHerrmann%2Fswift-multipart-formdata%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/FelixHerrmann/swift-multipart-formdata)\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FFelixHerrmann%2Fswift-multipart-formdata%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/FelixHerrmann/swift-multipart-formdata)\n[![Swift](https://github.com/FelixHerrmann/swift-multipart-formdata/actions/workflows/swift.yml/badge.svg)](https://github.com/FelixHerrmann/swift-multipart-formdata/actions/workflows/swift.yml)\n[![SwiftLint](https://github.com/FelixHerrmann/swift-multipart-formdata/actions/workflows/swiftlint.yml/badge.svg)](https://github.com/FelixHerrmann/swift-multipart-formdata/actions/workflows/swiftlint.yml)\n\nBuild multipart/form-data type-safe in Swift. A result builder DSL is also available.\n\n\n## Installation\n\n### [Swift Package Manager](https://swift.org/package-manager/)\n\nAdd the following to the dependencies of your `Package.swift`:\n\n```swift\n.package(url: \"https://github.com/FelixHerrmann/swift-multipart-formdata.git\", from: \"x.x.x\")\n```\n\n### Xcode\n\nAdd the package to your project as shown [here](https://developer.apple.com/documentation/swift_packages/adding_package_dependencies_to_your_app).\n\n### Manual\n\nDownload the files in the [Sources](/Sources) folder and drag them into you project.\n\n\n## Example\n\n```swift\nimport MultipartFormData\n\nlet boundary = try Boundary(uncheckedBoundary: \"example-boundary\")\nlet multipartFormData = try MultipartFormData(boundary: boundary) {\n    Subpart {\n        ContentDisposition(name: \"field1\")\n    } body: {\n        Data(\"value1\".utf8)\n    }\n    try Subpart {\n        ContentDisposition(name: \"field2\")\n        ContentType(mediaType: .applicationJson)\n    } body: {\n        try JSONSerialization.data(withJSONObject: [\"string\": \"abcd\", \"int\": 1234], options: .prettyPrinted)\n    }\n    \n    let filename = \"test.png\"\n    let homeDirectory = FileManager.default.homeDirectoryForCurrentUser\n    let fileDirectory = homeDirectory.appendingPathComponent(\"Desktop\").appendingPathComponent(filename)\n    \n    if FileManager.default.fileExists(atPath: fileDirectory.path) {\n        try Subpart {\n            try ContentDisposition(uncheckedName: \"field3\", uncheckedFilename: filename)\n            ContentType(mediaType: .applicationOctetStream)\n        } body: {\n            try Data(contentsOf: fileDirectory)\n        }\n    }\n}\n\nlet url = URL(string: \"https://example.com/example\")!\nlet request = URLRequest(url: url, multipartFormData: multipartFormData)\nlet (data, response) = try await URLSession.shared.data(for: request)\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eThe generated HTTP request\u003c/summary\u003e\n  \n  ```http\n  POST https://example.com/example HTTP/1.1\n  Content-Length: 428\n  Content-Type: multipart/form-data; boundary=\"example-boundary\"\n\n  --example-boundary\n  Content-Disposition: form-data; name=\"field1\"\n\n  value1\n  --example-boundary\n  Content-Disposition: form-data; name=\"field2\"\n  Content-Type: application/json\n\n  {\n    \"string\" : \"abcd\",\n    \"int\" : 1234\n  }\n  --example-boundary\n  Content-Disposition: form-data; name=\"field3\"; filename=\"test.png\"\n  Content-Type: application/octet-stream\n\n  \u003c\u003cpng-data\u003e\u003e\n  --example-boundary--\n  ```\n\u003c/details\u003e\n\n## Documentation\n\nFor a detailed usage description, you can check out the [documentation](https://swiftpackageindex.com/FelixHerrmann/swift-multipart-formdata/master/documentation/multipartformdata).\n\n![docs](https://user-images.githubusercontent.com/42500484/193477691-ff5fa9a7-8a3e-48bd-aade-a853144ab05f.png#gh-light-mode-only)\n![docs](https://user-images.githubusercontent.com/42500484/193477695-cebe2417-6311-4ef0-bbe3-2e5217a89ab9.png#gh-dark-mode-only)\n\n## License\n\nMultipartFormData is available under the MIT license. See the [LICENSE](/LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFelixHerrmann%2Fswift-multipart-formdata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFelixHerrmann%2Fswift-multipart-formdata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFelixHerrmann%2Fswift-multipart-formdata/lists"}