Swiftpack.co - Package - JohnSundell/Files

“Files”

BuddyBuild CocoaPods Carthage Marathon Swift Package Manager Twitter: @johnsundell

Welcome to Files, a compact library that provides a nicer way to handle files and folders in Swift. It’s primarily aimed at Swift scripting and tooling, but can also be embedded in applications that need to access the file system. It's essentially a thin wrapper around the FileManager APIs that Foundation provides.

Features

  • [X] Modern, object-oriented API for accessing, reading and writing files & folders.
  • [X] Unified, simple do, try, catch error handling.
  • [X] Easily construct recursive and flat sequences of files and folders.

Examples

Iterate over the files contained in a folder:

for file in try Folder(path: "MyFolder").files {
    print(file.name)
}

Rename all files contained in a folder:

try Folder(path: "MyFolder").files.enumerated().forEach { (index, file) in
    try file.rename(to: file.nameWithoutExtension + "\(index)")
}

Recursively iterate over all folders in a tree:

Folder.home.makeSubfolderSequence(recursive: true).forEach { folder in
    print("Name : \(folder.name), parent: \(folder.parent)")
}

Create, write and delete files and folders:

let folder = try Folder(path: "/users/john/folder")
let file = try folder.createFile(named: "file.json")
try file.write(string: "{\"hello\": \"world\"}")
try file.delete()
try folder.delete()

Move all files in a folder to another:

let originFolder = try Folder(path: "/users/john/folderA")
let targetFolder = try Folder(path: "/users/john/folderB")
try originFolder.files.move(to: targetFolder)

Easy access to system folders:

Folder.current
Folder.temporary
Folder.home

Usage

Files can be easily used in either a Swift script, command line tool or in an app for iOS, macOS, tvOS or Linux.

In a script

  • Install Marathon.
  • Add Files using $ marathon add https://github.com/johnsundell/files.git.
  • Run your script using $ marathon run <path-to-your-script>.

In a command line tool

  • Drag the file Files.swift into your command line tool's Xcode project.

In an application

Either

  • Drag the file Files.swift into your application's Xcode project.

or

  • Use CocoaPods, Carthage or the Swift Package manager to include Files as a dependency in your project.

Backstory

So, why was this made? As I've migrated most of my build tools and other scripts from languages like Bash, Ruby and Python to Swift, I've found myself lacking an easy way to deal with the file system. Sure, FileManager has a quite nice API, but it can be quite cumbersome to use because of its string-based nature, which makes simple scripts that move or rename files quickly become quite complex.

So, I made Files, to enable me to quickly handle files and folders, in an expressive way. And, since I love open source, I thought - why not package it up and share it with the community? :)

Questions or feedback?

Feel free to open an issue, or find me @johnsundell on Twitter.

Github

link
Stars: 1013
Help us keep the lights on

Dependencies

Releases

2.0.1 - Nov 5, 2017

Files now uses the Swift 4 version of the Swift Package Description API.

View build details and download artifacts on buddybuild: Files (iOS, Files-iOS)

2.0.0 - Nov 4, 2017

  • Files now uses Swift 4 (thanks @artemnovichkov!)
  • Errors now have much nicer descriptions when printed (thanks @VFUC!)
  • You can now modify a folder that you are iterating over, and the changes will propagate to the iteration (thanks @LarsJK!)

View build details and download artifacts on buddybuild: Files (iOS, Files-iOS)

1.12.0 - Sep 23, 2017

This release adds an API for copying files/folders (thanks @artemnovichkov!)

1.11.0 - Aug 15, 2017

You can now include hidden files/folders when moving the contents of a folder to another (thanks @clayellis!)

1.10.0 - Jul 10, 2017

  • You can now create a file with string content directly using: folder.createFile(named: "File", content: "Hello world")
  • Iterating over files and folders recursively is now done in the same order on all supported operating systems.

View build details and download artifacts on buddybuild: Files (iOS, Files-iOS)