rss_feed_plus 0.1.0

data/rss_example/prog.xml

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <title>FYI Center for Software Developers</title>
+  <subtitle>FYI (For Your Information) Center for Software Developers with
+    large collection of FAQs, tutorials and tips codes for application and
+    wWeb developers on Java, .NET, C, PHP, JavaScript, XML, HTML, CSS, RSS,
+    MySQL and Oracle - dev.fyicenter.com.</subtitle>
+  <link rel="self" href="http://dev.fyicenter.com/atom_xml.php"/>
+  <id>http://dev.fyicenter.com/atom_xml.php</id>
+  <updated>2017-09-22T03:58:52+02:00</updated>
+  <author>
+    <name>FYIcenter.com</name>
+  </author>
+  <rights>Copyright (c) 2017 FYIcenter.com</rights>
+  <category term="Programming"/>
+  <category term="Computer"/>
+  <category term="Developer"/>
+  <entry>
+    <title>Use Developer Portal Internally</title>
+    <link rel="alternate"
+          href="http://dev.fyicenter.com/1000702_Use_Developer_Portal_Internally.ht
+ml"/>
+
+    <id>http://dev.fyicenter.com/1000702_Use_Developer_Portal_Internally.html
+    </id>
+    <updated>2017-09-20T13:29:08+02:00</updated>
+    <summary type="html">&lt;img align='left' width='64' height='64'
+      src='http://dev.fyicenter.com/Azure-API/_icon_Azure-API.png' />How to
+      use the Developer Portal internally by you as the publisher? Normally,
+      the Developer Portal of an Azure API Management Service is used by
+      client developers. But as a publisher, you can also use the Developer
+      Portal to test API operations internally. You can follow this tutorial
+      to access the ...  - Rank: 120; Updated: 2017-09-20 13:29:06 -> &lt;a
+      href='http://dev.fyicenter.com/1000702_Use_Developer_Portal_Internally.ht
+      ml'>Source&lt;/a></summary>
+    <author>
+      <name>FYIcenter.com</name>
+    </author>
+    <category term="Microsoft"/>
+  </entry>
+  <entry>
+    <title>Using Azure API Management Developer Portal</title>
+    <link rel="alternate"
+          href="http://dev.fyicenter.com/1000701_Using_Azure_API_Management_Develop
+er_Portal.html"/>
+
+    <id>http://dev.fyicenter.com/1000701_Using_Azure_API_Management_Developer
+      _Portal.html</id>
+    <updated>2017-09-20T13:29:07+02:00</updated>
+    <summary type="html">&lt;img align='left' width='64' height='64'
+      src='http://dev.fyicenter.com/Azure-API/_icon_Azure-API.png' />Where to
+      find tutorials on Using Azure API Management Developer Portal? Here is
+      a list of tutorials to answer many frequently asked questions compiled
+      by FYIcenter.com team on Using Azure API Management Developer Portal:
+      Use Developer Portal Internally What Can I See on Developer Portal What
+      I You T...  - Rank: 120; Updated: 2017-09-20 13:29:06 -> &lt;a
+      href='http://dev.fyicenter.com/1000701_Using_Azure_API_Management_Develop
+      er_Portal.html'>Source&lt;/a></summary>
+    <author>
+      <name>FYIcenter.com</name>
+    </author>
+    <category term="Microsoft"/>
+  </entry>
+  <entry>
+    <title>Add API to API Products</title>
+    <link rel="alternate"
+          href="http://dev.fyicenter.com/1000700_Add_API_to_API_Products.html"/>
+    <id>http://dev.fyicenter.com/1000700_Add_API_to_API_Products.html</id>
+    <updated>2017-09-20T13:29:06+02:00</updated>
+    <summary type="html">&lt;img align='left' width='64' height='64'
+      src='http://dev.fyicenter.com/Azure-API/_icon_Azure-API.png' />How to
+      add an API to an API product for internal testing on the Publisher
+      Portal of an Azure API Management Service? You can follow this tutorial
+      to add an API to an API product on the Publisher Portal of an Azure API
+      Management Service. 1. Click API from the left menu on the Publisher
+      Portal. You s...  - Rank: 119; Updated: 2017-09-20 13:29:06 -> &lt;a
+      href='http://dev.fyicenter.com/1000700_Add_API_to_API_Products.html'>Sour
+      ce&lt;/a></summary>
+    <author>
+      <name>FYIcenter.com</name>
+    </author>
+    <category term="Microsoft"/>
+  </entry>
+</feed>

