new helper methods + examples

Author: Ondrej Rafaj

Generator/MimeLibGenerator.xcodeproj/project.pbxproj

@@ -11,6 +11,7 @@
 		156C17551E020B3200101575 /* Mime+Tools.swift in Sources */ = {isa = PBXBuildFile; fileRef = 156C17521E020B3200101575 /* Mime+Tools.swift */; };
 		156C17561E020B3200101575 /* Mime.swift in Sources */ = {isa = PBXBuildFile; fileRef = 156C17531E020B3200101575 /* Mime.swift */; };
 		156C17571E020B3200101575 /* MimeType.swift in Sources */ = {isa = PBXBuildFile; fileRef = 156C17541E020B3200101575 /* MimeType.swift */; };
+		156C175E1E0211AB00101575 /* Example.swift in Sources */ = {isa = PBXBuildFile; fileRef = 156C175D1E0211AB00101575 /* Example.swift */; };
 		15FBD0631E01F3CE00E75B63 /* main.swift in Sources */ = {isa = PBXBuildFile; fileRef = 15FBD0621E01F3CE00E75B63 /* main.swift */; };
 		15FBD06A1E01F41200E75B63 /* String+Tools.swift in Sources */ = {isa = PBXBuildFile; fileRef = 15FBD0691E01F41200E75B63 /* String+Tools.swift */; };
 /* End PBXBuildFile section */
@@ -35,6 +36,7 @@
 		156C17581E020B7F00101575 /* LICENSE */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text; name = LICENSE; path = ../LICENSE; sourceTree = "<group>"; };
 		156C17591E020B7F00101575 /* README.md */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = net.daringfireball.markdown; name = README.md; path = ../README.md; sourceTree = "<group>"; };
 		156C175B1E0210CC00101575 /* Package.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = Package.swift; path = ../Package.swift; sourceTree = "<group>"; };
+		156C175D1E0211AB00101575 /* Example.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Example.swift; sourceTree = "<group>"; };
 		15FBD05F1E01F3CE00E75B63 /* MimeLibGenerator */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = MimeLibGenerator; sourceTree = BUILT_PRODUCTS_DIR; };
 		15FBD0621E01F3CE00E75B63 /* main.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = main.swift; sourceTree = "<group>"; };
 		15FBD0691E01F41200E75B63 /* String+Tools.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = "String+Tools.swift"; sourceTree = "<group>"; };
@@ -88,6 +90,7 @@
 				15FBD0691E01F41200E75B63 /* String+Tools.swift */,
 				15FBD0621E01F3CE00E75B63 /* main.swift */,
 				156C174F1E0206BB00101575 /* Updater.swift */,
+				156C175D1E0211AB00101575 /* Example.swift */,
 			);
 			path = MimeLibGenerator;
 			sourceTree = "<group>";
@@ -151,6 +154,7 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				156C175E1E0211AB00101575 /* Example.swift in Sources */,
 				15FBD06A1E01F41200E75B63 /* String+Tools.swift in Sources */,
 				15FBD0631E01F3CE00E75B63 /* main.swift in Sources */,
 				156C17501E0206BB00101575 /* Updater.swift in Sources */,

Generator/MimeLibGenerator/Example.swift

@@ -0,0 +1,25 @@
+//
+//  Example.swift
+//  MimeLibGenerator
+//
+//  Created by Ondrej Rafaj on 14/12/2016.
+//  Copyright © 2016 manGoweb UK Ltd. All rights reserved.
+//
+
+import Foundation
+
+
+final class Example {
+    
+    static func run() {
+        print("Couple of examples:")
+        
+        print(Mime.fileExtension(forMime: "text/plain")!)                   // Prints: txt
+        print(Mime.fileExtension(forMime: "application/octet-stream")!)     // Prints: bin
+        print(Mime.get(fileExtension: "psd")!.rawValue)                     // Prints: image/vnd.adobe.photoshop
+        print(Mime.get(fileExtension: "ogg") ?? "nil result")               // Prints: nil result
+        print(Mime.string(forPath: "/home/file.pdf")!)                      // Prints: application/pdf
+        
+        print("\n\n")
+    }
+}

Generator/MimeLibGenerator/main.swift

@@ -117,6 +117,6 @@ else {
 
 print("\nThank you for using MimeLibGenerator!\n\nOndrej Rafaj & team manGoweb UK! (http://www.mangoweb.cz/en)\n\n\n")
 
-
+Example.run()
 
 

README.md

@@ -19,6 +19,17 @@ If you want to generate files straight from the Xcode project, you have two opti
 .Package(url: "https://github.com/manGoweb/MimeLib.git", majorVersion: 1)
 ```
 
+## Usage
+
+Couple of examples:
+```swift
+Mime.fileExtension(forMime: "text/plain")                  // Prints: txt
+Mime.fileExtension(forMime: "application/octet-stream")    // Prints: bin
+Mime.get(fileExtension: "psd")!.rawValue                   // Prints: image/vnd.adobe.photoshop
+Mime.get(fileExtension: "ogg") ?? "nil result"             // Prints: nil result
+Mime.string(forPath: "/home/file.pdf")                     // Prints: application/pdf
+```
+
 ## Info
 
 :gift_heart: Contributing

Sources/Mime+Tools.swift

@@ -11,12 +11,21 @@ import Foundation
 
 public extension Mime {
 
-    public static func string(forUrl url: URL) -> String? {
+    public static func get(fileUrl url: URL) -> MimeType? {
         let ext: String = url.pathExtension
         guard ext != "" else {
             return nil
         }
-        return Mime.get(fileExtension: ext)?.rawValue
+        return Mime.get(fileExtension: ext)
+    }
+    
+    public static func get(filePath path: String) -> MimeType? {
+        let url: URL = URL(fileURLWithPath: path)
+        return Mime.get(fileUrl: url)
+    }
+    
+    public static func string(forUrl url: URL) -> String? {
+        return Mime.get(fileUrl: url)?.rawValue
     }
 
     public static func string(forPath path: String) -> String? {