{"id":22011391,"url":"https://github.com/mutlusun/csv2bibtex","last_synced_at":"2025-03-23T07:43:39.336Z","repository":{"id":174741305,"uuid":"339969744","full_name":"mutlusun/csv2bibtex","owner":"mutlusun","description":"A small utility to parse CSV files to Bib(La)TeX files.","archived":false,"fork":false,"pushed_at":"2022-05-28T11:14:03.000Z","size":210,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-28T14:37:12.638Z","etag":null,"topics":["biblatex","bibtex","converter","csv","parser","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mutlusun.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-18T07:30:04.000Z","updated_at":"2025-01-08T18:45:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"e9c570c3-fb0b-469b-86fb-fe0d22ccbdc5","html_url":"https://github.com/mutlusun/csv2bibtex","commit_stats":null,"previous_names":["mutlusun/csv2bibtex"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutlusun%2Fcsv2bibtex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutlusun%2Fcsv2bibtex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutlusun%2Fcsv2bibtex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutlusun%2Fcsv2bibtex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mutlusun","download_url":"https://codeload.github.com/mutlusun/csv2bibtex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245072252,"owners_count":20556353,"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":["biblatex","bibtex","converter","csv","parser","rust"],"created_at":"2024-11-30T02:16:50.445Z","updated_at":"2025-03-23T07:43:39.312Z","avatar_url":"https://github.com/mutlusun.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# csv2bibtex\n\nA small command line utility to parse CSV files to Bib(La)TeX files.\n\n\n## Usage\n\n```\ncsv2bibtex 0.2.0\nmutluyuz\n\n\nUSAGE:\n    csv2bibtex [OPTIONS] \u003cINPUT\u003e \u003cOUTPUT\u003e\n\nARGS:\n    \u003cINPUT\u003e     Input file to use\n    \u003cOUTPUT\u003e    Output file to use\n\nOPTIONS:\n        --biblatex                  Print output in BibLaTeX mode (default)\n        --bibtex                    Print output in BibTeX mode\n    -d, --delimiter \u003cDELIMITER\u003e     Delimiter between cells in CSV file\n    -f, --field-mapping \u003cFIELD\u003e     Assignment of csv fields to bibtex fields\n    -h, --help                      Print help information\n    -l, --lazy                      Try to recover from as much errors as possible.\n        --no-defaults               Don't add default field mappings and verbatim fields.\n    -v, --verbosity \u003cLEVEL\u003e         Verbosity level, either DEBUG, INFO, WARN, or ERROR\n    -V, --version                   Print version information\n        --verbatim-field \u003cFIELD\u003e    Bib(La)TeX verbatim fields, like url, file or doi\n```\n\nUsage is really intuitive: `csv2bibtex INPUTFILE OUTPUTFILE`. CSV fields can be \nmapped to BibTeX fields with the `--field-mapping` argument. In the following \nexample, the CSV field `AUTH` is mapped to the BibTeX field `author`:\n\n```\ncsv2bibtex \\\n    --field-mapping \"author=[[AUTH]]\" \\\n    input.csv \\\n    output.bib\n```\n\nThe CSV field has to be enclosed betwee `[[` and `]]`. This offers the \npossibility to add regular characters like in the following example:\n\n```\ncsv2bibtex \\\n    --field-mapping \"pages=[[StartPage]]--[[EndPage]]\" \\\n    --field-mapping \"journal=My Great Journal\" \\\n    input.csv \\\n    output.bib\n```\n\nThere are two special fields: `entrytype` and `bibtexkey`. The former specifies \nthe type of the BibTeX entry, the latter the BibTeX key. They can be used like \nany other field (see above). In addition, there are some default field mappings \nset (like `title=[[titles]]`, use `--no-defaults` to prevent this).\nThe field mapping argument can be given multiple times to map multiple fields.\n\nThe `--verbatim-field` argument can be used to not escape a certain field\n(e.g., `file`, `doi`, or `url`). This means that for example an url like\n\"https://www.example.com/?1234%56\" stays this way and is not changed to \n\"https://www.example.com/?1234\\\\%56\".\n\n\n## Installation\n\nThis is a small rust utility. You have to install \n[rust](https://www.rust-lang.org/) and execute the following commands:\n\n```\ngit clone https://codeberg.org/mutluyuz/csv2bibtex\ncd csv2bibtex\ncargo install --path .\n```\n\n\n## Bugs and Contributing\n\nOf course there are not any bugs in this software. However, you may encounter \nunexpected behavior. Please report them at \nhttps://codeberg.org/mutluyuz/csv2bibtex/issues.\nPlease use also the Codeberg page for pull requests.\n\n## Speed\n\nSome very rough benchmarking on my (rather old) laptop yielded about 500.000\nprocessed lines per second. However, this depends on the number of fields and\nthus, runtime might be a bit slower or faster. You can run your own benchmarks\nwith `cargo bench`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmutlusun%2Fcsv2bibtex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmutlusun%2Fcsv2bibtex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmutlusun%2Fcsv2bibtex/lists"}