trk 0.1.4 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c38302d31fd705e553d2596b8c6e878a95f81b4a49d15bb044354a930d1fe2d
-  data.tar.gz: 0aae3f6637ac5838c776c590877ad2a67f4581302525ef510612a969a56cd6f0
+  metadata.gz: aadec329696267ada6db94f0d871454eece18090a4566e3a6f9684c406e48db6
+  data.tar.gz: c2a28757d21a24d0197332ca50c30aa36bf2a69de43accd5e54c550ca8b3b695
 SHA512:
-  metadata.gz: 44390e4ab9e14328dda5c05645bc1c7e2eb74ee6c32a7a6a962edd06fe1f9c1f6f4c2a28dadc312cbdbb4690173c73529bc84cccdd65e3e20e380bb0d671852d
-  data.tar.gz: 0daa1839615e15d522ae3d6c48608d3f5ec24f055ab6c79d89809696c6e6773bbc9fe68891cf9e0f9fe4e583084f3580288aec97edc879cb27fd2ce6f7ed766a
+  metadata.gz: 6d0ed0b289b76acbf65269be76b22a5ad8ea2284e38dbe0a04b48e221a7b17343b80b4df496a2b0dfe3f24e2f8971a0fcedee50490fe7d94c3916db88316edaf
+  data.tar.gz: 9cde2261c3bad6236099fce1901cb0d5e63965073f3557f1400f7dec939f33922d28399643c14b5e36ecf14d88ab58dca2c74139667ae9c3bca6cc38cbfd6f0e

data/README.md

@@ -17,16 +17,42 @@ mkdir ~/trk
 
 ### Links for code in README
 
-For code that is written only in README file we need to wrap with
-`This code is from: link` where link is a repo path with an anchor to
-subheader `#sub-header`, and finish with `End of code from: link`
+For a single line or for complete file we can use comment
+```
+# This code is from: https://trk.tools/app/trk-readme-source-links/-/blob/main/README.md
+```
+
+When a part of the file is extracted from trk.tools we can use `Start` and `End
+of code from:`
+
 ```
 # .bashrc
-# This code is from: https://trk.tools/app/trk-readme-source-links#links-for-code-in-readme
+# Start of code from: https://trk.tools/app/trk-readme-source-links#links-for-code-in-readme
 ...
 # End of code from: https://trk.tools/app/trk-readme-source-links#links-for-code-in-readme
 ```
 
+For download use `wget` and `raw` instead of `blob`
+```
+# wget -P path https://trk.tools/app/trk-readme-source-links/-/raw/main/README.md
+```
+
+Using this gem you can get the string with
+```
+trk link-show
+```
+
+For vim you can use mapping
+```
+# .vimrc
+nnoremap <leader>s :r !trk link-show %<CR>
+
+# local gem
+nnoremap <leader>s :r !cd ~/trk.tools/app/trk-readme-source-links && bundle exec exe/trk link-show %:p<CR>
+nnoremap <leader>e :r !cd ~/trk.tools/app/trk-readme-source-links && bundle exec exe/trk link-show-end %:p<CR>
+nnoremap <leader>r :r !cd ~/trk.tools/app/trk-readme-source-links && bundle exec exe/trk link-show-raw %:p<CR>
+```
+
 ### Links for code in other files
 
 For other files we need to link to specific file
