ad-si / transity Goto Github PK

Description
Since https://github.com/feramhq/transity/blob/master/scripts/helpers.js#L104 function is responsible to simplify the id of the transactions. I was wondering if the idea is that each person extends the mappings by himself or is it worth to create a pull request?
This question came up because I noticed in my transactions.yml had many ids were not readable, duplicates, etc.

I would like to see transity balance for specified period of time. Would be good to have some options so I can configure this interval.

Nightmare does not seem to be maintained anymore.
=> https://pptr.dev

Description:
The tempy library uses rename to move the files under Linux. In this https://github.com/feramhq/transity/blob/master/scripts/transactions/hypovereinsbank.js#L156 case it moves the downloaded csv from the ~/Download/... directory to the temporary directory. This caused an error because of:

EXDEV oldpath and newpath are not on the same mounted filesystem. (Linux permits a filesystem to be mounted at multiple points, but rename() does not work across different mount points, even if the same filesystem is mounted on both.)

For more, see man rename manpage:

• http://man7.org/linux/man-pages/man2/rename.2.html

Log:

Open https://my.hypovereinsbank.de/login?view=/de/login.jsp
Log in
Go to transactions page
Enter range 2020-06-24 to 2020-09-12
Download CSV file to /tmp/28ccc30ea3fa35728eac46a9c4dd7e62/hypovereinsbank-transactions.csv
Nightmare runner error:

	Error: EXDEV: cross-device link not permitted, rename '/home/DEDUCTED/Downloads/15620204_Umsatzliste.csv' -> '/tmp/28ccc30ea3fa35728eac46a9c4dd7e62/hypovereinsbank-transactions.csv'
	   at Object.fs.renameSync (fs.js:772:18)
	   at DownloadItem.eval (eval at <anonymous> (/home/DEDUCTED/.work/github/public/transity/node_modules/nightmare/lib/runner.js:543:14), <anonymous>:43:22)
	   at emitTwo (events.js:125:13)
	   at DownloadItem.emit (events.js:213:7)

Workaround:
I changed the filePathTemp to a path which was on the same partition as from where I ran the script.

Use e.g. https://github.com/Eumeryx/gnuplot-wasm

I.e. they must always be zero after all transfers of a transaction

• More beginner friendly for people who don't know about plain text accounting
• Describe how journal file is supposed to be created (write-by-hand and copy-paste)

This feels like a remnant of ledger/hledger/beancount, especially as the colon is part of yaml syntax and can get visually confusing. / clearly denotes belonging/sub-accounts, while : is only intuitive for lispers (and possibly C++/Rust devs given ::).

For those choosing transity as their first plain text accounting tool, I feel like this is a simple change to make things a little more intuitive, while the : could be kept around for those coming from other plain text accounting tools.

How do you handle split transactions? For example I spent $50 at a restaurant, $20 I am counting as expense toward food and $30 is money I expect to be paid back to me by a friend?

https://www.cs.tufts.edu/~nr/cs257/archive/simon-peyton-jones/contracts.pdf

The above link is a paper by Simon Peyton Jones and two others describing ideas similar to ones found in your blogpost. Don't know if anyone developing transity has seen or read this, so I made an issue because it's the quickest way of reliable contact. Feel free to close this immediately, there's no actual issue

E.g. _no-balance_ to ignore the transfer / transaction in all balance calculations

I see this note in initial announcement:

Please be aware that filtering by tag is still in development and only partially included in the latest release.

Waiting for this feature! But probably it's a good idea to document how to use it now if people want to play with this command.

This was brought up recently on debian-legal: it is unclear what the licensing conditions of Transity are. Specifically, it appears that you are violating the terms of your own license.

