gloss 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: efa5107f463e2776911f8897141a352305c964561f4d64f5002d21ad2f3e25cf
+  data.tar.gz: 0c65ac9ffd1a26ebd10c9e68eeb31e754c19fb22e9afb652e3a659c51b844217
+SHA512:
+  metadata.gz: 48e4df3d238b7b322baff5b7a30ceb037fb0bc2a067ee4318a1e3876f876d2e0a3bdf82e779295c6f76239c0c92f9e7b5e7eab8242384b4a052f610a866e2f15
+  data.tar.gz: c456de971b4ffed42a5a67dbc628dd6bdc793c9eb97a50e9bfc85433121ab634e35b920af8fd4adc64d20f7e600f7628f51179b54cc2f080c163b8688bfbc954

data/.gitignore

@@ -0,0 +1,5 @@
+*.bundle
+*.o
+ext/.shards/
+tmp/
+*.log

data/.gloss.yml

@@ -0,0 +1,3 @@
+---
+frozen_string_literals: true
+src_dir: src

data/.rubocop.yml

@@ -0,0 +1,147 @@
+AllCops:
+  Exclude:
+    - "bin/**/*"
+    - "db/**/*"
+    - "config/**/*"
+    - "node_modules/**/*"
+    - "spec/**/*"
+    - "support/**/*"
+    - "tmp/**/*"
+    - "test/**/*"
+
+# probably don't need this yet - more useful to have them grouped by category/use than alphabetical anyway
+Bundler/OrderedGems:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 100
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+
+Lint/RaiseException:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
+Lint/SuppressedException: # this is sometimes useful in a rails context
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+Metrics/BlockLength:
+  Enabled: false
+Metrics/ClassLength:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Enabled: false
+Metrics/MethodLength:
+  Max: 50
+
+Style/RedundantReturn:
+  Enabled: false
+Style/Documentation:
+  Enabled: false
+Style/StringLiterals:
+  EnforcedStyle: double_quotes # consistency across ts and rb
+Style/ConditionalAssignment:
+  Enabled: false
+Style/EmptyMethod:
+  Enabled: false
+# sometimes it is good to have else with just `nil` in it for clarity eg. it is a return value
+Style/EmptyElse:
+  EnforcedStyle: empty
+Style/HashEachMethods:
+  Enabled: true
+Style/HashTransformKeys:
+  Enabled: true
+Style/HashTransformValues:
+  Enabled: true
+Style/AsciiComments:
+  Enabled: false # Emojis and comments on foreign characters 👌
+Style/FrozenStringLiteralComment:
+  Enabled: false
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+Style/ParallelAssignment:
+  Enabled: false
+Style/ExponentialNotation:
+  Enabled: false
+
+Layout/EmptyLinesAroundAttributeAccessor: # (new in 0.83)
+  Enabled: true
+Lint/BinaryOperatorWithIdenticalOperands: # (new in 0.89)
+  Enabled: true
+Lint/DeprecatedOpenSSLConstant: # (new in 0.84)
+  Enabled: true
+
+Lint/DuplicateElsifCondition: # (new in 0.88)
+  Enabled: true
+Lint/DuplicateRequire: # (new in 0.90)
+  Enabled: true
+Lint/DuplicateRescueException: # (new in 0.89)
+  Enabled: true
+Lint/EmptyConditionalBody: # (new in 0.89)
+  Enabled: true
+Lint/EmptyFile: # (new in 0.90)
+  Enabled: true
+Lint/FloatComparison: # (new in 0.89)
+  Enabled: true
+Lint/MissingSuper: # (new in 0.89)
+  Enabled: true
+Lint/MixedRegexpCaptureTypes: # (new in 0.85)
+  Enabled: true
+Lint/OutOfRangeRegexpRef: # (new in 0.89)
+  Enabled: true
+Lint/SelfAssignment: # (new in 0.89)
+  Enabled: true
+Lint/TopLevelReturnWithArgument: # (new in 0.89)
+  Enabled: true
+Lint/TrailingCommaInAttributeDeclaration: # (new in 0.90)
+  Enabled: true
+Lint/UnreachableLoop: # (new in 0.89)
+  Enabled: true
+Lint/UselessMethodDefinition: # (new in 0.90)
+  Enabled: true
+Style/AccessorGrouping: # (new in 0.87)
+  Enabled: true
+Style/ArrayCoercion: # (new in 0.88)
+  Enabled: true
+Style/BisectedAttrAccessor: # (new in 0.87)
+  Enabled: true
+Style/CaseLikeIf: # (new in 0.88)
+  Enabled: true
+Style/CombinableLoops: # (new in 0.90)
+  Enabled: true
+
+Style/ExplicitBlockArgument: # (new in 0.89)
+  Enabled: true
+Style/GlobalStdStream: # (new in 0.89)
+  Enabled: true
+Style/HashAsLastArrayItem: # (new in 0.88)
+  Enabled: true
+Style/HashLikeCase: # (new in 0.88)
+  Enabled: true
+Style/KeywordParametersOrder: # (new in 0.90)
+  Enabled: true
+Style/OptionalBooleanParameter: # (new in 0.89)
+  Enabled: true
+Style/RedundantAssignment: # (new in 0.87)
+  Enabled: true
+Style/RedundantFetchBlock: # (new in 0.86)
+  Enabled: true
+Style/RedundantFileExtensionInRequire: # (new in 0.88)
+  Enabled: true
+
+Style/RedundantRegexpCharacterClass: # (new in 0.85)
+  Enabled: true
+Style/RedundantRegexpEscape: # (new in 0.85)
+  Enabled: true
+Style/RedundantSelfAssignment: # (new in 0.90)
+  Enabled: true
+Style/SingleArgumentDig: # (new in 0.89)
+  Enabled: true
+Style/SlicingWithRange: # (new in 0.83)
+  Enabled: true
+Style/SoleNestedConditional: # (new in 0.89)
+  Enabled: true
+Style/StringConcatenation: # (new in 0.89)
+  Enabled: true

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+gemspec
+gem "rbs", git: "git@github.com:duderman/rbs.git", branch: "file-open-block"

