filecon 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b254f6b7438d2e85fe743aacb1a2b5946b6b6ab855cb86259ed12a48b6c7e7f9
-  data.tar.gz: 7c38a7b9c191511d5684def2b6ef312e5d3aef5d37c5b38a22d82654dea96508
+  metadata.gz: 7f656a074b7160a9c362539e004b02f9e5d474cfafa6dd009df97040cc4398bf
+  data.tar.gz: 28f6a13ebf1aa1d536b69928f0f0e279cb0a5f60adadbf17e6bfbeb30d0213e1
 SHA512:
-  metadata.gz: 86fcec1e7a0c0d7d0a77838fc91acdfcb89d81536ea58f348de75cb881fa9e6609e685aaffc8f2d52fa8f3641b1e2af4c6b1a222828e05ca8380c4f82c9a9f61
-  data.tar.gz: 67bff21259f80836d24af248434943a59b6c6803cfb1711a59b6b4cd2cefec45a045767d2b0fbfaaa5f0476c8472535cf61f7ac3b5467e7815f2b3adc379f8bb
+  metadata.gz: aee107ce9e33a5529ce0b574079d22471e7f96b5e42b246bb8b547730b40676a87d5f99f8f9988d108610af0d2c7d922bdefd0d8593b22cf8ce8027942304d7b
+  data.tar.gz: b4ca16e0cb4b8b5de25f0cc8088db0178894afe92f270176f6cb39cac7edd2a2f168470376357a85eba183fbfa7c827f547971840322f42bb10e8003b0b87f6a

data/LICENSE

@@ -0,0 +1,16 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.
+
+  For the complete license text, see: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

data/README.md