It's fairly clear that GPL-3+ is the licence you are distributing the code under: its is what's listed in you description. However, you add the additional condition that long-term users purchase a license. That is not a legal request to make of GPL-3+ licensed code: the GPL explicitly prohibits additional restrictions. Granted, you could be choosing to distribute your code under a new license that is based on the GPL, but in that case, you would need to comply with a few additional rules (which you don't), and other projects would be unable to use your code as part of their software (defeating the point of the open-source system).

In short, you can't require your end users to do much of anything, or place restrictions on the redistribution of your code, without violating the terms of the GPL. As soon as a person owns software covered by the GPL, they have the ability to use, modify, and redistribute it as they please: even if you say in the README that they have to purchase a license, they don't: they already have one.

Fear not, however: there is an easy solution to permit you to distribute your code as GPL3+ while also requesting donations and prohibiting commercial redistribution. Simply rephrase your additional line that requires that long-term users purchase a license to one that asks for donations, and uses the currently existing price as a recommended donation. That would let Transity be included in debian, which would also cause Transity to be distributed as part of Ubuntu, Mint, and almost any other distro that isn't Arch or Fedora.

Its worth noting that you keep the ability to sell a commercial license to Transity, no matter what solution you pick. You can also chose to stop offering your code under the GPL altogether, and simply have it exist as a source-available paid software product (whose source is copyrighted and may not be redistributed) or even just as a standard proprietary software application. You could even distribute the GPL'd source only to those who buy your product. The thing you can't do is give people GPL'd code, then ask them to give you money later.

While the example given in the README file under "Journal File Format" is valid YAML, I had to make changes to it because in its original form I got errors like:

Couldn't decode Array: Value is not a String

That error is given by the utc field when the string is not quoted. Once quoted things started to work.

Here's the version with quoted utc:

owner: anna
commodities:
  - id: €
    name: Euro
    alias:
      - EUR
    note: Currency used in the European Union
    utc: '2017-04-02 19:33:53'

entities:
  - id: anna
    name: Anna Smith
    utc: '2017-04-02 19:33:28'
    tags:
      - person
    accounts:
      - id: wallet
        name: Wallet
        note: Anna's black wallet
        utc: '2017-04-02 19:33:28'
        tags:
          - wallet

  - id: evil-corp
    name: Evil Corporation
    utc: '2017-04-02 19:33:28'
    note: The Evil Corporation in the United States of Evil
    tags:
      - company

transactions:
  - title: Purchase of evil machine
    transfers:
      - utc: '2017-02-17'
        from: anna
        to: evil-corp
        amount: 50000 €
      - utc: '2017-02-17'
        from: evil-corp
        to: anna
        amount: 1 evil-machine

In bash it's impossible to paste it, since it gets an error in this line and parsing break from that.

In zsh it also gives an error:

Am I doing something wrong?

Minimal example file:

<?xml version="1.0" encoding="UTF-8" ?>
<Document 
  xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03 pain.001.001.03.xsd"
>
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>JustATest123</MsgId>
      <CreDtTm>2022-08-26T14:45:57Z</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>1</CtrlSum>
      <InitgPty><Nm>Test GmbH</Nm></InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>Submitter123</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <BtchBookg>false</BtchBookg>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>1</CtrlSum>
      <PmtTpInf><SvcLvl><Cd>SEPA</Cd></SvcLvl></PmtTpInf>
      <ReqdExctnDt>2022-08-26</ReqdExctnDt>
      <Dbtr><Nm>Test GmbH</Nm></Dbtr>
      <DbtrAcct><Id><IBAN>DExxxxxxxxxx</IBAN></Id></DbtrAcct>
      <DbtrAgt><FinInstnId><BIC>BANKXXXXXXX</BIC></FinInstnId></DbtrAgt>
      <ChrgBr>SLEV</ChrgBr>
      <CdtTrfTxInf>
        <PmtId><EndToEndId>NOTPROVIDED</EndToEndId></PmtId>
        <Amt><InstdAmt Ccy="EUR">1.00</InstdAmt></Amt>
        <Cdtr><Nm>John Doe</Nm></Cdtr>
        <CdtrAcct><Id><IBAN>DEyyyyyyy</IBAN></Id></CdtrAcct>
        <Purp><Cd>53</Cd></Purp>
        <RmtInf><Ustrd>Test Transaction</Ustrd></RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
  </CstmrCdtTrfInitn>
</Document>

I have multiple accounts from which I transfer money. I would like to have an option to see total spent amount from all my accounts.

Before diving into the Readme, I thought this tool would allow me to record spendings from the command-line, something like
transity transaction --to anna --amount 300€ accounting.yaml (with --from being inferred to my default account)

Did I miss something in the Readme or have I misunderstood the purpose of this tool?

In the original post it was announced that it ought to be possible to change the view point of journal

https://feram.io/blog/2018-06-05_transity_the_future_of_plain_text_accounting/

How does this work and how do I use it?

I get the following upon running npm install --global transity:

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] postinstall: `make postinstall`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] postinstall script.
npm ERR! This is probably not a problem with npm. There is likely additional log
ging output above.

Typing "make" on the command line gives 'make' is not recognized as an internal or external command, operable program or batch file.

Platform: Windows 10, 64-bit