Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A Python to JavaScript two way converter. Your client side done in a Jiphy.

Project description


PyPI version PyPi downloads Build Status License Bitdeli Badge

Write your client side code in a Jiphy! Jiphy is a two-way Python->JavaScript converter. It’s not meant to create runnable Python code from complex JavaScript files, or runnable JavaScript from complex Python projects. Instead, Jiphy enables Python programmers to more easily write JavaScript code by allowing them to use more familiar syntax, and even JavaScript developers to more easily write Python code.

As a Python developer you can convert existing code in someone else’s project from JavasScript into Python, edit it, and then convert it back before submitting.

Jiphy’s Design Objectives:

  • Reduce the context switching necessary for a Python developer to write JavaScript code and vice versa.
  • Always output 1:1 line mappings (a line of Python produces a line of JavaScript) so source maps are not necessary.
  • Be usable for a single developer on a project (No mass buy-in needed).
  • Should be easy to write text-editor plugins that expose Jiphy within IDEs for on-the-spot conversion.
  • Quickly run over many files.
  • Change syntax only


import underscore as _

def my_function(argument1, argument2):
    if argument1:
        del argument2
    elif argument2:

    if somevar is someothervar And x is not b: pass


var _ = require('_');

function my_function(argument1, argument2) {
    if (argument1) {
        delete argument2;
    } else if (argument2) {
    if (somevar === someothervar && x !== b) {}

in a jiphy.

Important things to know when writing Python for conversion to JavaScript

  • Every indented block must have a line after it.

For instance:

if something is True:


Is valid as the if statement has a new line after it. However:

if something is True:

is NOT valid in Jiphy. The lack of a new line makes it impossible to do a 1:1 conversion and still be nicely formatted JS code.

  • Jiphy isn’t smart enough to know when to create a var

For now, you still have to write var in front of new variables in Jiphy. Jiphy simply does not yet have the smarts to know when it is and when it is not required.

  • Jiphy does not implement stdlib components, classes, etc. It’s SYNTAX ONLY.

Syntax / Contstructs Jiphy Suppports

Python JavaScript Supported To JavaScript Supported To Python
def (…): function(…) {}
if …: if (…) {}
elif …: } else if (…) {
else: } else {
pass {}
print(…) console.log(…)
True true
False false
None null
Or ||
And &&
Unset undefined
not !
is ===
del delete
# comment // comment
import x var x = require(x)  
import x as _ var _ = require(x)  
“String” ‘String’  
“””String””” ‘Str’ + ‘ing’  

Installing jiphy

Installing jiphy is as simple as:

pip install jiphy

or if you prefer

easy_install jiphy

Using jiphy

from the command line:


or recursively:

jiphy -rc .

which is equivalent to

jiphy **/*.py

or to see the proposed changes without applying them

jiphy --diff

from within Python:

import jiphy

Why jiphy?

jiphy (pronounced: jiffy) simply stands for JavaScript In, Python Out.

Thanks and I hope you find jiphy useful!

~Timothy Crosley

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jiphy, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size jiphy-1.0.0-py2.py3-none-any.whl (23.1 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size jiphy-1.0.0.tar.gz (14.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page