fortrangoingonforty/fortress / 061808d

+# AUR Packaging Guide for FORTRESS

+

+This guide explains how to package FORTRESS for the Arch User Repository (AUR).

+

+## Files Needed for AUR

+

+The following files are required in the AUR repository:

+

+1. **PKGBUILD** - Build script that describes how to build and install the package

+2. **.SRCINFO** - Metadata file generated from PKGBUILD

+3. **fortress.install** - Post-install messages and scripts

+

+## Preparing for AUR Submission

+

+### 1. Create a Release on GitHub

+

+First, create a tagged release on GitHub:

+

+```bash

+# Tag the release

+git tag -a v0.1.0 -m "Release v0.1.0"

+git push origin v0.1.0

+```

+

+Then create a release on GitHub using this tag.

+

+### 2. Generate Checksum

+

+Download the release tarball and generate its SHA256 checksum:

+

+```bash

+# Download the release

+wget https://github.com/FortranGoingOnForty/fortress/archive/v0.1.0.tar.gz

+

+# Generate checksum

+sha256sum v0.1.0.tar.gz

+```

+

+Update the `sha256sums` line in PKGBUILD with this value.

+

+### 3. Test the PKGBUILD

+

+Before submitting to AUR, test the build locally:

+

+```bash

+# Install dependencies (if not already installed)

+sudo pacman -S fpm gcc-fortran base-devel

+

+# Test build

+makepkg -sf

+

+# Test installation

+sudo pacman -U fortress-0.1.0-1-x86_64.pkg.tar.zst

+

+# Test the installed package

+fortress

+```

+

+### 4. Generate .SRCINFO

+

+The .SRCINFO file must be generated from PKGBUILD:

+

+```bash

+makepkg --printsrcinfo > .SRCINFO

+```

+

+**Important**: Regenerate .SRCINFO every time you update PKGBUILD!

+

+### 5. Submit to AUR

+

+If this is your first time:

+

+```bash

+# Clone the AUR repository (will be empty initially)

+git clone ssh://aur@aur.archlinux.org/fortress.git aur-fortress

+cd aur-fortress

+

+# Copy the required files

+cp ../PKGBUILD .

+cp ../fortress.install .

+makepkg --printsrcinfo > .SRCINFO

+

+# Commit and push

+git add PKGBUILD fortress.install .SRCINFO

+git commit -m "Initial import of fortress v0.1.0"

+git push

+```

+

+For updates:

+

+```bash

+cd aur-fortress

+

+# Update PKGBUILD (bump pkgver, update sha256sums, etc.)

+# Then regenerate .SRCINFO

+makepkg --printsrcinfo > .SRCINFO

+

+# Commit and push

+git add PKGBUILD .SRCINFO

+git commit -m "Update to v0.2.0"

+git push

+```

+

+## How Installation Works

+

+When users install fortress from AUR:

+

+1. **Binary Installation**: The executable is installed as `/usr/bin/fortress-bin`

+

+2. **Shell Integration** (automatic for most shells):

+   - **Bash**: Auto-loaded from `/etc/profile.d/fortress.sh` on shell startup

+   - **Fish**: Auto-loaded from `/usr/share/fish/vendor_functions.d/fortress.fish`

+   - **Zsh**: Users need to add `source /usr/share/fortress/fortress.sh` to `~/.zshrc`

+

+3. **Usage**: Users just run `fortress` and the cd-on-exit feature works automatically

+

+## Testing Shell Integration

+

+After installation, test each shell:

+

+```bash

+# Bash

+bash

+fortress  # Should work, press 'c' to cd

+

+# Fish

+fish

+fortress  # Should work, press 'c' to cd

+

+# Zsh (after sourcing)

+zsh

+source /usr/share/fortress/fortress.sh

+fortress  # Should work, press 'c' to cd

+```

+

+## Maintaining the AUR Package

+

+### Version Updates

+

+1. Update `pkgver` in PKGBUILD

+2. Update `sha256sums` with new release checksum

+3. Test build: `makepkg -sf`

+4. Regenerate .SRCINFO: `makepkg --printsrcinfo > .SRCINFO`

+5. Commit and push to AUR

+

+### Common Issues

+

+**fpm not in official repos**: Users need to install `fpm` from AUR first:

+```bash

+yay -S fpm

+```

+

+**Build fails**: Check that all makedepends are correct and the build() function works

+

+**Shell integration doesn't work**: Verify files are installed to correct locations and users have restarted their shell

+

+## Resources

+

