pre_c 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0c9c5773613593a9021040b2b2bf4f6342d082fbdb5367f4eaf4f8d0d4b12833
+  data.tar.gz: 817d1cb42016917f660d137a611577c36a4b5798466a38d647ed2a5940ab8aed
+SHA512:
+  metadata.gz: 7c1d895fdabb8273b7f878fd872bcb9cb731a3211eafccc1f55d1a1c95f3a0dbae3de77956dc32eec6f15e27097dfd66c50877b764d500babd4fc633e491c15b
+  data.tar.gz: 9c1cb7904f8fcd7c2cf7cb5ac5e5e3b69e676bec23fadd5894434b6df4c7d88b4e3e15b81777a8d3f8936712f9644def30427fa365ee162c741e9dda4af6d957

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-12-02
+
+- Initial release

data/README.md

@@ -0,0 +1,50 @@
+# PreC
+
+PreC aims to solve all the problems created by every C successor.
+
+The two main advantages of C are abstraction and simplicity.
+Abstraction means that C code can be easily ported to many different hardware.
+Simplicity means that it is easy to learn C (despite the fact that the language is hard to master), and a compiler for the language can be easily implemented.
+
+The problem with C successors is that they offer many features to ease software development, but it is impossible to add such features without influencing the code design and without making the language more complex.
+Also, it is common for such features to negatively impact runtime performance.
+And many times, such new features are not exactly what you need, since software design requirements are vastly different for each software.
+In the end, each language becomes an API, so having many new languages trying to succeed C became its own problem, since libraries need to be ported and rewritten several times.
+
+The fundamental principle for PreC is that a C successor must be a simpler language, or a language that produces more efficient binaries, or both.
+Anything beyond that is unnecessary bloat.
+Instead of offering ad hoc features that may improve your productivity, the goal is to provide metaprogramming tools that allow you to create the exact features you need for your project.
+If you find that a meta-language is not working for a project, you can keep the generated C code and move to another meta-language without having to rewrite your entire software.
+PreC uses ERB as a meta-programming language on top of C.
+It is named PreC because it compiles ERB code to C before the C code is compiled to binary.
+
+
+## Installation
+
+TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+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.
+
+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).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/pre_c.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/lib/pre_c/meta_code.rb

@@ -0,0 +1,50 @@
+require_relative "template"
+
+module PreC
+  module MetaCode
+    def compile input_path, output_path
+      self.read input_path
+
+      begin
+        File.write(output_path, @output)
+      rescue Errno::ENOENT => e
+        path = File.dirname(output_path)
+        Dir.mkdir(path)
+        File.write(output_path, @output)
+      end
+    end
+
+    def read file_path
+      @templates = []
+
+      erb = ERB.new(File.read(file_path), eoutvar: "@erb_out")
+      erb.result(binding)
+      @templates << @erb_out
+
+      @output = @templates.inject("") do |r, i|
+        if i.is_a? String then
+          r + i
+        else
+          r + read(i.file_path) {i.content}
+        end
+      end
+
+      return @output
+    end
+
+    def partial file_path
+      content = nil
+
+      @templates << @erb_out
+      @erb_out = ""
+
+      if block_given?
+        yield
+        content = @erb_out
+        @erb_out = ""
+      end
+
+      @templates << Template.new(file_path, content)
+    end
+  end
+end

data/lib/pre_c/raw.rb

@@ -0,0 +1,11 @@
+require_relative "meta_code"
+
+module PreC
+  class Raw
+    include MetaCode
+
+    def initialize file_path
+      self.compile file_path, file_path.delete_suffix(".erb")
+    end
+  end
+end

data/lib/pre_c/template.rb

@@ -0,0 +1,10 @@
+module PreC
+  class Template
+    attr_reader :file_path, :content
+
+    def initialize file_path, content
+      @file_path = "#{PreC.path}/template/#{file_path}.erb"
+      @content = content
+    end
+  end
+end

data/lib/pre_c/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PreC
+  VERSION = "0.1.0"
+end

data/lib/pre_c.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "erb"
+
+require_relative "pre_c/meta_code"
+require_relative "pre_c/raw"
+require_relative "pre_c/version"
+
+module PreC
+  class Error < StandardError; end
+
+  Generic = Struct.new('Generic', :classes, :args)
+
+  @@generics = []
+
+  def self.path = @@path
+
+  def self.generic classes, args
+    @@generics << Generic.new(classes, args)
+  end
+
+  def self.pre_compile
+    @@path = Dir.pwd
+
+    @@generics.each do |generic|
+      generic.classes.each {_1.new(@@path, generic.args)}
+    end
+
+    meta_code = Dir["#{path}/src/**/*.erb"]
+    meta_code.each {Raw.new _1}
+  end
+end

data/sig/pre_c.rbs

@@ -0,0 +1,4 @@
+module PreC
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: pre_c
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Frederico Linhares
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: erb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+email:
+- fred@linhares.blue
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- Rakefile
+- lib/pre_c.rb
+- lib/pre_c/meta_code.rb
+- lib/pre_c/raw.rb
+- lib/pre_c/template.rb
+- lib/pre_c/version.rb
+- sig/pre_c.rbs
+homepage: https://gitlab.com/fredlinhares/pre_c
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://gitlab.com/fredlinhares/pre_c
+  source_code_uri: https://gitlab.com/fredlinhares/pre_c
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A metaprogramming tool for low-level languages such as C and Assembly.
+test_files: []