PyTextNow 1.0.0

Texting python package which utilizes TextNow.

TextNow API

TNAPI is a python module that uses TextNow to enable free programmable texting

Credit

• Developer: Leonardo Wu-Gomez
• Reddit: leogomezz4t
• Please tell me if you have any ideas for the API or reporting a bug

Installation

Method One: Using git clone

git clone https://github.com/WuGomezCode/TextNow-API.git

Method Two: Using pip

pip install PyTextNow

Note: If there is an unexplained error with the pip install, try adding the --user flag to it.

Usage

How to send an sms message

import TNAPI

client = TNAPI.Client("Email address", "Password", "Name") #The name is used for the message storing.

client.send_sms("18006969420", "Hello World!")

How to send an mms message

file_path = "./img.jpeg"
client.send_mms("18006969420", file_path)

How to get new messages

new_messages = client.get_new_messages() -> List
for message in new_messages:
    print(message)
    # Class Message | Class MultiMediaMessage
    # Message
    # content: "body of sms"
    # number: "number of sender"
    # date: datetime object of when the message was received
    # first_contact: bool if its the first time that number texted you
    # type: MESSAGE_TYPE if class is Message and MULTIMEDIAMESSAGE_TYPE if class is MultiMediaMessage

    # MultiMediaMessage
    # number: "number of sender"
    # date: datetime object of when the message was received
    # first_contact: bool if its the first time that number texted you
    # type: MESSAGE_TYPE if class is Message and MULTIMEDIAMESSAGE_TYPE if class is MultiMediaMessage
    # url: "url of the media"
    # raw_data: bytes of the media
    # content_type: str the MIME type ie. "image/jpeg" or "video/mp4"
    # extension: str of the file extension is. "jpeg" or "mp4"
    # Functions
    # mv(file_path): downloads the file to file_path

    print(message.number)
    print(message.content)

    # MultiMediaMessage

    print(message.content_type)
    message.mv("./image." + message.extension)

How to get all messages

messages = client.get_messages() -> List
# Same as above

How to get all sent messages

sent_messages = client.get_sent_messages() -> List
#Same as above

Custom Module Exceptions

FailedRequest:

This API runs on web requests and if the request fails this Exception will be raised

Patch Notes

1.0.0

• Complete overhaul of the way this module works.

• client.get_new_messages() is now deprecated and no longer in use. Instead of that use the new method client.get_unread_messages() which will return all unread messages. It will return the same thing each time unless you mark the messages as read with Message.mark_as_read()

• Message and MultiMediaMessage class have a new mark_as_read() method to mark the message as read. mark_as_read() will make a POST to the textnow.com server.

• client.get_messages() now returns a list of Message or MultiMediaMessage classes. For the old function which returned the raw dict use client.get_raw_messages()

• client.get_sent_messages() is a new method that gets all messages you have sent

• client.get_received_messages() is a new method that gets all messages you have received regardless of whether or not it has been read.

• client.get_read_messages() is a new method that returns all messages that have been read by you.

0.9.8

• Bug Fixes

0.9.7

• Bug Fixes

0.9.6

• Bug Fixes

0.9.5

• Linux __file__ not absolute. Used os.path.abspath

0.9.4

• Bug fixes

0.9.3

• Added constants such as
  • SENT_MESSAGE_TYPE
  • RECEIVED_MESSAGE_TYPE
  • MESSAGE_TYPE
  • MULTIMEDIAMESSAGE_TYPE
• Fixed MultiMediaMessage.mv() function

0.9.2

• No longer have to use selenium to authenticate. Now you have to manually grab connect.sid cookie.

0.9.1

• Nothing much

0.9.0

• Using Message and MultiMediaMessage classes instead of dictionary for /get_new_messages/get_sent_messages
• get_messages still returns old dictionary
• Fixed user_sids.json overwrite problem

0.8.0

• Fixed the receiving messages. Now working 100%

0.7.0

• Added FailedRequest and InvalidFileType errors to Client instance

0.5.0

• bug fixes

0.4.0

• Added Client = TNAPI.Client in __init__.py
• Fixed the failed login import in TNAPI.py

0.3.0

• Receiving messages are better but not good

0.2.0

• Nothing much

0.1.0

• Initial Commit
• Can send messages and photos/videos
• receiving messages a work in progress

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT