alexandria-book-collection-manager 0.6.9.pre1

data/share/gnome/help/alexandria/ja/working-with-libraries.xml

@@ -0,0 +1,88 @@
+<!-- ============= Working with Libraries Subsection ============ -->
+
+<section id="working-with-libraries">
+  <title>ライブラリを管理するには</title>
+  <para>&app; に登録した本は、いくつかのコレクションにグループ分けされて収納されます。
+これをライブラリと呼びます。例えば、小説を全て１つのライブラリに入れてもよいですし、
+また別のライブラリにはプログラミングのマニュアルをいれてもよいです。&app; では、
+ライブラリを作成したり、編集したり、ライブラリ間で本を移動したりできます。</para>
+  <para>&app; のメインウィンドの左にある<guilabel>ライブラリのペイン</guilabel>
+には利用可能なライブラリの一覧が表示されています。
+ライブラリのペインが表示されていない場合には、メインメニューから
+<menuchoice><guimenu>表示</guimenu><guimenuitem>サイドペイン</guimenuitem></menuchoice>
+を選択してください。ペインを消すには、同じようにしてメニューから選ぶか、
+ライブラリペインの左上にある<guibutton>閉じる（×）</guibutton>
+のアイコンをクリックしてください。</para>
+  <figure id="library-pane-fig">
+    <title>&app; のライブラリの一覧</title>
+    <screenshot>
+      <mediaobject>
+	<imageobject>
+	  <imagedata fileref="figures/working_with_libraries_library_pane.png" format="PNG"/>
+	</imageobject>
+	<!-- EPS versions of the figures are not required at the moment. -->
+	<!-- 
+	     <imageobject>
+	     <imagedata fileref="figures/image.eps" format="EPS"/>
+	     </imageobject>
+	-->
+	<textobject>
+	  <phrase>&app;のライブラリの一覧です。</phrase>
+	</textobject>
+      </mediaobject>
+    </screenshot>
+  </figure>
+  <para>
+    <itemizedlist>
+      <listitem><para><xref linkend="create-new-library"/></para></listitem>
+      <listitem><para><xref linkend="renaming-libraries"/></para></listitem>
+      <listitem><para><xref linkend="delete-library"/></para></listitem>
+      <listitem><para><xref linkend="moving-between-libraries"/></para></listitem>
+    </itemizedlist>
+  </para>
+
+  <!-- ======= Creating libraries ===== -->
+  <section id="create-new-library">
+    <title>新しいライブラリを作成作成するには</title>
+    <para>新しいライブラリを作成するには、ツールバーにある
+<guibutton>新規ライブラリの作成</guibutton> のボタンを押すか、メニューから
+<menuchoice><guimenu>ライブラリ</guimenu><guimenuitem>新規ライブラリの作成</guimenuitem>
+</menuchoice>を選択します。他の場所から本のリストをインポートした時にも、
+新しいライブラリが新規に作成されます。</para>
+  </section>
+
+  <!-- ======= Renaming libraries ===== -->
+  <section id="renaming-libraries">
+    <title>ライブラリ名を変更するには</title>
+    <para>ライブラリの名前を変更するにはライブラリペインの名前のところをクリックして、
+新しい名前を入力してください。または、ライブラリの名前の上で右クリックをして、
+ポップアップのメニューから<guimenuitem>名称変更</guimenuitem> を選択してください。</para>
+  </section>
+
+  <!-- ======= Deleting libraries ===== -->
+  <section id="delete-library">
+    <title>ライブラリを削除するには</title>
+    <para>ライブラリを削除するには、ライブラリのペインの名前の上で右クリックして、
+<guimenuitem>削除</guimenuitem>,を選択するか、メインメニューから
+<menuchoice>
+ <guimenu>編集</guimenu>
+ <guimenuitem>削除</guimenuitem>
+</menuchoice>
+を選択するか、キーボードから<source>Delete</source>キーを押します。削除するとき、&app;
+は本当にライブラリを削除してもよいか尋ねてきます。</para>
+    <warning>
+      <para>ライブラリを削除すると、そのライブラリの中にある本を全て削除します。この操作は
+取り消せません。</para>
+    </warning>
+  </section>
+
+  <!-- ====== Moving between libraries == -->
+  <section id="moving-between-libraries">
+    <title>ライブラリ間で本を移動するには</title>
+    <para>本を移動するには、移動したい本を１つまたは複数を選択し、右クリックして<menuchoice><guimenu>移動</guimenu><guimenuitem>移動先ライブラリの名前</guimenuitem>
+</menuchoice> を選択するか、メインメニューから
+<menuchoice><guimenu>編集</guimenu><guimenuitem>移動</guimenuitem>
+<guimenuitem>移動先ライブラリの名前</guimenuitem></menuchoice> を選択してください。
+    </para>
+  </section>
+</section>

