Possible error in the Podspec Syntax Reference

[DaveWoodCom]

On this page: https://guides.cocoapods.org/syntax/podspec.html#source, the documentation suggests :path is a supported source, however this doesn't appear to be true.

When specifying a spec.source = { :path => "/some/local/path" } in a Podspec, an error is given when trying to lint the file:

Encountered an unknown error (Unsupported download strategy{:path=>"/some/local/path"}.) during validation.

The Guidelines for Contributing indicate the issue is actually in the comments of this file: https://github.com/CocoaPods/Core/blob/master/lib/cocoapods-core/specification/dsl.rb

[segiddins]

It is a valid source in the sense that it works, but you are correct that it is not intended to lint. If I recall, it's documented for people who specify external sources directly in their Podfiles

[alloy]

It could maybe have an extra note for those that need to load a pod from a local path that links to https://guides.cocoapods.org/syntax/podfile.html#pod, but as it stands that key being in the list of supported keys is indeed confusing.

[DaveWoodCom]

Ideally, I'd like to see linting actually work with a :path source. It would be handy to test the .podspec without having to push possibly broken spec's to the repo before testing them.

[segiddins]

@DaveWoodCom that's exactly what pod lib lint does

[DaveWoodCom]

Hmm, that's very interesting. I'd missed that completely. Not sure the docs are as clear as they could be in that case then. Will definitely same me some time now though. :) Thanks!

[jbarros35]

I need a solution for that; im following that tutorial
https://samwize.com/2017/10/01/creating-a-swift-framework-cocoapods/

please!