8

GitHub - SwiftPackageIndex/PackageList: The master list of repositories for the...

 3 years ago
source link: https://github.com/SwiftPackageIndex/PackageList
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

The Swift Package Index

Anyone can add a package to the Swift Package Index. Every package indexed by the site comes from a list of package repository URLs, stored in a publicly available JSON file. To add a package to the index, add a URL to a package repository to that file.

Please feel free to submit your own, or other people's repositories to this list. There are a few requirements, but they aren't onerous.

The easiest way to validate that packages meet the requirements is to run the validation tool included in this repository. Fork this repository and clone your fork locally. Then edit packages.json and add the package URL(s) to the JSON. Finally, in the directory where you have the clone of your fork of this repository, run the following command:

swift ./validate.swift

When validation succeeds, commit your changes and submit your pull request! Your package(s) will appear in the index within a few minutes.

If you would prefer to validate the requirements manually, please verify that:

  • The package repositories are all publicly accessible.
  • The packages all contain a Package.swift file in the root folder.
  • The packages are written in Swift 5.0 or later.
  • The packages all contain at least one product (either library or executable), and at least one product must be usable in other Swift apps.
  • The packages all have at least one release tagged as a semantic version.
  • The packages all output valid JSON from swift package dump-package with the latest Swift toolchain.
  • The package URLs are all fully specified including the protocol (usually https) and the .git extension.
  • The packages all compile without errors.
  • The packages JSON file is sorted alphabetically.

Note: There's no gatekeeping or quality threshold to be included in the Swift Package Index. As long as packages are valid, and meet the requirements above, we will accept them.


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK