natalie

Natália

Natalie é uma implementação Ruby em andamento.

Ele fornece um compilador avançado usando C++ e gcc/clang como back-end. Além disso, a linguagem possui um REPL que realiza compilação incremental.

Ainda há muito trabalho a fazer antes que isso seja útil. Por favor, deixe-me saber se você quiser ajudar!

Ajudando

Contribuições são bem-vindas! Você pode aprender mais sobre como trabalho com Natalie nos vídeos da sessão de hacking no YouTube.

A maneira mais fácil de começar agora seria encontrar um método em um objeto que ainda não esteja implementado e fazer você mesmo! Também dê uma olhada nas boas primeiras questões. (Consulte as seções 'Construindo' e 'Executando Testes' abaixo para obter algumas etapas úteis.)

Temos um servidor Discord muito silencioso – venha e divirta-se!

Prédio

Natalie foi testada em macOS e Ubuntu Linux. O Windows ainda não é compatível.

Natalie requer um sistema Ruby (MRI) para hospedar o compilador, por enquanto.

Pré-requisitos:

• idiota
• autoconf
• automake
• ferramentalib
• Marca GNU
• gcc ou clang
• Ruby 3.1 ou superior com cabeçalhos de desenvolvimento
  • É preferível usar rbenv para instalar Ruby.
  • Instalar rbenv-aliases junto com rbenv ajuda a combinar versões Ruby como 3.1 com a versão de patch mais recente.
  • Se não estiver usando o rbenv ou outro gerenciador de versão, você precisará do pacote ruby ​​e ruby-dev do seu sistema.
• ccache (opcional, mas recomendado)
• compiladob (opcional, mas recomendado)

Instale os pré-requisitos acima em sua plataforma e execute:

git clone https://github.com/natalie-lang/natalie
cd natalie
rake

Solução de erros de compilação

• Não use sudo ! Se você já cometeu esse erro, sudo rm -rf build e tente novamente.
• Se você receber um erro sobre permissões de arquivo, por exemplo, incapaz de gravar um arquivo em algum lugar como /usr/lib/ruby ou outro caminho que exija root, então você tem algumas opções:
  • Use uma ferramenta como rbenv para instalar uma versão Ruby em seu diretório inicial. Gemas também serão instaladas lá. Execute rbenv version para ver qual versão está selecionada no momento. Execute rbenv shell seguido por uma versão para selecionar essa versão.
  • Especifique onde instalar as gems com algo como:

     mkdir -p ~/gems
    export GEM_HOME=~/gems
    

    Você apenas terá que se lembrar de fazer isso sempre que abrir uma nova guia do terminal.
• Se você receber um erro sobre a falta bundler , então seu sistema operacional provavelmente não o instalou junto com o Ruby. Você pode executar gem install bundler para obtê-lo.

Uso

REPL:

bin/natalie

Execute um script Ruby:

bin/natalie examples/hello.rb

Compile um arquivo em um executável:

bin/natalie -c hello examples/hello.rb
./hello

Usando com Docker

 docker build -t natalie .                                            # build image
docker run -it --rm natalie                                          # repl
docker run -it --rm natalie -e "p 2 * 3"                             # immediate
docker run -it --rm -v$(pwd)/myfile.rb:/myfile.rb natalie /myfile.rb # execute a local rb file
docker run -it --rm --entrypoint bash natalie                        # bash prompt

Executando testes

Para executar um teste (ou especificação), você pode executá-lo como um script Ruby normal:

bin/natalie spec/core/string/strip_spec.rb

Isso executará os testes e informará se houver alguma falha.

Se quiser executar todos os testes que esperamos passar, você pode executar:

rake test

Por último, se precisar executar alguns testes localmente, você pode usar o script auxiliar test/runner.rb :

bin/natalie test/runner.rb test/natalie/if_test.rb test/natalie/loop_test.rb

Qual é a diferença entre os diretórios 'spec/' e 'test/'?

Os arquivos em spec/ vêm do excelente projeto Ruby/spec, que é um repositório de arquivos de teste com curadoria da comunidade que qualquer implementação de Ruby pode usar para comparar sua conformidade com o que o MRI (Matz's Ruby Interpreter) faz. Copiamos as especificações à medida que implementamos a parte da linguagem que elas cobrem.

Tudo em test/ são coisas que escrevemos enquanto trabalhávamos em Natalie. Esses são testes que nos ajudaram a inicializar certas partes da linguagem e/ou não foram cobertos tanto quanto gostaríamos pelas especificações oficiais do Ruby. Usamos isso para complementar as especificações em spec/ .

Direitos autorais e licença

Natalie tem copyright 2023, Tim Morgan e colaboradores. Natalie é licenciada sob a licença MIT; consulte o arquivo LICENSE neste diretório para obter o texto completo.

Algumas partes deste programa são copiadas de outras fontes e os direitos autorais pertencem ao respectivo proprietário. Esses avisos de direitos autorais estão no topo do respectivo arquivo, no mesmo diretório com um nome como LICENSE ou ambos.

arquivo(s)	direitos autorais	licença
benchmark.rb	Gotoken	BSD
bigint.{h,c}	983	Não licenciar
cgi.rb / cgi/*	Wakou Aoyama	BSD
crypt.{h,c}	Os Regentes da Univ. de Cáli.	BSD
delegate.rb	Yukihiro Matsumoto	BSD
dtoa.c	David M. Gay, Lucent Technologies	permissivo personalizado
erb/util.rb	Masatoshi SEKI	BSD
ipaddr.rb	Hajimu Umemoto e Akinori Musha	BSD
find.rb	Kazuki Tsujimoto	BSD
formatter.rb	Yukihiro Matsumoto	BSD
linenoise	S. Sanfilippo e P. Noordhuis	BSD
minicoro.h	Eduardo Bart	MIT
pp.rb	Yukihiro Matsumoto	BSD
prettyprint.rb	Yukihiro Matsumoto	BSD
shellwords.rb	Akinori MUSHA	BSD
spec/*	Motor Yard, Inc.	MIT
uri.rb / uri/*	Akira Yamada	BSD
version.rb	Motor Yard, Inc.	MIT
zlib	Jean-loup Gailly e Mark Adler	licença zlib

Veja cada arquivo acima para obter o texto completo dos direitos autorais e da licença.