ba_upload 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cceefb5de17f2e510d450c83e0ab44a231c23f8024f3b86c1cf4e55c9e2bee32
-  data.tar.gz: 29f249da985d7e5213f1cdc8f56f0d1dfc3e352f26823731413ba66506e6672d
+  metadata.gz: 929ae4afa02061b2855f56812284f7353e446b10a9d5c331f10d9bfee70df29b
+  data.tar.gz: 5897f8e1d95d1b4252c0ad34119d92ba608edd7482267ce539ce42bc3b6becb3
 SHA512:
-  metadata.gz: d4ba083e3d90f2d5d750127892b914dba63678a0b4423755b08c455d467cba9e28e02eb4bd5a4d900e19572f258d1befe2109a67af5c144fe10a36e8597552c2
-  data.tar.gz: c45d8070153d9aca7842ede6b4dea90098608e6b078bdf4e4370a698e837b021382ddccdfe31b4f47c0121ea76e5e8749e15a86a6f8841f9022b635c7f8d6bca
+  metadata.gz: 572fb95d84d934a4679eb97621ecaf8205290328196a75ab4a5c900826ff4490f666cdfbc83b946cf7df67246ca51bf5c6ffe612ac1b0d5ecec36567b49c2954
+  data.tar.gz: 05d3339b30db3866917a28386fb7f080ba7e921aec04ff7d32b0bc52b7be66aa0601b0bb57f8708136774154e7e3b9863331a1013291d4ecacb52511f3f7da56

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.6.0
+
+- Feat: Add `Connection#job_proposals` to list Vermittlungsvorschlag zip files from the BA `VV/` directory
+- Feat: New `BaUpload::JobProposalFile` wrapper (binary-safe read/tempfile) analogous to `ErrorFile`

data/README.md

@@ -51,11 +51,23 @@ end
 ```ruby
 #!/usr/bin/env ruby
 require 'ba_upload'
-connection = BaUpload.open_connection(file_path: 'config/Zertifikat-1XXXX.p12', passphrase: 'YOURPASSPHRASE')
+BaUpload.open_connection(file_path: 'config/Zertifikat-1XXXX.p12', passphrase: 'YOURPASSPHRASE')
 connection.upload(file: File.open(ARGV[0]))
 ```
 
-Save to a file and just run it with the xml file as argument
+Save to a file and just run it with the xml file as argument. It's important, because the file upload of BA validates the original file name.
+
+
+### Memory safety
+
+because we are using Mechanize under the hood, it's a good idea to always close sockets, (with connection.shutdown), or use the open helper:
+
+```ruby
+BaUpload.open(file_path: 'config/Zertifikat-1XXXX.p12', passphrase:) do |c|
+    c.upload(file: file_path)
+    c.error_files....
+end
+```
 
 
 ### Downloading "misc" files
@@ -71,6 +83,19 @@ connection.misc.each do |link|
 end
 ```
 
+### Downloading 'Statistiken' xlsx reports
+
+Download XLSX reports (validation errors and "Stellenübersicht") from BA; You might use another Gem, like roo, axlsx etc. to parse those files if necessary.
+
+```ruby
+connection.statistics.each do |link|
+  link.tempfile
+
+  # or:
+  link.read
+end
+```
+
 ### Usage with multiple client certificats
 
 Since September 2022, users with multiple client certificats issued to the same email address need to provide their respective partner ID when using the API.
@@ -255,6 +280,7 @@ xsd.validate(doc)
 
 <details>
 <summary>Generate a filename</summary>
+
 ```ruby
 # for historic reasons, you could transmit a bunch of files with the same timestamp using an index/offset, but usually, just putting 0 here should be enought
 index = 0
