nanodoc


Namenanodoc JSON
Version 0.9.2 PyPI version JSON
download
home_pageNone
SummaryA minimalist document bundler designed for stitching hints, reminders and short docs.
upload_time2025-03-16 21:26:12
maintainerNone
docs_urlNone
authorArthur Debert
requires_python>=3.9
license# License MIT License Copyright (c) 2024 Arthur Debert Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, innerlicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, innerject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or innerstantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords documentation bundler minimalist text prompts
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Nanodoc
--------

Nanodoc is a minimalist document bundler designed for stiching hints, reminders and short docs.
Useful for prompts, personalized docs highlights for your teams or a note to your future self

No config, nothing to learn nor remember. Short , simple, sweet.

Features
--------

- No config, no tutorial, no pain.
- Combines multiple text files into a single document
- Adds clear title separators between pages
- Supports optional line numbering (per file or global)
- Can generate a table of contents
- Flexible file selection methods
- Customizable header styles and sequence numbering

Usage
-----

$ nanodoc file1.txt file2.txt


$ nanodoc -n file1.txt file2.txt              # Per-file line numbering
$ nanodoc -nn file1.txt file2.txt             # Global line numbering
$ nanodoc -nn --toc file1.txt file2.txt       # Global numbering with TOC

File Selection Options
----------------------

Nanodoc is flexible in how you specify the files to bundle:

$ nanodoc <file-1>...<file-n> # individual files
$ nanodoc <dir-name> # all txt and md files in the dir will be included
$ nanodoc <dir-name> <file-1> # mix and match as you'd like
$ nanodoc <bundle> # any .bundle.* file that is a list of paths, one per line
$ nanodoc <live-bundle> # a file that mixes text and file paths, where paths are replaced with their content

Get only parts of a file:

$ nanodoc readme.txt:L14-16,L30-50 # get the good parts only

Command Line Options
--------------------

- `-n`: Add per-file line numbering (01, 02, etc.)
- `-nn`: Add global line numbering: useful for referencing the full doc gen later
- `--toc`: Generate a table of contents at the beginning

Get fancy
---------

- `--seq`: numerical, roman or letter for ref the file sequence
- `--style`: nice (Human Readable (human-readable.txt), or file, or full-path

Save for later:
---------------

Generated a doc good enough to repeat, export the bundle

$nanodoc --export-bundle bestdocs.bundle.txt <file-1>...<file-n>

Keep it simple
--------------

Nothing to config.
Nothing to learn.
No tutorials to watch.

In fact, you've just went through the full documentation.
$ nanodoc --help # all there is


## Installation

nanodoc is available at a distributor near you:

# Using pip
pip install nanodoc
# even better pipx
pipx install --user nanodoc

## Contributing

Contributions are welcome! Say hi, curse me for eternity or even send in something constructive.
Feel free to open issues or submit pull requests.

(just keep it short, we're nano people after all)

## License

MIT License


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "nanodoc",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "documentation, bundler, minimalist, text, prompts",
    "author": "Arthur Debert",
    "author_email": "arthur@debert.xyz",
    "download_url": "https://files.pythonhosted.org/packages/b2/ab/414e77fab125da0f5a89e22139b15a3c129e5bac06cac903ddcbb539c5cb/nanodoc-0.9.2.tar.gz",
    "platform": null,
    "description": "Nanodoc\n--------\n\nNanodoc is a minimalist document bundler designed for stiching hints, reminders and short docs.\nUseful for prompts, personalized docs highlights for your teams or a note to your future self\n\nNo config, nothing to learn nor remember. Short , simple, sweet.\n\nFeatures\n--------\n\n- No config, no tutorial, no pain.\n- Combines multiple text files into a single document\n- Adds clear title separators between pages\n- Supports optional line numbering (per file or global)\n- Can generate a table of contents\n- Flexible file selection methods\n- Customizable header styles and sequence numbering\n\nUsage\n-----\n\n$ nanodoc file1.txt file2.txt\n\n\n$ nanodoc -n file1.txt file2.txt              # Per-file line numbering\n$ nanodoc -nn file1.txt file2.txt             # Global line numbering\n$ nanodoc -nn --toc file1.txt file2.txt       # Global numbering with TOC\n\nFile Selection Options\n----------------------\n\nNanodoc is flexible in how you specify the files to bundle:\n\n$ nanodoc <file-1>...<file-n> # individual files\n$ nanodoc <dir-name> # all txt and md files in the dir will be included\n$ nanodoc <dir-name> <file-1> # mix and match as you'd like\n$ nanodoc <bundle> # any .bundle.* file that is a list of paths, one per line\n$ nanodoc <live-bundle> # a file that mixes text and file paths, where paths are replaced with their content\n\nGet only parts of a file:\n\n$ nanodoc readme.txt:L14-16,L30-50 # get the good parts only\n\nCommand Line Options\n--------------------\n\n- `-n`: Add per-file line numbering (01, 02, etc.)\n- `-nn`: Add global line numbering: useful for referencing the full doc gen later\n- `--toc`: Generate a table of contents at the beginning\n\nGet fancy\n---------\n\n- `--seq`: numerical, roman or letter for ref the file sequence\n- `--style`: nice (Human Readable (human-readable.txt), or file, or full-path\n\nSave for later:\n---------------\n\nGenerated a doc good enough to repeat, export the bundle\n\n$nanodoc --export-bundle bestdocs.bundle.txt <file-1>...<file-n>\n\nKeep it simple\n--------------\n\nNothing to config.\nNothing to learn.\nNo tutorials to watch.\n\nIn fact, you've just went through the full documentation.\n$ nanodoc --help # all there is\n\n\n## Installation\n\nnanodoc is available at a distributor near you:\n\n# Using pip\npip install nanodoc\n# even better pipx\npipx install --user nanodoc\n\n## Contributing\n\nContributions are welcome! Say hi, curse me for eternity or even send in something constructive.\nFeel free to open issues or submit pull requests.\n\n(just keep it short, we're nano people after all)\n\n## License\n\nMIT License\n\n",
    "bugtrack_url": null,
    "license": "# License\n         \n         MIT License\n         \n         Copyright (c) 2024 Arthur Debert\n         \n         Permission is hereby granted, free of charge, to any person obtaining a copy\n         of this software and associated documentation files (the \"Software\"), to deal\n         in the Software without restriction, including without limitation the rights\n         to use, copy, modify, merge, publish, distribute, innerlicense, and/or sell\n         copies of the Software, and to permit persons to whom the Software is\n         furnished to do so, innerject to the following conditions:\n         \n         The above copyright notice and this permission notice shall be included in all\n         copies or innerstantial portions of the Software.\n         \n         THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n         FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n         SOFTWARE.",
    "summary": "A minimalist document bundler designed for stitching hints, reminders and short docs.",
    "version": "0.9.2",
    "project_urls": {
        "Bug Tracker": "https://github.com/arthur-debert/nanodoc/issues",
        "Homepage": "https://github.com/arthur-debert/nanodoc/",
        "Repository": "https://github.com/arthur-debert/nanodoc/"
    },
    "split_keywords": [
        "documentation",
        " bundler",
        " minimalist",
        " text",
        " prompts"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "fafdd58e53ce937f65ddde391385b7d2e8916f6c414f12e6532fd418df618ccd",
                "md5": "317fb2f17bd3c1a1f9d186cf8c16c9a0",
                "sha256": "8d6df50a89edc82cb56d2b97c4f25578da7d876db60b8c9e3f449181079f0fd5"
            },
            "downloads": -1,
            "filename": "nanodoc-0.9.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "317fb2f17bd3c1a1f9d186cf8c16c9a0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 23510,
            "upload_time": "2025-03-16T21:26:11",
            "upload_time_iso_8601": "2025-03-16T21:26:11.231156Z",
            "url": "https://files.pythonhosted.org/packages/fa/fd/d58e53ce937f65ddde391385b7d2e8916f6c414f12e6532fd418df618ccd/nanodoc-0.9.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b2ab414e77fab125da0f5a89e22139b15a3c129e5bac06cac903ddcbb539c5cb",
                "md5": "7769d108205ec9b5879b1bc5dbdb3e6c",
                "sha256": "625956e6ef907a1be28532d91e3c8f2c2fd0817f1d108fe822eecb0e70fbe07a"
            },
            "downloads": -1,
            "filename": "nanodoc-0.9.2.tar.gz",
            "has_sig": false,
            "md5_digest": "7769d108205ec9b5879b1bc5dbdb3e6c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 19350,
            "upload_time": "2025-03-16T21:26:12",
            "upload_time_iso_8601": "2025-03-16T21:26:12.210307Z",
            "url": "https://files.pythonhosted.org/packages/b2/ab/414e77fab125da0f5a89e22139b15a3c129e5bac06cac903ddcbb539c5cb/nanodoc-0.9.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-16 21:26:12",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "arthur-debert",
    "github_project": "nanodoc",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "nanodoc"
}
        
Elapsed time: 0.75114s