py-logn 1.0.0

A zero-dependency single-file logging library.

🐞 LogX

One file. Ten languages. Zero dependencies.
Copy. Paste. Log.

---

What if logging were this easy?

from logx import info, warn, error

info("Server started on port %d", 8080)
warn("Memory at %.1f%%", 74.2)
error("Connection lost")

LOGX_INFO("Server started on port %d", 8080);
LOGX_WARN("Memory at %.1f%%", 74.2);
LOGX_ERROR("Connection lost");

logx_info!("Server started on port {}", 8080);
logx_warn!("Memory at {:.1}%", 74.2);
logx_error!("Connection lost");

That's it. No installs. No config files. No npm install hunting down 200 transitive deps.

---

Why LogX?

Logging should be as easy as print(). But print() doesn't give you levels, timestamps, colors, or file output.

Most logging libraries give you all that — and also give you a headache. Setup, configuration, dependencies, framework lock-in...

LogX is the opposite. One file per language. Same API philosophy everywhere. Drop it in, include it, done.

Why not just print()?

Feature	print()	LogX
Log levels	❌	✅ TRACE, INFO, WARN, ERROR, FATAL
Timestamps	❌	✅ [HH:MM:SS.mmm]
File & line	❌	✅ Automatic
Colored output	❌	✅ Auto TTY detection
File logging	❌	✅ Optional, one call
Thread safe	❌	✅ Mutex-guarded
Level filtering	❌	✅ LOG_LEVEL=WARN ./app
Still one file	✅	✅

---

Quick Start

Language	File	Include
Python	python/logx.py	from logx import info
JavaScript	js/logx.js	const { info } = require('./logx')
TypeScript	ts/logx.ts	import { info } from './logx'
C	c/logx.h	#include "logx.h" → LOGX_INFO(...)
C++	cpp/logx.h	#include "logx.h" → LOGX_INFO << ...
Rust	rust/logx.rs	#[macro_use] mod logx; → logx_info!(...)
Go	go/logx.go	import "yourmodule/logx" → logx.Info(...)
Java	java/logx.java	import Logx; → Logx.info(...)
Zig	zig/logx.zig	@import("logx.zig") → logx.log(.info, ...)
Assembly	asm/logx.asm	%include "logx.asm" → log_info "..."

---

Python

from logx import trace, info, warn, error, fatal, set_log_file

info("hello %d", 42)
error("something broke")

set_log_file("/tmp/app.log")  # redirect to file

JavaScript (Node)

const { trace, info, warn, error, fatal, setLogFile } = require('./logx');

info('hello %d', 42);
error('something broke');

TypeScript

import { trace, info, warn, error, fatal, setLogFile } from './logx';

info('hello %d', 42);
error('something broke');

C

#include "logx.h"

int main() {
    LOGX_INFO("hello %d", 42);
    LOGX_ERROR("something broke");
}

// Optional: log to file
lx_set_log_file("/tmp/app.log");

gcc -std=c11 main.c -o app -lpthread

C++

#include "logx.h"

int main() {
    LOGX_INFO << "hello " << 42;
    LOGX_ERROR << "something broke";
}

// Optional: log to file
Logx::setLogFile("/tmp/app.log");
Logx::setLogFile();  // back to terminal

g++ -std=c++11 main.cpp -o app

Rust

#[macro_use] mod logx;

fn main() {
    logx_info!("hello {}", 42);
    logx_error!("something broke");
}

// Optional: log to file
logx::set_log_file("/tmp/app.log");

[dependencies]
libc = "0.2"

Go

package main

import "yourmodule/logx"

func main() {
    logx.Info("hello %d", 42)
    logx.Error("something broke")
}

// Optional: log to file
logx.SetLogFile("/tmp/app.log")

Java

public class Main {
    public static void main(String[] args) {
        Logx.info("hello %d", 42);
        Logx.error("something broke");
    }
}

// Optional: log to file
Logx.setLogFile("/tmp/app.log");

javac Logx.java Main.java && java Main

Zig

const logx = @import("logx.zig");

pub fn main() void {
    logx.log(.info, "hello 42", @src());
    logx.log(.error, "something broke", @src());
}

// Optional: log to file
try logx.setLogFile("/tmp/app.log");

x86-64 Assembly (Linux, NASM)

%include "logx.asm"

section .data
log_str(msg_hello, "hello 42")
log_str(msg_error, "something broke")

section .text
global _start
_start:
    call log_init
    log_info msg_hello
    log_error msg_error
    call log_close

    mov rax, 60
    xor rdi, rdi
    syscall

; Optional: log to file (define before including)
%define LOG_FILE_PATH "/tmp/app.log"
%include "logx.asm"

nasm -felf64 main.asm -o main.o && ld main.o -o main

---

Environment Variables

Variable	Values	Default
LOG_LEVEL	TRACE, INFO, WARN, ERROR, FATAL	TRACE
LOG_COLOR	0, 1, yes	Auto (enabled if both stdout/stderr are TTYs)

Output Format

[HH:MM:SS.mmm][LEVEL] filename:line -> message

Philosophy

LogX is not trying to replace OpenTelemetry. It is built for:

• Prototypes & hackathons
• CLI tools & scripts
• Game jams
• Students learning a new language
• Small-to-medium projects
• Anyone who just wants to log without ceremony

"If you can write print(), you already know how to use LogX."

License

BSD 2-Clause. See LICENSE.