@@ -264,6 +290,7 @@ flag = ended ? "E" : "C"
 date = Time.zone.now.strftime "%Y-%m-%d_%H-%M-%S_F#{'%03d' % (index + 1)}#{flag}"
 "DS#{SUPPLIER_ID}_#{date}.xml"
 ```
+
 </details>
 
 - Upload the file using this Gem. You should wait a "couple of minutes" (tip: enqueue a activeJob for 10 minutes later), to fetch the resulting **error file**, and analyse that.

data/ba_upload.gemspec

@@ -14,12 +14,17 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/pludoni/ba_upload"
   spec.license       = "MIT"
 
+  spec.metadata = {
+    "source_code_uri" => "https://github.com/pludoni/ba_upload",
+    "changelog_uri"   => "https://github.com/pludoni/ba_upload/blob/master/CHANGELOG.md",
+  }
+
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
   spec.add_dependency "mechanize"
-  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "rake", "~> 10.0"
 end

data/lib/ba_upload/connection.rb

@@ -1,4 +1,6 @@
 require 'ba_upload/error_file'
+require 'ba_upload/statistic_file'
+require 'ba_upload/job_proposal_file'
 module BaUpload
   class Connection
     attr_reader :m
@@ -16,7 +18,7 @@ module BaUpload
 
     def upload(file: nil, partner_id: nil)
       url = base_url(partner_id) + "in/"
-      m.get url
+      m.get(url)
       form = m.page.forms.first
       form.file_uploads.first.file_name = file
       form.submit
@@ -24,13 +26,33 @@ module BaUpload
 
     def error_files(partner_id: nil)
       url = base_url(partner_id)
-      m.get url
+      m.get(url)
       links = m.page.links_with(text: /ESP|ESV/)
       links.map do |link|
         ErrorFile.new(link)
       end
     end
 
+    def statistics(partner_id: nil)
+      url = base_url(partner_id) + "Statistiken"
+      m.get(url)
+      m.page.links_with(text: /xlsx/).map do |link|
+        StatisticFile.new(link)
+      end
+    end
+
+    def job_proposals(partner_id: nil)
+      url = base_url(partner_id) + "VV/"
+      m.get(url)
+      m.page.links.reject { |l| l.href.to_s[/^\?|mailto:/] || l.href == "/" }.map do |link|
+        JobProposalFile.new(link)
+      end
+    rescue Mechanize::ResponseCodeError => e
+      return [] if e.response_code.to_i == 404
+
+      raise
+    end
+
     def misc(partner_id: nil)
       url = base_url(partner_id)
       m.get url

data/lib/ba_upload/job_proposal_file.rb

@@ -0,0 +1,25 @@
+module BaUpload
+  class JobProposalFile
+    def initialize(mechanize_link)
+      @mechanize_link = mechanize_link
+      @link = mechanize_link.href
+    end
+
+    def read
+      response = @mechanize_link.click
+      response.body
+    end
+
+    def filename
+      @mechanize_link.text
+    end
+
+    def tempfile
+      tf = Tempfile.new(['job_proposal', '.zip'])
+      tf.binmode
+      tf.write(read)
+      tf.flush
+      tf
+    end
+  end
+end

data/lib/ba_upload/statistic_file.rb

@@ -0,0 +1,18 @@
+require 'ba_upload/error_file'
+module BaUpload
+  class StatisticFile < ErrorFile
+    def tempfile
+      tf = Tempfile.new(['statistic_file', '.xlsx'])
+      tf.binmode
+      tf.write(read)
+      tf.flush
+      tf.rewind
+      tf
+    end
+
+    def read
+      @mechanize_link.click.body
+    end
+  end
+end
+

data/lib/ba_upload/version.rb

@@ -1,3 +1,3 @@
 module BaUpload
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/ba_upload.rb

@@ -1,7 +1,7 @@
 require "ba_upload/version"
 require "openssl"
 
-if OpenSSL::VERSION >= '3.0.0'
+if OpenSSL::VERSION >= '3.0.0' && defined?(OpenSSL::Provider)
   # import legacy
   OpenSSL::Provider.load("legacy")
 end
@@ -20,6 +20,13 @@ module BaUpload
     cert = BaUpload.export_certificate(file_path: file_path, passphrase: passphrase)
     BaUpload::Connection.new(cert[:key], cert[:cert], cert[:ca_cert])
   end
+
+  def self.open(file_path:, passphrase:, &block)
+    conn = BaUpload.open_connection(file_path: file_path, passphrase: passphrase)
+    block.call(conn)
+  ensure
+    conn.shutdown
+  end
 end
 
 require 'ba_upload/connection'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ba_upload
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Stefan Wienert
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-26 00:00:00.000000000 Z
+date: 2026-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mechanize
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -60,6 +60,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -70,11 +71,15 @@ files:
 - lib/ba_upload.rb
 - lib/ba_upload/connection.rb
 - lib/ba_upload/error_file.rb
+- lib/ba_upload/job_proposal_file.rb
+- lib/ba_upload/statistic_file.rb
 - lib/ba_upload/version.rb
 homepage: https://github.com/pludoni/ba_upload
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/pludoni/ba_upload
+  changelog_uri: https://github.com/pludoni/ba_upload/blob/master/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -90,7 +95,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.5.16
 signing_key: 
 specification_version: 4
 summary: Upload API for Bundesagentur fuer Arbeit (hrbaxml.arbeitsagentur)