alexandria-book-collection-manager 0.7.1 → 0.7.6

data/.simplecov

@@ -1,3 +1,7 @@
+# frozen_string_literal: true
+
 SimpleCov.start do
-  track_files 'lib/**/*.rb'
+  add_group "Main", "lib"
+  add_group "Specs", "spec"
+  enable_coverage :branch
 end

data/.travis.yml

@@ -0,0 +1,45 @@
+language: ruby
+
+dist: xenial
+
+services:
+  - xvfb
+
+before_install:
+  - sudo apt-get update
+  # Needed for gtk3 gem
+  - sudo apt-get install libgtk-3-dev
+  # Needed for gstreamer gem
+  - sudo apt-get install libgstreamer1.0-dev
+  # Needed for GooCanvas::Canvas widget
+  - sudo apt-get install libgoocanvas-2.0-dev
+  # Needed for zoom gem
+  - sudo apt-get install libyaz-dev
+  # Needed for intltool-merge executable
+  - sudo apt-get install intltool
+  # Needed for gconftool-2 executable
+  - sudo apt-get install gconf2
+  # Needed to provide A11y dbus service to silence warnings
+  - sudo apt-get install at-spi2-core
+  # Needed to set up sound player pipeline
+  - sudo apt-get install gstreamer1.0-plugins-good
+  # Needed to play sound
+  - sudo apt-get install pulseaudio
+
+cache:
+  bundler: true
+
+script: bundle exec rake
+
+jobs:
+  include:
+    - rvm: 2.5
+    - rvm: 2.6
+    - rvm: 2.7
+    - rvm: 2.7.1
+      name: "RuboCop"
+      script: bundle exec rubocop
+
+branches:
+  only:
+    - master

data/.yardopts

@@ -1 +1 @@
-- INSTALL.rdoc
+- INSTALL.md

