{
    "info": {
        "author": "Aden Herold",
        "author_email": "aden.herold1@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# django-typomatic\n_A simple solution for generating Typescript interfaces from your [Django Rest Framework Serializers](https://www.django-rest-framework.org/api-guide/serializers/)._\n\nSince I now require a simple package to generate Typescript interfaces for Django Rest Framework serializers, I've decided to port over my [Typemallow](https://github.com/adenh93/typemallow/) package for use with DRF serializers!\n\n### Usage:\n\n_Using django-typomatic is just as simple!_\n\nFirst, install the package \n`pip install django-typomatic`\n\nNext, for your Django Rest Framework serializers that you wish to generate Typescript interfaces for, simply import `ts_interface` and `generate_ts` from the `django_typomatic` module, and add the `@ts_interface()` class decorator to your Django Rest Framework serializer class.\n\nAll that is required to generate your Typescript interfaces is to call the `generate_ts()` function, and provide a filepath as a parameter to output the result.\n\n_main.py_\n```python\nfrom django_typomatic import ts_interface, generate_ts\nfrom rest_framework import serializers\n\n\n@ts_interface()\nclass Foo(serializers.Serializer):\n    some_field = serializers.CharField()\n    another_field = serializers.DateTimeField()\n\n\ngenerate_ts('./output.ts')\n```\n\n_output.ts_\n```typescript\nexport interface Foo {\n    some_field: string;\n    another_field: date;\n}\n```\n\n_django-typomatic_ supports nested serializers, as well as list fields and other fields that act as lists (any field with many=True)\n\n_main.py_\n```python\nfrom django_typomatic import ts_interface, generate_ts\nfrom rest_framework import serializers\n\n\n@ts_interface()\nclass Foo(serializers.Serializer):\n    some_field = serializers.IntegerField(many=True)\n    another_field = serializers.CharField()\n\n\n@ts_interface()\nclass Bar(serializers.Serializer):\n    foo = Foo()\n    foos = Foo(many=True)\n    bar_field = serializers.CharField()\n```\n_output.ts_\n```typescript\nexport interface Foo {\n    some_field: number[];\n    another_field: string;\n}\n\nexport interface Bar {\n    foo: Foo;\n    foos: Foo[];\n    bar_field: string;\n}\n```\n\n### Extended Usage:\nThe `@ts_interface()` decorator function accepts an optional parameter, _context_, which defaults to... well... 'default'.\n\n\"_Why is this the case?_\" \n\nWhen a Serializer is identified with with `@ts_interface` decorator, it is added to a list in a dictionary of serializers, with the dictionary key being the value provided to the _context_ parameter. If you were to provide different contexts for each serializer, additional keys will be created if they do not exist, or the serializer will simply be appended to the list at the existing key.\n\nThis comes in handy, as the `generate_ts()` function _also_ accepts an optional _context_ parameter, which will filter only serializers in the dictionary at the specific key.\n\nThis is useful if you wish to output different contexts to different files, e.g.\n\n_main.py_\n```python\n...\nfrom django_typomatic import ts_interface, generate_ts\nfrom rest_framework import serializers\n\n\n@ts_interface(context='internal')\nclass Foo(serializers.Serializer):\n    foo = serializers.CharField()\n\n\n@ts_interface(context='internal')\nclass Bar(serializers.Serializer):\n    bar = serializers.CharField()\n\n\n@ts_interface(context='external')\nclass FooBar(serializers.Serializer):\n    foo_bar = serializers.CharField()\n\n\n''' \nwe're telling django-typomatic that we only want to generate interfaces from serializers with \nan 'internal' context to './internal.ts' \n'''\ngenerate_ts('./internal.ts', context='internal')\n\n''' \nonly generate interfaces from serializers with an 'external' context to './external.ts' \n'''\ngenerate_ts('./external.ts', context='external')\n```\n\n_internal.ts_\n```typescript\nexport interface Foo {\n    foo: string;\n}\n\nexport interface Bar {\n    bar: string;\n}\n```\n\n_external.ts_\n```typescript\nexport interface FooBar {\n    foo_bar: string;\n}\n```\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/adenh93/django_typomatic",
        "keywords": "Django,Django Rest Framework,DRF,Typescript,Python",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "django-typomatic",
        "package_url": "https://pypi.org/project/django-typomatic/",
        "platform": "any",
        "project_url": "https://pypi.org/project/django-typomatic/",
        "project_urls": {
            "Homepage": "https://github.com/adenh93/django_typomatic"
        },
        "release_url": "https://pypi.org/project/django-typomatic/0.0.1/",
        "requires_dist": [
            "django",
            "django-rest-framework"
        ],
        "requires_python": "",
        "summary": "A simple solution for generating Typescript interfaces from your Django Rest Framework Serializers.",
        "version": "0.0.1"
    },
    "last_serial": 5703472,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "85467dbf2b79743eedbae2afcb3a9323",
                    "sha256": "63e48d1e127636a27d02d65752fa6f4ef34f8c71c3dbbb2fe727ba6ed1928fff"
                },
                "downloads": -1,
                "filename": "django_typomatic-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "85467dbf2b79743eedbae2afcb3a9323",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 16201,
                "upload_time": "2019-08-20T13:54:05",
                "url": "https://files.pythonhosted.org/packages/4c/b7/4aa25104cff3670e8911971ff5d661938070e33c4a79db5b522a182156d7/django_typomatic-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "b2c621a4bd3acdd215ae01718dcea245",
                    "sha256": "77459f2b1ec4e3c0f59c7385d245267845db76289d8e08d831db75fda8ca7800"
                },
                "downloads": -1,
                "filename": "django-typomatic-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "b2c621a4bd3acdd215ae01718dcea245",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 3645,
                "upload_time": "2019-08-20T13:54:10",
                "url": "https://files.pythonhosted.org/packages/cc/58/bbab96e32ee9be2b37111e3391d06dec072437d48b1ec34553ccf73b469f/django-typomatic-0.0.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "85467dbf2b79743eedbae2afcb3a9323",
                "sha256": "63e48d1e127636a27d02d65752fa6f4ef34f8c71c3dbbb2fe727ba6ed1928fff"
            },
            "downloads": -1,
            "filename": "django_typomatic-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "85467dbf2b79743eedbae2afcb3a9323",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 16201,
            "upload_time": "2019-08-20T13:54:05",
            "url": "https://files.pythonhosted.org/packages/4c/b7/4aa25104cff3670e8911971ff5d661938070e33c4a79db5b522a182156d7/django_typomatic-0.0.1-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "b2c621a4bd3acdd215ae01718dcea245",
                "sha256": "77459f2b1ec4e3c0f59c7385d245267845db76289d8e08d831db75fda8ca7800"
            },
            "downloads": -1,
            "filename": "django-typomatic-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b2c621a4bd3acdd215ae01718dcea245",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 3645,
            "upload_time": "2019-08-20T13:54:10",
            "url": "https://files.pythonhosted.org/packages/cc/58/bbab96e32ee9be2b37111e3391d06dec072437d48b1ec34553ccf73b469f/django-typomatic-0.0.1.tar.gz"
        }
    ]
}