Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leavez/cocoapods-developing-folder
a branch of tools for who heavily use development pods
https://github.com/leavez/cocoapods-developing-folder
cocoapods cocoapods-plugin development-pods dsl local-pods pod
Last synced: about 1 month ago
JSON representation
a branch of tools for who heavily use development pods
- Host: GitHub
- URL: https://github.com/leavez/cocoapods-developing-folder
- Owner: leavez
- License: mit
- Created: 2018-01-04T08:52:13.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-21T10:18:43.000Z (almost 6 years ago)
- Last Synced: 2024-03-28T14:41:27.088Z (8 months ago)
- Topics: cocoapods, cocoapods-plugin, development-pods, dsl, local-pods, pod
- Language: Ruby
- Homepage:
- Size: 23.4 KB
- Stars: 30
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# cocoapods-developing-folder
A cocoapods plugin provide a branch of tools for who heavily use development pods in project. You can do these:
- new keyword `local_pod` to import a local pod without specifying path
- new keyword `folder` to import all local pods in a specific folder and its subfolders
- preserves the folder structure in `development pods`
- inhibit warnings for specific pods with a block.
## Installation
$ gem install cocoapods-developing-folder
## Usage
Firstly, you should add this in head of Podifle:
```ruby
plugin 'cocoapods-developing-folder'
```
#### 🔸 Import a local pods without specifying path
Use `local_pod` just like `pod` keyword. No need to adding path. E.g.
```ruby
local_pod "Evangelion" # no need for `:path => "modules/Evangelion"`
```
It will search your project root path. If you want smaller or larger search range, set `local_pod_searching_root`, e.g.
``` ruby
# in the podfile
local_pod_searching_root "../Libs"
# Array is also supported.
# local_pod_searching_root ["../Libs", "../../modules"]
```
#### 🔸 Import all local pods in specific folder
Use `folder` just like `pod` keyword. (In fact, they are just ruby functions)
```ruby
plugin 'cocoapods-developing-folder'
target "ABC" do
pod "SnapKit"
folder "frameworks/core" # 'frameworks/core' is just a relative path to podfile
folder "modules" # it will import all pod in 'modules' folder and its subfolders
folder "libs", :inhibit_warnings => true # the option will apply to all pods in the libs folder
end
```
It will import all local pods in that folder and its subfolders recrusively, equivalent of:
```
pod "Ayanami", :path => "modules/Ayanami"
pod "Asuka", :path => "modules/Asuka"
pod "Shinji", :path => "modules/some/path/to/Shinji"
#...
```
#### 🔸 Preserves the folder structure
Add the following to your podfile
```ruby
use_folders
```
If you don't want to create groups for top level folders (Local pods are usually grouped in the same folder):
```ruby
use_folders :skip_top_level_group => ["modules"]
```
#### 🔸 Inhibit warnings for specific pods
Add the following to your podfile
```ruby
plugin 'cocoapods-developing-folder'
inhibit_warnings_with_condition do |pod_name, pod_target|
# your condition written in ruby, like:
# `not pod_name.start_with? "LE"` or
# `['Asuka', 'Ayanami', 'Shinji'].include? pod_name`
end
```
`pod_target` is a instance of `Pod::PodTarget` [class](https://github.com/CocoaPods/CocoaPods/blob/93011ece10dd76b8d783bc80db742dfd03f7cbac/lib/cocoapods/target/pod_target.rb), containing many more info than the name. You can use it to set up complex rules.
This function will override the warning inhibition settings by the original methods, like: `inhibit_all_warnings!`, `pod 'Ayanami', :inhibit_warnings => true`
This function is usually used for disabling warning inhibition for development pods and enabling for the others. When you try to implement this with offical methods, cocoapods may warn you at `pod install`:
> The pod #{pod_name} is linked to different targets which contain different settings to inhibit warnings. CocoaPods does not currently support different settings and will fall back to your preference set in the root target definition.
This function solve the problem.
# License
MIT
Appreciate a 🌟 if you like it. Another cocoapods plugin made by me [cocoapods-static-swift-framework](https://github.com/leavez/cocoapods-static-swift-framework).