data/share/menu/alexandria

@@ -0,0 +1,7 @@
+?package(alexandria):\
+  needs="X11"\
+  section="Applications/Office"\
+  title="Alexandria"\
+  icon="/usr/share/icons/hicolor/scalable/apps/alexandria.svg"\
+  command="/usr/bin/alexandria"
+

data/share/omf/alexandria/alexandria-C.omf.in

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE omf PUBLIC "-//OMF//DTD Scrollkeeper OMF Variant V1.0//EN" "http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd">
+<omf>
+  <resource>
+    <creator>
+      liam@liamjdavison.info (Liam Davison)
+    </creator>
+    <title>
+      Alexandria Manual
+    </title>
+    <date>
+      2005-03-12
+    </date>
+    <subject category="GNOME|Applications"/>
+    <description>
+      User manual for the Alexandria application.    
+    </description>
+    <type>
+      user's guide
+    </type>
+    <format mime="text/xml"/>
+    <identifier url="PATH_TO_DOC_FILE"/>
+    <language code="C"/>
+    <relation seriesid="7591aee4-92d9-11d9-88aa-939bacdd01aa"/>
+  </resource>
+</omf>
+

data/share/omf/alexandria/alexandria-fr.omf.in

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE omf PUBLIC "-//OMF//DTD Scrollkeeper OMF Variant V1.0//EN" "http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd">
+<omf>
+  <resource>
+    <creator>
+      aymeric AT nnx DOT com (Aymeric Nys)	  
+    </creator>
+    <title>
+	Manuel d&#8217;Alexandria
+    </title>
+    <date>
+      2006-01-06
+    </date>
+    <version identifier="0.6.1-fr.1.0" date="2006-01-06" description="Manuel d&#8217;Alexandria" />
+    <subject category="GNOME|Applications"/>
+    <description>
+	    Alexandria a pour but de vous aider dans la gestion de votre bibliothèque personnelle.
+	    Ce manuel décrit toutes les fonctionnalités du logiciel pour une prise en main rapide.
+    </description>
+    <type>
+      user's guide
+    </type>
+    <format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.4//EN"/>
+    <identifier url="PATH_TO_DOC_FILE"/>
+    <language code="fr"/>
+    <relation seriesid="7591aee4-92d9-11d9-88aa-939bacdd01aa"/>
+    <rights type="GNU FDL" holder="Aymeric Nys"/>
+  </resource>
+</omf>
+

data/spec/alexandria/library_spec.rb

