JYTHON(1)

💖 JYTHON(1) — the manual page, but make it slay 💖

okay so bestie, you're holding the manual page for jython — a real one from the General Commands Manual collection. Sit down, hydrate, and let's get into it. 🫶

---

✨ NAME ✨

jython — Python seamlessly integrated with Java 💅

---

🌸 SYNOPSIS 🌸

jython [ -i ] [ -S ] [ -v ] [ -Dproperty=value ... ] [ -Wargument ]
       [ -Ecodec ] [ -Qargument ]
       [ -jar jar | -c cmd | file | - ] [ script-args ]

jython [ --help | --version ]

two whole invocation forms, no cap. the top one runs stuff, the bottom one just tells you things and dips. 👑

---

🦋 DESCRIPTION 🦋

Jython is an implementation of the high-level, dynamic, object-oriented language Python that's seamlessly integrated with the Java platform. The predecessor to Jython, JPython, is certified as 100% Pure Java. iconic behaviour honestly. ✨

Jython is complementary to Java, and it's lowkey especially suited for these three tasks:

🎀 Embedded scripting

Java programmers can add the Jython libraries to their system so that end users can write simple or complicated scripts that add functionality to the application. like, the app gets a glow-up from the inside. 💖

🎀 Interactive experimentation

Jython provides an interactive interpreter that can be used to interact with Java packages or with running Java applications. This allows programmers to experiment with and debug any Java system using Jython. poking at a live Java thing from a REPL is main character energy, fr fr. 🔥

🎀 Rapid application development

Python programs are typically 2-10X shorter than the equivalent Java program. This translates directly to increased programmer productivity. The seamless interaction between Python and Java allows developers to freely mix the two languages both during development and in shipping products. two languages, one vibe, mixing it up whenever. 🧚

---

okay so here's a cute little trick: to make a jython script executable on your system, you can add the following line to the top of the file:

#!/usr/bin/env jython

You will also need to add execute permissions to the script using chmod(1). and now for the part that gets people every single time —

note, bestie: #!/usr/bin/jython will NOT work. you must use #!/usr/bin/env jython. this is because /usr/bin/jython is a script itself, not a compiled binary. do not come for me, that's just the truth. 💀

---

💅 OPTIONS 💅

a summary of options is included below. there's a lot. we're getting through all of them. periodt.

• -i — Continue running Jython interactively after running the given script, and force prompts even if standard input doesn't appear to be a terminal. stay in the chat even when the chat didn't technically ask. 💬
• -S — Don't imply import site on initialisation.
• -v — Trace import statements on error output. it's giving detective era 🔍
• -Dproperty=value — Set the Jython property property to value; see jython.conf(5) for details of available properties.
• -Wargument — Warning control. The full form of argument is action:message:category:module:line. Trailing empty fields may be omitted. Multiple -W options may be given. See documentation of the warnings module for details.
• -Ecodec — Set the encoding used to read module source files from disk.
• -Qargument — Division control. See PEP 239 for details. Valid arguments are old, new, warn and warnall.
• -jar jar — The program to run is read from the file __run__.py in the specified jar archive.
• -c cmd — The program to run is passed as the cmd string. This option terminates the options list.
• file — The program to run is the script file.
• - — The program to run is read from standard input (default behaviour). Interactive mode is used if running on a tty. This flag allows you to pipe a file into Jython and have it be treated correctly.
• script-args — Command-line arguments to pass to the Jython script in sys.argv[1:].
• --help — Print a usage message and exit.
• --version — Print the Jython version number and exit. that's it, that's the whole thing. 🎀

---

🌈 ENVIRONMENT VARIABLES 🌈

• JAVA (default: /usr/bin/java) — The Java interpreter to use when running Jython.
• JAVA_OPTIONS (default: empty) — Options to pass to the Java interpreter when running Jython.

---

⭐ SEE ALSO ⭐

jythonc(1), jython.conf(5).

If the Debian package jython-doc is installed, full documentation from the Jython authors will be available in /usr/share/doc/jython-doc/html/. go read it, it's good for you, like vegetables but for your brain. 🍓

---

👑 AUTHOR 👑

This manual page was prepared by Ben Burton <bab@debian.org> for the Debian GNU/Linux system (but may be used by others). It is based upon the official Jython documentation. shoutout Ben. 🫶

---

and that's the whole page, bestie. this version of the page is dated July 7, 2001, and it came to you as part of JYTHON(1) in the General Commands Manual collection. drink water, run your scripts with #!/usr/bin/env jython, and never use the wrong shebang. mwah. 💖✨🎀🦋🌸💅🫶