# DESCRIPTION Spamcup NG is a Perl web crawler for finishing Spamcop.net reports automatically. It will use your account details to login into Spamcop.net web page and finish reporting your SPAM. Spamcup NG tries to be as polite as possible, introducing forced delays to not overwhelm Spamcop.net website. All reports are sent sequentially. Spamcup NG is a fork from the original Spamcup project. Spamcup is copyright (C) Toni Willberg . # INTRO In your favorite shell: $ spamcup That's it! See the configuration file details. You can also provide all the parameters in the command line. Check the command line documentation: Usage: $ spamcup -h spamcup Options: -n Does nothing, just shows if you have unreported spam or not. -a Run in a loop untill all spam is reported. -s Stupid. Runs without asking confirmation. Use with care. -q Be quiet. -c Alternate method for signifying code. (Unpaid users WITHOUT username & password) -l Alternate method for providing username. (Paid & unpaid users with password) -p Method for providing password. (Required for users with password) -d Debug mode. Prints all kinds of funny things. -D Even more debug mode. Dumps also HTML. -v Show version and quit. -h You are reading it. # WARNINGS Some important warnings before starting using it: - The script does NOT know where the spam report will be sent so IT'S YOUR RESPONSIBILITY! - If the script asks spamcop to send reports to wrong places IT'S YOUR FAULT! - If the script has a bug that causes same report being sent thousand times IT'S YOUR MAIL ADDRESSES! - DO NOT USE THIS SCRIPT IF YOU DON'T UNDERSTAND WHAT IT DOES! IT'S YOUR SHAME! # SETUP So far this project didn't release any tarball, so you'll have to `git clone` ir or download it file individually. Using git is probably the easiest way. After that, you can follow up installing executing the sequence: 1. perl Makefile.PL 2. make 3. make install You will need administrator rights to execute the third step unless you're on a UNIX-like OS that has your own perl interpreter (like installed by perlbrew). Once it get available on CPAN (still a work in progress), you can take advantage of it. This project does generates a CPANFile too, but since it doesn't have a "release package", you will need to install Dist::Zilla just to get advantage of it. # CONFIGURATION FILE You can also provide a configuratio file to avoid having to provide the same information everytime you want to execute the program. The program will look for a configuration file name `.spamcup.yml` in the corresponding home directory of the user (that will dependend on the OS you're executing it). Pay attention to the dot ('.') in front of the file. The configuration file must be written as an YAML file, with the exact properties below: ```YAML --- ExecutionOptions: all: y stupid: y nothing: n quiet: n alt_code: n alt_user: n info_level: n debug_level: n Accounts: Yahoo!: e-mail: account@provider1.com.br password: FOOBAR Gmail: e-mail: account@provider2.com.br password: FOOBAR ``` All those options have their corresponding command line parameter. Be sure to take care of file permissions to avoid disclosure of your Spamcop.net password! # Installing spamcup-ng is distribuited as a regular Perl distribution, so you can do it from [CPAN](http://search.cpan.org) by downloading it with your preferred CPAN client or directly, by downloading the tarball (and doing the traditional `perl Makefile.PL; make; make test; make install`). Additionally, spamcup-ng ships with a `cpanfile`, which can allow you to install directly from Github. See [here](http://blogs.perl.org/users/mark_allen/2013/07/why-i-use-cpanfile-and-you-should-too.html) for more details on that. # COPYRIGHT AND LICENSE This software is copyright (c) 2015 of Alceu Rodrigues de Freitas Junior, This file is part of spamcup-ng distribution. spamcup-ng is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. spamcup-ng is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with spamcup-ng. If not, see http://www.gnu.org/licenses/.