tcp-server 1.0.1-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4b24ec50845ec5dac9b5d06a19a27575620319981f812f929e234506c8fbce9d
+  data.tar.gz: 1fd77e294ea65d8a69d04c25c10b829d649cfda9d745baca45389605c918b4f9
+SHA512:
+  metadata.gz: e6c68d68dc1d5f062d3febb563064730680ffe1099358bb6da27238eca58a7f5e6f221f82d9591b0015e0f1252d20fadf2fc2e70098951bc4da50417d070d85e
+  data.tar.gz: e2129c54272cd36c5dbf7aa71d54abc0ed082dcd0cd5ad6f3c267aeb0b2c2b6b8475b4273f8fc8b0927f421fb36db95e8abc006f4120397a711462d574da6949

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Nels Nelson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,123 @@
+# tcp-server-jruby
+
+[![License](https://img.shields.io/badge/license-MIT--2.0-blue.svg?style=flat)][license]
+
+This is a small tcp server for [JRuby].
+
+It is based on the [Netty project].  Netty is written in java, but I wanted to write ruby.
+
+
+## Quick-start
+
+Follow these instructions to get a tcp server echo program running.
+
+
+### Docker
+
+You may run the websocket server in a container.
+
+```sh
+colima start
+docker-compose up
+```
+
+Building the image or running the container:
+
+```sh
+docker build --squash --tag tcp-server-jruby .
+docker run --detach --publish 4000:4000 --name tcp-server-jruby tcp-server-jruby
+```
+
+
+## Manually
+
+If one insists, one may run everything directly with the required dependencies installed.
+
+### Install asdf
+
+The [asdf] CLI tool used to manage multiple runtime versions.
+
+```sh
+git clone https://github.com/asdf-vm/asdf.git "${HOME}/.asdf" --branch release-v0.10.0
+pushd "${HOME}/.asdf"; git fetch origin; popd
+source "${HOME}/.asdf/asdf.sh"; source "${HOME}/.asdf/completions/asdf.bash"
+```
+
+### Install required runtime software
+
+Download and install the latest version of the [Java JDK].
+
+```sh
+asdf plugin add java
+asdf install java openjdk-17.0.2
+```
+
+
+Download and install the latest version of [JRuby].
+
+```sh
+asdf plugin add ruby
+pushd "${HOME}/.asdf/plugins/ruby/ruby-build"; git fetch origin; git pull origin master; popd
+# ~/.asdf/plugins/ruby/bin/list-all
+asdf list all ruby
+asdf install ruby jruby-9.3.4.0
+```
+
+
+Install the project dependencies.
+
+```sh
+bundle install
+```
+
+
+## Run
+
+The entrypoint for the web application service may now be invoked from a command line interface terminal shell.
+
+```sh
+bundle exec ./server.rb
+```
+
+
+## Build the gem
+
+To run linting, unit tests, build the gem file, execute:
+
+```sh
+bundle exec rake
+```
+
+
+## Publish the gem
+
+To publish the gem after first verifying that the built gem works, execute:
+
+```sh
+bundle exec rake verify
+bundle exec rake publish
+```
+
+
+## Clean up gem artifacts
+
+To clean the project, execute:
+
+```sh
+bundle exec rake clean clobber
+```
+
+
+## Project file tree
+
+Here is a bird's-eye view of the project layout.
+
+```sh
+# date && tree
+```
+
+[license]: https://gitlab.com/nelsnelson/tcp-server-jruby/blob/master/LICENSE
+[asdf]: https://asdf-vm.com/
+[Netty project]: https://github.com/netty/netty
+[Java JDK]: https://www.java.com/en/download/
+[JRuby]: https://jruby.org/download

data/Rakefile

@@ -0,0 +1,56 @@
+# encoding: utf-8
+# frozen_string_literal: false
+
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+require 'rake'
+require 'rake/clean'
+
+PROJECT = File.basename(__dir__) unless defined?(PROJECT)
+
+load "#{PROJECT}.gemspec"
+
+CLEAN.add File.join('tmp', '**', '*'), 'tmp'
+CLOBBER.add '*.gem', 'pkg'
+
+task default: %i[package]
+
+desc 'Run the rubocop linter'
+task :lint do
+  system('bundle', 'exec', 'rubocop') or abort
+end
+
+desc 'Run the spec tests'
+task :test do
+  system('bundle', 'exec', 'rspec', '--exclude-pattern', 'spec/verify/**/*_spec.rb') or abort
+end
+task test: :lint
+
+desc 'Explode the gem'
+task :explode do
+  system('jgem', 'install', '--no-document', '--install-dir=tmp', '*.gem')
+end
+task explode: :clean
+
+desc 'Package the gem'
+task :package do
+  system('jgem', 'build')
+end
+task package: %i[clean clobber test]
+
+desc 'Verify the gem'
+task :verify do
+  system('bundle', 'exec', 'rspec', 'spec/verify') or abort
+end
+task verify: :explode
+
+desc 'Publish the gem'
+task :publish do
+  system('jgem', 'push', latest_gem)
+end
+task publish: :verify
+
+def latest_gem
+  `ls -t #{PROJECT}*.gem`.strip.split("\n").first
+end

data/exe/tcp_server

@@ -0,0 +1,17 @@
+#! /usr/bin/env jruby
+
+# encoding: utf-8
+# frozen_string_literal: false
+
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# =begin
+
+# Copyright Nels Nelson 2016-2022 but freely usable (see license)
+
+# =end
+
+require_relative '../lib/server'
+
+Object.new.extend(Server).main