line 0.1.5

May the LINE be with you...

|PyPi version| |PyPi downloads|

• 2014.08.06 UPDATE : Echo bot example update!!!

• 2014.08.06 UPDATE : We can send a sticker!!!

• 2014.08.04 ANNOUNCE : This project is not completed yet :(

May the LINE be with you…

>>> from line import LineClient
>>> client = LineClient("carpedm20", "xxxxxxxxxx")
Enter PinCode '9779' to your mobile phone in 2 minutes
>>> client = LineClient("[e-mail]", "xxxxxxxxxx")
Enter PinCode '7390' to your mobile phone in 2 minutes
>>> print client.profile

Installing

First, you need to install Apache Thrift. Install instructions are here. (This might take some time…)

Next:

$ pip install line

Or, you can use:

$ easy_install line

Or, you can also install manually:

$ git clone git://github.com/carpedm20/line.git
$ cd LINE
$ python setup.py install

Using

First, you need to create a LineClinet object with YOUR_ID and YOUR_PASSWORD. YOUR ID can be LINE email address or NAVER id.

>>> from line import LineClient
>>> client = LineClient(YOUR_ID, YOUR_PASSWORD)
Enter PinCode '9779' to your mobile phone in 2 minutes

After you enter PinCode to your mobile phone, you will get authToken.

>>> authToken = client.authToken
>>> print authToken

With authToken, you don’t have to enter PinCode to your phone anymore!

>>> client = LineClient(authToken=authToken)
>>> print client.profile

View contacts and groups

You can see your contacts by:

>>> print client.contacts  # your friends
>>> print client.groups

If there is a change in contact or group, you’d better call:

>>> client.refreshGroup()
>>> client.refreshContact()

You can get contact and group from name by:

>>> contact = client.getContactFromName('CONTACT_NAME')
>>> group = client.getGroupFromName('GROUP_NAME')

Send a message

You can send a message by:

>>> client.contacts[0].sendMessage("test")
True
>>> client.groups[0].sendMessage("test")
True

You can send a sticker by:

>>> client.contacts[0].sendSticker(stickerId="13",stickerPackageId="1",stickerVersion="100")
True
>>> client.groups[0].sendSticker(stickerId="13",stickerPackageId="1",stickerVersion="100")
True

Get a list of message

You can read a recent message from contact or gruop by:

>>> messages = client.contacts[0].getRecentMessages(count=10)
>>> messages = client.groups[0].getRecentMessages(count=15)

Deal with a chat room or group

You can create a room or group by:

>>> members = [client.contacts[0], client.contacts[1]]
>>> room = client.createRoomWithContacts(members)
>>> group = client.createGroupWithContacts(name="Test group", contacts=members)

You can also send a message or sticker by:

>>> room.sendMessage("Test")
>>> group.sendSticker() # default sticker

You can leave a room or group by:

>>> room.leave()
>>> group.leave()

Screenshot

Todo

• Send a Image file

• More usable methods and objects

License

Source codes are distributed under BSD license.

Author

Taehoon Kim / @carpedm20