newscast 1.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8ecb966380bc32d55480f8d0415c071a03578381
+  data.tar.gz: 20c3742e4bd41f188a323a21f23605613610a477
+SHA512:
+  metadata.gz: 814d7a15c7abd29cb545602f008aad5ddaf282548255e703f78ac9578e15ae64a982babbbf38492e4c846c0af0f33916489e72cadb3213d9282ad0ce6c831820
+  data.tar.gz: 6fec147ef395ad06ae6cbb671c06e48d4e0049544304b3454c48b63f4b99d25df06309a387feba326201d879e58da84b052106bdcfa22a182209a3ee18c2f6a8

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+
+### 0.0.1 / 2020-02-04
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,8 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+lib/newscast.rb
+lib/newscast/version.rb
+test/helper.rb
+test/test_queries.rb

data/README.md

@@ -0,0 +1,249 @@
+# newscast gem - newsreader for easy (re)use - build your own facebook newsfeed in 1-2-3 steps in 5 minutes
+
+
+* home  :: [github.com/feedreader/pluto](https://github.com/feedreader/pluto)
+* bugs  :: [github.com/feedreader/pluto/issues](https://github.com/feedreader/pluto/issues)
+* gem   :: [rubygems.org/gems/newscast](https://rubygems.org/gems/newscast)
+* rdoc  :: [rubydoc.info/gems/newscast](http://rubydoc.info/gems/newscast)
+* forum :: [groups.google.com/group/wwwmake](http://groups.google.com/group/wwwmake)
+
+
+
+## Usage
+
+The `News` module offers easy to (re)use "porcelain" helpers / methods
+that hide the "plumbing" for building your own newsreader or newsfeeds in minutes.
+
+
+### Step 1 - Subscribe
+
+Use the `News.subscribe( *feeds )` method to subscribe to news feeds / channels.
+Example:
+
+```ruby
+News.subscribe(
+  'http://www.ruby-lang.org/en/feeds/news.rss',     # Ruby Lang News
+  'http://www.jruby.org/atom.xml',                  # JRuby Lang News
+  'http://blog.rubygems.org/atom.xml',              # RubyGems News
+  'http://bundler.io/blog/feed.xml',                # Bundler News
+  'http://weblog.rubyonrails.org/feed/atom.xml',    # Ruby on Rails News
+  'http://sinatrarb.com/feed.xml',                  # Sinatra News
+  'https://hanamirb.org/atom.xml',                  # Hanami News
+  'http://jekyllrb.com/feed.xml',                   # Jekyll News
+  'http://feeds.feedburner.com/jetbrains_rubymine?format=xml',  # RubyMine IDE News
+  'https://blog.phusion.nl/rss/',                   # Phusion News
+  'https://rubyinstaller.org/feed.xml',             # Ruby Installer for Windows News
+  'http://planetruby.github.io/calendar/feed.xml',  # Ruby Conferences & Camps News
+  'https://rubytogether.org/news.xml',              # Ruby Together News
+  'https://foundation.travis-ci.org/feed.xml',      # Travis Foundation News
+  'https://railsgirlssummerofcode.org/blog.xml',    # Rails Girls Summer of Code News
+
+  'http://blog.zenspider.com/atom.xml',          # Ryan Davis @ Seattle › Washington › United States
+  'http://tenderlovemaking.com/atom.xml',        # Aaron Patterson @ Seattle › Washington › United States
+  'http://blog.headius.com/feed.xml',            # Charles Nutter @ Richfield › Minnesota › United States
+  'http://www.schneems.com/feed.xml',            # Richard Schneeman @ Austin › Texas › United States
+  'https://eregon.me/blog/feed.xml',             # Benoit Daloze @ Zurich › Switzerland
+  'http://samsaffron.com/posts.rss',             # Sam Saffron @ Sydney › Australia
+  )
+```
+
+
+Note: If you call `News.subscribe` the method will setup a single-file SQLite database,
+that is, `./news.db` and auto-migrate the schema, that is, database tables and so on.
+
+
+### Step 2 - Update
+
+Use the `News.update` method to fetch from the internets all news feeds / channels
+and update the `./news.db` database. Example:
+
+```ruby
+News.update
+```
+
+
+
+### Step 3 - Query and Remix the News Items
+
+Profit!  Now you can query the `./news.db` database with any of the many
+pre-made / ready-to-use query helpers. Example:
+
+``` ruby
+puts ":::::::::::::::::::::::::::::::::::::::::::::::::::"
+puts ":: #{News.items.count} news items from #{News.channels.count} channels:"
+puts
+```
+
+resulting in:
+
+```
+:::::::::::::::::::::::::::::::::::::::::::::::::::
+:: 793 news items from 21 channels:
+```
+
+and
+
+``` ruby
+puts "100 Latest News Items"
+News.latest.limit( 100 ).each do |item|
+  print "%4dd " % (Date.today.jd-item.updated.to_date.jd)
+  print "  #{item.updated}"
+  print " - #{item.title}"
+  print " - #{URI(item.feed.feed_url).host}"
+  print "\n"
+end
+```
+
+resulting in:
+
+```
+100 Latest News Items
+   0d   2020-02-04 00:00:00 - RubyNess @ Inverness, Scotland, United Kingdom - planetruby.github.io
+   0d   2020-02-04 00:00:00 - Ruby by the Bay (Ruby for Good, West Coast Edition) @ Marin Headlands (near San Francisco), California, United States - planetruby.github.io
+   8d   2020-01-27 14:44:38 - RubyMine 2020.1 EAP is Open!  - jetbrains.com
+  11d   2020-01-24 00:00:00 - Crowdfunding for 2020 scholarships has commenced - railsgirlssummerofcode.org
+  15d   2020-01-20 00:00:00 - Alumni Interview with Keziah Naggita - railsgirlssummerofcode.org
+  16d   2020-01-19 00:00:00 - This week in Rails - Rack 2.1 released, disallowed deprecations, and more! - weblog.rubyonrails.org
+  19d   2020-01-16 00:00:00 - RubyConf Belarus (BY) @ Minsk, Belarus - planetruby.github.io
+  22d   2020-01-13 14:00:39 - Guide to String Encoding in Ruby - tenderlovemaking.com
+  23d   2020-01-12 23:00:00 - A Migration Path to Bundler 2+ - eregon.me
+  24d   2020-01-11 00:00:00 - This week in Rails - Deprecations, bugfixes and improvements! - weblog.rubyonrails.org
+  30d   2020-01-05 00:00:00 - This week in Rails - The 2019 edition - weblog.rubyonrails.org
+  30d   2020-01-05 00:00:00 - RubyInstaller 2.7.0-1 released - rubyinstaller.org
+  32d   2020-01-03 00:00:00 - Submit Your Open Source Projects - railsgirlssummerofcode.org
+  34d   2020-01-01 00:00:00 - Happy new year & Sinatra 2.0.8! - sinatrarb.com
+  39d   2019-12-27 00:00:00 - Ruby 2.7.0, Rails 6.0.2.1 and more - weblog.rubyonrails.org
+  41d   2019-12-25 00:00:00 - Ruby 2.7.0 Released - ruby-lang.org
+  ...
+```
+
+More queries include:
+
+``` ruby
+News.today
+
+News.week
+News.week( 1 )
+News.week( 1, 2019 )
+
+News.month
+News.month( 1 )
+News.month( 1, 2019 )
+
+News.year
+News.year( 2019 )
+
+News.this_week
+News.this_month
+News.this_year
+
+News.q1
+News.q2
+News.q3
+News.q4
+```
+
+and some more.
+
+
+
+### All Together Now - Let's Build A Newsfeed in 20 Lines
+
+```ruby
+require 'newscast'
+
+# step 1) subscribe to a list of news feeds / channels
+
+News.subscribe(
+  'http://www.ruby-lang.org/en/feeds/news.rss',     # Ruby Lang News
+  'http://www.jruby.org/atom.xml',                  # JRuby Lang News
+  'http://blog.rubygems.org/atom.xml',              # RubyGems News
+  'http://bundler.io/blog/feed.xml',                # Bundler News
+  'http://weblog.rubyonrails.org/feed/atom.xml',    # Ruby on Rails News
+  'http://sinatrarb.com/feed.xml',                  # Sinatra News
+  'https://hanamirb.org/atom.xml',                  # Hanami News
+  'http://jekyllrb.com/feed.xml',                   # Jekyll News
+  'http://feeds.feedburner.com/jetbrains_rubymine?format=xml',  # RubyMine IDE News
+  'https://blog.phusion.nl/rss/',                   # Phusion News
+  'https://rubyinstaller.org/feed.xml',             # Ruby Installer for Windows News
+  'http://planetruby.github.io/calendar/feed.xml',  # Ruby Conferences & Camps News
+  'https://rubytogether.org/news.xml',              # Ruby Together News
+  'https://foundation.travis-ci.org/feed.xml',      # Travis Foundation News
+  'https://railsgirlssummerofcode.org/blog.xml',    # Rails Girls Summer of Code News
+
+  'http://blog.zenspider.com/atom.xml',          # Ryan Davis @ Seattle › Washington › United States
+  'http://tenderlovemaking.com/atom.xml',        # Aaron Patterson @ Seattle › Washington › United States
+  'http://blog.headius.com/feed.xml',            # Charles Nutter @ Richfield › Minnesota › United States
+  'http://www.schneems.com/feed.xml',            # Richard Schneeman @ Austin › Texas › United States
+  'https://eregon.me/blog/feed.xml',             # Benoit Daloze @ Zurich › Switzerland
+  'http://samsaffron.com/posts.rss',             # Sam Saffron @ Sydney › Australia
+  )
+
+
+# step 2) fetch and update news feeds / channels
+
+News.update
+
+
+# step 3) mix up all news items in a new page
+
+puts News.render( <<TXT )
+  <% News.latest.limit(100).each do |item| %>
+    <div class="item">
+      <h2><a href="<%= item.url %>"><%= item.title %></a></h2>
+      <div><%= item.content %></div>
+    </div>
+  <% end %>
+TXT
+```
+
+resulting in:
+
+``` html
+<div class="item">
+  <h2><a href="http://planetruby.github.io/calendar/2020#rubyness">RubyNess @ Inverness,
+    Scotland, United Kingdom - Ruby Conferences 'n' Camps Update</a></h2>
+  <div><p>What's News? What's Upcoming in 2020?</p>
+   <p>
+     <b><a href="https://rubyness.org/" id="rubyness">RubyNess</a></b><br>
+     Jul/16+17 (2d) Thu+Fri @ Inverness, Scotland, United Kingdom •
+     <a href="https://twitter.com/rubynessconf" title="@rubynessconf">(Updates)</a>
+   </p>
+   <p>
+   See all <a href="http://planetruby.github.io/calendar/2020">Conferences 'n' Camps in 2020»</a>.
+  </p></div>
+</div>
+
+<div class="item">
+  <h2><a href="http://feedproxy.google.com/~r/jetbrains_rubymine/~3/DiNxpQHKHrk/">RubyMine
+    2020.1 EAP is Open!</a></h2>
+  <div><p>Hello everyone,</p>
+    <p>Today we are happy to announce the opening of the Early Access Program (EAP)
+       for RubyMine 2020.1! You can get EAP builds...
+    </p>
+    <p>Happy Developing!<br>
+     Your RubyMine team
+    </p></div>
+  </div>
+...
+```
+
+
+
+## More
+
+- [news.rb quick starter script](https://github.com/feedreader/news.rb) - build your own facebook newsfeed in 1-2-3 steps in 5 minutes
+
+
+
+## License
+
+![](https://publicdomainworks.github.io/buttons/zero88x31.png)
+
+The `newscast` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+## Questions? Comments?
+
+Send them along to the [wwwmake Forum/Mailing List](http://groups.google.com/group/wwwmake).
+Thanks!

data/Rakefile

@@ -0,0 +1,32 @@
+require 'hoe'
+require './lib/newscast/version.rb'
+
+Hoe.spec 'newscast' do
+
+  self.version = Newscast::VERSION
+
+  self.summary = "newscast - newsreader for easy (re)use - build your own facebook newsfeed in 1-2-3 steps in 5 minutes"
+  self.description = summary
+
+  self.urls    = ['https://github.com/feedreader/pluto']
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['pluto-models', '>= 1.6.1'],
+    ['pluto-update', '>= 1.6.3'],
+    ['sqlite3'],     # note: for easy installation include sqlite database library
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.2.2'
+  }
+
+end

data/lib/newscast.rb

@@ -0,0 +1,358 @@
+
+require 'pluto/update'
+
+
+## todo/fix: include stdlibs in pluto/update or pluto/models upstream!!!
+require 'date'
+require 'time'
+require 'cgi'
+require 'uri'
+require 'digest'
+require 'yaml'    ## check - already included upstream?
+require 'json'    ## check - already included upstream?
+
+require 'erb'
+require 'ostruct'
+
+
+
+class Date
+  ## def quarter() 1+(self.month-1)/3; end
+
+  def quarter
+    case self.month
+    when 1,2,3    then 1
+    when 4,5,6    then 2
+    when 7,8,9    then 3
+    when 10,11,12 then 4
+    end
+  end
+end
+
+# -- for testing:
+# (1..12).each do |num|
+#   puts "#{num} -> #{Date.new(2020,num,1).quarter}"
+# end
+# -- prints:
+#   1 -> 1
+#   2 -> 1
+#   3 -> 1
+#   4 -> 2
+#   5 -> 2
+#   6 -> 2
+#   7 -> 3
+#   8 -> 3
+#   9 -> 3
+#  10 -> 4
+#  11 -> 4
+#  12 -> 4
+
+
+
+## our own code
+require 'newscast/version'
+
+
+
+module News
+
+  ##
+  ## todo/check: allow (add) site = nil for no site "filter" (all items / feeds) - why? why not?
+  def self.site=(value)  @site   = value;  end
+  def self.site()        @site ||= 'news'; end   ## note: defaults to news
+
+
+####
+# helpers
+
+  def self.autogen_feed_key( feed_url )
+    ## note:
+    ##   use a "fingerprint" hash digest as key
+    ##     do NOT include scheme (e.g. https or http)
+    ##     do NOT include port
+    ##   so you can change it without "breaking" the key - why? why not?
+    ##
+    ##  e.g.   u = URI( 'https://example.com:333/a/b?f=xml'
+    ##          u.host+u.request_uri
+    ##         #=> example.com/a/b?f=xml
+    uri = URI( feed_url )
+    ## note: add host in "plain" text - making errors and the key more readable
+    ## note: cut-off www. if leading e.g. www.ruby-lang.org => ruby-lang.org
+    host = uri.host.downcase.sub( /^www\./, '' )
+    #   use a differt separator e.g _ or ~ and NOT $ - why? why not?
+    key = "#{host}$#{Digest::MD5.hexdigest( uri.request_uri )}"
+    key
+  end
+
+  def self.norm_feed_hash( old_h )   ## todo/check: rename to normalize/unify_feeds or resolve_feedlist or something?
+    ## unify feed list entries
+    ## case 1) if section name is some thing like [Andrew Kane]
+    ##           and  NO title/name key than assume it's the title/name
+    ##           and auto-generated key/id
+
+    ## move all "global" settings to [planet] section - why? why not?
+    ##  e.g.
+    ##   title = Planet Open Data News
+    ##  becomes
+    ##   [planet]
+    ##     title = Planet Open Data News
+
+    h = {}
+    old_h.each do |k,v|
+       if    v.is_a?( String )
+          h[ k ] = v   ## pass along as-is (assume "top-level" / global setting)
+       elsif v.is_a?( Hash )
+          ## puts "#{k}:"
+          ## pp v
+          ## todo/fix: use "proper" ident e.g. allow 0-9 and .-_ too? why? why not?
+          if k =~ /^[a-z_][a-z0-9$_.]*$/   ## all lower case; assume id - add 0-9 and .-_ - why? why not?
+            h[ k ] = v
+          else
+             ## puts "bingo! section name shortcut - #{k}"
+             if k.start_with?( 'http' )
+                if v.has_key?( 'feed' ) then raise ArgumentError.new( "duplicate >feed< hash table entry in section >#{k}<; cannot autogen key" );  end
+
+                new_k = autogen_feed_key( k )
+                # note: use merge - why? why not? to NOT overwrite existing entry - why? why not?
+                h[ new_k ]  = { 'feed' => k }.merge( v )
+             else
+                ## transform key to title and auto-generate id (new key)
+                if v.has_key?( 'title' ) || v.has_key?( 'name' ) then raise ArgumentError.new( "duplicate >name< or >title< hash table entry in section >#{k}<; cannot autogen key" );  end
+                if v.has_key?( 'feed' ) == false                 then raise ArgumentError.new( "expected / required >feed< hash table entry missing for section >#{k}<");  end
+
+                new_k = autogen_feed_key( v['feed'] )
+                # note: use merge - why? why not? to NOT overwrite existing entry - why? why not?
+                h[ new_k ]  = { 'title' => k }.merge( v )
+             end
+          end
+       else
+         raise ArgumentError.new( "expected String or Hash for value (in hash table) but got >#{v.class.name}< for key >#{k}<" )
+       end
+    end
+
+    ## todo/check - auto-add required (?) missing title if missing - why? why not?
+    h['title'] = 'Untitled'   if h.has_key?( 'title' ) == false
+
+    h
+  end
+
+
+  def self.subscribe( *feeds )
+
+    site_hash =   if feeds.size == 1 && feeds[0].is_a?( Hash )
+                     ## puts "bingo!  it's a hash"
+                     norm_feed_hash( feeds[0] )
+                  elsif feeds.size == 1 && feeds[0].is_a?( String ) && feeds[0] =~ /\n/
+                     ## string includes newline (e.g. more than a single line?)
+                     ## if yes, parse and assume ini (config) format
+                     norm_feed_hash( INI.load( feeds[0] ))
+                  else   ## assume list / array of strings (feed_urls)
+                     ## puts "bingo! it's a string list"
+                     ##   auto-build a (simple) site hash
+                     feeds.reduce( {        ## note: keys are strings (NOT symbols) for now
+                                      'title' => 'Untitled'
+                                      ## todo/check: remove title? required? check in model update if missing?
+                                    } ) do |h, feed|
+                                         key = autogen_feed_key( feed )
+
+                                         h[ key ] = { 'feed'  => feed }
+                                         h
+                                        end
+                  end
+
+    connection   ## make sure we have a database connection (and setup) up-and-running
+    ## note: always use "multi-site" setup; defaults to 'news' site key
+    Pluto::Model::Site.deep_create_or_update_from_hash!( site, site_hash )
+  end
+
+  def self.update
+    connection   ## make sure we have a database connection (and setup) up-and-running
+    Pluto.update_feeds
+  end
+  def self.refresh() update; end    ## convenience alias for update
+
+
+
+  def self.feeds
+    connection
+    ## note: always use "multi-site" setup; defaults to 'news' site key
+    ## note: add "default" scope - orders (sorts) by latest / time
+    rec = Pluto::Model::Site.where(key: site).first
+    if rec.nil?
+      Pluto::Model::Feed.none     ## use null (relation) pattern to avoid crash on nil - why? why not?
+    else
+      rec.feeds.order(
+        Arel.sql( "coalesce(feeds.updated,feeds.published,'1970-01-01') desc" )
+      )
+    end
+  end
+  def self.channels()  feeds; end   ## convenience alias for feeds
+
+
+  def self.items
+    connection    ## make sure we have a database connection (and setup) up-and-running
+    ## note: always use "multi-site" setup; defaults to 'news' site key
+    ## note: add "default" scope - orders (sorts) by latest / time
+    rec = Pluto::Model::Site.where(key: site).first
+    if rec.nil?
+      Pluto::Model::Item.none    ## use null (relation) pattern to avoid crash on nil - why? why not?
+    else
+      rec.items.order(
+        Arel.sql( "coalesce(items.updated,items.published,'1970-01-01') desc" )
+      )
+    end
+  end
+  def self.latest()    items; end   ## note: "default" scope orders (sorts) by latest / time
+
+
+  def self.today
+      ## todo: order by time!! - possible - why? why not?
+      ## note: use date() to cut-off hours etc. if present?
+
+      q = Date.today.strftime('%Y-%m-%d')   # e.g. 2020-02-20
+      items.
+        where(
+          Arel.sql( "date(coalesce(items.updated,items.published)) = '#{q}'" )
+        )
+  end
+
+
+  def self.between( start_date, end_date )   ## helper for week, q1, q2, etc.
+    q_start = start_date.strftime('%Y-%m-%d')
+    q_end   = end_date.strftime('%Y-%m-%d')
+
+    items.
+      where(
+        Arel.sql( "date(coalesce(items.updated,items.published,'1970-01-01')) BETWEEN '#{q_start}' AND '#{q_end}'" )
+      )
+  end
+
+  def self.week( week=Date.today.cweek, year=Date.today.year )
+    ## note: SQLite only supports "classic" week of year (not ISO "commercial week" starting on monday - and not on sunday)
+    ## %W - week of year: 00-53
+    ## thus, needs to calculate start and end date!!!
+
+    start_date = Date.commercial(year, week, 1)
+    end_date   = Date.commercial(year, week, 7)
+
+    between( start_date, end_date )
+  end
+
+  def self.month( month=Date.today.month, year=Date.today.year )
+    q = "%4d-%02d" % [year,month]     # e.g. 2020-01 etc.
+    items.
+      where(
+        Arel.sql( "strftime('%Y-%m', coalesce(items.updated,items.published,'1970-01-01')) = '#{q}'" )
+      )
+  end
+
+  def self.quarter( quarter=Date.today.quarter, year=Date.today.year )
+    case quarter
+    when 1 then between( Date.new( year,  1, 1), Date.new( year, 3, 31) );
+    when 2 then between( Date.new( year,  4, 1), Date.new( year, 6, 30) );
+    when 3 then between( Date.new( year,  7, 1), Date.new( year, 9, 30) );
+    when 4 then between( Date.new( year, 10, 1), Date.new( year,12, 31) );
+    else  raise ArgumentError
+    end
+  end
+
+  def self.quarter1( year=Date.today.year ) quarter(1, year); end
+  def self.quarter2( year=Date.today.year ) quarter(2, year); end
+  def self.quarter3( year=Date.today.year ) quarter(3, year); end
+  def self.quarter4( year=Date.today.year ) quarter(4, year); end
+
+  def self.q( quarter=Date.today.quarter, year=Date.today.year ) quarter( quarter, year ); end
+  def self.q1( year=Date.today.year ) quarter1( year ); end
+  def self.q2( year=Date.today.year ) quarter2( year ); end
+  def self.q3( year=Date.today.year ) quarter3( year ); end
+  def self.q4( year=Date.today.year ) quarter4( year ); end
+
+
+  def self.year( year=Date.today.year )
+    q = year
+    items.
+      where(
+        Arel.sql( "strftime('%Y', coalesce(items.updated,items.published,'1970-01-01')) = '#{q}'" )
+      )
+  end
+
+
+
+
+  def self.this_week()    week;    end   ## convenience alias - keep - why? why not?
+  def self.this_month()   month;   end
+  def self.this_quarter() quarter; end
+  def self.this_year()    year;    end
+
+
+
+  class Template
+    class Context < OpenStruct
+      ## use a different name - why? why not?
+      ##  e.g. to_h, to_hash, vars, locals, assigns, etc.
+      def get_binding() binding; end
+
+      ## add builtin helpers / shortcuts
+      def h( text ) CGI.escapeHTML( text ); end
+    end # class Template::Context
+
+
+    def initialize( text )
+      @template = ERB.new( text )
+    end
+
+    ## todo: use locals / assigns or something instead of **kwargs - why? why not?
+    ##        allow/support (extra) locals / assigns - why? why not?
+    def render( **kwargs )
+      ## note: Ruby >= 2.5 has ERB#result_with_hash - use later - why? why not?
+      @template.result( Context.new( **kwargs ).get_binding )
+    end
+  end # class Template
+
+  def self.render( text, **kwargs )
+    template = Template.new( text )
+    template.render( **kwargs )
+  end
+
+
+
+
+  class Configuration
+     def database=(value) @database = value;  end
+     def database()       @database || { adapter: 'sqlite3', database: './news.db' }; end
+  end # class Configuration
+
+  def self.configure
+    yield( config )
+  end
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+
+  class Connection
+    def initialize    # convenience shortcut w/ automigrate
+      config = if News.config.database.is_a?(Hash)
+                    News.config.database
+               else  ## assume a string (e.g. :memory:, or <path> AND sqlite3 adapter)
+                    { adapter: 'sqlite3', database: News.config.database }
+               end
+
+      Pluto.connect( config )
+      Pluto.auto_migrate!
+    end
+  end  # class Connection
+
+  def self.connection     ## use for "auto-magic" connection w/ automigrate
+    ##  todo/fix: check - "just simply" return ActiveRecord connection - possible - why? why not?
+    ##                       do NOT use our own Connection class
+    @connection ||= Connection.new
+  end
+end  # module News
+
+
+
+
+# say hello
+puts Newscast.banner   if $DEBUG || (defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG)

data/lib/newscast/version.rb

@@ -0,0 +1,22 @@
+
+module Newscast
+
+    MAJOR = 1
+    MINOR = 1
+    PATCH = 1
+    VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+    def self.version
+      VERSION
+    end
+
+    def self.banner
+      ### todo: add RUBY_PATCHLEVEL or RUBY_PATCH_LEVEL  e.g. -p124
+      "newscast/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+    end
+
+    def self.root
+      "#{File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )}"
+    end
+
+end # module Newscast

data/test/helper.rb

@@ -0,0 +1,10 @@
+## minitest setup
+require 'minitest/autorun'
+
+## our own code
+require 'newscast'
+
+
+Pluto.config.debug        = true
+Pluto.config.logger.level = :debug
+

data/test/test_queries.rb

@@ -0,0 +1,94 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_queries.rb
+
+
+require 'helper'
+
+class TestQueries < MiniTest::Test
+
+  def test_queries   
+    puts News.channels.to_sql
+    puts News.feeds.to_sql
+    
+    puts News.items.to_sql
+    
+
+    puts News.latest.limit( 2 ).to_sql
+    puts News.today.to_sql
+    
+    puts News.week.to_sql
+    puts News.week( 1 ).to_sql
+    puts News.week( 1, 2019 ).to_sql
+    
+    puts News.month.to_sql
+    puts News.month( 1 ).to_sql
+    puts News.month( 1, 2019 ).to_sql
+    
+    puts News.year.to_sql
+    puts News.year( 2019 ).to_sql
+    
+    puts News.this_week.to_sql
+    puts News.this_month.to_sql
+    puts News.this_quarter.to_sql
+    puts News.this_year.to_sql
+ 
+    
+    puts News.quarter.to_sql
+    puts News.q.to_sql
+
+    puts News.quarter( 1 ).to_sql
+    puts News.quarter( 2 ).to_sql
+    puts News.quarter( 3 ).to_sql
+    puts News.quarter( 4 ).to_sql
+    puts News.quarter1.to_sql
+    puts News.quarter2.to_sql
+    puts News.quarter3.to_sql
+    puts News.quarter4.to_sql
+
+    puts News.q( 1 ).to_sql
+    puts News.q( 2 ).to_sql
+    puts News.q( 3 ).to_sql
+    puts News.q( 4 ).to_sql
+    puts News.q1.to_sql
+    puts News.q2.to_sql
+    puts News.q3.to_sql
+    puts News.q4.to_sql
+    puts News.q( 1, 2019 ).to_sql
+    puts News.q( 2, 2019 ).to_sql
+    puts News.q( 3, 2019 ).to_sql
+    puts News.q( 4, 2019 ).to_sql
+    puts News.q1( 2019 ).to_sql
+    puts News.q2( 2019 ).to_sql
+    puts News.q3( 2019 ).to_sql
+    puts News.q4( 2019 ).to_sql
+    
+    
+    ###### run queries
+    pp News.latest.limit( 2 ).to_a
+    pp News.today.to_a
+    
+    pp News.week.to_a
+    pp News.week( 1 ).to_a
+    pp News.week( 1, 2019 ).to_a
+    
+    pp News.month.to_a
+    pp News.month( 1 ).to_a
+    pp News.month( 1, 2019 ).to_a
+    
+    pp News.year.to_a
+    pp News.year( 2019 ).to_a
+    
+    pp News.this_week.to_a
+    pp News.this_month.to_a
+    pp News.this_year.to_a
+    
+    pp News.q1.to_a
+    pp News.q2.to_a
+    pp News.q3.to_a
+    pp News.q4.to_a
+    
+    assert true    
+  end
+
+end  # class TestQueries

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: newscast
+version: !ruby/object:Gem::Version
+  version: 1.1.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pluto-models
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+- !ruby/object:Gem::Dependency
+  name: pluto-update
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+description: newscast - newsreader for easy (re)use - build your own facebook newsfeed
+  in 1-2-3 steps in 5 minutes
+email: wwwmake@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/newscast.rb
+- lib/newscast/version.rb
+- test/helper.rb
+- test/test_queries.rb
+homepage: https://github.com/feedreader/pluto
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: newscast - newsreader for easy (re)use - build your own facebook newsfeed
+  in 1-2-3 steps in 5 minutes
+test_files: []