@@ -0,0 +1,205 @@
+#-- -*- ruby -*-
+# Copyright (C) 2007 Cathal Mc Ginley
+# Copyright (C) 2014 Matijs van Zuijlen
+#
+# 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.
+#
+# Alexandria is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public
+# License along with Alexandria; see the file COPYING.  If not,
+# write to the Free Software Foundation, Inc., 51 Franklin Street,
+# Fifth Floor, Boston, MA 02110-1301 USA.
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Alexandria::Library do
+
+  before(:each) do
+    FileUtils.mkdir(TESTDIR) unless File.exist? TESTDIR
+  end
+
+  it 'has symbolic references to file extensions' do
+    extensions = Alexandria::Library::EXT
+    expect(extensions[:book]).not_to be_nil
+    expect(extensions[:cover]).not_to be_nil
+  end
+
+  it 'disallows multiple deletion of the same copy of a book' do
+    my_library = Alexandria::Library.loadall[0]
+    first_copy = an_artist_of_the_floating_world
+    my_library << first_copy
+    my_library.delete(first_copy)
+    expect { my_library.delete(first_copy) }.to raise_error
+  end
+
+  it 'allows multiple copies of a book to be added and deleted in turn' do
+    my_library = Alexandria::Library.loadall[0]
+    first_copy = an_artist_of_the_floating_world
+    # puts "first_copy #{first_copy.object_id}"
+    my_library << first_copy
+    my_library.delete(first_copy)
+
+    second_copy = an_artist_of_the_floating_world
+    my_library << second_copy
+    third_copy = an_artist_of_the_floating_world
+    my_library << third_copy
+
+    # puts "AAA my_library.size #{my_library.size}"
+
+    # puts "second_copy #{second_copy.object_id}"
+    # lambda {  my_library.delete(second_copy) }.should raise_error
+    expect { my_library.delete(second_copy) }.not_to raise_error
+
+    # puts "BBB my_library.size #{my_library.size}"
+    # my_library.size.should == 1 # not yet an established feature...
+  end
+
+  after(:each) do
+    FileUtils.rm_rf(TESTDIR)
+  end
+
+end
+
+describe Alexandria::Library, ' imported from 0.6.1 data files' do
+
+  before(:each) do
+    lib_version = File.join(LIBDIR, '0.6.1')
+    FileUtils.cp_r(lib_version, TESTDIR)
+  end
+
+  it 'imports cleanly from version 0.6.1 data format' do
+    libs = Alexandria::Library.loadall
+    expect(libs.size).to eq(1)
+    my_library = libs[0]
+    expect(my_library.size).to eq(3)
+    # Malory
+    malory_book = my_library.select { |b| b.isbn == '9780192812179' }[0]
+    expect(malory_book.publisher).to eq('Oxford University Press')
+    expect(malory_book.authors.include?('Vinaver')).to be_truthy
+    expect(malory_book.version).to eq(Alexandria::DATA_VERSION)
+
+    # Guide to LaTeX
+    latex_book = my_library.select { |b| b.title.include? 'Latex' }[0]
+    expect(latex_book.isbn).to eq('9780201398250')
+    expect(latex_book.publisher).to eq('Addison Wesley') # note, no Ruby-Amazon cruft
+  end
+
+  after(:each) do
+    FileUtils.rm_rf(TESTDIR)
+  end
+
+end
+
+describe Alexandria::Library, ' with books without an ISBN' do
+
+  before(:each) do
+    lib_version = File.join(LIBDIR, '0.6.1-noisbn')
+    FileUtils.cp_r(lib_version, TESTDIR)
+  end
+
+  it 'allows books to have no ISBN' do
+    libs = Alexandria::Library.loadall
+    expect(libs.size).to eq(1)
+    my_library = libs[0]
+    expect(my_library.size).to eq(2)
+
+    # Guide to LaTeX
+    latex_book = my_library.select { |b| b.title.include? 'Latex' }[0]
+    expect(latex_book.isbn).to eq('9780201398250')
+    expect(latex_book.publisher).to eq('Addison Wesley') # note, no Ruby-Amazon cruft
+    expect(latex_book.version).to eq(Alexandria::DATA_VERSION)
+
+    # Lex and Yacc
+    lex_and_yacc_book = my_library.select { |b| b.title.include? 'Lex' }[0]
+    expect(lex_and_yacc_book.publisher).to eq("O'Reilley")
+
+    # puts "ident -> " + lex_and_yacc_book.ident
+
+    my_library.each do |book|
+      my_library.save(book, true)
+    end
+
+    libraries_reloaded = Alexandria::Library.loadall
+    my_library_reloaded = libraries_reloaded[0]
+
+    expect(my_library_reloaded.size).to eq(2)
+
+    latex_book = my_library_reloaded.select { |b| b.title.include? 'Latex' }[0]
+    expect(latex_book).not_to be_nil
+    expect(latex_book.publisher).to eq('Addison Wesley')
+    # puts latex_book.title
+
+    lex_and_yacc_book = my_library_reloaded.select { |b| b.title.include? 'Lex' }[0]
+    expect(lex_and_yacc_book).not_to be_nil
+    expect(lex_and_yacc_book.publisher).to eq("O'Reilley")
+    # puts lex_and_yacc_book.title
+
+  end
+
+  after(:each) do
+    FileUtils.rm_rf(TESTDIR)
+  end
+
+end
+
+describe Alexandria::Library, ' export sort order' do
+
+  before(:all) do
+    require 'tmpdir'
+    require 'csv'
+  end
+
+  before(:each) do
+    lib_version = File.join(LIBDIR, '0.6.2')
+    FileUtils.cp_r(lib_version, TESTDIR)
+    @format = Alexandria::ExportFormat.new('CSV list', 'csv', :export_as_csv_list)
+    @outfile = File.join(Dir.tmpdir, 'my_library-0.6.2.csv')
+    @my_library = Alexandria::Library.loadall[0]
+  end
+
+  def load_rows_from_csv
+    CSV.read(@outfile, col_sep: ';')
+  end
+
+  it 'can sort by title' do
+    sort_by_title = Alexandria::LibrarySortOrder.new(:title)
+    @format.invoke(@my_library, sort_by_title, @outfile)
+    expect(File.exist?(@outfile)).to be_truthy
+    rows = load_rows_from_csv
+    rows.shift
+    expect(rows.size).to eq(@my_library.size)
+    TITLE = 0
+    comparisons = rows.size - 1
+    comparisons.times do |index|
+      expect(rows[index][TITLE]).to be <= rows[index + 1][TITLE]
+    end
+  end
+
+  it 'can sort in descending order' do
+    sort_by_date_desc = Alexandria::LibrarySortOrder.new(:publishing_year, false)
+    @format.invoke(@my_library, sort_by_date_desc, @outfile)
+    expect(File.exist?(@outfile)).to be_truthy
+    rows = load_rows_from_csv
+    rows.shift
+    expect(rows.size).to eq(@my_library.size)
+    DATE = 5
+    comparisons = rows.size - 1
+    comparisons.times do |index|
+      expect(rows[index][DATE]).to be >= rows[index + 1][DATE]
+    end
+  end
+
+  after(:each) do
+    FileUtils.rm_rf(TESTDIR)
+    if File.exist? @outfile
+      File.unlink @outfile
+    end
+  end
+
+end

