Latest 1.0.4
Homepage https://github.com/StevenVeshkini/Marimo
License MIT
Platforms ios 7.0, requires ARC
Dependencies AFNetworking
Authors

Build Status

Accessing manga data online is relatively difficult without web scraping, which can prove to be unreliable. Luckily, MangaEden has an API that can be used (without needing authentication) to get access to its wealth of archived manga and manga chapters. Marimo is an Objective-C wrapper around MangaEden’s API meant to abstract the API’s details.

Installation

Install using CocoaPods

If you don’t have a Podfile yet, run pod init.
Next, add the following line to your Podfile:

pod 'Marimo', '~>1.0'

Then run pod install.

Usage

There are a few core methods that can be used with Marimo.

+ (void)fetchInformationForMangaTitled:(NSString *)title
                            completion:(void (^)(SVManga *manga, NSError *error))completion;

+ (void)fetchMangaListForAllManga:(void (^)(NSArray *mangaList, NSError *error))completion;

+ (void)fetchPageURLsForChapterWithID:(NSString *)chapterID
                           completion:(void (^)(NSArray *pages, NSError *error))completion;

+ (void)fetchPagesForMangaWithTitle:(NSString *)title 
                   andChapterNumber:(NSNumber *)chapterNumber
                         completion:(void (^)(NSArray *pages, NSError *error))completion;

Example Usage

If I want to get information for a specific manga, I’d:

#import <Marimo/Marimo.h>
// ...
[Marimo fetchInformationForMangaTitled:@"Naruto" completion:^(SVManga *manga, NSError *error){
    NSLog(@"%@", manga.author);
    for (SVChapter *chapter in manga.chapters) {
        NSLog(@"%@", chapter); // Print out chapter information for all the chapters in the manga
    }
}];

Note: You can create your own manga model and use the SVManga‘s properties to populate your own manga model, or you can just use SVManga and SVChapter as your models. Check the headers of SVManga and SVChapter to see what properties you have access to from the API.

Contributing

Contributions are always welcome! Feel free to make pull requests if you have any improvements! Also, please report any bugs or usability issues.

Latest podspec

{
    "name": "Marimo",
    "version": "1.0.4",
    "summary": "An Objective-C wrapper for the MangaEden API.",
    "description": "                   Accessing manga data online is relatively difficult without web scraping, which can prove to be unreliable. Luckily, MangaEden has an API that can be used (without needing authentication) to get access to its wealth of archived manga and manga chapters. Marimo is an Objective-C wrapper around the MangaEden API meant to abstract the API's details.n",
    "homepage": "https://github.com/StevenVeshkini/Marimo",
    "license": {
        "type": "MIT"
    },
    "authors": {
        "Steven Veshkini": "[email protected]"
    },
    "social_media_url": "http://twitter.com/stevenveshkini",
    "platforms": {
        "ios": "7.0"
    },
    "source": {
        "git": "https://github.com/StevenVeshkini/Marimo.git",
        "tag": "1.0.4"
    },
    "source_files": "Marimo/*.{h,m}",
    "requires_arc": true,
    "dependencies": {
        "AFNetworking": [
            "~> 2.0"
        ]
    }
}

Pin It on Pinterest

Share This