@@ -62,9 +88,39 @@ Run without installing the gem
 bundle exec exe/trk pull
 ```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies.
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To put a debugger use
+```
+binding.break
+```
+
+## Test
+
+To run all tests
+```
+rake test
+```
+To run single file
+```
+ruby -Itest test/test_link.rb
+```
+or single test
+```
+ruby -Itest test/test_link.rb --name test_link_show_success
+```
+
+## Gem push
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+To release a new version, update the version number in `lib/trk/version.rb`, and
+then deploy with:
+```
+bundle exec rake release
+```
+which will create a git tag for the version, push git commits and the created
+tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 

data/lib/trk/cli.rb

@@ -2,6 +2,7 @@ require "thor"
 require "open3"
 require "net/http"
 require "uri"
+require "debug"
 
 module Trk
   class CLI < Thor
@@ -15,8 +16,8 @@ module Trk
 
     def self.help(shell, subcommand = false)
       super
-      puts "\n To enable autocomplete, put in .bashrc: 'complete -W \"$(trk completion)\" trk', eg:\n"
-      puts "echo '# https://trk.tools/app/trk-readme-source-links\ncomplete -W \"$(trk completion)\" trk' >> ~/.bashrc && source ~/.bashrc"
+      puts "\nTo enable autocomplete, put in .bashrc following two lines:"
+      puts "# https://trk.tools/app/trk-readme-source-links\ntrk completion > /dev/null 2>&1 && complete -W \"$(trk completion)\" trk"
     end
 
     desc "completion", "Outputs available commands for autocompletion"
@@ -75,5 +76,61 @@ module Trk
 
       puts "\n#{CHECK_ICON} All done!"
     end
+
+    desc "link-show FILENAME", "Show start link of the file"
+    def link_show(filename)
+      result = Link.new(filename).show
+      if result.success?
+        # puts "#{CHECK_ICON} link done #{result.message}\n#{result.data[:link]}"
+        puts result.data[:link]
+      else
+        puts "#{UNCHECK_ICON} link failed\n#{result.message}"
+      end
+    end
+
+    desc "link-show-end FILENAME", "Show end link of the file"
+    def link_show_end(filename)
+      result = Link.new(filename).show_end
+      if result.success?
+        # puts "#{CHECK_ICON} link done #{result.message}\n#{result.data[:link]}"
+        puts result.data[:link]
+      else
+        puts "#{UNCHECK_ICON} link failed\n#{result.message}"
+      end
+    end
+
+    desc "link-show-raw FILENAME", "Show wget link of the file"
+    def link_show_raw(filename)
+      result = Link.new(filename).raw
+      if result.success?
+        # puts "#{CHECK_ICON} link done #{result.message}\n#{result.data[:link]}"
+        puts result.data[:link]
+      else
+        puts "#{UNCHECK_ICON} link failed\n#{result.message}"
+      end
+    end
+
+    desc "sos", "Add sos script to .bashrc if not already there"
+    def sos(*arguments)
+      command = <<~HERE_DOC
+        # Start of code: https://trk.tools/sh/screen-tips#remote-multiuser-access-help-using-ssh-and-gnu-screen
+        # remote version
+        sos() { sos_user=$1 sos_port=$2 sos_host=h2.trk.tools bash <(curl -sL sos.trk.tools) ;}
+        # local version
+        # sos() { sos_user=$1 sos_port=$2 sos_host=h2.trk.tools ~/trk.tools/sh/screen-tips/remote_multiuser_access_help_using_ssh_and_gnu_screen.sh ;}
+        # End of code: https://trk.tools/sh/screen-tips#remote-multiuser-access-help-using-ssh-and-gnu-screen
+      HERE_DOC
+      bashrc_path = File.expand_path("~/.bashrc")
+      bashrc_content = File.read(bashrc_path) if File.exist?(bashrc_path)
+      if bashrc_content&.include?("sos()")
+        puts "#{UNCHECK_ICON} sos already exists in .bashrc"
+      else
+        File.open(bashrc_path, "a") do |file|
+          file.puts
+          file.puts command
+        end
+        puts "#{CHECK_ICON} sos function added to .bashrc, please open new terminal, or run: source ~/.bashrc"
+      end
+    end
   end
 end

data/lib/trk/link.rb

@@ -0,0 +1,49 @@
+module Trk
+  class Link
+    BASE_URL = "https://trk.tools"
+    BRANCH_PREFIX = "-/blob/main/"
+    BRANCH_RAW_PREFIX = "-/raw/main/"
+    THIS_CODE_IS_FROM = "This code is from:"
+    START_OF_CODE_FROM = "Start of code from:"
+    END_OF_CODE_FROM = "End of code from:"
+    WGET = "#   wget -P"
+
+    def initialize(filename = nil)
+      @filename = filename
+    end
+
+    def show
+      full_path = File.absolute_path?(@filename) ? @filename : File.expand_path(@filename) # /Volumes/ONETB/dule/trk.tools/app/trk-readme-source-links/test/test_link.rb
+      folders_from_trk_tools = full_path.sub(/.*trk.tools\//, "")
+      return Error.new "File #{@filename} is not inside trk.tools" if full_path == folders_from_trk_tools
+
+      repo_path = folders_from_trk_tools.split("/")[0..1].join("/")
+      file_path = folders_from_trk_tools.split("/")[2..].join("/")
+      link = "# #{START_OF_CODE_FROM} #{BASE_URL}/#{repo_path}/#{BRANCH_PREFIX}#{file_path}"
+      Result.new "OK", link: link
+    end
+
+    def show_end
+      full_path = File.absolute_path?(@filename) ? @filename : File.expand_path(@filename) # /Volumes/ONETB/dule/trk.tools/app/trk-readme-source-links/test/test_link.rb
+      folders_from_trk_tools = full_path.sub(/.*trk.tools\//, "")
+      return Error.new "File #{@filename} is not inside trk.tools" if full_path == folders_from_trk_tools
+
+      repo_path = folders_from_trk_tools.split("/")[0..1].join("/")
+      file_path = folders_from_trk_tools.split("/")[2..].join("/")
+      link = "# #{END_OF_CODE_FROM} #{BASE_URL}/#{repo_path}/#{BRANCH_PREFIX}#{file_path}"
+      Result.new "OK", link: link
+    end
+
+    def raw
+      full_path = File.absolute_path?(@filename) ? @filename : File.expand_path(@filename) # /Volumes/ONETB/dule/trk.tools/app/trk-readme-source-links/test/test_link.rb
+      folders_from_trk_tools = full_path.sub(/.*trk.tools\//, "")
+      return Error.new "File #{@filename} is not inside trk.tools" if full_path == folders_from_trk_tools
+
+      repo_path = folders_from_trk_tools.split("/")[0..1].join("/")
+      file_path = folders_from_trk_tools.split("/")[2..].join("/")
+      file_folder = folders_from_trk_tools.split("/")[2..-2].join("/") || "."
+      link = "#{WGET} #{file_folder} #{BASE_URL}/#{repo_path}/#{BRANCH_RAW_PREFIX}#{file_path}"
+      Result.new "OK", link: link
+    end
+  end
+end

data/lib/trk/result_and_error.rb

@@ -0,0 +1,42 @@
+class Result
+  attr_accessor :message, :data
+
+  # Use this to class to return results from service:
+  #
+  #   class MyService
+  #     def perform
+  #       if true
+  #         Result.new "Next task created", next_task: next_task
+  #       else
+  #         Error.new "Failed"
+  #       end
+  #     end
+  #   end
+  #
+  # and use in controller:
+  #
+  #   result = MyService.new.perform
+  #   if result.success?
+  #     flash[:notice] = result.message
+  #     redirect_to result.data[:next_task]
+  #   end
+  #
+  # Note when iterating a huge objects, use `next_task_id` so Ruby Garbage
+  # Collector can clear all temp objects from the service run
+  # If you return some object which is not basic, it can not safely clear all
+  # temp objects
+  #
+  def initialize(message, data = {})
+    @message, @data = message, data
+  end
+
+  def success?
+    true
+  end
+end
+
+class Error < Result
+  def success?
+    false
+  end
+end

data/lib/trk/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Trk
-  VERSION = "0.1.4"
+  VERSION = "0.1.7"
   CHECK_ICON = "✅ "
   UNCHECK_ICON = "❌ "
 end

data/lib/trk.rb

@@ -2,8 +2,8 @@
 
 require_relative "trk/version"
 require_relative "trk/cli"
+require_relative "trk/link"
+require_relative "trk/result_and_error"
 
 module Trk
-  class Error < StandardError; end
-  # Your code goes here...
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trk
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.7
 platform: ruby
 authors:
 - Dusan Orlovic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-03-11 00:00:00.000000000 Z
+date: 2025-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -41,6 +41,8 @@ files:
 - exe/trk
 - lib/trk.rb
 - lib/trk/cli.rb
+- lib/trk/link.rb
+- lib/trk/result_and_error.rb
 - lib/trk/version.rb
 - sig/trk.rbs
 homepage: https://trk.tools
@@ -57,7 +59,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.0.1
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="