# Nautobot Dev Example App
This application serves as a testbed for evaluating improvements to the [Nautobot App Cookiecutter Templates](https://github.com/nautobot/cookiecutter-nautobot-app). **DO NOT USE** this repository directly in production environments or to bootstrap a new app!
For those wanting to develop a new Nautobot app, please use the [cookiecutter template](https://github.com/nautobot/cookiecutter-nautobot-app) as a starting point.
<p align="center">
<img src="https://raw.githubusercontent.com/nautobot/nautobot-app-dev-example/develop/docs/images/icon-nautobot-dev-example.png" class="logo" height="200px">
<br>
<a href="https://github.com/nautobot/nautobot-app-dev-example/actions"><img src="https://github.com/nautobot/nautobot-app-dev-example/actions/workflows/ci.yml/badge.svg?branch=main"></a>
<a href="https://docs.nautobot.com/projects/dev-example/en/latest/"><img src="https://readthedocs.org/projects/nautobot-app-dev-example/badge/"></a>
<a href="https://pypi.org/project/nautobot-dev-example/"><img src="https://img.shields.io/pypi/v/nautobot-dev-example"></a>
<a href="https://pypi.org/project/nautobot-dev-example/"><img src="https://img.shields.io/pypi/dm/nautobot-dev-example"></a>
<br>
An <a href="https://networktocode.com/nautobot-apps/">App</a> for <a href="https://nautobot.com/">Nautobot</a>.
</p>
## Overview
An example Nautobot app with multiple functions:
- Acts as a Canary App to test enhancements to the Nautobot app [cookiecutter templates](https://github.com/nautobot/cookiecutter-nautobot-app).
- Illustrates how to use the Nautobot app framework.
### Screenshots
More screenshots can be found in the [Using the App](https://docs.nautobot.com/projects/dev-example/en/latest/user/app_use_cases/) page in the documentation. Here's a quick overview of some of the app's added functionality:
![](https://raw.githubusercontent.com/nautobot/nautobot-app-dev-example/develop/docs/images/placeholder.png)
## Documentation
Full documentation for this App can be found over on the [Nautobot Docs](https://docs.nautobot.com) website:
- [User Guide](https://docs.nautobot.com/projects/dev-example/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.
- [Administrator Guide](https://docs.nautobot.com/projects/dev-example/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.
- [Developer Guide](https://docs.nautobot.com/projects/dev-example/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.
- [Release Notes / Changelog](https://docs.nautobot.com/projects/dev-example/en/latest/admin/release_notes/).
- [Frequently Asked Questions](https://docs.nautobot.com/projects/dev-example/en/latest/user/faq/).
### Contributing to the Documentation
You can find all the Markdown source for the App documentation under the [`docs`](https://github.com/nautobot/nautobot-app-dev-example/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.
If you need to view the fully-generated documentation site, you can build it with [MkDocs](https://www.mkdocs.org/). A container hosting the documentation can be started using the `invoke` commands (details in the [Development Environment Guide](https://docs.nautobot.com/projects/dev-example/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). Using this container, as your changes to the documentation are saved, they will be automatically rebuilt and any pages currently being viewed will be reloaded in your browser.
Any PRs with fixes or improvements are very welcome!
## Questions
For any questions or comments, please check the [FAQ](https://docs.nautobot.com/projects/dev-example/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.
Raw data
{
"_id": null,
"home_page": "https://github.com/nautobot/nautobot-app-dev-example",
"name": "nautobot-dev-example",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.8",
"maintainer_email": null,
"keywords": "nautobot, nautobot-app, nautobot-plugin",
"author": "Network to Code, LLC",
"author_email": "opensource@networktocode.com",
"download_url": "https://files.pythonhosted.org/packages/ca/c2/1221cfc7ffe93f727315c62b54f533daefc98685aabd01253eb128a78df2/nautobot_dev_example-2.0.0.tar.gz",
"platform": null,
"description": "# Nautobot Dev Example App\n\nThis application serves as a testbed for evaluating improvements to the [Nautobot App Cookiecutter Templates](https://github.com/nautobot/cookiecutter-nautobot-app). **DO NOT USE** this repository directly in production environments or to bootstrap a new app!\n\nFor those wanting to develop a new Nautobot app, please use the [cookiecutter template](https://github.com/nautobot/cookiecutter-nautobot-app) as a starting point.\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/nautobot/nautobot-app-dev-example/develop/docs/images/icon-nautobot-dev-example.png\" class=\"logo\" height=\"200px\">\n <br>\n <a href=\"https://github.com/nautobot/nautobot-app-dev-example/actions\"><img src=\"https://github.com/nautobot/nautobot-app-dev-example/actions/workflows/ci.yml/badge.svg?branch=main\"></a>\n <a href=\"https://docs.nautobot.com/projects/dev-example/en/latest/\"><img src=\"https://readthedocs.org/projects/nautobot-app-dev-example/badge/\"></a>\n <a href=\"https://pypi.org/project/nautobot-dev-example/\"><img src=\"https://img.shields.io/pypi/v/nautobot-dev-example\"></a>\n <a href=\"https://pypi.org/project/nautobot-dev-example/\"><img src=\"https://img.shields.io/pypi/dm/nautobot-dev-example\"></a>\n <br>\n An <a href=\"https://networktocode.com/nautobot-apps/\">App</a> for <a href=\"https://nautobot.com/\">Nautobot</a>.\n</p>\n\n## Overview\n\nAn example Nautobot app with multiple functions:\n\n- Acts as a Canary App to test enhancements to the Nautobot app [cookiecutter templates](https://github.com/nautobot/cookiecutter-nautobot-app).\n- Illustrates how to use the Nautobot app framework.\n\n### Screenshots\n\nMore screenshots can be found in the [Using the App](https://docs.nautobot.com/projects/dev-example/en/latest/user/app_use_cases/) page in the documentation. Here's a quick overview of some of the app's added functionality:\n\n![](https://raw.githubusercontent.com/nautobot/nautobot-app-dev-example/develop/docs/images/placeholder.png)\n\n## Documentation\n\nFull documentation for this App can be found over on the [Nautobot Docs](https://docs.nautobot.com) website:\n\n- [User Guide](https://docs.nautobot.com/projects/dev-example/en/latest/user/app_overview/) - Overview, Using the App, Getting Started.\n- [Administrator Guide](https://docs.nautobot.com/projects/dev-example/en/latest/admin/install/) - How to Install, Configure, Upgrade, or Uninstall the App.\n- [Developer Guide](https://docs.nautobot.com/projects/dev-example/en/latest/dev/contributing/) - Extending the App, Code Reference, Contribution Guide.\n- [Release Notes / Changelog](https://docs.nautobot.com/projects/dev-example/en/latest/admin/release_notes/).\n- [Frequently Asked Questions](https://docs.nautobot.com/projects/dev-example/en/latest/user/faq/).\n\n### Contributing to the Documentation\n\nYou can find all the Markdown source for the App documentation under the [`docs`](https://github.com/nautobot/nautobot-app-dev-example/tree/develop/docs) folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.\n\nIf you need to view the fully-generated documentation site, you can build it with [MkDocs](https://www.mkdocs.org/). A container hosting the documentation can be started using the `invoke` commands (details in the [Development Environment Guide](https://docs.nautobot.com/projects/dev-example/en/latest/dev/dev_environment/#docker-development-environment)) on [http://localhost:8001](http://localhost:8001). Using this container, as your changes to the documentation are saved, they will be automatically rebuilt and any pages currently being viewed will be reloaded in your browser.\n\nAny PRs with fixes or improvements are very welcome!\n\n## Questions\n\nFor any questions or comments, please check the [FAQ](https://docs.nautobot.com/projects/dev-example/en/latest/user/faq/) first. Feel free to also swing by the [Network to Code Slack](https://networktocode.slack.com/) (channel `#nautobot`), sign up [here](http://slack.networktocode.com/) if you don't have an account.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Nautobot App to demonstrate how to create a Nautobot App.",
"version": "2.0.0",
"project_urls": {
"Documentation": "https://docs.nautobot.com/projects/dev-example/en/latest/",
"Homepage": "https://github.com/nautobot/nautobot-app-dev-example",
"Repository": "https://github.com/nautobot/nautobot-app-dev-example"
},
"split_keywords": [
"nautobot",
" nautobot-app",
" nautobot-plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e339f4122b834dd0f1545f8f855859e67ac438baae2f596c6f8394edfbcd49e3",
"md5": "818537b31e31cff1053c74c149e0ce29",
"sha256": "e9a2ff96613dbe36c3f9571e53f4eca08d9867ba714d811a72a46f42c6803c60"
},
"downloads": -1,
"filename": "nautobot_dev_example-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "818537b31e31cff1053c74c149e0ce29",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.8",
"size": 925569,
"upload_time": "2024-08-13T11:43:15",
"upload_time_iso_8601": "2024-08-13T11:43:15.840605Z",
"url": "https://files.pythonhosted.org/packages/e3/39/f4122b834dd0f1545f8f855859e67ac438baae2f596c6f8394edfbcd49e3/nautobot_dev_example-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cac21221cfc7ffe93f727315c62b54f533daefc98685aabd01253eb128a78df2",
"md5": "31314e6c1b614e37dd22ed41d00d74da",
"sha256": "6134e61ab0f46770b3e8fc3e6089e0cc08f0c8e5f31bc9f0d02c5ed008b36a87"
},
"downloads": -1,
"filename": "nautobot_dev_example-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "31314e6c1b614e37dd22ed41d00d74da",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.8",
"size": 869652,
"upload_time": "2024-08-13T11:43:17",
"upload_time_iso_8601": "2024-08-13T11:43:17.517675Z",
"url": "https://files.pythonhosted.org/packages/ca/c2/1221cfc7ffe93f727315c62b54f533daefc98685aabd01253eb128a78df2/nautobot_dev_example-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-13 11:43:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nautobot",
"github_project": "nautobot-app-dev-example",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nautobot-dev-example"
}