comic-dl

Author: X

.travis.yml

@@ -0,0 +1,18 @@
+language: python
+python:
+  - "2.6"
+  - "2.7"
+  - "3.2"
+  - "3.3"
+  - "3.4"
+  - "3.5"
+  - "3.5-dev" # 3.5 development branch
+  - "3.6-dev" # 3.6 development branch
+  - "nightly" # currently points to 3.7-dev
+# command to install dependencies
+install: "pip install -r requirements.txt"
+# command to run tests
+script: nosetests
+notifications:
+  email:
+    - [email protected]    

Changelog.md

@@ -0,0 +1 @@
+#Changelog

LICENSE

@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+
+Copyright (c) 2013-2016 Blackrock Digital LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

ReadMe.md

@@ -0,0 +1,151 @@
+# Comic-DL
+
+Comic-dl is a command line tool to download Comics and Manga from various Manga and Comic sites easily.
+
+> Don't overuse this script. Support the developers of those websites by disabling your adblock on their site. 
+>Advertisments pay for the website servers.
+
+> WINDOWS BINARY COMING SOON!
+
+### Table of Content
+
+* [Supported Sites]()
+* [Dependencies Installation]()
+    * [Linux/Debian]()
+    * [Windows]()
+    * [Mac OS X]()
+* [Installation]()
+* [Windows Binary]()
+* [List of Arguments]()
+* [Usage]()
+    * [Windows]()
+    * [Linux/Debian]()
+* [Features]()
+* [Changelog]()
+* [Opening An Issue/Requesting A Site]()
+    * [Reporting Issues]()
+    * [Suggesting A Feature]()
+
+## Supported Websites
+You can check the list of supported websites [**`HERE`**](https://github.com/Xonshiz/comic-dl/blob/master/Supported_Sites.md).
+
+## Dependencies Installation
+This script can run on multiple Operating Systems. So, if you're using the `python` script instead of the `windows binary` of this script, then you'll need to get things ready first. Follow the instructions mentioned below, according to your OS.
+
+### Linux/Debian :
+Since most (if not all) Linux/Debian OS come with python pre-installed, you don't have to install python manually. Make sure you're using python >= 2.7.x though.
+
+We need `pip` to install any external dependenc(ies). So, open any terminal and type in `pip list` and if it shows some data, then it is fine. But, if it shows error, like `pip not found` or something along this line, then you need to install `pip`. Just type this command in terminal :
+
+> `sudo apt-get install python-pip`
+
+If you're on Fedora, CentOS/RHEL, openSUSE, Arch Linux, then you simply need to follow [`THIS TUTORIAL`](https://packaging.python.org/install_requirements_linux/) to install `pip`.
+
+If this still doesn't work, then you'll manually need to install pip. Doing so is an easy one time job and you can follow   [`THHIS TUTORIAL`](https://pip.pypa.io/en/stable/installing/) to do so.
+
+### Windows :
+If you're on windows, then it is recommended to download the [`windows binary`](#) for this script. If you use the windows binary, you don't need to install anything. But, if for some weird reason you want to use Python script instead, then follow these steps :
+
+* Install Python > 2.7.6. Download the desired installer from [here](https://www.python.org/downloads/).
+* [Add it in the system path](http://superuser.com/questions/143119/how-to-add-python-to-the-windows-path) (if not already added).
+* If you're using python >2.7.9, you don't need to install `PIP`. However, if you don't have pip installed and added in windows path, then do so by following [this little tutorial](http://stackoverflow.com/a/12476379).
+* Download [this `text`]() file and put it in some directory/folder.
+* Open Command Prompt and browse to the directory where you downloaded your requiremenets.txt file and run this command :
+```
+pip install -r requirements.txt
+```
+* It should install the required external libraries.
+
+Well, if everything came up good without any error(s), then you're good to go!
+
+### Mac OS X :
+Mac OS X users will have to fetch their version of `Python` and `Pip`.
+* Python installation guide : http://docs.python-guide.org/en/latest/starting/install/osx/
+* Pip installation guide : http://stackoverflow.com/questions/17271319/installing-pip-on-mac-os-x
+
+After downloading and installing these, you need to add PIP & Python in your path. Follow [`THIS LITTLE GUIDE`](http://www.pyladies.com/blog/Get-Your-Mac-Ready-for-Python-Programming/) to install both, Python & pip successfully.
+
+## Installation
+After installing and setting up all the dependencies in your Operating System, you're good to go and use this script.
+The instructions for all the OS would remain same. Download [`THIS REPOSITORY`]() and put it somewhere in your system.
+
+**Windows users**, it's better to not place it places where it requires administrator privileges. Good example would be `C:\Windows`. This goes for both, the Python script and the windows binary file (.exe).
+
+**Linux/Debian** users make sure that this script is executable.just run this command, if you run into problem(s) :
+
+> `chmod +x comic-dl.py`
+
+and then, execute with this :
+
+> `./comic-dl.py`
+
+## Windows Binary
+It is recommended that windows users use this binary to save both, your head and time from installing all the dependencies. You can download the binary and start using the script right off the bat. Grab the respective binaries from the links below :
+* `x86 Systems` : [COMING SOON](#)
+* `x64 Systems` : [COMING SOON](#)
+
+## List of Arguments
+Currently, the script supports these arguments :
+```
+-h, --help                             Prints the basic help menu of the script and exits.
+-i,--input                             Defines the input link to the comic/manga.
+-V,--version                           Prints the VERSION and exits.
+-a,--about                             Prints ABOUT and USAGE of the script and exits.
+```
+
+## Usage
+With this script, you have to pass arguments in order to be able to download anything. Passing arguments in a script is pretty easy. Since the script is pretty basic, it doesn't have too many arguments. Go check the [`ARGUMENTS SECTION`] to know more about which arguments the script offers.
+
+Follow the instructions according to your OS :
+
+### Windows
+After you've saved this script in a directory/folder, you need to open `command prompt` and browse to that directory and then execute the script. Let's do it step by step :
+* Open the folder where you've downloaded the files of this repository.
+* Hold down the **`SHIFT`** key and while holding down the SHIFT key, **`RIGHT CLICK`** and select `Open Command Prompy Here` from the options that show up.
+* Now, in the command prompt, type this :
+
+*If you're using the windows binary :*
+>>> `comic-dl.exe -i <URL TO THE COMIC>`
+
+*If you're using the Python Script :*
+>>> `comic-dl.py -i <URL TO THE COMIC>`
+
+URL can be any URL of the [supported websites]().
+
+### Linux/Debian
+After you've saved this script in a directory/folder, you need to open `command prompt` and browse to that directory and then execute the script. Let's do it step by step :
+* Open a terminal, `Ctrl + Alt + T` is the shortcut to do so (if you didn't know).
+* Now, change the current working directory of the terminal to the one where you've downloaded this repository.
+* Now, in the Terminal, type this :
+
+>>> `comic-dl.py -i <URL TO THE COMIC>`
+
+URL can be any URL of the [supported websites]().
+
+## Features
+This is a very basic and small sript, so at the moment it only have a few features.
+* Downloads a Single Chapter and puts in a directory with the comic name, volume and chapter.
+* Downloads all the chapters available for a series.
+* Skip if the file has already been downloaded.
+* Show human readable error(s) in most places.
+
+## Changelog
+You can check the changelog [**`HERE`**](https://github.com/Xonshiz/comic-dl/blob/master/Changelog.md).
+
+## Opening An Issue/Requesting A Site
+If your're planning to open an issue for the script or ask for a new feature or anything that requires opening an Issue, then please do keep these things in mind.
+
+### Reporting Issues
+If you're about to report some issue with the script, the please do include these things :
+* The command your entered. Yes, with the URL
+* The output of that command. You can simply copy the text from the terminal/command prompt and paste it. Make sure you put that output inside `` (tilde).
+* Your Operating System and python version.
+ 
+### Suggesting A Feature
+If you're here to make suggestions, please follow the basic syntax to post a request :
+
+**Subject** : Something that briefly tells us about the feature.
+
+**Long Explanation** : Describe in details what you want and how you want.
+
+This should be enough, but it'll be great if you can add more ;)

Supported_Sites.md

@@ -1,5 +1,5 @@
 #List of Supported Websites
 
-* [Mangafox]
-* [YoManga]
-* [GoManga]
+* [Mangafox](http://mangafox.me/)
+* [YoManga](http://yomanga.co/)
+* [GoManga](http://gomanga.co/)

comic_dl/comic-dl.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from honcho import url_checker
+import os
+import sys
+import argparse
+from version import __version__
+
+def version():
+	print '\n'
+	print '{:^80}'.format('Current Version : %s')%(__version__)
+	print '\n'
+	print '{:^80}'.format("More info : comic-dl -h")
+	sys.exit()
+
+def usage():
+	print '\n'
+	print '{:^80}'.format('################################################')
+	print '{:^80}'.format('Comic-DL Usage')
+	print '{:^80}'.format('################################################\n')
+	print '\n'
+	print '{:^80}'.format('Author : Xonshiz | Version : %s')%(__version__)
+	print '{:^80}'.format('-------------------------------------------------\n')
+	print "Comic-dl is a command line tool to download manga and comics from various comic and manga sites."
+	print "Using the script is pretty simple and should be easy for anyone familiar with a command line/shell."
+	print '\n'
+	print '{:^80}'.format("USAGE : comic-dl -i <URL to comic>")
+	print '\n'
+	print "Check Supported websites : https://github.com/Xonshiz/comic-dl/blob/master/Supported_Sites.md ",'\n'
+	print "Available Arguments : "
+	print '{:^80}'.format("-i,--input : Specifies the Input URL")
+	print '{:^80}'.format("-h : Prints this help menu")
+	print '{:^80}'.format("--version : Prints the current version and exits")
+	print '{:^80}'.format("-a,--about : Shows the info about this script and exits.")
+	sys.exit()
+
+def main(argv):
+	current_directory = str(os.getcwd())
+	parser = argparse.ArgumentParser(description='Comic-dl is a command line tool to download manga and comics from various comic and manga sites.')
+	parser.add_argument('--version',action='store_true',help='Shows version and exits' )
+	parser.add_argument('-i','--input',nargs=1,help='Inputs the URL to comic',default='--version')
+	parser.add_argument('-a','--about',action='store_true',help='Shows the info regarding this script' )
+	
+
+	args = parser.parse_args()
+
+	if args.version:
+		version()
+		sys.exit()
+
+	if args.input:
+		#print args.input
+		input_url = str(args.input[0]).strip()
+		url_checker(input_url,current_directory)
+		sys.exit()
+
+	if args.about:
+		usage()
+
+if __name__ == "__main__":
+   main(sys.argv[1:])

comic_dl/honcho.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+
+'''
+
+This python module decides which URL should be assigned to which other module from the site package.
+
+'''
+
+
+
+from sites.yomanga import yomanga_Url_Check
+from sites.gomanga import gomanga_Url_Check
+from sites.mangafox import mangafox_Url_Check
+import os
+import urllib2
+
+
+
+
+def url_checker(input_url,current_directory):
+	
+	domain = urllib2.urlparse.urlparse(input_url).netloc
+
+	if domain in ['mangafox.me']:
+		mangafox_Url_Check(input_url,current_directory)
+		pass
+	elif domain in ['yomanga.co']:
+		yomanga_Url_Check(input_url,current_directory)
+		pass
+	elif domain in ['gomanga.co']:
+		gomanga_Url_Check(input_url,current_directory)
+		pass
+	elif domain in ['']:
+		print 'You need to specify at least 1 URL. Please run : comic-dl -h'
+	else:
+		print "%s is unsupported at the moment. Please request on Github repository."%(domain)

comic_dl/sites/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+
+import mangafox
+import yomanga
+import gomanga