football-cat 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b99f5753f1c440b0c2bce4c18965ed07b37bc193
-  data.tar.gz: db8bf5223f6e5e42de9f610fcb5812e45c87e65f
+  metadata.gz: 5f049230d455d5f193ef47130fc8fceb5c24f170
+  data.tar.gz: b03a2d436aec95aa8bac7f02f36b2e35aee4336b
 SHA512:
-  metadata.gz: c4fdddaebd05f0df7bfae509c2ace78374888f421fa1aac68b815e1a6830cc7c815e1b4438c7ee1926cccfe805e8dee1f1355a99b1f979a959795ecea13bec6f
-  data.tar.gz: 063de7fe1f277d2f968a17b16bc5f83c9455fe956d88f96403d21079355fb4867bb0bc65c526137241a3ba573a2da0ddf0fc0efd3b2de8325f3de716aa73cf81
+  metadata.gz: c96ad2a9b2516d1c44ea872ac8f43ff7135a7591009d7e4aebe7c1077a6f367551ef893d11b6f01f4dea9fefe23b8ca44db4b2010b297c333d3891f73a66c9ce
+  data.tar.gz: b99f5b5e26dcdf52c00aebc345166e01f85ea256976a0f9d0bc7488db2a4d8c62fba5d0d33ed85e00bf9173e21c0e4f556a175ddb6f3aa7c3303d80500f3b610

data/README.md