data/Gemfile.lock

@@ -0,0 +1,112 @@
+GIT
+  remote: git@github.com:duderman/rbs.git
+  revision: cb347ab605c6409d5ad38ba7439b170ed5996fae
+  branch: file-open-block
+  specs:
+    rbs (1.0.0)
+
+PATH
+  remote: .
+  specs:
+    gloss (0.0.1)
+      fast_blank
+      listen
+      steep
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (6.1.0)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    ast (2.4.1)
+    ast_utils (0.3.0)
+      parser (~> 2.4)
+      thor (>= 0.19)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.7)
+    diff-lcs (1.4.4)
+    fast_blank (1.0.0)
+    ffi (1.14.2)
+    i18n (1.8.5)
+      concurrent-ruby (~> 1.0)
+    language_server-protocol (3.15.0.1)
+    listen (3.3.3)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    method_source (1.0.0)
+    minitest (5.14.2)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
+      byebug (~> 11.0)
+      pry (~> 0.13.0)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    rake-compiler (1.1.1)
+      rake
+    rb-fsevent (0.10.4)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    regexp_parser (2.0.0)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.5)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.0)
+      rexml
+      rubocop-ast (>= 1.2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.3.0)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.10.1)
+    steep (0.39.0)
+      activesupport (>= 5.1)
+      ast_utils (~> 0.3.0)
+      language_server-protocol (~> 3.15.0.1)
+      listen (~> 3.0)
+      parser (~> 2.7.0)
+      rainbow (>= 2.2.2, < 4.0)
+      rbs (~> 1.0.0)
+    thor (1.0.1)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (1.7.0)
+    zeitwerk (2.4.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  gloss!
+  pry-byebug
+  rake-compiler
+  rbs!
+  rspec
+  rubocop
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,205 @@
+# Gloss
+
+Gloss is a high-level programming language based on [Ruby](https://github.com/ruby/ruby) and [Crystal](https://github.com/crystal-lang/crystal), which compiles to ruby; its aims are on transparency,
+efficiency, and to enhance ruby's goal of developer happiness and productivity. Some of the features include:
+
+- Type checking, via optional type annotations
+- Compile-time macros
+- Enums
+- Tuples and Named Tuples
+- All ruby files are valid gloss files (a small exceptions for now; workarounds are mostly available)
+- Other syntactic sugar
+
+Coming soon:
+- abstract classes
+
+Maybe on the roadmap:
+- Method overloading
+
+## Examples:
+
+#### Type checking:
+
+```crystal
+class HelloWorld
+  def perform : String
+    str = "Hello world"
+    puts str
+    str
+  end
+end
+
+result : String = HelloWorld.perform # Error => No singleton method `perform` for HelloWorld
+result : Integer = HelloWorld.new.perform # Incompatible assignment => can't assign string to integer
+result : String = HelloWorld.new.perform # OK
+result.length # OK => 11
+```
+
+#### Macros:
+
+```crystal
+# src/lib/http_client.gloss
+
+class HttpClient
+
+  @base_url : String
+
+  def initialize(@base_url); end
+
+  {% for verb in %w[get post put patch delete] %}
+    def {{verb}}(path : String, headers : Hash[untyped, untyped]?, body : Hash[untyped, untyped]?)
+      {% if verb == "get" %}
+        warn "ignoring body #{body} for get request" unless body.nil?
+        # business logic
+      {% elsif %w[post patch put].include? verb %}
+        body : String = body.to_json
+        # business logic
+      {% else %}
+        # delete request business logic
+      {% end %}
+    end
+  {% end %}
+end
+```
+
+compiles to:
+
+```ruby
+# lib/http_client.rb
+# frozen_string_literal: true
+
+class HttpClient
+  # @type ivar base_url: String
+
+  def initialize(base_url)
+    @base_url = base_url
+  end
+
+  def get(path, headers, body)
+    warn "ignoring body #{body} for get request" unless body.nil?
+    # business logic
+  end
+
+  def post(path, headers, body)
+    # @type var body: String
+    body = body.to_json
+    # business logic
+  end
+
+  def put(path, headers, body)
+    # @type var body: String
+    body = body.to_json
+    # business logic
+  end
+
+  def patch(path, headers, body)
+    # @type var body: String
+    body = body.to_json
+    # business logic
+  end
+
+  def delete(path, headers, body)
+    # delete request business logic
+  end
+end
+```
+
+#### Enums:
+
+```crystal
+class Language
+  enum Lang
+    R = "Ruby"
+    C = "Crystal"
+    TS = "TypeScript"
+    P = "Python"
+  end
+  
+  def favourite_language(language : Lang)
+    puts "my favourite language is #{language}"
+  end
+end
+```
+
+#### Tuples + Named Tuples:
+
+Currently, named tuples can only have symbols as keys, and are distinguished from hashes by the use of the post ruby-1.9 syntax `key: value` (for named tuple) vs `:key => value` (for hash) - see example below. **This is liable to change to ensure maximum compatibility with existing ruby code**.
+
+```crystal
+tuple = {"hello", "world"}
+array = ["hello", "world"]
+named_tuple = { hello: "world" }
+hash = { :hello => "world" }
+
+array << "!" # OK
+tuple << "!" # Error
+hash["key"] = "value" # OK
+named_tuple["key"] = "value" # Error
+```
+
+#### Other syntactic suger:
+
+```crystal
+class MyClass
+  def initialize(@var1, @@var2)
+  end
+end
+```
+
+compiles to
+
+```ruby
+class MyClass
+  def initialize(var1, var2)
+    @var1 = var1
+    @var2 = var2
+  end
+end
+```
+
+```crystal
+str = "abc"
+case str
+when "a"
+  "only a"
+when .start_with?("a")
+  "starts with a"
+when String
+  "definitely a string"
+end
+```
+
+compiles to
+
+```ruby
+str = "abc"
+case str
+when "a"
+  "only a"
+when ->(x) { x.start_with?("a") }
+  "starts with a"
+when String
+  "any other string"
+end
+```
+
+## Usage:
+
+```ruby
+# Gemfile
+group :development do
+  gem "gloss"
+end
+```
+
+then
+
+`bundle install`
+
+then
+
+`gloss init # create .gloss.yml config file`
+
+then
+
+`gloss build`