This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Description

mal is a command-line client for MyAnimeList.net which uses the official API. It should remain functional indefinitely (unlike web-scraping alternatives). It is currently in alpha development so new ideas are welcome! This project is inspired from mal.

Features

  • Searching your anime list
  • Fetch your anime list
  • List animes in certain status (e.g. watching)
  • Increment or decrement episodes seen of animes

And more are currently being developed!

TL;DR | Demos

Main Usage

Listing Animes By Status

Requirements

Check requirements.txt for exact versions.

Installation

Using pip

From the command line run:

sudo pip install mal

Manual Installation

Clone this project and run inside it:

sudo python setup.py install

Or alternatively using make:

sudo make install

On ArchLinux

If you’re using the archlinux distro this project has been packaged and uploaded to the AUR as python-mal-git.

You can install it using an AUR wrappers like yaourt or pacaur which will be much simpler.

Using yaourt:

yaourt -S python-mal-git

Using pacaur:

pacaur -y python-mal-git

Or do it manually:

wget https://aur.archlinux.org/cgit/aur.git/snapshot/python-mal-git.tar.gz
tar xvzf python-mal-git.tar.gz
cd python-mal-git/
makepkg -si

Notice that before using this method all dependencies should be installed.

Usage

Authenticating

The program needs your credentials to access your list. In the first call to any valid command the program will ask for your username and password and save it in plain text in the default path (on linux ~/.config/mal/myanimelist.ini).

The file will be save in the following format:

[mal]
username = your_username
password = your_password

After authenticating you can start using the program.

Using The Interface

When mal is executed without any arguments the help message is displayed:

usage: mal [-h]
           {search,increase,inc,decrease,dec,login,list,config,download,watch}
           ...

MyAnimeList command line client.

positional arguments:
  {search,increase,inc,decrease,dec,login,list,config,download,watch}
                        commands
    search              search an anime
    increase (inc)      increase anime's watched episodes by one
    decrease (dec)      decrease anime's watched episodes by one
    login               save login credentials
    list                list animes
    config              config - not implemented yet
    download            download - not implemented yet
    watch               watch - not implemented yet

optional arguments:
  -h, --help            show this help message and exit

You can also use the -h or --help options on mal or any of its subcommands to see specific help message.

Contributing

We are looking for contributors. If you know some python and would like to help check out our issues.

Also feel free to open new issues for any bug you found, features you think would be nice to have or questions in general.

Running The Source

There are a few options to run the source in development.

Development Mode

For developing you can run:

sudo python setup.py develop

Or alternatively using make:

sudo make develop

In development mode an EGG file is linked with the actual source so that way you can modify it and test without reinstalling.

For more information see Development Mode.

Running With Python

Inside the project run:

PYTHONPATH=. python mal/cli.py

PYTHONPATH variable is set to look inside the project so it will look for the local module mal before looking for installed mal.

License

GPLv3

Release History

Release History

0.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
mal-0.2-py3-none-any.whl (14.8 kB) Copy SHA256 Checksum SHA256 3.5 Wheel Oct 28, 2016
mal-0.2.tar.gz (11.5 kB) Copy SHA256 Checksum SHA256 Source Oct 28, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting