{"id":16700142,"url":"https://github.com/guyzmo/clait","last_synced_at":"2025-04-10T03:51:12.195Z","repository":{"id":62562446,"uuid":"70285644","full_name":"guyzmo/clait","owner":"guyzmo","description":"Command Line Accounting \u0026 Invoicing Tool","archived":false,"fork":false,"pushed_at":"2020-04-29T22:50:34.000Z","size":114,"stargazers_count":13,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-24T05:05:18.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guyzmo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-07T21:52:46.000Z","updated_at":"2017-07-19T02:42:01.000Z","dependencies_parsed_at":"2022-11-03T15:30:56.174Z","dependency_job_id":null,"html_url":"https://github.com/guyzmo/clait","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyzmo%2Fclait","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyzmo%2Fclait/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyzmo%2Fclait/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guyzmo%2Fclait/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guyzmo","download_url":"https://codeload.github.com/guyzmo/clait/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248145119,"owners_count":21055058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T18:09:32.182Z","updated_at":"2025-04-10T03:51:12.173Z","avatar_url":"https://github.com/guyzmo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clait\n\nA tool to generate nicely formatted and LaTeX generated invoices.\n\n## How to install?\n\njust run:\n\n    pip3 install .\n\n## How to develop?\n\n    virtualenv var\n    var/bin/pip3 install -r requirements.txt\n    var/bin/pip3 install -e .\n\nyou'll find the tool in:\n\n    var/bin/clait\n\n## External dependency\n\nyou need to make sure you have installed the texlive suite, along with\nthe `pdflatex` tool. No special LaTeX library is needed.\n\n## How to use?\n\ncreate a directory such as `paperwork`, within it create two files:\n\n`invoices_config.yaml`:\n\nthat will contain the name of the template (`format` key) the path to the pdflatex tool,\nand in `source` all the custom information for your billing.\n\n```\nformat: french\nprefix:\n  invoice: FA\n  quote: DV\nsource:\n    name: Ford Prefect\n    address:\n        - Hyperspace bypass\n        - Earth\n    telephone: +44 777 7777 7777\n    website: http://mostly.harmless.com\n    email: ford.prefect@mostly.harmless.com\n    siren: 111 222 333\n    ape: 9602A\n    payment_delay: 30 jours\n    bank:\n        rib:\n            - 00001\n            - 00002\n            - 00000000001\n            - 42\n        iban: FR42 0000 1000 0200 0000 0000 142\n        bics: FOOBARFUBAR\ntools:\n    pdflatex: /usr/local/texlive/2014/bin/universal-darwin/pdflatex\n```\n\n`invoices_list.yaml`:\n\nthat will contain a list of `!invoice` objects. The `iid` will be the unique reference\nof the invoice. Then all the elements are as defined by the template.\n\n\n```\n- !invoice\n  iid: 201410-001\n  date: 2014-10-02\n  kind: paid\n  customer: !customer\n    address: [Alpha du centaure]\n    name: Zaphod Beeblebrox\n  subject: Voyage en dauphin\n  desc: \"Pr\\xE9paration et embarquation sur un dauphin \\xE0 travers les mers\"\n  place: Babylon\n  products:\n  - !product\n    descr: Soutien psychologique du dauphin\n    price: 430\n    qty: 1\n  - !offer\n    descr: Discount because I'm nice\n    price: 20\n    qty: 1\n```\n\n## How to run?\n\nTo generate all your invoices, in the `paperwork` directory:\n\n    clait -d paperwork generate\n\nIf you want your tax calculation:\n\n    clait -d paperwork results quarterly\n    clait -d paperwork results yearly\n\nAnd finally, to launch the webapp, use\n\n    clait -d paperwork api\n\nIf you've made a change to an invoice and need to regenerate, just remove\nthe pdf file!\n\n\n## How will it look like?\n\nhere's a shot of one of the example invoices:\n\n![IV201410-001.pdf](https://github.com/guyzmo/clait/blob/master/examples/IV201410-001.pdf.png)\n\n## License\n\nThis code is licensed under the GPLv3.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguyzmo%2Fclait","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguyzmo%2Fclait","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguyzmo%2Fclait/lists"}