data/rss_feed.gemspec

@@ -0,0 +1,47 @@
+require_relative 'lib/rss_feed/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'rss_feed_plus'
+  spec.version = RssFeed::VERSION
+  spec.authors = ['talaatmagdyx']
+  spec.email = ['talaatmagdy75@gmail.com']
+
+  spec.summary = 'A simple RSS parser gem for Ruby'
+  spec.description = <<-DESC
+    #{spec.name} is a Ruby gem designed to simplify the process of parsing RSS feed in Ruby applications.#{' '}
+    It provides a straightforward interface for fetching RSS feed from URLs and extracting relevant information#{' '}
+    such as titles, links, descriptions, publication dates, and authors.#{' '}
+    With #{spec.name}, you can quickly integrate RSS feed parsing functionality into your Ruby projects,#{' '}
+    making it easy to work with syndicated content from various sources.
+  DESC
+  spec.homepage = 'https://github.com/talaatmagdyx/rss_feed_plus'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/talaatmagdyx/rss_feed_plus'
+  spec.metadata['changelog_uri'] = 'https://github.com/talaatmagdyx/rss_feed_plus/blob/main/CHANGELOG.md'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/talaatmagdyx/rss_feed_plus/issues'
+  spec.metadata['wiki_uri'] = 'https://github.com/talaatmagdyx/rss_feed_plus/wiki'
+  spec.post_install_message = "Thanks for installing! #{spec.name} is a simple RSS parser gem for Ruby."
+  spec.platform = Gem::Platform::RUBY
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git appveyor Gemfile])
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

data/sig/dynamic_object.rbs

@@ -0,0 +1,9 @@
+class DynamicObject
+  def initialize: (data: JSON)-> void
+
+  private
+
+  def process_array: -> Array[untyped]
+
+  def set_instance_variable: (key: String, value: untyped)-> void
+end

data/sig/rss_feed/feed/base.rbs

@@ -0,0 +1,18 @@
+module RssFeed
+  module Feed
+    class Base
+      @document: Nokogiri::XML::Document
+
+      attr_reader document: Nokogiri::XML::Document
+
+      def parser: -> Nokogiri::XML::Document
+
+      private
+
+      def detect_feed_type: -> String
+
+
+      def execute_method: -> String
+    end
+  end
+end

data/sig/rss_feed/feed/channel.rbs

@@ -0,0 +1,15 @@
+module RssFeed
+  module Feed
+    class Channel
+      TAGS: Array[String]
+
+      def atom: -> String
+
+      alias feed atom
+
+      def parse: -> Nokogiri::XML::NodeSet
+
+      def rss: -> String
+    end
+  end
+end

data/sig/rss_feed/feed/item.rbs

@@ -0,0 +1,15 @@
+module RssFeed
+  module Feed
+    class Item
+      TAGS: Array[String]
+
+      def atom: -> String
+
+      alias feed atom
+
+      def parse: -> Nokogiri::XML::NodeSet
+
+      def rss: -> String
+    end
+  end
+end

data/sig/rss_feed/feed/namespace.rbs

@@ -0,0 +1,21 @@
+module RssFeed
+  module Feed
+    class Namespace
+      NAMESPACES: Hash[String, String]
+
+      def self.access_tag: (tag: String, doc: Nokogiri::XML::NodeSet)-> Hash[Symbol, bool | String | Nokogiri::XML::Document ]
+
+      def self.namespace: (tag: String)-> Hash[String, String]
+
+      def self.nested_attributes?:  (node: Nokogiri::XML::NodeSet) -> bool
+
+      def self.nested_elements?: (node: Nokogiri::XML::NodeSet) -> bool
+
+      def self.remove_html_tags: (content: Nokogiri::XML::NodeSet)-> String
+
+      private
+
+      def self.contains_html_tags?: (content: String)-> bool
+    end
+  end
+end

data/sig/rss_feed/parser.rbs