+- [AUR Submission Guidelines](https://wiki.archlinux.org/title/AUR_submission_guidelines)

+- [PKGBUILD Manual](https://wiki.archlinux.org/title/PKGBUILD)

+- [Creating Packages](https://wiki.archlinux.org/title/Creating_packages)

+    integer :: i, rows, cols, visible_height, top_padding

+    character(len=256) :: term_program

+

+    ! Detect terminal type once for consistent padding throughout

+    call get_environment_variable("TERM_PROGRAM", term_program)

+    if (index(term_program, "WezTerm") > 0 .or. index(term_program, "ghostty") > 0) then

+        top_padding = 2  ! WezTerm/Ghostty need 2 lines to prevent top cutoff

+    else if (index(term_program, "Apple_Terminal") > 0 .or. index(term_program, "iTerm") > 0) then

+        top_padding = 2  ! Terminal.app and iTerm2 need 2 lines

+    else

+        top_padding = 1  ! Other terminals need 1 line

+    end if

+

+    ! Clear screen and position at home

+    write(output_unit, '(a)', advance='no') CLEAR

+        ! Get terminal size and calculate visible height accounting for padding and 2-line header

+        ! Layout: top_padding + header(2 lines) + vis_h + footer(1 line) = rows

+        ! So: vis_h = rows - top_padding - 3

+        visible_height = rows - top_padding - 3

+        ! Draw - use CLEAR which does move home + clear in one operation

+        write(output_unit, '(a)', advance='no') CLEAR

+        call draw_interface(rows, cols, top_padding, current_dir, current_files, current_is_dir, current_is_exec, &

+        case(27)  ! ESC - could be arrow keys, Shift+arrow, or standalone ESC

+            ! Read the arrow key sequence first to determine what was pressed

+            ! If it's not an arrow key (A/B/C/D), it was a standalone ESC press

+            if (key /= 'A' .and. key /= 'B' .and. key /= 'C' .and. key /= 'D') then

+                ! Standalone ESC - exit multi-select mode if active

+                if (selection_count > 0) then

+                    call clear_all_selections(is_selected, selection_count, in_selection_mode)

+                    selection_anchor = -1

+                    has_disjoint_selection = .false.

+                end if

+                cycle  ! Redraw and wait for next input

+            end if

+

+            ! If we get here, it's an arrow key - continue with normal arrow handling

+

+    subroutine draw_interface(r, c, top_padding, current_dir, current_files, current_is_dir, current_is_exec, &

+        integer, intent(in) :: r, c, top_padding, current_count, parent_count, selected, parent_selected

+        integer :: left_w, i, parent_idx, current_idx, vis_h, display_len

+        character(len=256) :: fname

+        vis_h = r - top_padding - 3  ! Visible height: rows - (top_padding + header(2) + footer(1))

+        ! Header - Line 1: Always show path

+        write(output_unit, '(a)') BOLD // "FORTRESS" // RESET // " - " // trim(current_dir)

+

+        ! Header - Line 2: Status info (always present to prevent shifting)

+            write(output_unit, '(a)') RED // "MOVE: " // trim(move_source_name) // RESET

+            write(output_unit, '(a)') BLUE // trim(adjustl(itoa(selection_count))) // " selected" // RESET

+                    write(output_unit, '(a)') YELLOW // "CUT: " // trim(adjustl(itoa(clipboard_count))) // " items" // RESET

+                    write(output_unit, '(a)') GREEN // "COPY: " // trim(adjustl(itoa(clipboard_count))) // " items" // RESET

+                    write(output_unit, '(a)') YELLOW // "CUT: " // trim(clipboard_source_name) // RESET

+                    write(output_unit, '(a)') GREEN // "COPY: " // trim(clipboard_source_name) // RESET

+        else if (in_git_repo) then

+            ! Show git repo info when no other status

+            write(output_unit, '(a)') DIM // trim(repo_name) // ":" // trim(branch_name) // RESET

+            ! Empty status line to maintain consistent spacing - write a space not empty string

+            write(output_unit, '(a)') " "

+                else if (current_idx == selected .and. .not. move_mode .and. is_selected(current_idx)) then

+                    ! Cursor on a selected item - use bold+underline with original color

+                    write(output_unit, '(a)', advance='no') BOLD // UNDERLINE // trim(color_code) // trim(fname)

+                    ! Add git indicators if in repo

+                    if (in_git_repo) then

+                        call write_git_indicators(current_is_staged(current_idx), &

+                                                  current_is_unstaged(current_idx), &

+                                                  current_is_untracked(current_idx), &

+                                                  current_has_incoming(current_idx), .true.)

+                    end if

+                    write(output_unit, '(a)') RESET

+                    ! Normal selection cursor (not selected) - use bold+underline with original color

+        ! Footer - help text only (status moved to header)

+            write(output_unit, '(a)') DIM // "↑↓:next/prev dir →:enter dir ←:parent ~:home /:root v:move here q:cancel" // RESET

+            write(output_unit, '(a)') DIM // "ESC:exit Space:toggle Shift+↑↓:block y:copy x:cut p:paste r:delete | " // RESET // &

+            write(output_unit, '(a)') DIM // "Space:select Shift+↑↓:block | ↑↓:nav →:enter ←:back ~:home /:root s:search 8:favorites *:star o:open n:rename r:remove v:move y:copy x:cut p:paste .:hidden a:add u:unstage m:commit d:diff f:fetch l:pull h:push c:cd q:quit" // RESET