Amatino


A new version of the Amatino Python library is now available! 0.0.11 introduces Python versions of the powerful <a href="https://github.com/amatino-code/amatino-python/wiki/Position">Position</a> and <a href="https://github.com/amatino-code/amatino-python/wiki/Performance">Performance</a> objects.
<ul>
<li>Add Position class</li>
<li>Add Performance class</li>
<li>Add <a href="https://github.com/amatino-code/amatino-python/wiki/Tree-Node">TreeNode</a> class</li>
<li>Add Denominated protocol</li>
<li>Add Decodable protocol</li>
<li>Add tests for Position &amp; Performance retrieval</li>
</ul>
The new Position &amp; Performance classes map to the Amatino HTTP API <a href="https://amatino.io/documentation/positions">Position</a> &amp; <a href="https://amatino.io/documentation/performances">Performance</a> objects. TreeNodes support the Position &amp; Performance classes by representing Accounts in their hierarchies.

A Position is analogous to a balance sheet or statement of financial position. A Performance is analogous to an income statement or statement of financial performance.

You may retrieve the new objects like so:
<pre>from amatino import Performance

income_statement = Performance.retrieve(
entity=mega_corp,
start_time=(datetime.utcnow() - timedelta(days=365))
end_time=datetime.utcnow()
denomination=USD
)
</pre>
<pre>from amatino import Position

balance_sheet = Position.retrieve(
entity=mega_corp,
balance_time=datetime.utcnow()
denomination=USD
)
</pre>
For detailed documentation of the properties and methods of these new classes, check out the <a href="https://github.com/amatino-code/amatino-python/wiki/Documentation">Amatino Python Documentation</a>.

You can install Amatino via PyPi:
<pre>$ pip install amatino</pre>
Or, if you already have Amatino Python installed, upgrade:
<pre>$ pip install --upgrade amatino</pre>
Enjoy!


Amatino Python 0.0.10 has been released! 0.0.10 is all about balance. 0.0.10 is backward compatible with <a href="https://amatino.io/blog/amatino-python-0-0-7-released/">0.0.7</a>. 0.0.8 and 0.0.9 were skipped because... software. Changes in 0.0.10:
<ul>
<li>Add <code>Balance</code> class</li>
<li>Add <code>RecursiveBalance</code> class</li>
<li>Add tests for <code>Balance</code> &amp; <code>RecursiveBalance</code></li>
<li>Resolve bug causing amounts &gt; 1,000 units to raise errors on retrieval</li>
</ul>
The new Balance &amp; RecursiveBalance classes map to the Amatino API <a href="https://amatino.io/documentation/accounts/balance">Balance</a> &amp; <a href="https://amatino.io/documentation/accounts/recursive_balance">RecursiveBalance</a> objects. They both have the same <code>.retrieve()</code> method signature...

python
balance = Balance.retrieve(
entity=mega_corporation,
account=current_assets,
balance_time=datetime.utcnow(),
denomination=us_dollars
)

... Wherein <code>balance_time</code> is optional (defaults to "now") and denomination is optional (defaults to <code>account.denomination</code>).

For detailed documentation of the properties and methods of these new classes, check out the <a href="https://github.com/amatino-code/amatino-python/wiki/Documentation">Amatino Python Documentation</a>.

You can install <a href="https://pypi.org/project/amatino/">Amatino via PyPi</a>:
<pre>$ pip install amatino</pre>
Or, if you already have Amatino Python installed, upgrade:
<pre>$ pip install --upgrade amatino</pre>


Amatino Python 0.0.7 has been released! This is a major new release, introducing a vast array of capabilities. It is not backwards compatible with 0.0.6. You can [install Amatino via PyPi](
https://pypi.org/project/amatino):

bash
$ pip install amatino


Or, if you already have Amatino Python installed, upgrade:


$ pip install --upgrade amatino


Here’s the full list of changes:

* Added Entity class including .create(), .retrieve()
* Added Account class including .create(), .retrieve(), .update()
* Added Transaction class including .create(), .retrieve(), .update(), .delete()
* Added Entry class including various convenience initialisers
* Added GlobalUnit class including .retrieve()
* Added CustomUnit class including .create(), .retrieve()
* Added User class including .retrieve()
* Added Ledger & RecursiveLedger classes
* Added internal Denomination abstract class
* Added internal enumeration HTTPMethod
* Added internal interface Encodable
* Added some internal error types to provide more robust error explanations
* Added tests for new classes
* Removed AmatinoAlpha class & attendant tests


The high level

0.0.7 is the first Amatino Python release to include expressive, object-oriented syntax. Previous releases required manual composition of requests using the AmatinoAlpha object.

Documentation

So many new goodies. But how do we use them? Documentation to the rescue! All the new classes included in 0.0.7 are documented in [Amatino Python’s GitHub Wiki](
https://github.com/amatino-code/amatino-python/wiki/Documentation). For example, you can check out the [Transaction](
https://github.com/amatino-code/amatino-python/wiki/Transaction) page to see all the Transaction class’s properties and methods.

The future

The most glaring omissions are 0.0.7 are probably Balance, Position, and Performance. Expect 0.0.8 to add those bad boys in the near future.

Enjoy!

[– Hugh](https://twitter.com/hugh_jeremy)