@@ -1,4 +1,4 @@
-# football-cat - concatenate football.csv datafiles
+# football-cat - concatenate football.csv datafiles - make out of many, one
 
 
 * home  :: [github.com/sportdb/football.db](https://github.com/sportdb/football.db)
@@ -11,6 +11,103 @@
 
 ## Usage
 
+Run this tool to concatenate match files (for football clubs or national teams) in the one-line, one-match & one-file, one-season Football.CSV format
+into one
+PLUS (auto-)adding the missing league and season headers / columns
+inferred from the file's basename (e.g. `es.1.csv` => `ES1`)
+and the file's directory (e.g. `/2020-21/` => `2020/21`). Example:
+
+```
+$ football-cat espana.csv espana
+```
+
+Concatenates all match files in the `espana` directory
+(and all its subdirectories) into the single-file `espana.csv`
+plus (auto-)adding two new leading columns, that is, league and season.
+
+```
+/footballcsv/espana
+├───2010s
+│   ├───2012-13
+│   │       es.1.csv
+│   ├───2013-14
+│   │       es.1.csv
+│   ├───2014-15
+│   │       es.1.csv
+│   ├───2015-16
+│   │       es.1.csv
+│   ├───2016-17
+│   │       es.1.csv
+│   ├───2017-18
+│   │       es.1.csv
+│   ├───2018-19
+│   │       es.1.csv
+│   │       es.2.csv
+│   └───2019-20
+│           es.1.csv
+│           es.2.csv
+└───2020s
+    └───2020-21
+            es.1.csv
+            es.2.csv
+```
+
+and looking into `2010s/2012-12/es.1.csv`, for example:
+
+```
+Round,Date,Team 1,FT,Team 2
+1,Sat Aug 18 2012,RCD Mallorca,2-1,RCD Espanyol
+1,Sat Aug 18 2012,Sevilla FC,2-1,Getafe CF
+1,Sat Aug 18 2012,RC Celta Vigo,0-1,Málaga CF
+1,Sun Aug 19 2012,Levante UD,1-1,Atlético Madrid
+1,Sun Aug 19 2012,Real Madrid,1-1,Valencia CF
+1,Sun Aug 19 2012,FC Barcelona,5-1,Real Sociedad
+1,Sun Aug 19 2012,Athletic Club Bilbao,3-5,Real Betis
+1,Mon Aug 20 2012,RCD La Coruña,2-0,CA Osasuna
+1,Mon Aug 20 2012,Rayo Vallecano,1-0,Granada CF
+1,Mon Aug 20 2012,Real Zaragoza,0-1,Real Valladolid CF
+```
+
+becomes the all-in-one `espana.csv`:
+
+```
+League,Season,Round,Date,Team 1,FT,Team 2
+ES1,2012/13,1,Sat Aug 18 2012,RCD Mallorca,2-1,RCD Espanyol
+ES1,2012/13,1,Sat Aug 18 2012,Sevilla FC,2-1,Getafe CF
+ES1,2012/13,1,Sat Aug 18 2012,RC Celta Vigo,0-1,Málaga CF
+ES1,2012/13,1,Sun Aug 19 2012,Levante UD,1-1,Atlético Madrid
+ES1,2012/13,1,Sun Aug 19 2012,Real Madrid,1-1,Valencia CF
+ES1,2012/13,1,Sun Aug 19 2012,FC Barcelona,5-1,Real Sociedad
+ES1,2012/13,1,Sun Aug 19 2012,Athletic Club Bilbao,3-5,Real Betis
+ES1,2012/13,1,Mon Aug 20 2012,RCD La Coruña,2-0,CA Osasuna
+ES1,2012/13,1,Mon Aug 20 2012,Rayo Vallecano,1-0,Granada CF
+ES1,2012/13,1,Mon Aug 20 2012,Real Zaragoza,0-1,Real Valladolid CF
+...
+ES2,2020/21,42,Sun May 30 2021,AD Alcorcón,,RCD Espanyol
+ES2,2020/21,42,Sun May 30 2021,Albacete Balompié,,CF Fuenlabrada
+ES2,2020/21,42,Sun May 30 2021,CD Mirandés,,CE Sabadell
+ES2,2020/21,42,Sun May 30 2021,CD Tenerife,,Real Oviedo
+ES2,2020/21,42,Sun May 30 2021,FC Cartagena,,Girona FC
+ES2,2020/21,42,Sun May 30 2021,Málaga CF,,CD Castellón
+ES2,2020/21,42,Sun May 30 2021,Rayo Vallecano,,CD Lugo
+ES2,2020/21,42,Sun May 30 2021,Real Zaragoza,,CD Leganés
+ES2,2020/21,42,Sun May 30 2021,SD Ponferradina,,RCD Mallorca
+ES2,2020/21,42,Sun May 30 2021,Sporting Gijón,,UD Almería
+ES2,2020/21,42,Sun May 30 2021,UD Logroñés,,UD Las Palmas
+```
+
+
+Note: You can pass along more than one directory to the tool.
+Let's concatenate the top leagues from the football.csv org:
+
+```
+$ football-cat top.csv footballcsv/england     \
+                       footballcsv/espana      \
+                       footballcsv/deutschland
+```
+
+
+That's all for now. Happy data wrangling. Enjoy the beautiful game.
 
 
 ## Datasets

data/Rakefile

@@ -6,7 +6,7 @@ Hoe.spec 'football-cat' do
 
   self.version = SportDb::Module::FootballCat::VERSION
 
-  self.summary = 'football-cat - concatenate football.csv datafiles'
+  self.summary = 'football-cat - concatenate football.csv datafiles - make out of many, one'
   self.description = summary
 
   self.urls    = { home: 'https://github.com/sportdb/football.db'}

data/lib/football-cat.rb

@@ -3,18 +3,11 @@ require 'optparse'
 
 require 'sportdb/catalogs'
 
+
 ###
 # our own code
 require 'football-cat/version' # let version always go first
-
-
-module FootballCat
-class Tool
-
-end  # class Tool
-
-def self.main( args=ARGV ) Tool.new.run( args ); end
-end  # module FootballCat
+require 'football-cat/tool'
 
 
 

data/lib/football-cat/version.rb

@@ -3,8 +3,8 @@ module Module
 module FootballCat
 
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 0
-  PATCH = 1
+  MINOR = 1
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: football-cat
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
@@ -58,7 +58,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.22'
-description: football-cat - concatenate football.csv datafiles
+description: football-cat - concatenate football.csv datafiles - make out of many,
+  one
 email: opensport@googlegroups.com
 executables:
 - football-cat
@@ -102,5 +103,5 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: football-cat - concatenate football.csv datafiles
+summary: football-cat - concatenate football.csv datafiles - make out of many, one
 test_files: []