Skip to main content

Iron Editor is a terminal-based code editor built with Textual.

Project description

Iron Editor

PyPI - Version PyPI - Python Version License: MIT

A terminal-based code editor built with Textual. Designed for educational environments where students edit code directly in the terminal.


Features

  • Syntax highlighting for Python, JavaScript, HTML, CSS, Java, C, C++, JSON and Markdown
  • Multi-tab editing
  • Integrated file explorer (sidebar)
  • Integrated terminal panel
  • File integrity verification via HMAC signature
  • Log panel for debugging
  • Dracula theme

Installation

pip install iron-editor

Requirements: Python 3.9+


Usage

# Open editor in current directory
ironedit

# Open editor in a specific directory
ironedit /path/to/project

Keyboard Shortcuts

Key Action
N Create new file
Shift+N Create new folder
Ctrl+S Save current file
Ctrl+W Close current tab
Ctrl+T Toggle terminal panel
Ctrl+L Toggle log panel
Ctrl+R Run current file (in terminal)
Q Quit

File Signing

Iron Editor signs every saved file with an HMAC signature. Files created or modified outside of Iron Editor will be blocked when opened. This is intentional for classroom use — it ensures students work within the editor.



Para alumnos / For Students (Español)

Instalación

pip install iron-editor

Cómo usarlo

Abre una terminal y escribe:

ironedit

Esto abrirá el editor en la carpeta actual. También puedes indicar una carpeta específica:

ironedit C:\Users\TuNombre\mis-proyectos

Interfaz

┌─────────────────────────────────────────────────────┐
│  IronEdit                              🕐 12:00      │
├──────────┬──────────────────────────┬────────────────┤
│          │  archivo.py  ×           │                │
│  📁 src  │──────────────────────────│   Log          │
│  📄 main │  1  def main():          │                │
│  📄 util │  2      print("Hola")    │                │
│          │  3                       │                │
│          ├──────────────────────────┤                │
│          │  Terminal                │                │
├──────────┴──────────────────────────┴────────────────┤
│  N Nueva  Shift+N Carpeta  Ctrl+S Guardar  Q Salir   │
└─────────────────────────────────────────────────────┘
  • Panel izquierdo: explorador de archivos. Haz clic en un archivo para abrirlo.
  • Centro: editor de código con pestañas. Puedes tener varios archivos abiertos.
  • Panel inferior (Ctrl+T): terminal integrada para ejecutar tu código.
  • Panel derecho (Ctrl+L): log de eventos del editor.

Atajos principales

Tecla Acción
N Crear archivo nuevo
Shift+N Crear carpeta nueva
Ctrl+S Guardar archivo actual
Ctrl+W Cerrar pestaña actual
Ctrl+T Mostrar/ocultar terminal
Ctrl+L Mostrar/ocultar log
Ctrl+R Ejecutar archivo actual
Q Salir del editor

Nota sobre los archivos

Iron Editor firma los archivos que guarda. Si intentas abrir un archivo que no fue creado o guardado con Iron Editor, el editor lo bloqueará. Esto es para garantizar que trabajes siempre dentro del entorno del editor.


Changelog

v0.0.3

  • Terminal: resize panel with Ctrl+Up / Ctrl+Down
  • Terminal: added min-height to prevent collapsing too small
  • File explorer: F5 refreshes the directory tree
  • pyproject.toml: corrected author email and GitHub URLs

v0.0.2

  • Integrated terminal panel with command history and cd support
  • Ctrl+T toggle for terminal, Ctrl+R to run current file
  • Log panel toggle (Ctrl+L) and last-log in status bar

v0.0.1

  • Initial release: syntax highlighting, multi-tab editor, file explorer, HMAC file signing

License

iron-editor is distributed under the terms of the MIT license.

Project details


Download files

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

Source Distribution

iron_editor-0.0.3.tar.gz (12.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iron_editor-0.0.3-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file iron_editor-0.0.3.tar.gz.

File metadata

  • Download URL: iron_editor-0.0.3.tar.gz
  • Upload date:
  • Size: 12.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for iron_editor-0.0.3.tar.gz
Algorithm Hash digest
SHA256 78ffd2ad8e901ed6f4e8954616ba2d69b756fd1cc8cd2ad5584562e6d80e5a1d
MD5 07bd3a0d8a6c9697375b369fd31afc13
BLAKE2b-256 b911e3d145a4525f02d54e451df164a154ad0f3495cec63f04036c21cc327ad0

See more details on using hashes here.

File details

Details for the file iron_editor-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: iron_editor-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 15.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.11

File hashes

Hashes for iron_editor-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2bc568132dd7ed96cfb5179944738ef1c8ef4692ac47b9bd9df1cf226136bc19
MD5 073cfed57e4cf501e3b1d06b2e948adc
BLAKE2b-256 e4773e885cb5b4115f705320b6082913e191f121a7a95c5092bc8beea185317a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page