Metadata-Version: 2.4
Name: tedit
Version: 2.8.0
Summary: TE: a cross-platform terminal text editor with mouse support and syntax highlighting
Project-URL: Homepage, https://github.com/alby13/TE-Text-Editor
Author-email: alby13 <alby13@singularityon.com>
License: Proprietary
License-File: LICENSE
Keywords: editor,terminal,text-editor,tui
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: pygments
Requires-Dist: pyperclip
Requires-Dist: windows-curses; platform_system == 'Windows'
Description-Content-Type: text/markdown

================================================================================
 TEdit (Text Editor)  —  also known as "TE"
================================================================================

Python: 3.8+
License: Custom — All Rights Reserved © 2024-2026 alby13

--------------------------------------------------------------------------------
OVERVIEW
--------------------------------------------------------------------------------
TE is a Windows optimized terminal text editor that provides a simple,
mouse-driven, and intuitive editing experience without leaving the command
line. It leverages the powerful Pygments library for syntax highlighting
across dozens of languages and the standard curses library for its terminal
user interface (TUI).

How does this exist? A programmer named Ken Arnold made a software library
in 1978 called Curses.

--------------------------------------------------------------------------------
ASCII LOGO
--------------------------------------------------------------------------------

░▒▓████████▓▒░▒▓██████▓▒░
____░▒▓█▓▒░______░▒▓█▓▒░
____░▒▓█▓▒░______░▒▓█▓▒░
____░▒▓█▓▒░______░▒▓████▓▒░
____░▒▓█▓▒░______░▒▓█▓▒░
____░▒▓█▓▒░______░▒▓█▓▒░
____░▒▓█▓▒░______░▒▓█████▓▒░

--------------------------------------------------------------------------------
VERSIONS
--------------------------------------------------------------------------------
Current Version: Version 2.7 — Released 2026-05-24

Previous Releases:
  - Version 1.6 — 2024-07-10
  - Version 1.7 — 2025-06-22
  - Version 1.8 — 2025-06-23
  - Version 1.9 listed as v0.9.1 — 2025-09-29

--------------------------------------------------------------------------------
ABOUT THE PROJECT
--------------------------------------------------------------------------------
TE was created as a demonstration of programming capabilities, showing how to
handle complex state management, user input (both keyboard and mouse), and
third-party library integration in a significant console application.

--------------------------------------------------------------------------------
WHAT'S NEW IN VERSION 2.7.0
--------------------------------------------------------------------------------
  * Bug Fixes and Refinements
  * Limited Horizontal Support (WIP)
  * Bug fixes for line movement and horizontal scrolling
  * Color Themes added for normal text files
  * Improvements and fixes for Color Displays
  * Find Feature
  * Improvements to Open File GUI
  * Proper TAB text area support

--------------------------------------------------------------------------------
FEATURES
--------------------------------------------------------------------------------
  Syntax Highlighting      Auto-detect languages; powered by Pygments
  Full Mouse Support       Click to move, drag-select, scroll, interact with menus
  File Browser             Navigate filesystem to open files and directories
  Color Themes             Select a Background Color and Text Color for any file
  Code Themes              Cycle through Pygments color schemes instantly
  File Operations          New, Open, Save, Save As — all built-in
  Robust Handling          Graceful handling of legacy encodings and files
  Toggleable Line Numbers  Show or hide line numbers with a keypress
  Search for Text          You can now search from your cursor for text
  Status Bar               Shows file name, cursor position, theme, and mode

--------------------------------------------------------------------------------
GETTING STARTED
--------------------------------------------------------------------------------
Prerequisites:
  - Python 3.8 or newer
  - Pygments (installed automatically with tedit, or manually):
      pip install pygments

Installation:
  Open Command Prompt (Windows) or Terminal (Linux/macOS) and run:

      pip install tedit

--------------------------------------------------------------------------------
RUNNING THE EDITOR
--------------------------------------------------------------------------------
After installation, launch with either command:

    TE
    or
    TEdit

--------------------------------------------------------------------------------
USAGE & CONTROLS
--------------------------------------------------------------------------------
TE is designed to feel familiar to users of graphical editors.

Main Keys:
  F1        Open file browser
  F2        Save current file
  F3        New file
  F4        Cycle color theme
  F5        Toggle line numbers
  F9        Switch between Edit & Menu modes
  Esc x3    Exit the editor immediately

Edit Mode (default):
  Arrow keys        Move cursor
  Page Up / Down    Scroll by screen
  Typing            Insert characters
  Enter             New line
  Backspace/Delete  Remove characters
  Shift + Arrows    Select text

Menu Mode (activate with F9 or click menu bar):
  Left/Right Arrows   Switch top-level menus
  Up/Down Arrows      Navigate submenu
  Enter               Select menu item
  Esc                 Exit submenu or Menu Mode

Mouse Controls:
  Click in text area      Move cursor
  Right-click             Access submenu
  Click and drag          Select text
  Scroll wheel            Scroll document
  Click menu bar          Activate Menu Mode
  Click submenu item      Execute action (Undo, Redo, Copy, Paste, Cut)

--------------------------------------------------------------------------------
LICENSE NOTICE
--------------------------------------------------------------------------------
This program is distributed via PyPI for personal use only. The source code
shown on GitHub is for demonstration purposes and may NOT be copied, modified,
or redistributed without express written permission from the author.

Third-party components retain their own licenses:
  - curses  → Python Software Foundation License
  - pyperclip → 3-Clause BSD
  - Pygments → BSD-style

================================================================================


Install:

pip install tedit

