Rails Tempfile Binary Options

Goodbye attachmentfu, hello Paperclip Por bem mais de um ano agora attachmentfu tem sido o meu plugin de escolha para adicionar uploads arquivo para nossos aplicativos Rails, mas recentemente meus companheiros WebFellas têm sido delirante sobre Paperclip dos rapazes inteligentes em thoughtbot. Como Irsquove apenas começou outro novo projeto eu percebi que era hora de tomar Paperclip para dar uma volta. As instruções especiais obrigatórias para o Windows Se, como eu, o seu, um desenvolvedor Rails sofredor do Windows (esses novos Macbooks estão procurando muito tentador), você não ficará surpreso ao saber que a obtenção de Paperclip em funcionamento precisa de alguns passos especiais. Instalar o plugin Você pode instalar o Paperclip como um plugin Rails regular do GitHub a partir de uma janela de prompt de comando como este: Yoursquoll obviamente precisa de uma cópia de trabalho do Git. Thoughtbot desligou seu repositório SVN esta semana ea versão gemificada do Paperclip no RubyForge é bastante antiga agora e provavelmente não deveria ser usada (gems ​​via GitHub não estão disponíveis no momento). Download ImageMagick Paperclip usa ImageMagick para executar processamento de imagem, que é felizmente muito mais fácil de instalar no Windows do que ImageScience foi para attachmentfu Yoursquove tem duas opções: Use a jóia RMagick Embora Paperclip doesnrsquot usar a jóia RMagick, se você pensa yoursquore sempre provável que você Deve baixar a jóia mais recente do RubyForge e usar a versão do ImageMagick que vem com ela (consulte o arquivo Readme. html incluído no download das instruções de instalação). Baixe a versão mais recente do ImageMagick Se yourquore não incomodado sobre RMagick suporte, em seguida, baixar e instalar o instalador ImageMagick (eu usei a biblioteca dinâmica de 16 bits por pixel sem problemas). Seja qual for o método de instalação escolhido, certifique-se de selecionar a opção Atualizar procura executável pathrsquo no instalador ImageMagick. Patch da classe Tempfile Importante: depois de olhar para isso um pouco mais de perto, o Irsquom já não está convencido de que o patch Tempfile é necessário para o Paperclip. Irsquod recomendo que você tente primeiro usá-lo sem este patch e se você começar a ver problemas, tente o patch (e itrsquod também será ótimo se você pudesse postar um comentário para me informar que você precisava do patch). Paperclip faz uso extensivo de arquivos temporários através da classe Ruby Tempfile. Infelizmente, isso pode causar alguma estranheza no Windows, onde o tamanho do arquivo é relatado incorretamente como zero bytes (attachmentfu sofrido com problemas semelhantes). A solução é para monkey-patch Tempfile como este: Este código vem de Emmanuel Pirsch e tem funcionado bem para mim em vários projetos. Eu costumo deixá-lo em minha pasta lib / patches e exigi-lo de um inicializador. Encerrar, fechar, reabrir e reiniciar Certifique-se de desligar todos os servidores em execução, feche todas as janelas de console e, em seguida, reabrir e reiniciar conforme necessário: itrsquos importante que seus consoles e servidores pegar a variável de ambiente PATH atualizado definido pelo instalador como Paperclip chamadas ImageMagick usando A linha de comando (é por isso que doesnrsquot necessidade RMagick). Por onde começar Neste ponto você deve estar pronto para começar a usar o plugin. Eu wonrsquot cobrir as noções básicas de usar Paperclip com Rails como theyrsquove já foi explicado na página oficial do projeto, bem como em Jim Neathrsquos excelente tutorial e mais recentemente em um RailsCast de Ryan Bates. No entanto, existem alguns recursos e dicas mais recentes que você deve saber sobre para tirar o melhor proveito do Paperclip. Proteja seus atributos Se você já usou attachmentfu então yoursquore provavelmente consciente de que versões mais antigas didnrsquot como attrprotected. A boa notícia é que não só o attachmentfu foi recentemente corrigido. Mas Paperclip também joga muito bem com attrprotected e attraccessible também. Então, para jogá-lo seguro você deve proteger o nome do arquivo. Contenttype e tamanho em seus modelos, por exemplo: Anexando em migrações ou o console Rails Anexar um arquivo a um modelo em uma migração ou ao usar o console Rails é muito mais fácil com Paperclip do que com attachmentfu. Tudo o que você precisa fazer é abrir um objeto File e atribuí-lo ao atributo de anexo do modelo: Claro que funciona em praticamente todos os sistemas operacionais do mundo, exceto o Windows, onde a atribuição causará um erro como este a ser produzido em A janela de console: Além dessa mensagem enigmática, o arquivo isnrsquot anexado corretamente e não miniaturas são geradas. Felizmente a solução é simples (embora tenha me levado alguns momentos de coçar a cabeça para descobrir): definir o modo binário no arquivo para parar o Windows tratá-lo como um arquivo de texto: Descartando uma imagem enviada Quando um arquivo de imagem é carregado Paperclip Armazena-o usando o nome do estilo original. Embora não seja possível dizer Paperclip simplesmente descartar a imagem original, é possível definir seu próprio estilo original que o Paperclip usará. Por exemplo, se seu modelo contém o seguinte: Então, mesmo se uma foto enorme (por exemplo, 1600x1600) for carregada, ela não será armazenada no servidor (ou no balde S3). No entanto, você ainda terá um arquivo original, mas ele terá sido redimensionado para 250 x 250, ajudando a reduzir a quantidade de espaço de armazenamento necessário para anexos. Estilos podem ser Procs também A maioria das vezes o seu provavelmente está passando strings de geometria para a opção hasattachedfile: styles, mas um recurso muito bom é a capacidade de também passar um Proc para fornecer geração de seqüência de caracteres de geometria dinâmica. Por exemplo, você pode ter um modelo que tenha photowidth e photoheight atributos que podem ser especificados pelo usuário e você deseja gerar uma miniatura customrsquo que usa essas dimensões. Paperclip permite que você faça isso facilmente: Como você pode ver o Proc recebe o objeto que o anexo é parte de como um parâmetro e retorna uma seqüência de caracteres de geometria gerada usando o photowidth e photoheight atributos. Adicionando uma chamada para o método de reprocesso do objeto anexo no seu modelrsquos beforesave callback também permite que você para regenerar as miniaturas se qualquer um desses atributos são atualizados. Renomear arquivos no upload As opções hasattachedfile: url e: path podem ser usadas para personalizar o nome de seus anexos. Url define o URL que será usado por coisas como imagetag para acessar sua imagem e permite que você forneça acesso direto à imagem ou rotear acesso através de um controlador (para fornecer verificação de permissão, por exemplo) e: path determina onde o arquivo de imagem É armazenado em seu servidor (para armazenamento de sistema de arquivos) ou em um balde S3. Ambas as opções usam interpolação, permitindo que você use tags especiais que serão substituídas por valores reais em tempo de execução (assim como a interpolação regular de cordas Ruby). As interpolações padrão fornecidas pelo plugin são: railsroot O caminho para o aplicativo Rails. Railsenv O ambiente atual (por exemplo, desenvolvimento, produção): class O nome da classe do modelo do qual o anexo é parte, sublinhado e pluralizado para sua conveniência. Basename O nome do arquivo originalmente carregado sem sua extensão. Extensão A extensão de arquivo do arquivo carregado originalmente. Id O ID do modelo do qual o anexo faz parte. Idpartition O mesmo que: id mas formatado como uma string usando o particionamento de ID. Attachment O nome do atributo attachment (definido na chamada para hasattachedfile) downcased e pluralizado para sua diversão. Style O estilo atual do arquivo de anexo que está sendo processado (por exemplo, no descarte de um exemplo de imagem carregada acima do: style seria um dos originalrsquo ou smallrsquo) O padrão: url e: opções de caminho para hasattachedfile são: Letrsquos dizer yoursquod preferir seus usersrsquo fotos Para ser armazenado em um único subdiretório photosrsquo da pasta public / images no seu servidor usando o ID do usuário eo estilo como o nome do arquivo base. Seu modelo precisaria conter algo como isto: Se você quiser ocultar imagens atrás de um controlador, faça algo como isto: Neste exemplo, o URL aponta para um PhotosController aninhado dentro do recurso Usuário (um URL de exemplo seria / users / 2 / photos /small. png) e os arquivos de anexos são armazenados fora da raiz pública em um subdiretório de uma pasta de anexos (por exemplo, RAILSROOT / attachments / users / 2 / photos / small. png). A ação show do PhotosController seria responsável por retornar os dados binários do arquivo apropriado usando o: style. Extensão e: userid parâmetros. Interpolações personalizadas Além das interpolações predefinidas descritas acima, o Paperclip facilita muito a definição das suas próprias. Por exemplo, um dos meus modelos tem um atributo de símbolo que eu quero usar no nome do arquivo de imagens anexado a ele, então em um inicializador Rails eu adiciono o seguinte código: As interpolações são Procs que levam dois parâmetros, o objeto anexo eo atual , E é possível acessar o modelo que o anexo faz parte do uso do atributo de instância do objeto de anexo. Depois de adicionar minha interpolação personalizada, posso usá-la assim: Excluir um anexo existente Excluir um anexo existente de um modelo é tão simples quanto definir o atributo de anexo como nulo. Em um mundo RESTful você poderia fazer isso a partir da ação de destruir de um controlador que mapeia para o anexo (por exemplo, usando uma solicitação DELETE em / users / 1 / photos). Você também pode facilmente substituir um anexo existente por POSTing um novo arquivo para sua ação de atualização. As coisas ficam um pouco mais complicadas se você quiser ser capaz de excluir um anexo existente sem substituí-lo usando uma ação de atualização. A abordagem Irsquove usada é adicionar uma caixa de seleção ao formulário de edição que, quando marcada, faz com que qualquer anexo existente seja removido, a menos que um novo arquivo também tenha sido selecionado na caixa de upload de arquivo. Herersquos o código da vista: Isto adiciona uma caixa de verificação, usando uma variável de instância para controlar o seu valor, se o usuário não é novo e já tem uma foto. A variável de instância é adicionada ao modelo juntamente com uma chamada de retorno para limpar a foto: Então a ação de atualização no controlador se parece com isto: Um módulo contendo uma versão reutilizável deste código está disponível nesta essência. O módulo pode ser incluído em um inicializador e adiciona o método hasdeletableattachment aos seus modelos. Você pode então fazer algo como isto: Obtendo inteligente com validações Paperclip permite que você valide a presença, tipo de conteúdo e tamanho de um arquivo de anexo usando o validatesattachmentpresence. Validatesattachmentcontenttype e validatesattachmentsize methods. Mas o que se você quiser fazer algo mais avançado Por exemplo letrsquos dizer que temos um modelo Track que representa carregado arquivos MP3 e, porque queremos preservar a integridade musical do nosso site, queremos impedir que os arquivos de certos artistsrsquo sendo carregado. Para fazer isso, podemos usar um método de validação personalizado: Este modelo faz uso do ruby-mp3info gem para acessar as tags ID3: o yoursquoll precisa instalá-lo e configurar a linha config. gem necessária em seu arquivo environment. rb para obter este Exemplo de trabalho. As quatro primeiras linhas do modelo são chamadas diretas para métodos Paperclip: eles configuram o anexo e garantem que ele é validado para presença, tipo de conteúdo e tamanho. O modelo então contém um callback de validação para o método musthavevalidartisttag: é aqui que as coisas boas acontecem. Se um novo arquivo MP3 tiver sido anexado, então no momento da validação ele não será gravado no local correto no servidor (ou no balde S3). Felizmente, o método tofile significa que não precisamos nos preocupar com isso: ele retorna um objeto File que se referirá a um arquivo de anexo existente ou ao novo arquivo temporário carregado. A primeira linha do método de validação passa o nome do caminho desse arquivo para a classe Mp3Info para que ele possa processá-lo. Neste exemplo simples, a validação verifica se a tag do artista do arquivo MP3 está definida para um determinado artista e sinaliza um erro conforme apropriado. Antes de fazer qualquer um dos itrsquos acima uma boa idéia para verificar que um arquivo foi realmente anexado: Paperclip fornece uma maneira simples de fazer isso chamando o método mp3 que retorna true se um arquivo foi anexado. O nome deste método é baseado no nome do seu anexo, por isso, por exemplo, se o seu modelo contém hasattachedfile: foto, então o método de foto será usado para verificar um arquivo anexado. A classe Mp3Info irá levantar uma Mp3InfoException se algo der errado. Precisamos resgatá-lo no caso de um arquivo MP3 inválido ser carregado. Para manter este exemplo simples, se ocorrer uma exceção, um erro será adicionado ao atributo mp3 que contém a mensagem de exceção: você poderia naturalmente fazer algo mais impressionante aqui. Ao fornecer acesso direto ao arquivo de anexo usando o método tofile, o Paperclip permite que você faça praticamente qualquer coisa com o anexo, seja em uma validação como a mostrada acima ou em um callback de modelo diferente, como beforesave. Whatrsquos next Ser hospedado no GitHub naturalmente significa que outros desenvolvedores estão forking Paperclip e alterá-lo para atender às suas necessidades. Wersquore nenhuma exceção e Chris foi recentemente indo forking louco. Adicionando suporte para thumbnailing de anexos de vídeo, entre outras coisas, então Irsquoll tentar encurralá-lo em blogs sobre suas mudanças. Mesmo que a Irsquove só tenha usado o Paperclip por alguns dias, eu realmente gosto de sua abordagem direta e flexível e a Irsquoll definitivamente a está usando para projetos futuros (até que algo mais novo e mais brilhante apareça). No entanto meu velho amigo attachmentfu está longe de morto e assim Irsquoll estar vigiando o seu desenvolvimento também. Pode o caminho para ImageMagick ser configurado Se o seu preferir não confiar no caminho de pesquisa você pode configurar explicitamente a localização do ImageMagick em um inicializador: Pode erros de miniatura ser relatado A opção whinythumbnails pode ser habilitado para ver erros quando thumbnailing vai mal: Validatesattachmentcontenttype ser usado com uploads de imagem Se você tiver um anexo de fotos e quiser apenas permitir gif. Jpeg e png você pode fazer isso: Pode um formato de arquivo específico ser usado para uma miniatura Por predefinição miniaturas são criadas usando o mesmo formato de imagem como o arquivo original, no entanto, é possível especificar o formato como mostrado abaixo: Neste exemplo o Quadrada foi definida usando uma matriz contendo uma seqüência de caracteres de geometria e um especificador de formato. Se você fosse fazer o upload de um arquivo GIF, a pequena miniatura também seria um GIF, mas a miniatura quadrada seria convertida em PNG. Um modelo pode ter vários anexos Você pode chamar hasattachedfile várias vezes em um modelo para definir vários anexos. Alternativamente, você pode criar um modelo de anexo que pode ser compartilhado (através de uma associação polimórfica) em vários modelos. Se você tomar essa abordagem, você deve definir explicitamente o nome da classe de anexo ao definir a associação, caso contrário, você terá um erro ao tentar acessar a associação como esta: Uma classe de utilitário para gerenciar arquivos temporários. Quando você cria um objeto Tempfile, ele criará um arquivo temporário com um nome de arquivo exclusivo. Um objeto Tempfile se comporta exatamente como um objeto File, e você pode executar todas as operações de arquivo habituais: ler dados, gravar dados, alterar suas permissões, etc. Portanto, embora essa classe não documente explicitamente todos os métodos de instância suportados pelo File, você Pode de fato chamar qualquer método de instância de arquivo em um objeto Tempfile. Quando um objeto Tempfile é coleta de lixo, ou quando o interpretador Ruby sai, seu arquivo temporário associado é automaticamente excluído. Isso significa que é desnecessário excluir explicitamente um Tempfile após o uso, embora sua boa prática para fazer isso: excluir explicitamente Tempfiles não utilizados pode potencialmente deixar grandes quantidades de tempfiles no sistema de arquivos até que eles sejam coletados. A existência desses arquivos temporários pode tornar mais difícil determinar um novo arquivo Tempfile. Portanto, sempre se deve chamar desassociar ou fechar em um bloco de garantia, como este: Desassociar após a criação Para sistemas POSIX, é possível desassociar um arquivo logo após criá-lo e antes de fechá-lo. Isso remove a entrada de sistema de arquivos sem fechar o identificador de arquivo, portanto, garante que somente os processos que já tinham o identificador de arquivo aberto podem acessar o conteúdo dos arquivos. É altamente recomendável que você faça isso se você não quiser que outros processos sejam capazes de ler ou gravar no Tempfile. E você não precisa saber o arquivo Tempfiles também. Por exemplo, um caso de uso prático para unlink-after-creation seria este: você precisa de um buffer de bytes grandes que é muito grande para caber confortavelmente na RAM, p. Quando você está escrevendo um servidor web e você deseja armazenar em buffer os dados do arquivo de clientes. Consulte desvincular para obter mais informações e um exemplo de código. Menor notas para uarr Tempfiles método de picking filename é tanto thread-safe e inter-process-safe: garante que nenhum outro segmento ou processo irá escolher o mesmo nome de arquivo. O próprio Tempfile não pode ser inteiramente thread-safe. Se você acessar o mesmo objeto Tempfile de vários segmentos, em seguida, você deve protegê-lo com um mutex. Métodos de classe pública create (basename, tmpdirnil, mode: 0, options) clique para alternar source Cria um arquivo temporário como o objeto File usual (não Tempfile). Não usa finalizador e delegação. Se nenhum bloco é fornecido, isso é semelhante a :: new, exceto criar arquivo em vez de Tempfile. O arquivo criado não é removido automaticamente. Você deve usar File. unlink para removê-lo. Se um bloco for dado, então um objeto File será construído eo bloco será chamado com o objeto como argumento. O objeto Arquivo será fechado automaticamente eo arquivo temporário será removido após o término do bloco. A chamada retorna o valor do bloco. Em qualquer caso, todos os argumentos (args) serão tratados como :: new. New (basename, tmpdir Dir. tmpdir, opções) click to toggle source Cria um arquivo temporário com permissões 0600 (somente legível e gravável pelo proprietário) e abre com o modo w. O parâmetro basename é usado para determinar o nome do arquivo temporário. Você pode passar um String ou um Array com 2 elementos String. Na forma anterior, o nome da base de arquivos temporários começará com a string dada. Na última forma, o nome da base de arquivos temporários começará com o primeiro elemento dos arrays e terminará com o segundo elemento. Por exemplo: O arquivo temporário será colocado no diretório conforme especificado pelo parâmetro tmpdir. Por padrão, este é Dir. tmpdir. Quando SAFE gt 0 eo dado tmpdir está contaminado, ele usa / tmp como o diretório temporário. Observe que os valores ENV são corrompidos por padrão eo valor de retorno de Dir. tmpdir pode vir de variáveis ​​de ambiente (por exemplo, TMPDIR). Você também pode passar um hash de opções. Sob o capuz, Tempfile cria o arquivo temporário usando File. open. Essas opções serão passadas para File. open. Isso é útil principalmente para especificar opções de codificação, por exemplo: Exceptions para uarr Se :: new não consegue encontrar um nome de arquivo exclusivo dentro de um número limitado de tentativas, então ele criará uma exceção. Open (args) clique para alternar fonte Se nenhum bloco é dado, este é um sinônimo de :: new. Se um bloco é dado, então um objeto Tempfile será construído, eo bloco é executado com o dito objeto como argumento. O objeto Tempfile será automaticamente fechado após o término do bloco. A chamada retorna o valor do bloco. Em qualquer caso, todos os argumentos (args) serão passados ​​para :: new. Métodos de Instância Pública close (unlinknowfalse) click to toggle source Fecha o arquivo. Se unlinknow for true, o arquivo será desassociado (excluído) após o fechamento. Claro, você pode optar por chamar mais tarde desvincular se você não desvincular agora. Se você não explicitamente desvincular o arquivo temporário, a remoção será atrasada até que o objeto seja finalizado. Close () clique para alternar entre a origem Fecha e desassocia (exclui) o arquivo. Tem o mesmo efeito que chamado close (true). Um arquivo é uma abstração de qualquer objeto de arquivo acessível pelo programa e está intimamente associado com a classe IO O arquivo inclui os métodos do módulo FileTest como métodos de classe, permitindo que você escreva (por exemplo) File. exist (quotfooquot). Na descrição de métodos de arquivo, bits de permissão são um conjunto de bits específicos de plataforma que indicam permissões de um arquivo. Em sistemas baseados em Unix, as permissões são visualizadas como um conjunto de três octetos, para o proprietário, o grupo e o resto do mundo. Para cada uma dessas entidades, as permissões podem ser configuradas para ler, gravar ou executar o arquivo: Os bits de permissão 0644 (em octal) seriam assim interpretados como leitura / gravação para o proprietário e somente leitura para grupo e outros. Os bits de ordem superior também podem ser usados ​​para indicar o tipo de arquivo (planície, diretório, pipe, soquete e assim por diante) e vários outros recursos especiais. Se as permissões são para um diretório, o significado do bit de execução muda quando definir o diretório pode ser pesquisado. Em sistemas operacionais não-Posix, pode haver apenas a capacidade de tornar um arquivo somente leitura ou leitura-gravação. Neste caso, os bits de permissão restantes serão sintetizados para se assemelhar a valores típicos. Por exemplo, no Windows NT os bits de permissão padrão são 0644. o que significa leitura / gravação para proprietário, somente leitura para todos os outros. A única alteração que pode ser feita é para tornar o arquivo somente leitura, que é relatado como 0444. Várias constantes para os métodos em Arquivo podem ser encontradas em Arquivo :: Constantes. Plataforma separador separador separador separador separa as partes do diretório no caminho separa as partes do diretório no caminho Métodos de Classe Pública absolutepath (nome de arquivo, dirstring) rarr absfilename clique para alternar fonte Converte um caminho para um caminho absoluto. Caminhos relativos são referenciados a partir do diretório de trabalho atual do processo a menos que dirstring é fornecido, caso em que ele será usado como o ponto de partida. Se o nome de caminho dado começa com um não é expandido, ele é tratado como um nome de diretório normal. Atime (nome do arquivo) rarr time clique para alternar source Retorna o último tempo de acesso para o arquivo nomeado como um objeto Time). Filename pode ser um objeto IO. Basename (nome de arquivo, sufixo) rarr basename click to toggle source Retorna o último componente do nome de arquivo dado em filename. Que pode ser formado usando File :: SEPARATOR e File :: ALTSEPARATOR como o separador quando File :: ALTSEPARATOR não é nil. Se o sufixo é dado e presente no final do nome do arquivo. Ele é removido. Se o sufixo for., Qualquer extensão será removida. Birthtime (nome do arquivo) rarr time clique para alternar source Retorna a hora de nascimento do arquivo nomeado. Filename pode ser um objeto IO. Observe que no Windows (NTFS), retorna o tempo de criação (tempo de nascimento). Blockdev (nome do arquivo) rarr verdadeiro ou falso clique para alternar fonte Retorna true se o arquivo nomeado for um dispositivo de bloco. Filename pode ser um objeto IO. Chardev (nome do arquivo) rarr true ou false clique para alternar source Retorna true se o arquivo nomeado for um dispositivo de caractere. Filename pode ser um objeto IO. Chmod (modeint, filename.) Rarr inteiro clique para alternar fonte Muda os bits de permissão nos arquivos nomeados para o padrão de bits representado por modeint. Os efeitos reais dependem do sistema operacional (consulte o início desta seção). Em sistemas Unix, consulte chmod (2) para obter detalhes. Retorna o número de arquivos processados. Chown (ownerint, groupint, filename.) Rarr integer clique para alternar fonte Muda o proprietário eo grupo do arquivo (s) nomeado (s) para o dado proprietário numérico e IDs de grupo. Somente um processo com privilégios de superusuário pode alterar o proprietário de um arquivo. O proprietário atual de um arquivo pode alterar o grupo de arquivos para qualquer grupo ao qual o proprietário pertence. Um nil ou -1 proprietário ou id de grupo é ignorado. Retorna o número de arquivos processados. Ctime (nome do arquivo) rarr time clique para alternar fonte Retorna o tempo de alteração para o arquivo nomeado (a hora em que as informações do diretório sobre o arquivo foram alteradas, e não o próprio arquivo). Filename pode ser um objeto IO. Observe que no Windows (NTFS), retorna o tempo de criação (tempo de nascimento). Delete (filename.) Rarr integer clique para alternar fonte Exclui os arquivos nomeados, retornando o número de nomes passados ​​como argumentos. Gera uma exceção em qualquer erro. Veja também Dir :: rmdir. Diretório (nome do arquivo) rarr verdadeiro ou falso clique para alternar origem Retorna true se o arquivo nomeado for um diretório, ou um link simbólico que aponte para um diretório, e false caso contrário. Filename pode ser um objeto IO. Dirname (nome_do_arquivo) rarr dirname clique para alternar fonte Retorna todos os componentes do nome do arquivo fornecidos no nome do arquivo, exceto o último. O nome do arquivo pode ser formado usando File :: SEPARATOR e File :: ALTSEPARATOR como o separador quando File :: ALTSEPARATOR não é nil. Executável (nome do arquivo) rarr true ou false clique para alternar source Retorna true se o arquivo nomeado é executável pelo id de usuário efetivo desse processo. Executetablereal (nome do arquivo) rarr true ou false clique para alternar source Retorna true se o arquivo nomeado for executável pelo id de usuário real desse processo. Existe (nome de arquivo) rarr verdadeiro ou falso clique para alternar origem Retorna true se o arquivo nomeado existir. Filename pode ser um objeto IO. Arquivo existe significa que a chamada de sistema stat () ou fstat () é bem-sucedida. Existe (nome do arquivo) rarr verdadeiro ou falso clique para alternar fonte Método Deprecated. Não use. Expandpath (nome do arquivo, dirstring) rarr absfilename clique para alternar fonte Converte um caminho para um caminho absoluto. Caminhos relativos são referenciados a partir do diretório de trabalho atual do processo a menos que dirstring é fornecido, caso em que ele será usado como o ponto de partida. O nome de caminho dado pode começar com a, que se expande para o diretório inicial dos proprietários do processo (a variável de ambiente HOME deve ser definida corretamente). Usuário se expande para o diretório inicial de usuários nomeados. Um exemplo simples de usar dirstring é a seguinte. Um exemplo mais complexo que também resolve o diretório pai é o seguinte. Suponha que estamos em bin / mygem e queremos o caminho absoluto de lib / mygem. rb. Então primeiro resolve o pai do FILE, que é bin /, então vá para o pai, a raiz do projeto e acrescenta lib / mygem. rb. Extname (caminho) rarr string clique para alternar source Retorna a extensão (a parte do nome do arquivo no caminho a partir do último período). Se caminho é um arquivo de ponto, ou começa com um ponto, então o ponto de partida não é tratado com o início da extensão. Uma string vazia também será retornada quando o período for o último caractere no caminho. Arquivo (arquivo) rarr true ou false clique para alternar source Retorna true se o arquivo nomeado existir e for um arquivo regular. Arquivo pode ser um objeto IO. Se o argumento do arquivo for um link simbólico, ele resolverá o link simbólico e usará o arquivo referenciado pelo link. (Padrão, caminho, sinalizadores) rarr (true ou false) Retorna true se o caminho for compatível com o padrão. Fnmatch (pattern, path, flags) O padrão não é uma expressão regular, em vez disso, segue regras semelhantes à globbing do nome do shell. Ele pode conter os seguintes metacaracteres: Corresponde a qualquer arquivo. Pode ser restringido por outros valores no glob. Equivalente a / . / X em regexp. Corresponde a todos os arquivos arquivos regulares Corresponde a todos os arquivos que começam com c Corresponde a todos os arquivos que terminam com c Corresponde a todos os arquivos que têm c neles (incluindo no início ou no final). Para coincidir com os arquivos ocultos (que começam com um .. defina o sinalizador File :: FNMDOTMATCH Corresponde diretórios recursivamente ou arquivos de forma expansiva Corresponde a qualquer caractere Equivalente a /. / Em regexp Corresponde a qualquer caractere no conjunto Comporta exatamente como conjuntos de caracteres Em Regexp, incluindo set negation (az) Escapa o próximo metacaracteres Corresponde ao padrão a e pattern b se File :: FNMEXTGLOB flag for habilitado Behaves like a Regexp union ((: ab)). Flags é um bitwise OR do FNMXXX (Padrão, caminho, sinalizadores) rarr (true ou false) clique para alternar fonte Retorna true se o caminho coincide com o padrão O padrão não é uma expressão regular em vez disso Segue regras semelhantes a globbing do nome do arquivo shell. Pode conter os seguintes metacaracteres: Corresponde a qualquer arquivo. Pode ser restrito por outros valores no glob. Equivalente a / ./x em regexp. Combina todos os arquivos arquivos regulares Corresponde a todos os arquivos que começam com c Corresponde Todos os arquivos que terminam com c Corresponde a todos os arquivos que têm c neles (incluindo no início ou no final). Para coincidir com os arquivos ocultos (que começam com um .. defina o sinalizador File :: FNMDOTMATCH Corresponde diretórios recursivamente ou arquivos de forma expansiva Corresponde a qualquer caractere Equivalente a /. / Em regexp Corresponde a qualquer caractere no conjunto Comporta exatamente como conjuntos de caracteres Em Regexp, incluindo set negation (az) Escapa o próximo metacaracteres Corresponde ao padrão a e pattern b se File :: FNMEXTGLOB flag for habilitado Behaves like a Regexp union ((: ab)). Flags é um bitwise OR do FNMXXX Ftype (nome do arquivo) string rarr clique para alternar fonte Identifica o tipo do arquivo nomeado a string de retorno é um arquivo, diretório, caractereSpecial, blocoSpecial, fifo, link, Socket ou unknown. grpowned (nome do arquivo) rarr true ou false clique para alternar source Retorna true se o arquivo nomeado existir e o id de grupo efetivo do processo de chamada for o proprietário do arquivo. Retorna false no Windows. Filename pode ser um IO (File1, file2) rarr verdadeiro ou falso click to toggle source Retorna true se os arquivos nomeados forem idênticos. File1 e file2 podem ser um objeto IO. Join (string.) Rarr string Clique para alternar source Retorna uma nova seqüência de caracteres formada por juntar as seqüências usando File :: SEPARATOR. Lchmod (modeint, filename.) Rarr integer clique para alternar source Equivalente a File :: chmod. Mas não segue links simbólicos (assim ele irá alterar as permissões associadas com o link, não o arquivo referenciado pelo link). Frequentemente não disponível. Lchown (ownerint, groupint, filename.) Rarr integer clique para alternar source Equivalente a File :: chown. Mas não segue links simbólicos (assim ele irá mudar o proprietário associado com o link, não o arquivo referenciado pelo link). Frequentemente não disponível. Retorna o número de arquivos na lista de argumentos. Link (oldname, newname) rarr 0 clique para alternar fonte Cria um novo nome para um arquivo existente usando um link rígido. Não substituirá newname se já existir (criando uma subclasse de SystemCallError). Não disponível em todas as plataformas. Lstat (nome do arquivo) rarr stat clique para trocar a fonte Igual ao arquivo :: stat. Mas não segue o último link simbólico. Em vez disso, os relatórios sobre o link em si. Mtime (nome do arquivo) rarr time clique para alternar entre a origem Retorna a hora de modificação do arquivo nomeado como um objeto Time. Filename pode ser um objeto de E / S. Novo (nome de arquivo, moder, opt) arquivo rarr clique para alternar fonte novo (nome de arquivo, modo, perm, opt) arquivo rarr Abre o arquivo nomeado por nome de arquivo de acordo com o modo determinado e retorna um novo objeto File. Veja IO. new para uma descrição do modo e opt. Se um arquivo está sendo criado, os bits de permissão podem ser dadas em perm. Estes bits de modo e permissão são dependentes da plataforma em sistemas Unix, consulte as páginas de manual open (2) e chmod (2) para obter detalhes. Examples para uarr open(filename, moder , opt) rarr file click to toggle source open(filename , mode , perm , opt) rarr file open(filename, moder , opt) rarr obj open(filename , mode , perm , opt) rarr obj With no associated block, File. open is a synonym for ::new. If the optional code block is given, it will be passed the opened file as an argument and the File object will automatically be closed when the block terminates. The value of the block will be returned from File. open . If a file is being created, its initial permissions may be set using the perm parameter. See ::new for further discussion. See IO. new for a description of the mode and opt parameters. owned(filename) rarr true or false click to toggle source Returns true if the named file exists and the effective used id of the calling process is the owner of the file. filename can be an IO object.