data/spec/alexandria/preferences_spec.rb

@@ -0,0 +1,22 @@
+# Copyright (C) 2007 Joseph Method
+#
+# 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.
+#
+# Alexandria is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public
+# License along with Alexandria; see the file COPYING.  If not,
+# write to the Free Software Foundation, Inc., 51 Franklin Street,
+# Fifth Floor, Boston, MA 02110-1301 USA.
+
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Alexandria::Preferences do
+  it 'should work'
+end

data/spec/alexandria/scanners/cuecat_spec.rb

@@ -0,0 +1,68 @@
+#-- -*- ruby -*-
+# Copyright (C) 2007 Cathal Mc Ginley
+# Copyright (C) 2014 Matijs van Zuijlen
+#
+# 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.
+#
+# Alexandria is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public
+# License along with Alexandria; see the file COPYING.  If not,
+# write to the Free Software Foundation, Inc., 51 Franklin Street,
+# Fifth Floor, Boston, MA 02110-1301 USA.
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../../lib'))
+
+require 'alexandria/scanners/cuecat'
+
+describe Alexandria::Scanners::CueCat do
+
+  before :all do
+    @cuecat = Alexandria::Scanners::CueCat.new
+    @partials = ['.',
+                 '.C3nZC3nZC3n2ChnWENz7DxnY',
+                 '.C3nZC3nZC3n2ChnWENz7DxnY.',
+                 '.C3nZC3nZC3n2ChnWENz7DxnY.cGen',
+                 '.C3nZC3nZC3n2ChnWENz7DxnY.cGen.',
+                 '.C3nZC3nZC3n2ChnWENz7DxnY.cGen.ENr7C3z0CNj3Dhj1EW'
+                ]
+    @scans = {
+      isbn: '.C3nZC3nZC3n2ChnWENz7DxnY.cGen.ENr7C3z0CNj3Dhj1EW.',
+      ib5: '.C3nZC3nZC3n2ChnWENz7DxnY.cGf2.ENr7C3z0DNn0ENnWE3nZDhP6.'
+    }
+  end
+
+  it 'is called CueCat' do
+    expect(@cuecat.name).to match(/CueCat/i)
+  end
+
+  it 'should detect a complete scan only ' do
+    @partials.each { |scan| expect(@cuecat.match?(scan)).not_to be_truthy }
+    expect(@cuecat.match?(@scans[:isbn])).to be_truthy
+    expect(@cuecat.match?(@scans[:ib5])).to be_truthy
+  end
+
+  it 'should decode ISBN barcodes' do
+    expect(@cuecat.decode(@scans[:isbn])).to eq('9780571147168')
+  end
+
+  it 'should decode ISBN+5 barcodes' do
+    expect(@cuecat.decode(@scans[:ib5])).to eq('9780575079038') # 00799
+    # TODO are we supposed to keep the +5 bit?
+  end
+
+  it 'should decode ISSN barcodes' do
+    skip 'Test scan ISSN'
+  end
+
+  it 'should decode UPC barcodes' do
+    skip 'Test scan UPC'
+  end
+
+end