journalism is now known as agate. Closes #179.

ARCHITECTURE

@@ -1,4 +1,4 @@
-A few notes regarding journalism's internal architecture. (Users should not care about any of these things.)
+A few notes regarding agate's internal architecture. (Users should not care about any of these things.)
 
 * Operations on Tables return new Tables.
 
@@ -11,6 +11,3 @@ A few notes regarding journalism's internal architecture. (Users should not care
 * ColumnMapping, RowSequence, Column, and Row have **read only** access to a Table's private variables. They are purely a formal abstraction and for purposes of encapsulation they can be treated as a single unit.
 
 * Columns lazily construct a copy of their data from their parent Table and then cache it.
-
-* Operations accept functional arguments wherever possible for maximum flexibility.
-

AUTHORS

@@ -1,4 +1,4 @@
-The following individuals have contributed code to journalism:
+The following individuals have contributed code to agate:
 
 * Mick O'Brien
 * Christopher Groskopf

CHANGELOG

@@ -1,6 +1,7 @@
 0.5.0
 -----
 
+* Renamed the library to agate. (#179)
 * Results of common column operations are now cached using a common memoize decorator. (#162)
 * Deprecated support for Python version 3.2.
 * Added support for Python wheel packaging. (#127)

README

@@ -1,9 +1,9 @@
-journalism is a Python data analysis library designed for humans working in the real world. It is an alternative to numpy and pandas that is optimized for making humans faster at working with normal-sized datasets.
+agate is a Python data analysis library designed for humans working in the real world. It is an alternative to numpy and pandas that is optimized for making humans faster at working with normal-sized datasets.
 
-It is inspired by underscore.js and all the other libraries that know how to get the hell out of the way and let us do Journalism.
+agate was previously known as journalism.
 
 Important links:
 
-* Repository:       https://github.com/onyxfish/journalism
-* Issues:           https://github.com/onyxfish/journalism/issues
-* Documentation:    http://journalism.rtfd.org
+* Repository:       https://github.com/onyxfish/agate
+* Issues:           https://github.com/onyxfish/agate/issues
+* Documentation:    http://agate.rtfd.org

agate/__init__.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python
+
+from agate.aggregators import *
+from agate.columns import *
+from agate.column_types import *
+from agate.computations import *
+from agate.exceptions import *
+from agate.table import Table
+from agate.tableset import TableSet
+
+def save():
+    raise NotImplementedError

journalism/aggregators.py → agate/aggregators.py

@@ -3,9 +3,9 @@
 from collections import defaultdict
 import datetime
 
-from journalism.column_types import BooleanType, NumberType
-from journalism.columns import BooleanColumn, DateColumn, DateTimeColumn, NumberColumn, TextColumn
-from journalism.exceptions import NullComputationError, UnsupportedAggregationError
+from agate.column_types import BooleanType, NumberType
+from agate.columns import BooleanColumn, DateColumn, DateTimeColumn, NumberColumn, TextColumn
+from agate.exceptions import NullComputationError, UnsupportedAggregationError
 
 class Aggregation(object): #pragma: no cover
     """

journalism/column_types.py → agate/column_types.py

@@ -10,7 +10,7 @@
 from dateutil.parser import parse
 import six
 
-from journalism.exceptions import CastError
+from agate.exceptions import CastError
 
 #: String values which will be automatically cast to :code:`None`.
 NULL_VALUES = ('', 'na', 'n/a', 'none', 'null', '.')
@@ -59,7 +59,7 @@ def cast(self, d):
         raise CastError('Can not convert value %s to bool for BooleanColumn.' % d)
 
     def _create_column(self, table, index):
-        from journalism.columns import BooleanColumn
+        from agate.columns import BooleanColumn
 
         return BooleanColumn(table, index)
 
@@ -93,7 +93,7 @@ def cast(self, d):
         return parse(d).date()
 
     def _create_column(self, table, index):
-        from journalism.columns import DateColumn
+        from agate.columns import DateColumn
 
         return DateColumn(table, index)
 
@@ -127,7 +127,7 @@ def cast(self, d):
         return parse(d)
 
     def _create_column(self, table, index):
-        from journalism.columns import DateTimeColumn
+        from agate.columns import DateTimeColumn
 
         return DateTimeColumn(table, index)
 
@@ -160,7 +160,7 @@ def cast(self, d):
             raise CastError('Can not convert value "%s" to Decimal for NumberColumn.' % d)
 
     def _create_column(self, table, index):
-        from journalism.columns import NumberColumn
+        from agate.columns import NumberColumn
 
         return NumberColumn(table, index)
 
@@ -187,6 +187,6 @@ def cast(self, d):
         return six.text_type(d)
 
     def _create_column(self, table, index):
-        from journalism.columns import TextColumn
+        from agate.columns import TextColumn
 
         return TextColumn(table, index)

agate/columns/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+
+from agate.columns.boolean import BooleanColumn
+from agate.columns.date import DateColumn
+from agate.columns.date_time import DateTimeColumn
+from agate.columns.number import NumberColumn
+from agate.columns.text import TextColumn

journalism/columns/base.py → agate/columns/base.py

@@ -9,8 +9,8 @@
 
 import six
 
-from journalism.exceptions import ColumnDoesNotExistError
-from journalism.utils import memoize
+from agate.exceptions import ColumnDoesNotExistError
+from agate.utils import memoize
 
 class ColumnMapping(Mapping):
     """
@@ -81,7 +81,7 @@ def __unicode__(self):
 
         sample = '(%s)' % sample
 
-        return '<journalism.columns.%s: %s>' % (self.__class__.__name__, sample)
+        return '<agate.columns.%s: %s>' % (self.__class__.__name__, sample)
 
     def __str__(self):
         return str(self.__unicode__())

journalism/columns/boolean.py → agate/columns/boolean.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python
 
-from journalism.columns.base import Column
+from agate.columns.base import Column
 
 class BooleanColumn(Column):
     """

journalism/columns/date.py → agate/columns/date.py

@@ -2,7 +2,7 @@
 
 import datetime
 
-from journalism.columns.base import Column
+from agate.columns.base import Column
 
 class DateColumn(Column):
     """

journalism/columns/date_time.py → agate/columns/date_time.py

@@ -4,7 +4,7 @@
 
 from dateutil.parser import parse
 
-from journalism.columns.base import Column
+from agate.columns.base import Column
 
 class DateTimeColumn(Column):
     """

journalism/columns/number.py → agate/columns/number.py

@@ -5,9 +5,9 @@
 
 import six
 
-from journalism.columns.base import Column
-from journalism.exceptions import NullComputationError
-from journalism.utils import memoize
+from agate.columns.base import Column
+from agate.exceptions import NullComputationError
+from agate.utils import memoize
 
 class NumberColumn(Column):
     """

journalism/columns/text.py → agate/columns/text.py

@@ -2,7 +2,7 @@
 
 import six
 
-from journalism.columns.base import Column
+from agate.columns.base import Column
 
 class TextColumn(Column):
     """

journalism/computations.py → agate/computations.py

@@ -5,15 +5,15 @@
 columns.
 """
 
-from journalism.aggregators import Mean, StDev
-from journalism.columns import NumberColumn
-from journalism.column_types import NumberType
-from journalism.exceptions import UnsupportedComputationError
-from journalism.utils import NullOrder
+from agate.aggregators import Mean, StDev
+from agate.columns import NumberColumn
+from agate.column_types import NumberType
+from agate.exceptions import UnsupportedComputationError
+from agate.utils import NullOrder
 
 class Computation(object): #pragma: no cover
     """
-    Base class for row-wise computations on :class:`.Table`s.
+    Base class for row-wise computations on a :class:`.Table`.
     """
     def get_computed_column_type(self):
         """

journalism/rows.py → agate/rows.py

@@ -7,8 +7,8 @@
 if six.PY3:
     xrange = range
 
-from journalism.exceptions import ColumnDoesNotExistError, RowDoesNotExistError
-from journalism.utils import memoize
+from agate.exceptions import ColumnDoesNotExistError, RowDoesNotExistError
+from agate.utils import memoize
 
 class RowSequence(Sequence):
     """
@@ -61,7 +61,7 @@ def __unicode__(self):
 
         sample = '(%s)' % sample
 
-        return '<journalism.rows.Row: %s>' % sample
+        return '<agate.rows.Row: %s>' % sample
 
     def __str__(self):
         return str(self.__unicode__())

journalism/table.py → agate/table.py

@@ -2,7 +2,7 @@
 
 """
 This module contains the :class:`Table` object, which is the central data
-structure in :code:`journalism`.
+structure in :code:`agate`.
 """
 
 from copy import copy
@@ -14,13 +14,13 @@
 
 import six
 
-from journalism.aggregators import Sum, Mean, Median, StDev, MAD
-from journalism.columns.base import ColumnMapping
-from journalism.computations import Computation
-from journalism.exceptions import ColumnDoesNotExistError, RowDoesNotExistError
-from journalism.rows import RowSequence, Row
-from journalism.tableset import TableSet
-from journalism.utils import NullOrder, memoize
+from agate.aggregators import Sum, Mean, Median, StDev, MAD
+from agate.columns.base import ColumnMapping
+from agate.computations import Computation
+from agate.exceptions import ColumnDoesNotExistError, RowDoesNotExistError
+from agate.rows import RowSequence, Row
+from agate.tableset import TableSet
+from agate.utils import NullOrder, memoize
 
 class Table(object):
     """

journalism/tableset.py → agate/tableset.py

@@ -13,10 +13,10 @@
 except ImportError: # pragma: no cover
     from ordereddict import OrderedDict
 
-from journalism.aggregators import Aggregation
-from journalism.column_types import TextType, NumberType
-from journalism.exceptions import ColumnDoesNotExistError
-from journalism.rows import RowSequence
+from agate.aggregators import Aggregation
+from agate.column_types import TextType, NumberType
+from agate.exceptions import ColumnDoesNotExistError
+from agate.rows import RowSequence
 
 class TableMethodProxy(object):
     """

docs/Makefile

@@ -72,17 +72,17 @@ qthelp:
 	@echo
 	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
 	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/journalism.qhcp"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/agate.qhcp"
 	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/journalism.qhc"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/agate.qhc"
 
 devhelp:
 	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
 	@echo
 	@echo "Build finished."
 	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/journalism"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/journalism"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/agate"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/agate"
 	@echo "# devhelp"
 
 epub:

docs/api/aggregators.rst

@@ -1,8 +1,8 @@
 ======================
-journalism.aggregators
+agate.aggregators
 ======================
 
-.. automodule:: journalism.aggregators
+.. automodule:: agate.aggregators
     :members:
     :undoc-members:
     :show-inheritance:

docs/api/column_types.rst

@@ -1,7 +1,7 @@
 =======================
-journalism.column_types
+agate.column_types
 =======================
 
-.. automodule:: journalism.column_types
+.. automodule:: agate.column_types
     :members:
     :undoc-members:

docs/api/columns.rst

@@ -1,33 +1,33 @@
 ==================
-journalism.columns
+agate.columns
 ==================
 
-.. automodule:: journalism.columns.base
+.. automodule:: agate.columns.base
     :members:
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: journalism.columns.boolean
+.. automodule:: agate.columns.boolean
     :members:
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: journalism.columns.date
+.. automodule:: agate.columns.date
     :members:
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: journalism.columns.date_time
+.. automodule:: agate.columns.date_time
     :members:
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: journalism.columns.number
+.. automodule:: agate.columns.number
     :members:
     :undoc-members:
     :show-inheritance:
 
-.. automodule:: journalism.columns.text
+.. automodule:: agate.columns.text
     :members:
     :undoc-members:
     :show-inheritance:

docs/api/computations.rst

@@ -1,8 +1,8 @@
 =======================
-journalism.computations
+agate.computations
 =======================
 
-.. automodule:: journalism.computations
+.. automodule:: agate.computations
     :members:
     :undoc-members:
     :show-inheritance:

docs/api/exceptions.rst

@@ -1,8 +1,7 @@
 =====================
-journalism.exceptions
+agate.exceptions
 =====================
 
-.. automodule:: journalism.exceptions
+.. automodule:: agate.exceptions
     :members:
     :undoc-members:
-