openscad-docsgen


Nameopenscad-docsgen JSON
Version 2.0.44 PyPI version JSON
download
home_pageNone
SummaryA processor to generate Markdown code documentation with images from OpenSCAD source comments.
upload_time2024-05-05 02:14:39
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseNone
keywords openscad documentation generation docs generation docsgen
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ################################
OpenSCAD Documentation Generator
################################

This package generates wiki-ready GitHub flavored markdown documentation pages from in-line source
code comments.  This is similar to Doxygen or JavaDoc, but designed for use with OpenSCAD code.
Example images can be generated automatically from short example scripts.

Documentation about how to add documentation comments to OpenSCAD code can be found at
`https://github.com/revarbat/openscad_docsgen/blob/main/WRITING_DOCS.md`


Installing openscad-docsgen
---------------------------

The easiest way to install this is to use pip::

    % pip3 install openscad_docsgen
    
To install directly from these sources, you can instead do::

    % python3 setup.py build install


Using openscad-docsgen
----------------------

The simplest way to generate documentation is::

    % openscad-docsgen -m *.scad

Which will read all of .scad files in the current directory, and writes out documentation
for each .scad file to the ``./docs/`` dir.  To write out to a different directory, use
the ``-D`` argument::

    % openscad-docsgen -D wikidir -m *.scad

To write out an alphabetical function/module index markdown file, use the ``-i`` flag::

    % openscad-docsgen -i *.scad

To write out a Table of Contents markdown file, use the ``-t`` flag::

    % openscad-docsgen -t *.scad

To write out a CheatSheet markdown file, use the ``-c`` flag.  In addition, you can
specify the project name shown in the CheatSheet with the ``-P PROJECTNAME`` argument::

    % openscad-docsgen -c -P "My Foobar Library" *.scad
    
A Topics index file can be generated by passing the ``-I`` flag::

    % openscad-docsgen -I *.scad
    
You can just test for script errors more quickly with the ``-T`` flag (for test-only)::

    % openscad-docsgen -m -T *.scad

By default, the target output profile is to generate documentation for a GitHub Wiki.
You can output for a more generic Wiki with ``-p wiki``::

    % openscad-docsgen -ticmI -p wiki *.scad


Docsgen Configuration File
--------------------------
You can also make more persistent configurations by putting a `.openscad_docsgen_rc` file in the
directory you will be running openscad-docsgen from.  It can look something like this::

    DocsDirectory: WikiDir/
    TargetProfile: githubwiki
    ProjectName: The Foobar Project
    GeneratedDocs: Files, ToC, Index, Topics, CheatSheet
    SidebarHeader:
      ## Indices
      .
    SidebarMiddle:
      [Tutorials](Tutorials)  
    IgnoreFiles:
      foo.scad
      std.scad
      version.scad
      tmp_*.scad
    PrioritizeFiles:
      First.scad
      Second.scad
      Third.scad
      Fourth.scad
    DefineHeader(BulletList): Side Effects
    DefineHeader(Table;Headers=Anchor Name|Position): Extra Anchors

For an explanation of the syntax and the specific headers, see:
`https://github.com/revarbat/openscad_docsgen/blob/main/WRITING_DOCS.md`

Using openscad-mdimggen
-----------------------
If you have MarkDown based files that you would like to generate images for, you can use the
`openscad_mdimggen` command.  It can take the following arguments::

    -h, --help            Show help message and exit
    -D DOCS_DIR, --docs-dir DOCS_DIR
                          The directory to put generated documentation in.
    -P FILE_PREFIX, --file-prefix FILE_PREFIX
                          The prefix to put in front of each output markdown file.
    -T, --test-only       If given, don't generate images, but do try executing the scripts.
    -I IMAGE_ROOT, --image_root IMAGE_ROOT
                          The directory to put generated images in.
    -f, --force           If given, force regeneration of images.
    -a, --png-animation   If given, animations are created using animated PNGs instead of GIFs.

