Swiftpack.co - WikipediaBrown/SFSymbols as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by WikipediaBrown.
WikipediaBrown/SFSymbols 0.1.3
This is an extension to UIImage that provides all of the SF Symbols for you as a UIImage.
⭐️ 0
🕓 3 weeks ago
iOS
.package(url: "https://github.com/WikipediaBrown/SFSymbols.git", from: "0.1.3")

SFSymbols

SFSymbols is a tiny package that provides extensions to String and UIImage to make using SFSymbols easy peasy. The extensions and the accompanying Enum are all generated using the python scripts included in this package along with a list of all of the SFSymbols names.

Installation

SFSymbols can be installed with Swift Package Manager.

Swift Package Manager (Xcode 12 or higher)

The preferred way of installing SFSymbols is via the Swift Package Manager.

  1. In Xcode, open your project and navigate to FileSwift PackagesAdd Package Dependency...
  2. Paste the repository URL (https://github.com/WikipediaBrown/SFSymbols.git) and click Next.
  3. For Rules, select Version (Up to Next Major) and click Next.
  4. Click Finish.

Adding Package Dependencies to Your App

Usage

String

You can use the String extension to get the name of all of the SFSymbols available. You can add an image like this

Image(systemName: .plusApp)
    .resizable()
    .scaledToFit()
    .aspectRatio(contentMode: .fit)
    .foregroundColor(.primary)

UIImage

You can use the UIImage extension to get the image of all of the SFSymbols available. You can add an image like this

Image(uiImage: .plusApp)
    .resizable()
    .scaledToFit()
    .aspectRatio(contentMode: .fit)
    .foregroundColor(.primary)

Enum

Additionally, there is an enum that is CaseIterable that provides access to all of the strings in the String extension and access to all of the images through an image property.

Image(uiImage: SFSymbols.plusApp.image)
    .resizable()
    .scaledToFit()
    .aspectRatio(contentMode: .fit)
    .foregroundColor(.primary)

or

Image(systemName: SFSymbols.plusApp.rawValue)
    .resizable()
    .scaledToFit()
    .aspectRatio(contentMode: .fit)
    .foregroundColor(.primary)

Generation

Get List of Names

Get list of names of SFSymbols by opening the SFSymbols App (you can get it from Apple.com) and paste it into the SFSymbols.txt file. Check out this StackOverflow post.

Run Python Scripts

Run the command python UIImageExtension.py && python StringExtension.py && python Enum.py and the python scripts will regenerate the extension and enum.

Test

Run command+u to run the unit tests. Test are run automatically for all pull requests.

Versioning

SFSymbols releases a new version on GitHub automatically when a pull request is approved from the develop branch to the master branch.

Contribute

Send a pull request my dude.

Author

Wikipedia Brown

License

SFSymbols is available under the MIT license. See the LICENSE file for more info.

Made with 🌲🌲🌲 in Cascadia

GitHub

link
Stars: 0
Last commit: 2 weeks ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

Super New actions
3 weeks ago

No changelog provided

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics