{
    "info": {
        "author": "hl037",
        "author_email": "hl037.prog@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 4 - Beta",
            "Environment :: Console",
            "Intended Audience :: Developers",
            "Intended Audience :: Education",
            "Intended Audience :: Science/Research",
            "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
            "Natural Language :: English",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3",
            "Topic :: Other/Nonlisted Topic",
            "Topic :: Scientific/Engineering",
            "Topic :: Utilities"
        ],
        "description": "======\nTOREFL\n======\n\nTOREFL means To REFerence List, as the list of publications you will like to reference later when you will write some latex documents... And since some parts were developed at Paris, you will get the... reference (pun intended)\n\nFeatures\n========\n\n* Non-verbose command line interface\n* Easy management of references with tags, rating etc.\n* Pdf and metadata saved in the file system\n* Easy opening of a reference from its name or its ID\n* Powerful search and system on description, tags, rating, and any bibtex fields\n* Memorization of the selection you made (you can assign the result of a filter to sort of variable called register to match vim vocabulary)\n* Export to bibtex format of either the entire bibliography either only a selection\n* Possibility to edit the metadata from the software\n* Easy to extend (create other formatters, exports, filter etc.\n\nPhilosophy\n==========\n\nThis software is meant to respect KISS principles i.e. to be as simple as possible.\n\nTo use it, you only need to have a bibliography directory, and put all your pdf in it. The name of the pdf will be the bibtex identifier for using with the ``\\cite`` command. Then, just touch a file with the same name but the ``.torefl`` extension.\n\nso you should have a file tree like this ::\n\n    biblio\n    |--topology\n    |  |--MorseTheory.pdf\n    |  |--MorseTheory.torefl\n    |  |--ReebGraph.pdf\n    |  |--ReebGraph.torefl\n    |--Other\n    |  |--Matrices.pdf\n    |  |--Matrices.torefl\n    |--SuperArticle.pdf\n    |--SuperArticle.torefl\n\n.torefl format\n==============\n\nThis file can be either empty, either contain only the reference in bibtex format, either contain some meta-data (format described below) and the bibtex both separated by a line starting with 16 stars : ``****************``\n\nExample::\n\n    #NotRead #Topology @10 \n    \n    Presentation of the #Morse Morse Theory\n    \n    @-55.0\n    \n    ****************\n    \n    @book{9781400881802,\n      Author = {John Milnor},\n      Title = {Morse Theory. (AM-51) (Annals of Mathematics Studies)},\n      Publisher = {Princeton University Press},\n      Year = {1963},\n      ISBN = {9781400881802},\n    }\n\n**Note :** the identifier given in the bibtex will be discarded at export, and replaced by the name of the file without the extension\n\nMetadata format\n---------------\n\nThe metadata are basically a comment for yourself of the referenced article, a sum up, a description or whatever you like. You can also specify tags you will be able to search on, and also a rating that has the meaning you want, you will also be able to search on, with comparators like lesser than greater than etc.\n\nTags\n~~~~\n\nA tag is surrounded by two spaces, and begins with a ``#``. It will be converted to CamelCase starting with an uppercase letter. ``#TAG`` will become ``#Tag``, ``#test_tag`` will be converted to ``#TestTag``.\n\nRating\n~~~~~~\n\nThe rating is surrounded by two spaces it begins by ``@`` followed by a positive or negative, int or float number. If there are several ratings in the metadata, only the last one will be used, the others will be discarded.\n\nComment\n~~~~~~~\n\nThe parser removes all the tags and the ratings, and strip all spaces before and after the remaining. The remaining is what is called the \"comment\", or \"description\". It's user-defined, and you will also be able to search for string appearing in the comments.\n\nFrom the previous example\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIn the previous example, the tags are ``#NotRead``, ``#Topology`` and ``#Morse``, the rating is ``-55.0`` (the ``@10`` being discarded), and the comment is \"Presentation of the Morse Theory\".\n\nUsing Torefl\n============\n\nTo use Torefl, just go to your bibliography root, and type::\n\n    $> torefl\n\n(the ``$>`` means you are a standard user in your operating system)\n\nThen, a command line appears. Here is a list of the commands :\n\nCommand List\n============\n\nEach command has a short and a long alias. Different aliases are separated by a coma below.\n\nl, list\n-------\n\n::\n\n    torefl>l [ [ [-leg] /path/*/patern/* ] [ #tags ]... [ @[ < | > | <= | >= | = ] ]... [ -bib [ [field] [content] ]... ] [-com [commentSearch] ]...\n\nLists the entries using or not a filter. There are 3 filters currently, legacy ( ``-leg``) (default filter at the begin), bibtex (``-bib``) and comment (``-com``). You can switch between them using the ``-xxx`` corresponding.\n\nWithout arguments, it just lists all the entries in the bibliography\n\nYou can combine them at your will, it will do an AND between the results. For a or, just do the filter twice, and use the selections (explained below)\n\nlegacy filter\n~~~~~~~~~~~~~\n\nLegacy because it is the first filter I did, and I added the other ones after.\n\nThe first parameter is a path to look into, using unix glob pattern. Then, you can add tags and priority filters. Tags will filter all articles with the given tags appearing in the ``.torefl``.\nRating start with ``@``, then a comparator (left member is the rating of the article, right member is the number to compare) followed by the number to compare to. ``@<30`` will give all entries with priority lesser than 30.\n\nbibtex filter\n~~~~~~~~~~~~~\n\nBibtex filter is a list of pairs ``field content``, and will keep only entries with a bibtex containing ``content`` in the field ``field``. You can put several field/content pairs and it will combine them with an AND between the results\n\ncomment filter\n~~~~~~~~~~~~~~\n\nThe comment filter just filters the entries containing all the arguments given to the filter\n\no, open\n-------\n\n::\n\n    torefl>o <ID|Name>\n\nOpens ID (The blue number when listed using the default formatter) or the name (same identifier than used with \\cite, i.e. the file name without extension) with the command given in the configuration key ``open_cmd``.\n\ned, edit\n--------\n\n::\n\n   torefl>ed  <ID|Name>\n\nOpens the ``.torefl`` file corresponding to ID (The blue number when listed using the default formatter) or Name (same identifier than used with \\cite, i.e. the file name without extension) with the command given in the configuration key ``edit_cmd``, and refresh the database.\n\ns, sel, selection\n-----------------\n\nThis command permits to work with selections. Its syntax is just a mind f***. Any suggestion to improve it is definitively welcome !!!\n\n::\n\n    torefl>s <register> <operator> [register]\n\n``register`` can be any register name. ``operator`` is an operator amoung ``|=`` (union), ``&=`` (intersection), ``^=`` (symetric difference), ``-=`` (difference) and ``=`` (copy).\nThe left member is assigned the result of the operation. The right member can be either empty (it will use the result of the previous list call) either ``0`` (the empty set), either another register name.\n\nTo do a 'OR' filter, one can do ::\n\n    torefl>l [filter]\n    torefl>s a =\n    torefl>l [filter2]\n    torefl>s a |=\n    torefl>ls a\n\nls\n---\n\nList Selection ::\n\n    torefl>ls <register>\n\nList the content of ``register``\n\ne, export\n---------\n\n::\n\n    torefl>e bib <filename> [register]\n\nExports in bibtex format the selection in register if given, else the selection of the previous call to ``list``. You have to type the ``bib`` because other exporters could be supported in the future (like an html exporter or other reference list formats)",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/hl037/torefl",
        "keywords": "torefl,bibtex,bibliography,reference,pdf,management",
        "license": "GPL",
        "maintainer": "",
        "maintainer_email": "",
        "name": "torefl",
        "package_url": "https://pypi.org/project/torefl/",
        "platform": "",
        "project_url": "https://pypi.org/project/torefl/",
        "project_urls": {
            "Homepage": "https://github.com/hl037/torefl"
        },
        "release_url": "https://pypi.org/project/torefl/1.0b4/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Software to manage references",
        "version": "1.0b4"
    },
    "last_serial": 3921744,
    "releases": {
        "1.0b1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "bef15fd916cea113bb0b6e680757ddc5",
                    "sha256": "06c90c195bfc78f10014d80884a1a80fde7e76b46858374c2cf0dc8f24c4fe5b"
                },
                "downloads": -1,
                "filename": "torefl-1.0b1.tar.gz",
                "has_sig": false,
                "md5_digest": "bef15fd916cea113bb0b6e680757ddc5",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 16541,
                "upload_time": "2017-06-20T00:02:40",
                "url": "https://files.pythonhosted.org/packages/23/62/b904e737002a325171f1633d9774a574cafee904e7f906fd9de7bd5e1463/torefl-1.0b1.tar.gz"
            }
        ],
        "1.0b2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ef6ddc510ebd008fe2823804202da88a",
                    "sha256": "2449b6f7901d49f6a5aebe711bfb0cfd2ea4d92723939c7b0c34e0b146b48641"
                },
                "downloads": -1,
                "filename": "torefl-1.0b2.tar.gz",
                "has_sig": false,
                "md5_digest": "ef6ddc510ebd008fe2823804202da88a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 16646,
                "upload_time": "2017-06-20T11:44:42",
                "url": "https://files.pythonhosted.org/packages/7d/41/adff0d3a011fcf95903d782200883bcb049b5aa86d33bae2d6933c5facc1/torefl-1.0b2.tar.gz"
            }
        ],
        "1.0b3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "696f75c7e3788a638366f5ef882b0fcb",
                    "sha256": "ebc8fbb6bf6934c2667712dace5e11c8dfbf2b69dffebbcc7121d4883f83c40d"
                },
                "downloads": -1,
                "filename": "torefl-1.0b3.tar.gz",
                "has_sig": false,
                "md5_digest": "696f75c7e3788a638366f5ef882b0fcb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 16682,
                "upload_time": "2017-07-04T21:33:22",
                "url": "https://files.pythonhosted.org/packages/11/6e/60b35737f0cf724bce66a57045d9f2b29c76323b5e5c266322c4ebf8a63a/torefl-1.0b3.tar.gz"
            }
        ],
        "1.0b4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8967d02a3dede82e1bd126a731122dd1",
                    "sha256": "6c77a4bf2af9f870bad562185242f55b946b68e1ace4a9c54dc7f5f08a08426d"
                },
                "downloads": -1,
                "filename": "torefl-1.0b4.tar.gz",
                "has_sig": false,
                "md5_digest": "8967d02a3dede82e1bd126a731122dd1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14287,
                "upload_time": "2018-06-01T18:16:46",
                "url": "https://files.pythonhosted.org/packages/a1/a7/28ddbcc4d281900073297d6a819b5489fa7cfe683b22bf6cd8c02b6fb4fc/torefl-1.0b4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "8967d02a3dede82e1bd126a731122dd1",
                "sha256": "6c77a4bf2af9f870bad562185242f55b946b68e1ace4a9c54dc7f5f08a08426d"
            },
            "downloads": -1,
            "filename": "torefl-1.0b4.tar.gz",
            "has_sig": false,
            "md5_digest": "8967d02a3dede82e1bd126a731122dd1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 14287,
            "upload_time": "2018-06-01T18:16:46",
            "url": "https://files.pythonhosted.org/packages/a1/a7/28ddbcc4d281900073297d6a819b5489fa7cfe683b22bf6cd8c02b6fb4fc/torefl-1.0b4.tar.gz"
        }
    ]
}