What `openscad-mdimggen` will do is read the input MarkDown file and look for fenced scripts of
OpenSCAD code, that starts with a line of the form::

    ```openscad-METADATA

It will copy all non-script lines to the output markdown file, and run OpenSCAD for each of the
found fenced scripts, inserting the generated image into the output MarkDown file after the script block.
The METADATA for each script will define the viewpoint and other info for the given generated image.
This METADATA takes the form of a set of semi-colon separated options that can be any of the following:

- ``NORENDER``: Don't generate an image for this example, but show the example text.
- ``ImgOnly``: Generate and show the image, but hide the text of the script.
- ``Hide``: Generate, but don't show script or image.  This can be used to generate images to be manually displayed in markdown text blocks.
- ``2D``: Orient camera in a top-down view for showing 2D objects.
- ``3D``: Orient camera in an oblique view for showing 3D objects.
- ``VPT=[10,20,30]`` Force the viewpoint translation `$vpt` to `[10,20,30]`.
- ``VPR=[55,0,600]`` Force the viewpoint rotation `$vpr` to `[55,0,60]`.
- ``VPD=440``: Force viewpoint distance `$vpd` to 440.
- ``VPF=22.5``: Force field of view angle `$vpf` to 22.5.
- ``Spin``: Animate camera orbit around the `[0,1,1]` axis to display all sides of an object.
- ``FlatSpin``: Animate camera orbit around the Z axis, above the XY plane.
- ``Anim``: Make an animation where `$t` varies from `0.0` to almost `1.0`.
- ``FrameMS=250``: Sets the number of milliseconds per frame for spins and animation.
- ``FPS=8``: Sets the number of frames per second for spins and animation.
- ``Frames=36``: Number of animation frames to make.
- ``Small``: Make the image small sized.
- ``Med``: Make the image medium sized.
- ``Big``: Make the image big sized.
- ``Huge``: Make the image huge sized.
- ``Size=880x640``: Make the image 880 by 640 pixels in size.
- ``Render``: Force full rendering from OpenSCAD, instead of the normal preview.
- ``Edges``: Highlight face edges.
- ``NoAxes``: Hides the axes and scales.
- ``NoScales``: Hides the scale numbers along the axes.
- ``ColorScheme``: Generate the image using a specific color scheme
  - Usage: ``ColorScheme=<color scheme name>`` (e.g. ``ColorScheme=BeforeDawn``)
  - Default color scheme: ``Cornfield``
  - Predefined color schemes: ``Cornfield``, ``Metallic``, ``Sunset``, ``Starnight``, ``BeforeDawn``, ``Nature``, ``DeepOcean``, ``Solarized``, ``Tomorrow``, ``Tomorrow Night``, ``Monotone``
  - Color schemes defined as a [Read-only Resource](https://github.com/openscad/openscad/wiki/Path-locations#read-only-resources) or [User Resource](https://github.com/openscad/openscad/wiki/Path-locations#user-resources) are also supported.

For example::

    ```openscad-FlatSpin;VPD=500
    prismoid([60,40], [40,20], h=40, offset=[10,10]);
    ```

Will generate an animated flat spin of the prismoid at a viewing distance of 500.  While::

    ```openscad-3D;Big
    prismoid([60,40], [40,20], h=40, offset=[10,10]);
    ```

Will generate a still image of the same prismoid, but at a bigger image size.

MDImgGen Configuration File
---------------------------
You can store defaults for ``openscad_mdimggen`` in the ``.openscad_mdimggen_rc`` file like this::

    docs_dir: "BOSL2.wiki"
    image_root: "images/tutorials"
    file_prefix: "Tutorial-"
    source_files: "tutorials/*.md"
    png_animations: true
    

External Calling
----------------
Here's an example of how to use this library, to get the parsed documentation data::

    import openscad_docsgen as docsgen
    from glob import glob
    from pprint import pprint
    dgp = docsgen.DocsGenParser(quiet=True)
    dgp.parse_files(glob("*.scad"))
    for name in dgp.get_indexed_names():
        data = dgp.get_indexed_data(name)
        pprint(name)
        pprint(data["description"])

The data for an OpenSCAD function, module, or constant generally looks like::

    {
        'name': 'Function&Module',  // Could also be 'Function', 'Module', or 'Constant'
        'subtitle': 'line_of()',
        'body': [],
        'file': 'distributors.scad',
        'line': 43,
        'aliases': ['linear_spread()'],
        'topics': ['Distributors'],
        'usages': [
            {
                'subtitle': 'Spread `n` copies by a given spacing',
                'body': ['line_of(spacing, <n>, <p1=>) ...']
            },
            {
                'subtitle': 'Spread copies every given spacing along the line',
                'body': ['line_of(spacing, <l=>, <p1=>) ...']
            },
            {
                'subtitle': 'Spread `n` copies along the length of the line',
                'body': ['line_of(<n=>, <l=>, <p1=>) ...']
            },
            {
                'subtitle': 'Spread `n` copies along the line from `p1` to `p2`',
                'body': ['line_of(<n=>, <p1=>, <p2=>) ...']
            },
            {
                'subtitle': 'Spread copies every given spacing, centered along the line from `p1` to `p2`',
                'body': ['line_of(<spacing>, <p1=>, <p2=>) ...']
            },
            {
                'subtitle': 'As a function',
                'body': [
                    'pts = line_of(<spacing>, <n>, <p1=>);',
                    'pts = line_of(<spacing>, <l=>, <p1=>);',
                    'pts = line_of(<n=>, <l=>, <p1=>);',
                    'pts = line_of(<n=>, <p1=>, <p2=>);',
                    'pts = line_of(<spacing>, <p1=>, <p2=>);'
                ]
            }
        ],
        'description': [
            'When called as a function, returns a list of points at evenly spread positions along a line.',
            'When called as a module, copies `children()` at one or more evenly spread positions along a line.',
            'By default, the line will be centered at the origin, unless the starting point `p1` is given.',
            'The line will be pointed towards `RIGHT` (X+) unless otherwise given as a vector in `l`,',
            '`spacing`, or `p1`/`p2`.',
        ],
        'arguments': [
            'spacing = The vector giving both the direction and spacing distance between each set of copies.',
            'n = Number of copies to distribute along the line. (Default: 2)',
            '---',
            'l = Either the scalar length of the line, or a vector giving both the direction and length of the line.',
            'p1 = If given, specifies the starting point of the line.',
            'p2 = If given with `p1`, specifies the ending point of line, and indirectly calculates the line length.'
        ],
        'see_also': ['xcopies()', 'ycopies()'],
        'examples': [
            ['line_of(10) sphere(d=1);'],
            ['line_of(10, n=5) sphere(d=1);'],
            ['line_of([10,5], n=5) sphere(d=1);'],
            ['line_of(spacing=10, n=6) sphere(d=1);'],
            ['line_of(spacing=[10,5], n=6) sphere(d=1);'],
            ['line_of(spacing=10, l=50) sphere(d=1);'],
            ['line_of(spacing=10, l=[50,30]) sphere(d=1);'],
            ['line_of(spacing=[10,5], l=50) sphere(d=1);'],
            ['line_of(l=50, n=4) sphere(d=1);'],
            ['line_of(l=[50,-30], n=4) sphere(d=1);'],
            [
                'line_of(p1=[0,0,0], p2=[5,5,20], n=6) '
                'cube(size=[3,2,1],center=true);'
            ],
            [
                'line_of(p1=[0,0,0], p2=[5,5,20], spacing=6) '
                'cube(size=[3,2,1],center=true);'
            ],
            [
                'line_of(l=20, n=3) {',
                '    cube(size=[1,3,1],center=true);',
                '    cube(size=[3,1,1],center=true);',
                '}'
            ],
            [
                'pts = line_of([10,5],n=5);',
                'move_copies(pts) circle(d=2);'
            ]
        ],
        'children': [
            {
                'name': 'Side Effects',
                'subtitle': '',
                'body': [
                    '`$pos` is set to the relative centerpoint of each child copy.',
                    '`$idx` is set to the index number of each child being copied.'
                ],
                'file': 'distributors.scad',
                'line': 88
            }
        ]
    }



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "openscad-docsgen",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "Revar Desmera <revarbat@gmail.com>",
    "keywords": "openscad, documentation generation, docs generation, docsgen",
    "author": null,
    "author_email": "Revar Desmera <revarbat@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/d8/d7/b892a56d984c730c66c0983ff3bec30566d6749c83d359bfe4ad6130b767/openscad_docsgen-2.0.44.tar.gz",
    "platform": null,
    "description": "################################\nOpenSCAD Documentation Generator\n################################\n\nThis package generates wiki-ready GitHub flavored markdown documentation pages from in-line source\ncode comments.  This is similar to Doxygen or JavaDoc, but designed for use with OpenSCAD code.\nExample images can be generated automatically from short example scripts.\n\nDocumentation about how to add documentation comments to OpenSCAD code can be found at\n`https://github.com/revarbat/openscad_docsgen/blob/main/WRITING_DOCS.md`\n\n\nInstalling openscad-docsgen\n---------------------------\n\nThe easiest way to install this is to use pip::\n\n    % pip3 install openscad_docsgen\n    \nTo install directly from these sources, you can instead do::\n\n    % python3 setup.py build install\n\n\nUsing openscad-docsgen\n----------------------\n\nThe simplest way to generate documentation is::\n\n    % openscad-docsgen -m *.scad\n\nWhich will read all of .scad files in the current directory, and writes out documentation\nfor each .scad file to the ``./docs/`` dir.  To write out to a different directory, use\nthe ``-D`` argument::\n\n    % openscad-docsgen -D wikidir -m *.scad\n\nTo write out an alphabetical function/module index markdown file, use the ``-i`` flag::\n\n    % openscad-docsgen -i *.scad\n\nTo write out a Table of Contents markdown file, use the ``-t`` flag::\n\n    % openscad-docsgen -t *.scad\n\nTo write out a CheatSheet markdown file, use the ``-c`` flag.  In addition, you can\nspecify the project name shown in the CheatSheet with the ``-P PROJECTNAME`` argument::\n\n    % openscad-docsgen -c -P \"My Foobar Library\" *.scad\n    \nA Topics index file can be generated by passing the ``-I`` flag::\n\n    % openscad-docsgen -I *.scad\n    \nYou can just test for script errors more quickly with the ``-T`` flag (for test-only)::\n\n    % openscad-docsgen -m -T *.scad\n\nBy default, the target output profile is to generate documentation for a GitHub Wiki.\nYou can output for a more generic Wiki with ``-p wiki``::\n\n    % openscad-docsgen -ticmI -p wiki *.scad\n\n\nDocsgen Configuration File\n--------------------------\nYou can also make more persistent configurations by putting a `.openscad_docsgen_rc` file in the\ndirectory you will be running openscad-docsgen from.  It can look something like this::\n\n    DocsDirectory: WikiDir/\n    TargetProfile: githubwiki\n    ProjectName: The Foobar Project\n    GeneratedDocs: Files, ToC, Index, Topics, CheatSheet\n    SidebarHeader:\n      ## Indices\n      .\n    SidebarMiddle:\n      [Tutorials](Tutorials)  \n    IgnoreFiles:\n      foo.scad\n      std.scad\n      version.scad\n      tmp_*.scad\n    PrioritizeFiles:\n      First.scad\n      Second.scad\n      Third.scad\n      Fourth.scad\n    DefineHeader(BulletList): Side Effects\n    DefineHeader(Table;Headers=Anchor&nbsp;Name|Position): Extra Anchors\n\nFor an explanation of the syntax and the specific headers, see:\n`https://github.com/revarbat/openscad_docsgen/blob/main/WRITING_DOCS.md`\n\nUsing openscad-mdimggen\n-----------------------\nIf you have MarkDown based files that you would like to generate images for, you can use the\n`openscad_mdimggen` command.  It can take the following arguments::\n\n    -h, --help            Show help message and exit\n    -D DOCS_DIR, --docs-dir DOCS_DIR\n                          The directory to put generated documentation in.\n    -P FILE_PREFIX, --file-prefix FILE_PREFIX\n                          The prefix to put in front of each output markdown file.\n    -T, --test-only       If given, don't generate images, but do try executing the scripts.\n    -I IMAGE_ROOT, --image_root IMAGE_ROOT\n                          The directory to put generated images in.\n    -f, --force           If given, force regeneration of images.\n    -a, --png-animation   If given, animations are created using animated PNGs instead of GIFs.\n\nWhat `openscad-mdimggen` will do is read the input MarkDown file and look for fenced scripts of\nOpenSCAD code, that starts with a line of the form::\n\n    ```openscad-METADATA\n\nIt will copy all non-script lines to the output markdown file, and run OpenSCAD for each of the\nfound fenced scripts, inserting the generated image into the output MarkDown file after the script block.\nThe METADATA for each script will define the viewpoint and other info for the given generated image.\nThis METADATA takes the form of a set of semi-colon separated options that can be any of the following:\n\n- ``NORENDER``: Don't generate an image for this example, but show the example text.\n- ``ImgOnly``: Generate and show the image, but hide the text of the script.\n- ``Hide``: Generate, but don't show script or image.  This can be used to generate images to be manually displayed in markdown text blocks.\n- ``2D``: Orient camera in a top-down view for showing 2D objects.\n- ``3D``: Orient camera in an oblique view for showing 3D objects.\n- ``VPT=[10,20,30]`` Force the viewpoint translation `$vpt` to `[10,20,30]`.\n- ``VPR=[55,0,600]`` Force the viewpoint rotation `$vpr` to `[55,0,60]`.\n- ``VPD=440``: Force viewpoint distance `$vpd` to 440.\n- ``VPF=22.5``: Force field of view angle `$vpf` to 22.5.\n- ``Spin``: Animate camera orbit around the `[0,1,1]` axis to display all sides of an object.\n- ``FlatSpin``: Animate camera orbit around the Z axis, above the XY plane.\n- ``Anim``: Make an animation where `$t` varies from `0.0` to almost `1.0`.\n- ``FrameMS=250``: Sets the number of milliseconds per frame for spins and animation.\n- ``FPS=8``: Sets the number of frames per second for spins and animation.\n- ``Frames=36``: Number of animation frames to make.\n- ``Small``: Make the image small sized.\n- ``Med``: Make the image medium sized.\n- ``Big``: Make the image big sized.\n- ``Huge``: Make the image huge sized.\n- ``Size=880x640``: Make the image 880 by 640 pixels in size.\n- ``Render``: Force full rendering from OpenSCAD, instead of the normal preview.\n- ``Edges``: Highlight face edges.\n- ``NoAxes``: Hides the axes and scales.\n- ``NoScales``: Hides the scale numbers along the axes.\n- ``ColorScheme``: Generate the image using a specific color scheme\n  - Usage: ``ColorScheme=<color scheme name>`` (e.g. ``ColorScheme=BeforeDawn``)\n  - Default color scheme: ``Cornfield``\n  - Predefined color schemes: ``Cornfield``, ``Metallic``, ``Sunset``, ``Starnight``, ``BeforeDawn``, ``Nature``, ``DeepOcean``, ``Solarized``, ``Tomorrow``, ``Tomorrow Night``, ``Monotone``\n  - Color schemes defined as a [Read-only Resource](https://github.com/openscad/openscad/wiki/Path-locations#read-only-resources) or [User Resource](https://github.com/openscad/openscad/wiki/Path-locations#user-resources) are also supported.\n\nFor example::\n\n    ```openscad-FlatSpin;VPD=500\n    prismoid([60,40], [40,20], h=40, offset=[10,10]);\n    ```\n\nWill generate an animated flat spin of the prismoid at a viewing distance of 500.  While::\n\n    ```openscad-3D;Big\n    prismoid([60,40], [40,20], h=40, offset=[10,10]);\n    ```\n\nWill generate a still image of the same prismoid, but at a bigger image size.\n\nMDImgGen Configuration File\n---------------------------\nYou can store defaults for ``openscad_mdimggen`` in the ``.openscad_mdimggen_rc`` file like this::\n\n    docs_dir: \"BOSL2.wiki\"\n    image_root: \"images/tutorials\"\n    file_prefix: \"Tutorial-\"\n    source_files: \"tutorials/*.md\"\n    png_animations: true\n    \n\nExternal Calling\n----------------\nHere's an example of how to use this library, to get the parsed documentation data::\n\n    import openscad_docsgen as docsgen\n    from glob import glob\n    from pprint import pprint\n    dgp = docsgen.DocsGenParser(quiet=True)\n    dgp.parse_files(glob(\"*.scad\"))\n    for name in dgp.get_indexed_names():\n        data = dgp.get_indexed_data(name)\n        pprint(name)\n        pprint(data[\"description\"])\n\nThe data for an OpenSCAD function, module, or constant generally looks like::\n\n    {\n        'name': 'Function&Module',  // Could also be 'Function', 'Module', or 'Constant'\n        'subtitle': 'line_of()',\n        'body': [],\n        'file': 'distributors.scad',\n        'line': 43,\n        'aliases': ['linear_spread()'],\n        'topics': ['Distributors'],\n        'usages': [\n            {\n                'subtitle': 'Spread `n` copies by a given spacing',\n                'body': ['line_of(spacing, <n>, <p1=>) ...']\n            },\n            {\n                'subtitle': 'Spread copies every given spacing along the line',\n                'body': ['line_of(spacing, <l=>, <p1=>) ...']\n            },\n            {\n                'subtitle': 'Spread `n` copies along the length of the line',\n                'body': ['line_of(<n=>, <l=>, <p1=>) ...']\n            },\n            {\n                'subtitle': 'Spread `n` copies along the line from `p1` to `p2`',\n                'body': ['line_of(<n=>, <p1=>, <p2=>) ...']\n            },\n            {\n                'subtitle': 'Spread copies every given spacing, centered along the line from `p1` to `p2`',\n                'body': ['line_of(<spacing>, <p1=>, <p2=>) ...']\n            },\n            {\n                'subtitle': 'As a function',\n                'body': [\n                    'pts = line_of(<spacing>, <n>, <p1=>);',\n                    'pts = line_of(<spacing>, <l=>, <p1=>);',\n                    'pts = line_of(<n=>, <l=>, <p1=>);',\n                    'pts = line_of(<n=>, <p1=>, <p2=>);',\n                    'pts = line_of(<spacing>, <p1=>, <p2=>);'\n                ]\n            }\n        ],\n        'description': [\n            'When called as a function, returns a list of points at evenly spread positions along a line.',\n            'When called as a module, copies `children()` at one or more evenly spread positions along a line.',\n            'By default, the line will be centered at the origin, unless the starting point `p1` is given.',\n            'The line will be pointed towards `RIGHT` (X+) unless otherwise given as a vector in `l`,',\n            '`spacing`, or `p1`/`p2`.',\n        ],\n        'arguments': [\n            'spacing = The vector giving both the direction and spacing distance between each set of copies.',\n            'n = Number of copies to distribute along the line. (Default: 2)',\n            '---',\n            'l = Either the scalar length of the line, or a vector giving both the direction and length of the line.',\n            'p1 = If given, specifies the starting point of the line.',\n            'p2 = If given with `p1`, specifies the ending point of line, and indirectly calculates the line length.'\n        ],\n        'see_also': ['xcopies()', 'ycopies()'],\n        'examples': [\n            ['line_of(10) sphere(d=1);'],\n            ['line_of(10, n=5) sphere(d=1);'],\n            ['line_of([10,5], n=5) sphere(d=1);'],\n            ['line_of(spacing=10, n=6) sphere(d=1);'],\n            ['line_of(spacing=[10,5], n=6) sphere(d=1);'],\n            ['line_of(spacing=10, l=50) sphere(d=1);'],\n            ['line_of(spacing=10, l=[50,30]) sphere(d=1);'],\n            ['line_of(spacing=[10,5], l=50) sphere(d=1);'],\n            ['line_of(l=50, n=4) sphere(d=1);'],\n            ['line_of(l=[50,-30], n=4) sphere(d=1);'],\n            [\n                'line_of(p1=[0,0,0], p2=[5,5,20], n=6) '\n                'cube(size=[3,2,1],center=true);'\n            ],\n            [\n                'line_of(p1=[0,0,0], p2=[5,5,20], spacing=6) '\n                'cube(size=[3,2,1],center=true);'\n            ],\n            [\n                'line_of(l=20, n=3) {',\n                '    cube(size=[1,3,1],center=true);',\n                '    cube(size=[3,1,1],center=true);',\n                '}'\n            ],\n            [\n                'pts = line_of([10,5],n=5);',\n                'move_copies(pts) circle(d=2);'\n            ]\n        ],\n        'children': [\n            {\n                'name': 'Side Effects',\n                'subtitle': '',\n                'body': [\n                    '`$pos` is set to the relative centerpoint of each child copy.',\n                    '`$idx` is set to the index number of each child being copied.'\n                ],\n                'file': 'distributors.scad',\n                'line': 88\n            }\n        ]\n    }\n\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A processor to generate Markdown code documentation with images from OpenSCAD source comments.",
    "version": "2.0.44",
    "project_urls": {
        "Bug Tracker": "https://github.com/belfryscad/openscad_docsgen/issues",
        "Documentation": "https://github.com/belfryscad/openscad_docsgen/WRITING_DOCS.md",
        "Homepage": "https://github.com/belfryscad/openscad_docsgen",
        "Releases": "https://github.com/belfryscad/openscad_docsgen/releases",
        "Repository": "https://github.com/belfryscad/openscad_docsgen",
        "Usage": "https://github.com/belfryscad/openscad_docsgen/README.rst"
    },
    "split_keywords": [
        "openscad",
        " documentation generation",
        " docs generation",
        " docsgen"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b917acf846185b2ca98955b3d21316aea8c502e734ff706dcd0c6d8c1cdf01c5",
                "md5": "adde0af5e6715f295c5a1d3128bcfd94",
                "sha256": "4b98b73693077a82f190ea26a2700c5d4a658c3cf0dfead47d9f9a32fffa06ec"
            },
            "downloads": -1,
            "filename": "openscad_docsgen-2.0.44-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "adde0af5e6715f295c5a1d3128bcfd94",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 33082,
            "upload_time": "2024-05-05T02:14:37",
            "upload_time_iso_8601": "2024-05-05T02:14:37.558401Z",
            "url": "https://files.pythonhosted.org/packages/b9/17/acf846185b2ca98955b3d21316aea8c502e734ff706dcd0c6d8c1cdf01c5/openscad_docsgen-2.0.44-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d8d7b892a56d984c730c66c0983ff3bec30566d6749c83d359bfe4ad6130b767",
                "md5": "aad96a8645d2d0ebabacb291eacb4dc3",
                "sha256": "a74907a3380b025d3601cc89b1bb03e354b5bd5022ceceb006186712c2408321"
            },
            "downloads": -1,
            "filename": "openscad_docsgen-2.0.44.tar.gz",
            "has_sig": false,
            "md5_digest": "aad96a8645d2d0ebabacb291eacb4dc3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 33622,
            "upload_time": "2024-05-05T02:14:39",
            "upload_time_iso_8601": "2024-05-05T02:14:39.968087Z",
            "url": "https://files.pythonhosted.org/packages/d8/d7/b892a56d984c730c66c0983ff3bec30566d6749c83d359bfe4ad6130b767/openscad_docsgen-2.0.44.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-05 02:14:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "belfryscad",
    "github_project": "openscad_docsgen",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "openscad-docsgen"
}
        
Elapsed time: 2.51052s