data/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 0.7.6 / 2020-11-01
+
+* Make more strings translatable with help from rubocop-i18n
+* Code quality and testing infrastructure improvements
+* Update Polish translation ([#51] and [#64], by [Piotr Drąg][piotrdrag])
+* Update Dutch translation
+* Make several dialogs that stopped appearing appear again
+* Remove ability to enable and disable providers through a pop-up menu
+* Fix New Library functionality
+* Update dependencies on gtk3, gstreamer, and psych
+* Fix issues in preferences, smart library dialog, and book selection
+* Improve installation instructions
+* Improve README ([#83] by [Happy][HappyFacade])
+
+## 0.7.5 / 2020-05-11
+
+* Avoid crash when opening Import dialog
+* Avoid crash during export
+* Add support for Ruby 2.7
+* Drop support for Ruby 2.4
+* Remove broken Renaud provider
+
+## 0.7.4 / 2019-10-24
+
+* Drop support for Ruby 2.3
+* Avoid passing nil to Gtk method #visible=, which expects a boolean
+  ([#22], by [Joseph Haig][jrmhaig])
+* Update dependencies on gtk3 and gstreamer to 3.4.1
+* Fix WorldCat provider to use https
+
+## 0.7.3 / 2019-02-27
+
+* Remove DeaStore provider since the site is no longer online
+* Remove MCU provider since the site is no longer online
+* Various code cleanups
+* Update dependencies on `gstreamer`, `gtk3` and `image_size`
+* Call `#set_active` with `false` instead of `nil` (Fixes [#19])
+* Spec and fix export functionality
+* Do not hard-code storage location
+* Silence some Gtk+ warnings
+* Fix setup of default scanner when no scanner is configured
+* Update `YAML.safe_load` calls to new API, silencing deprecation warnings
+
+## 0.7.2 / 2018-03-18
+
+* Update dependencies
+* Various code cleanups
+
 ## 0.7.1 / 2016-12-13
 
 * Various code cleanups
@@ -45,3 +93,15 @@
 * Amazon queries now use a Associate Tag, a new requirement of
   Amazon's Product Advertising API. Thanks to Stephen McCamant for
   providing the patch.
+
+<!-- contributors -->
+[jrmhaig]: https://github.com/jrmhaig
+[piotrdrag]: https://github.com/piotrdrag
+[HappyFacade]: https://github.com/HappyFacade
+
+<!-- issues and pull requests -->
+[#83]: https://github.com/mvz/alexandria-book-collection-manager/pull/83
+[#64]: https://github.com/mvz/alexandria-book-collection-manager/pull/64
+[#51]: https://github.com/mvz/alexandria-book-collection-manager/pull/51
+[#23]: https://github.com/mvz/alexandria-book-collection-manager/pull/23
+[#19]: https://github.com/mvz/alexandria-book-collection-manager/issues/19

data/ChangeLog.0

@@ -1,38 +1,36 @@
-alexandria (0.6.2) unstable; urgency=low
-
- * Revision of the Italian translation
- * Added anonymous patch
- * [#11170] cuecat userland support:
- - http://rubyforge.org/tracker/index.php?func=detail&aid=11170&group_id=205&atid=865
- - I don't have a cuecat, and I don't know whether this patch is OK.
-
- -- Marco Costantini <costanti@science.unitn.it> Mon, 18 Jun 2007 18:28:55 -0400
-
- * Updated providers Worldcat and bol.it
-
- -- Marco Costantini <costanti@science.unitn.it> Fri, 27 Apr
-
-
- * CSV list export:
-  - the file has extension "csv"
-  - fixed in case that authors is [] or elements are missing
- * ONIX export:
-  - removed an unnecessary .to_s
-  - removed use of CGI.escapeHTML, whch is unnecessary
-  - fixed in case that ISBN is missing
- * BibTeX export:
-  - fixed in case that authors is [] or elements are missing
-  - exported also book.publishing_year
- * HTML export:
-  - added meta "Author", "Description", "Keywords"
- * Tellico export:
-  - added info on wether the book has been read or loaned
- * Tellico import:
-  - imported notes
-
- -- 2007-04-06 Marco Costantini <costanti@science.unitn.it>
-
- 2007-02-24 to 2007-04-02 Marco Costantini <costanti@science.unitn.it>
+2007-06-18 Marco Costantini <costanti@science.unitn.it>
+
+	* Revision of the Italian translation
+	* Added anonymous patch
+	* [#11170] cuecat userland support
+	  http://rubyforge.org/tracker/index.php?func=detail&aid=11170&group_id=205&atid=865
+	  I don't have a cuecat, and I don't know whether this patch is OK.
+
+2007-04-27 Marco Costantini <costanti@science.unitn.it>
+
+	* Updated providers Worldcat and bol.it
+
+2007-04-06 Marco Costantini <costanti@science.unitn.it>
+
+	* CSV list export:
+	  - the file has extension "csv"
+	  - fixed in case that authors is [] or elements are missing
+	* ONIX export:
+	  - removed an unnecessary .to_s
+	  - removed use of CGI.escapeHTML, whch is unnecessary
+	  - fixed in case that ISBN is missing
+	* BibTeX export:
+	  - fixed in case that authors is [] or elements are missing
+	  - exported also book.publishing_year
+	* HTML export:
+	  - added meta "Author", "Description", "Keywords"
+	* Tellico export:
+	  - added info on wether the book has been read or loaned
+	* Tellico import:
+	  - imported notes
+
+
+2007-02-24 to 2007-04-02 Marco Costantini <costanti@science.unitn.it>
 
 	* added new Z39.50 provider "Servizio Bibliotecario Nazionale (Italy)"
 	* added the FAQ

data/Gemfile

@@ -1,11 +1,12 @@
-source 'https://rubygems.org'
+# frozen_string_literal: true
+
+source "https://rubygems.org"
 
 # The gem's dependencies are specified in the gemspec
 gemspec
 
 group :development, :test do
-  gem 'pry'
-  gem 'rubocop', '~> 0.46.0'
-  gem 'simplecov'
-  gem 'yard', '~> 0.9.5'
+  gem "pry"
+  gem "simplecov"
+  gem "yard", "~> 0.9.5"
 end

data/INSTALL.md

@@ -0,0 +1,164 @@
+# Installing Alexandria
+
+Alexandria is written in Ruby with a GTK+3/GNOME user-interface. It
+currently only runs on UNIX-style systems, such as GNU/Linux.
+
+Alexandria is not an easy project to build from scratch. Apart from
+Ruby and GNOME, it has a lot of dependencies. Once the dependencies have been
+installed, however, building and installing Alexandria is relatively
+straightforward.
+
+## Dependencies
+
+The [Ruby-GNOME2](http://ruby-gnome2.sourceforge.jp/) user-interface
+involves a number of packages:
+
+* `gtk3`
+* `gio2`
+* `gstreamer`
+
+You should have GTK+ 3, and use Ruby-GNOME2 `~> 3.1.0`.
+
+[`ruby-gettext`](http://ruby-gettext.github.io/)
+is required for the internationalisation of the user interface.
+Requires version `~> 3.1`.
+
+### Hpricot
+
+Alexandria uses [hpricot](https://github.com/hpricot/hpricot) to
+parse the HTML from web pages for providers such as Siciliano.
+It is also used to parse the XML for the Amazon web
+service.
+
+## HTMLEntities
+
+This is used by all website-based providers.
+[htmlentities](https://github.com/threedaymonk/htmlentities) is used to
+provide more flexible HTML parsing.
+
+## Build Dependencies
+
+### Ruby Dependencies
+
+[`rake`](https://github.com/ruby/rake) is required to build Alexandria from
+the project `Rakefile`.
+
+You also need [`rubygems`](http://www.rubygems.org/) and
+[`rspec`](http://rspec.rubyforge.org/) to run the RSpec test suite.
+
+### Native Dependencies
+
+The [`gettext`](http://www.gnu.org/software/gettext) package is needed
+to generate the binary `mo` files used by `ruby-gettext` at
+runtime. You also need the
+[`intltool`](http://www.freedesktop.org/wiki/Software/intltool) package
+to merge translations into generated files (and to extract
+translatable string from xml files during development).
+
+Note that these files are pre-generated in tar.gz releases, so you'll
+only need them if you're building from the Git version, or want to
+change the translations.
+
+For support of the Z38.50 protocol you will need the
+[`yaz`](http://www.indexdata.dk/yaz) package.
+
+Alexandria also uses the outdate gconf2 configuration storage system, so you'll
+need to install `gconf2`.
+
+On Debian/Ubuntu systems, you can install the needed dependencies by running
+
+```
+apt-get install gettext intltool libyaz-dev gconf2
+```
+
+### Ruby/ZOOM and Yaz
+
+For Z39.50 support and the *Library of Congress* and *British Library* book
+providers you will need [`ruby-zoom`](http://ruby-zoom.rubyforge.org), which in
+turn requires the non-Ruby package [`yaz`](http://www.indexdata.dk/yaz) (see
+Native Dependencies above).
+
+Note that if you install the recent Ruby/ZOOM as the `zoom` gem, you will also
+need to install the `marc` gem. (Older implementations of ruby-zoom contained
+their own implementation of MARC.)
+
+The Z39.50 Object-Orientation Model (ZOOM) is an international standard for
+communication between computer systems, particularly libraries and
+information-related systems.
+
+### image_size
+
+You will need
+[`image_size`](https://github.com/toy/image_size) for
+optimizing the cover images in exported libraries.
+
+## Installing Alexandria
+
+After installing all the non-Ruby dependencies, you should be able to install alexandria using
+
+    gem install alexandria-book-collection-manager
+
+## Installing from Source
+
+**These instructions are outdated and you should for now install alexandria as a gem**
+
+To build Alexandria from a git checkout, go to the base project
+directory (where the Rakefile and this INSTALL file are located) and
+issue the command
+
+    rake build
+
+If you have downloaded a source package, this step will not usually be
+necessary.
+
+You must have root priveledges to install, so use `su`
+    su -c 'rake install'
+or `sudo`
+    sudo rake install
+
+Now you can check the version of the installed Alexandria
+    alexandria --version
+
+To launch Alexandria, simply use
+    alexandria
+
+If you wish to see more output on the console, you can use
+    alexandria --debug
+
+### Staged installation for making packages
+
+When building a binary package (such as a deb or rpm) you will want to
+"install" Alexandria into a specified directory instead of the root
+filesystem. You should specify this as the DESTDIR environment variable
+and use the `install_package_staging` task instead of `install`
+
+    DESTDIR=debian/alexandria rake install_package_staging
+
+If your distribution uses a specific directory to install Ruby
+packages, you should also set the RUBYLIBDIR.
+
+### Installing in the home directory
+
+If you want to install Alexandria in your home directory, you should
+specify the PREFIX, SHARE and RUBYLIBDIR envrionment variables, and
+use the `install_package` task instead of `install`.
+
+    PREFIX=$HOME SHARE=$HOME/.share RUBYLIBDIR=$HOME/.rubylib rake install_package
+
+This will install the `alexandria` program into `$HOME/bin` (which you
+should add to your `PATH`), and the ruby files to your
+`$HOME/.rubylib` which you should add to your `RUBYLIBDIR` environment
+variable.
+
+### Uninstalling
+
+To uninstall, simply run
+
+    sudo rake uninstall
+
+(or `rake uninstall_package` if you installed in your home directory).
+
+If you specified any of the environment variables PREFIX, SHARE,
+RUBYLIBDIR and DESTDIR during the installation, you should use the
+same variables during uninstallation (or rake won't know where to look
+for the files it has to remove).

data/README.md

@@ -4,7 +4,7 @@ Alexandria is a GNOME application for managing collections of books.
 
 Alexandria is written in Ruby, and is free software, distributed under
 the terms of the GNU General Public License, version 2 or later. See
-the file COPYING for more information.
+the file [COPYING](COPYING) for more information.
 
 What is Alexandria?
 ===================
@@ -39,50 +39,50 @@ Alexandria is a simple program designed to allow individuals to keep a
 catalogue of their book collection. In addition, it enables users to
 keep track of books which are on loan.
 
-    * retrieves and displays book information (sometimes with cover
-      pictures) from several online libraries and bookshops, such as
-          o Amazon
-          o Proxis
-          o DeaStore
-          o AdLibris
-          o Spanish Ministry of Culture
-          o Livraria Siciliano
-          o WorldCat
-          o US Library of Congress
-          o British Library
-    * allows books to be added and updated by hand
-    * enables searches either by ISBN, title, author or keyword
-    * supports the Z39.50 standard and allow you to manage your own
-      sources (e.g. university libraries)
-    * saves data using the plain-text YAML format
-    * can import and export data into ONIX, Tellico, ISBN-list
-      and GoodReads CSV formats
-    * can export XHTML web pages of your libraries, themable with CSS
-    * allows marking your books as loaned, each with the loan-date and
-      the name of the person who has borrowed them
-    * features a HIG-compliant user interface
-    * shows books in different views (standard list or icons list),
-      that can be filtered and/or sorted
-    * handles book rating and notes
-    * supports CueCat and standard "keyboard wedge" barcode readers
-    * includes translations for several languages
-    * is documented in a complete manual (at the moment only in
-      English and Japanese)
-
-Alexandria is not without problems. See doc/BUGS for a summary of issues.
+* retrieves and displays book information (sometimes with cover
+  pictures) from several online libraries and bookshops, such as
+   - Amazon
+   - Proxis
+   - AdLibris
+   - Spanish Ministry of Culture
+   - Livraria Siciliano
+   - WorldCat
+   - US Library of Congress
+   - British Library
+* allows books to be added and updated by hand
+* enables searches either by ISBN, title, author or keyword
+* supports the Z39.50 standard and allow you to manage your own
+  sources (e.g. university libraries)
+* saves data using the plain-text YAML format
+* can import and export data into ONIX, Tellico, ISBN-list
+  and GoodReads CSV formats
+* can export XHTML web pages of your libraries, themable with CSS
+* allows marking your books as loaned, each with the loan-date and
+  the name of the person who has borrowed them
+* features a HIG-compliant user interface
+* shows books in different views (standard list or icons list),
+  that can be filtered and/or sorted
+* handles book rating and notes
+* supports CueCat and standard "keyboard wedge" barcode readers
+* includes translations for several languages
+* is documented in a complete manual (at the moment only in
+  English and Japanese)
+
+Alexandria is not without problems. See [doc/BUGS](doc/BUGS) for a
+summary of issues.
 
 ## Installation
 
 There are full instructions for installing Alexandria from source in the
-file INSTALL, including information about all the dependencies.
+file [INSTALL](INSTALL), including information about all the dependencies.
 
 If you are installing on a Debian-based system, things should be
 easier as the dependencies can be handled automatically.
 
 To run the program, just type
-    alexandria
+    `alexandria`
 or, to get verbose debugging information,
-    alexandria --debug
+    `alexandria --debug`
 
 If you are running GNOME, Alexandria should appear under the
 'Applications > Office' menu.
@@ -100,6 +100,7 @@ The following people have contributed to Alexandria over the years:
 * Constantine Evans <cevans@costinet.org>
 * Dafydd Harries <daf@muse.19inch.net>
 * Javier Fernandez-Sanguino Pena <jfs@debian.org>
+* Joseph Haig <josephhaig@gmail.com>
 * Joseph Method <tristil@gmail.com>
 * Kevin Schultz <schultkl@ieee.org>
 * Laurent Sansonetti <lrz@gnome.org>
@@ -120,6 +121,11 @@ The following people have contributed to Alexandria over the years:
 * Cathal Mc Ginley <cathal.alexandria@gnostai.org>
 * Liam Davison <registrations@liamjdavison.info>
 
+### Artists
+
+* Andreas Nilsson <nisses.mail@home.se>
+* Stefanie Dijoux <stefanie.dijoux@gmail.com>
+
 ### Translators
 
 * Adrián Chaves Fernández <adriyetichaves@gmail.com> (gl)
@@ -141,20 +147,24 @@ The following people have contributed to Alexandria over the years:
 * Piotr Drąg <piotrdrag@gmail.com> (pl)
 * Serhij Dubyk <dubyk@library.lviv.ua> (uk)
 
-### Artists
-
-* Andreas Nilsson <nisses.mail@home.se>
-* Stefanie Dijoux <stefanie.dijoux@gmail.com>
+### Former translators
+* David Weinehall <tao@debian.org> (sv)
+* Jiří Pejchal <jiri.pejchal@gmail.com> (cs)
+* Laurent Sansonetti <lrz@gnome.org> (fr)
+* Lucas Rocha <lucasr@im.ufba.br> (pt_BR)
+* Marco Costantini <costanti@science.unitn.it> (it)
+* Masao Mutoh <mutoh@highway.ne.jp> (ja)
+* Mirko Maischberger <mirko@lilik.it> (it)
 
 ## License
 
 Unless otherwise noted, the following license applies to all files that are
 part of Alexandria:
 
-Copyright (C) 2004-2006 Laurent Sansonetti
-Copyright (C) 2007-2010,2014-2016 Alexandria Contributors
+Copyright (C) 2004 Laurent Sansonetti
+Copyright (C) 2005-2010,2014-2020 Alexandria Contributors
 
 Alexandria is free software; you can redistribute it and/or modify it under the
 terms of the GNU General Public License as published by the Free Software
 Foundation; either version 2 of the License, or (at your option) any later
-version. See the file COPYING for details.
+version. See the file [COPYING](COPYING) for details.