JYTHON.CONF(5)

💖 jython.conf — the manual page, bestie edition 💖

okay so this is jython.conf(5), from the File Formats Manual section, and it's literally just the ~vibe file~ for Jython's system-wide registry. let's get into it 🫶

✨ NAME ✨

jython.conf — the Jython registry where your system-wide options live 💅

🌸 DESCRIPTION 🌸

so when you're running jython(1) or jythonc(1), there's a whole bunch of properties you can set to customise how Jython behaves. and there are four ways to hand those properties their values. this list goes from lowest priority to highest priority, so like — a property set in your own personal registry will override that same property set in the system-wide registry. higher up the list = louder voice, periodt 👑

• Java system properties — you can set Jython options in the standard Java system properties. but — and this is the plot twist — since the jython and jythonc startup scripts are the ones responsible for starting the Java interpreter, it's lowkey unlikely you'll ever use this method for Jython config. not me side-eyeing an option nobody uses 🙈
• Jython system-wide registry — this is the file /etc/jython/jython.conf. it's got a bunch of lines shaped like property=value. lines that are empty, or that start with a hash (#), just get ignored. no thoughts, head empty, skipped 💀
• User's personal registry — this one's the file ~/.jython, and its format is exactly the same as the system-wide registry. same energy, different home 🏠
• Command-line options — you can also just specify properties when you run jython or jythonc at the command line. they get set with command-line options shaped like -Dproperty=value. main character behaviour, honestly 🔥

👑 PROPERTIES 👑

here's the thing — the following properties are the ones you can set in the Jython registry. there are also other, less-used properties hanging around; go read the comments in the default system-wide registry for more deets. iykyk 📖

and if a property is marked (auto), the jython and jythonc startup scripts will attempt to set that property automatically for you. cute, right? but it can still be overridden in the system registry, the user registry, or on the command line. nobody's locked in 🦋

• python.cachedir (auto) — the directory to use for caches (currently it's just package information, that's it). this directory must be writable by the user, no cap. if the directory is an absolute path, it's used exactly as given; otherwise it gets interpreted as relative to the root Jython directory, which is /usr/share/jython/.
• python.console — the name of the console class to use when you're running Jython from the command prompt. you can specify an alternative console class that emulates GNU readline using this property. readline girlies rise 🌈
• python.jythonc.classpath (auto) — extensions to the Java property java.class.path for use with jythonc. this is how you put extra classes on your Java compiler's classpath — and the core Java classes too, if your Java compiler requires them. very giving "help my compiler find its friends" 💖
• python.jythonc.compiler (auto) — the Java compiler to use with jythonc when it's turning generated Java code into Java class files. this should be the absolute path to a Java compiler, or the name of a compiler sitting on your standard PATH.
• python.jythonc.compileropts — options to pass to the Java compiler when you're using jythonc. lil gift basket of flags, as a treat 🎀
• python.path (auto) — the path on which Jython will look for additional python modules when importing. this one has a similar function to CPython's PYTHONPATH environment variable. same vibe, different ecosystem ✨
• python.security.respectJavaAccessibility — normally, Jython can only provide access to public members of classes. however, if this property is set to false and you're using Java 1.2, then Jython can access non-public fields, methods and constructors. so like… know what you're doing, bestie 😭
• python.verbose — sets the verbosity level for informative messages. all messages with at least the specified severity will be displayed. the valid values, in order of increasing verbosity, are: error, warning, message, comment and debug. pick your volume, queen 🔊

🔍 SEE ALSO 🔍

jython(1), jythonc(1).

and — if the Debian package jython-doc is installed, the full documentation from the Jython authors will be available in /usr/share/doc/jython-doc/html/. go read it, it's iconic 📚

💜 AUTHOR 💜

this manual page was prepared by Ben Burton <bab@debian.org> for the Debian GNU/Linux system (but it may be used by others, so share the love 🫶). it's based upon the official Jython documentation.

and that's the whole page, no crumbs left 💅

signing off — this was JYTHON.CONF(5), dated September 2, 2001, from the Jython world straight to your terminal 🦋⭐🌸