@@ -0,0 +1,51 @@
+module RssFeed
+  class Parser
+    @feed_urls: Array[String]
+
+    @logger: Logger
+
+    attr_reader feed_urls: String
+    attr_reader uri_parser: untyped
+    attr_reader xml_parser: Nokogiri | untyped
+
+    def initialize: (feed_urls: String) -> void
+
+    def parse: -> Hash[String, Hash[Symbol, Hash[Symbol, String]] | Array[Hash[Symbol, Hash[Symbol, String]]]]
+
+    def parse_as_object: -> DynamicObject
+
+    private
+
+    def add_attributes: -> void
+
+    def configure_logger: -> void
+
+    def create_item_info: ->  Hash[String, untyped]
+
+    def extract_attributes: (node: Nokogiri::XML::NodeSet)-> Array[Hash[Symbol, Hash[Symbol, String]]]
+
+    def extract_channel_info: (channel: Feed::Channel)-> Hash[Symbol, Hash[Symbol, String]]
+
+    def extract_clean_value: (docs:  Nokogiri::XML::Document)-> String
+
+    def extract_info: (feed: Feed::Item | Feed::Channel)-> Hash[Symbol, Hash[Symbol, String]]
+
+    def extract_item_info: (items: Feed::Item)-> Array[Hash[Symbol, Hash[Symbol, String]]]
+
+    def extract_items: (tag_data: Hash[Symbol, String])->  (Hash[Symbol, Hash[Symbol, String]] | String)
+
+    def extract_nested_data: (nodes: Nokogiri::XML::NodeSet)-> Hash[Symbol, Hash[Symbol, String]]
+
+    def extract_tag_data: (tag: String, feed_parse: Nokogiri::XML::Document)-> Hash[Symbol, String | bool| Nokogiri::XML::Document]
+
+    def fetch_and_parse_xml: -> Nokogiri::XML::Document
+
+    def handle_error: (error: string)-> void
+
+    def skip_extraction?: -> bool
+
+    def skip_items?: -> bool
+
+    def uri_options: -> Hash[Symbol | String, String | Integer]
+  end
+end

data/sig/rss_feeds.rbs

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

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: rss_feed_plus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- talaatmagdyx
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-04-08 00:00:00.000000000 Z
+dependencies: []
+description: "    rss_feed_plus is a Ruby gem designed to simplify the process of
+  parsing RSS feed in Ruby applications. \n    It provides a straightforward interface
+  for fetching RSS feed from URLs and extracting relevant information \n    such as
+  titles, links, descriptions, publication dates, and authors. \n    With rss_feed_plus,
+  you can quickly integrate RSS feed parsing functionality into your Ruby projects,
+  \n    making it easy to work with syndicated content from various sources.\n"
+email:
+- talaatmagdy75@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/rss_feed.rb
+- lib/rss_feed/dynamic_object.rb
+- lib/rss_feed/feed/base.rb
+- lib/rss_feed/feed/channel.rb
+- lib/rss_feed/feed/item.rb
+- lib/rss_feed/feed/namespace.rb
+- lib/rss_feed/object.rb
+- lib/rss_feed/parser.rb
+- lib/rss_feed/version.rb
+- parser.rb
+- rbs_collection.lock.yaml
+- rbs_collection.yaml
+- rss_example/news.rss
+- rss_example/prog.xml
+- rss_feed.gemspec
+- sig/dynamic_object.rbs
+- sig/rss_feed/feed/base.rbs
+- sig/rss_feed/feed/channel.rbs
+- sig/rss_feed/feed/item.rbs
+- sig/rss_feed/feed/namespace.rbs
+- sig/rss_feed/parser.rbs
+- sig/rss_feeds.rbs
+homepage: https://github.com/talaatmagdyx/rss_feed_plus
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/talaatmagdyx/rss_feed_plus
+  source_code_uri: https://github.com/talaatmagdyx/rss_feed_plus
+  changelog_uri: https://github.com/talaatmagdyx/rss_feed_plus/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/talaatmagdyx/rss_feed_plus/issues
+  wiki_uri: https://github.com/talaatmagdyx/rss_feed_plus/wiki
+  rubygems_mfa_required: 'true'
+post_install_message: Thanks for installing! rss_feed_plus is a simple RSS parser
+  gem for Ruby.
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: A simple RSS parser gem for Ruby
+test_files: []