class Linguist::FileBlob

A FileBlob is a wrapper around a File object to make it quack like a Grit::Blob. It provides the basic interface: `name`, `data`, and `size`.

Attributes

name[R]

Public: Filename

Examples

FileBlob.new("/path/to/linguist/lib/linguist.rb").name
# =>  "/path/to/linguist/lib/linguist.rb"

FileBlob.new("/path/to/linguist/lib/linguist.rb",
             "/path/to/linguist").name
# =>  "lib/linguist.rb"

Returns a String

Public Class Methods

new(path, base_path = nil) click to toggle source

Public: Initialize a new FileBlob from a path

path - A path String that exists on the file system. base_path - Optional base to relativize the path

Returns a FileBlob.

# File lib/linguist/file_blob.rb, line 16
def initialize(path, base_path = nil)
  # Guard against unintentionally shelling out (leading '|') and path
  # traversal
  full_path = path.start_with?('/') ? path : File.join(Dir.pwd, path)
  if path.start_with?('|') || File.absolute_path(full_path) != full_path
    raise "Invalid path: #{path}"
  end

  @path = path
  @name = base_path ? path.sub("#{base_path}/", '') : path
end

Public Instance Methods

data() click to toggle source

Public: Read file contents.

Returns a String.

# File lib/linguist/file_blob.rb, line 52
def data
  File.read(@path)
end
mode() click to toggle source

Public: Read file permissions

Returns a String like '100644'

# File lib/linguist/file_blob.rb, line 45
def mode
  File.stat(@path).mode.to_s(8)
end
size() click to toggle source

Public: Get byte size

Returns an Integer.

# File lib/linguist/file_blob.rb, line 59
def size
  File.size(@path)
end