@@ -0,0 +1,84 @@
+# Filecon
+
+A terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit.
+
+## Features
+
+- Directory browsing with MIME-type detection
+- Customizable views (content preview, file types, line counts, etc.)
+- Command execution with pipe support
+- Directory and command history
+- Configurable keybindings and colors
+
+## Installation
+
+```bash
+gem install filecon
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "filecon", "~> 0.1"
+```
+
+## Usage
+
+```bash
+filecon [directory]
+```
+
+### Keybindings
+
+**Navigation**
+- Arrow keys / Page Up/Down / Home / End — Navigate files
+- Backspace — Go to parent directory
+- Number keys — Open file with default command
+- Tab — Cycle hint numbers for rows beyond the first 10
+
+**Actions**
+- `o` — Open list of all commands for selected file
+- `c` — Command history
+- `h` — Help
+- `v` — Views
+- `s` — Sort view
+- `f` — Filter view
+- `r` — Reset view
+- `R` — Toggle recursive listing
+
+**Marking**
+- `m` — Mark file
+- `M` — Mark range
+- `a` — Mark all
+- `i` — Invert mark
+
+**Directory**
+- `~` — Go to home directory
+- `` ` `` — Go to root directory
+- `d` — Directory history
+
+**Other**
+- Enter — Select / confirm
+- Esc — Quit
+
+### Configuration
+
+Config is stored at `~/.config/filecon/config.yaml` and includes:
+
+- Color settings
+- Command definitions per file type
+- View configurations
+- History limits
+
+## Development
+
+```bash
+git clone https://codeberg.org/typr/filecon
+cd filecon
+bundle install
+rake test
+```
+
+## License
+
+GPL-2.0-only

data/config.yaml

@@ -106,7 +106,7 @@ commands:
     cd: "!cd %name"
 
   text:
-    view: "+less %name"
+    view: "+moor %name"
     edit: "+micro %name"
     count: "|wc -l %name"
 
@@ -117,7 +117,7 @@ commands:
     run: "+ruby %name"
 
   html:
-    terminal: "+w3m %name"
+    terminal: "+cha %name"
     graphics: "|vimb %name"
 
   image:
@@ -138,6 +138,72 @@ commands:
     help: "=%name --help"
     manual: "+man %name"
 
+  "x-python":
+    run: "+python3 %name"
+
+  "x PERL":
+    run: "+perl %name"
+
+  "x-shellscript":
+    run: "+bash %name"
+
+  "x-javascript":
+    run: "+node %name"
+
+  "x-php":
+    run: "+php %name"
+
+  "x-go":
+    run: "+go run %name"
+
+  "x-rust":
+    run: "+rustc %name && ./a.out"
+
+  java-archive:
+    run: "+java -jar %name"
+
+  "x-c":
+    run: "+gcc %name && ./a.out"
+
+  "x-c++":
+    run: "+g++ %name && ./a.out"
+
+  markdown:
+    view: "+glow %name"
+    edit: "+micro %name"
+
+  json:
+    view: "=cat %name | jq ."
+
+  "zip":
+    list: "|unzip -l %name"
+    extract: "|unzip %name -d %dir"
+
+  "x-gzip":
+    list: "|tar -tzf %name"
+    extract: "|tar -xzf %name -C %dir"
+
+  "x-bzip2":
+    list: "|tar -tjf %name"
+    extract: "|tar -xjf %name -C %dir"
+
+  "x-xz":
+    list: "|tar -tJf %name"
+    extract: "|tar -xJf %name -C %dir"
+
+  "x-tar":
+    list: "|tar -tf %name"
+    extract: "|tar -xf %name -C %dir"
+
+  "epub+zip":
+    view: "+folio %name"
+
+  "font-ttf":
+    view: "=fc-query %name | head -20"
+
+  "font-otf":
+    view: "=fc-query %name | head -20"
+
 
 # =============================================================================
 # VIEWS
@@ -148,9 +214,11 @@ commands:
 #
 # View values can be:
 #   - true     Use the built-in column for this field
-#   - A string A shell command to execute (with %name substitution)
+#   - A string Command to execute (with %name substitution)
 #   - A symbol Reference to a system field (e.g., :size, :type, :subtype)
 #
+# Prefix ! to evaluate as Ruby, prefix | for shell commands.
+#
 # Available system fields:
 #   target, permissions, owner, group, size,
 #   accessed, modified, created, type, subtype
@@ -162,15 +230,15 @@ commands:
 
 views:
   content:
-    content: "|head -n 50 %name"
+    content: "head -n 50 %name"
 
   filetype:
     type: true
     subtype: true
-    description: "|file -b %name"
+    description: "file -b %name"
 
   lines:
-    lines: "|wc -l %name"
+    lines: "wc -l %name"
 
   whatis:
     whatis: "!open('|whatis %name 2>&1').read.match(/[-:]\\s(.*)$/)[1]"

data/filecon.1

@@ -1,25 +1,37 @@
 .TH FILECON 1 "2026-07-26" "filecon" "User Commands"
 .SH NAME
-filecon \- interactive terminal file manager with speed-typing navigation
+filecon \- interactive terminal file manager with hint-based navigation
 .SH SYNOPSIS
 .B filecon
 .RI [ directory ]
 .SH DESCRIPTION
 .B filecon
 is a terminal-based file manager built on top of the
-.B typerspeed
+.B Typr
 Ruby library. It displays directory entries in a grid with columns for name,
 symlink target, permissions, owner, group, size, timestamps, and MIME type.
 Directories appear first in yellow; files are colored by MIME type.
 .PP
-Navigation is done by typing hint characters (1\-9, 0) displayed at the
-start of each row, enabling fast keyboard-only operation.
+Navigation is done by typing hint characters (1\-9, 0, then letters) displayed
+at the start of each row, enabling fast keyboard-only operation.
 .SH OPTIONS
 .TP
 .I directory
 Starting directory to browse. Defaults to the current working directory.
 .SH NAVIGATION KEYS
 .TP
+.B Arrow keys / Page Up/Down / Home / End
+Navigate files
+.TP
+.B Backspace
+Go to parent directory
+.TP
+.B Number keys
+Open file with default command
+.TP
+.B Tab
+Cycle hint numbers for rows beyond the first 10
+.TP
 .B h
 Show help
 .TP
@@ -61,32 +73,18 @@ Quit
 .SH FILECON KEYS
 .TP
 .B o
-Open file with configured command (prompts command picker if multiple match)
+Open list of all commands for selected file
 .TP
 .B c
 Browse command history
-.SH COMMANDS
-Commands are triggered by the [o]pen action on a file. The command executed
-depends on the file's MIME type and subtype. If multiple commands match the
-file type, a picker is shown.
-.SS Command Prefixes
-.TP
-.B |
-Internal execution (output piped to a viewer within the UI)
-.TP
-.B +
-Terminal execution (spawns an external terminal program, e.g. mpv, nano)
-.TP
-.B !
-Ruby code evaluation (result displayed in UI)
 .SH CONFIGURATION
 On first run, the default
-.B config.rb
+.B config.yaml
 is copied from the installation directory to
 .BR ~/.config/filecon/ .
 .SS Config File Locations
 .TP
-.B ~/.config/filecon/config.rb
+.B ~/.config/filecon/config.yaml
 Main configuration (colors, commands, views, term)
 .TP
 .B ~/.config/filecon/dir_history
@@ -107,35 +105,6 @@ Prompt to pick a file
 .TP
 .B %str
 Prompt for a text string (line input)
-.SH CONFIGURATION EXAMPLES
-.nf
-colors: {
-  types: {
-    directory: :yellow,
-    image: :blue,
-    video: :cyan,
-    audio: :green,
-    text: 146,
-    'x-pie-executable': :red
-  }
-}
-
-commands: {
-  default: { info: '|file %name', copy: '+rsync --progress %name %dir' },
-  text:    { view: '+less %name', edit: '+nano %name' },
-  html:    { terminal: '+w3m %name', graphics: '|vimb %name' },
-  image:   { play: '|mpv %name' },
-  video:   { play: '|mpv %name' },
-  pdf:     { view: '|mupdf %name' },
-  'x-pie-executable': { run: '|%name', run_terminal: '+%name',
-                         help: '+%name --help', manual: '+man %name' }
-}
-
-views: {
-  content: { content: '|head %name' },
-  whatis:  { whatis: "!open('|whatis %name 2>&1').read.match(...)..." }
-}
-.fi
 .SH VIEWS
 Column views control which fields are shown for each file entry.
 .TP
@@ -145,11 +114,11 @@ Displays first lines of file content via head(1)
 .B whatis
 Shows man page description via whatis(1)
 .PP
-Custom views can be defined in config.rb by adding entries to the views hash.
+Custom views can be defined in config.yaml by adding entries to the views hash.
 .SH ENVIRONMENT
 .TP
 .B TERM
-Terminal type used for curses initialization.
+Terminal type used for terminal initialization.
 .TP
 .B HOME
 Used to resolve ~ and config directory path (~/.config/filecon/).
@@ -160,12 +129,12 @@ Configuration and history directory
 .SH SEE ALSO
 .BR mpv (1),
 .BR less (1),
-.BR nano (1),
+.BR micro (1),
 .BR file (1),
 .BR rsync (1),
 .BR whatis (1),
 .BR typr (1)
 .SH AUTHOR
-Part of the Typerspeed ecosystem.
+Kilian Reitmayr
 .SH LICENSE
 GPL-2.0-only

data/lib/filecon/version.rb

@@ -1,3 +1,3 @@
 module Filecon
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/filecon.rb

@@ -64,8 +64,13 @@ class Filecon::App < Typr::Browser
     view = @views[id]
     return super if view.is_a? Array
     data = @data.map.with_index{ |row, id| row + view.values.map{ |cmd|
-      run( build cmd, id ).read(width).to_s.scrub.gsub(/[\n\t]/, ?|) if
-        cmd.is_a?(String) }.compact }
+      next unless cmd.is_a?(String)
+      built = build cmd, id
+      io = built[0] == ?! ?
+        StringIO.new( eval( built[1..-1] ).to_s ) :
+        open( ?| + built + " 2>&1" )
+      io.read(width).to_s.scrub.gsub(/[\n\t]/, ?|)
+    }.compact }
     @sequence = [ NAME ] + view.keys.map{ |head|
       @header.index(head.to_s) || (@header += [head.to_s]; @header.count-1) }
     clear

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: filecon
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Kilian Reitmayr
@@ -56,16 +56,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 description: A terminal-based file manager with customizable views, commands, and
   MIME-type based file operations, built on the Typr terminal UI toolkit.
 email:
@@ -75,13 +75,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
 - bin/filecon
-- config.rb
 - config.yaml
 - filecon.1
 - lib/filecon.rb
 - lib/filecon/version.rb
-homepage: https://github.com/kilianh/filecon
+homepage: https://codeberg.org/typr/filecon
 licenses:
 - GPL-2.0-only
 metadata: {}

data/config.rb

@@ -1,91 +0,0 @@
-
-term:       ENV["TERM"],
-term_hold:  ENV["TERM"] + ' --hold',
-max_history: 100,
-
-#########################################################################
-#
-# COLORS
-# 
-# standard colors:  black red green yellow blue magenta cyan white grey
-# grey shades: grey with percentage ( e.g. :grey62 for 62% grey )
-# 8bit color: 0 - 255
-# rgb values: [ 0-255, 0-255, 0-255 ]
-#
-#########################################################################
-
-colors: { 
-  types: {
-      default: [ :white, :black ],
-        image: :blue,  
-        audio: :green,
-        video: :cyan,
-    directory: :yellow,
- 'x-pie-executable': :red
-  }
-},
-
-#########################################################################
-#
-# COMMANDS
-#
-# execution type:
-#
-# | output in status line 
-# = output in text space
-# + run in new terminal 
-# ! ruby code evaluation
-#
-# substitutions:
-#
-# %name - selected file name
-# %dir - pick a directory
-# %file - pick a file
-# %str - read string
-#
-########################################################################
-
-commands: {
-#  default: { copy: 'cp %s %s' },#, move: 'mv %s %s' }, 
-   # default:{    list: '!Grid.new({input: %w[%name] }).pick', open: '|xdg-open', 
-   default:{    open: '|xdg-open %name', diskuse: '|du -hs %name',
-                info: '=file %name',   copy: '+rsync --progress %name %dir',
-                move: '|mv %name %dir', delete: '|rm %name '  },
- directory:{      cd: '!cd %name ' }, 
-      text:{    view: '+less %name',   edit: '+micro %name', 
-               count: '|wc -l %name' },
-      troff: { manual: '+man %name' },
-  "x-ruby":{     run: '+ruby %name' },
-      html:{terminal: '+w3m %name',graphics: '|vimb %name' },
-     image:{    play: '|mpv %name' }, 
-     video:{    play: '|mpv %name' },
-     audio:{    play: '|mpv %name' },
-       pdf:{    view: '|mupdf %name' },
-       # epub: :pdf
-  'x-pie-executable':{ run: '|%name', run_terminal: '+%name', 
-  help: '=%name --help', manual: '+man %name' }
-},
-
-#######################################################################
-#
-# VIEWS
-#
-# system infos : 
-#  target permissions owner group size accessed modified created type subtype
-#
-######################################################################
-
-views: {
-#  detail_ls: { ls: '|ls -l %s' },
-#  mimetypes: { type: '!type', subtype: '!subtype' },
-#  type_detail: { info: %w[ size access ], type: '|file -b %s' },
-  # type_detail:{ size: :size, type: '|file -b %name' },
-   content:{  content: '|head -n 50 %name' },
-  filetype:{  type: true, subtype: true, description: '|file -b %name' },
-     lines:{  lines: '|wc -l %name' },
-
-  # content:{  content: '!`head -n 50 %name `.gsub $/, ?|' },
-    whatis:{    whatis: #'|whatis %name' }
-    '!open(\'|whatis %name 2>&1\').read.match(/[-:]\s(.*)$/)[1] ' }
-    # "!open(\"|whatis %name 2>&1\").read.match(/[-:]\s(.*)$/)[1] " }
-}