gfycat

A very simple module that allows you to

1. upload a gif to gfycat from a remote location
2. upload a gif to gfycat from the local machine
3. query the upload url
4. query an existing gfycat link
5. query if a link is already exist
6. download the mp4 file

Usage:

upload a file:

Uploading a file from remote is very easy:

upload = gfycat().upload("i.imgur.com/lKi99vn.gif")

Or the longer version:

upload = gfycat()
upload = upload.upload("i.imgur.com/lKi99vn.gif")

You can also upload a file from your local machine (for this you will have to use the requests module):

upload = gfycat().uploadFile(r"C:\not\funny\sample.gif")

Then, you will be able to access the returning result via:

print upload.json()
print upload.raw()
print upload.formated()
print upload.get("someValue")

The result of the last 2 prints will be:

print upload.formated()

    "webmUrl": "http://zippy.gfycat.com/SimilarEmbellishedBinturong.webm",
    "gfyname": "SimilarEmbellishedBinturong",
    "gfyName": "SimilarEmbellishedBinturong",
    "mp4Url": "http://zippy.gfycat.com/SimilarEmbellishedBinturong.mp4",
    "frameRate": 1,
    "gifWidth": 374,
    "gifSize": 378641,
    "gifUrl": "http://zippy.gfycat.com/SimilarEmbellishedBinturong.gif",
    "gfysize": 368876
    
print upload.get("webmUrl")

    http://zippy.gfycat.com/SimilarEmbellishedBinturong.webm

query an existing gfycat link:

You can query an existing link in order to get more details:

query = gfycat().more("gfycatName")

Then, you will be able to access the returning result via (the same as above):

print query.json()
print query.raw()
print query.formated()
print query.get("someValue")

The result of the last 2 prints will be:

print query.formated()

    "frameRate": 25,
    "height": 252,
    "nsfw": "0",
    "sar": null,
    "webmUrl": "http://zippy.gfycat.com/SharpExcellentAbalone.webm",
    "redditId": "27ondd",
    "redditIdText": "flying_through_an_iceberg",
    "gifUrl": "http://giant.gfycat.com/SharpExcellentAbalone.gif",
    "userName": "anonymous",
    "gfyNumber": "394955002",
    "subreddit": "gfycats",
    "gfyName": "SharpExcellentAbalone",
    ...
    
print upload.get("redditIdText")

    flying_through_an_iceberg

query if a link is already exist:

This will be used if you want to quickly see if a link is already known to gfycat:

check = gfycat().check("i.imgur.com/lKi99vn.gif")

Then, you will be able to access the returning result via (same as above):

print check.json()
print check.raw()
print check.formated()
print check.get("someValue")

The result of the last 2 prints will be:

print check.formated()

    "webmUrl": "http://zippy.gfycat.com/ScaryGrizzledComet.webm",
    "gfyName": "ScaryGrizzledComet",
    "mp4Url": "http://zippy.gfycat.com/ScaryGrizzledComet.mp4",
    "frameRate": 1,
    "gfyUrl": "http://gfycat.com/ScaryGrizzledComet",
    "urlKnown": true,
    "gifUrl": "http://zippy.gfycat.com/ScaryGrizzledComet.gif"
    
print check.get("urlKnown")

    True

Download a file:

To download a file you will first have to create a gfycat object and than use the .download method:

    downloadMe = gfycat().upload("i.imgur.com/lKi99vn.gif")
    downloadMe.download("C:\\trash\\bb.mp4")

Note that you dont have to specify the file name, but the location will have to end with either "" or "/":

    downloadMe = gfycat().upload("i.imgur.com/lKi99vn.gif")
    downloadMe.download("C:\\trash\\")

If you use this way, the file name will be "gfyName".mp4

TODO:

• Finish formated() function
• Tests

Please note that although this module is working, there might still be some issues with it. if you find anything, please let me know!