# Aurora Framework (v0.9.3 beta)
Aurora is an MVC web framework for creating CRUD applications quickly and simply.
It is based on REST architecture. In another word it is a RESTFUL web framework.
Aurora is written in [Python](https://www.python.org/), and partially used [Flask](https://flask.palletsprojects.com/).
# Installation
You can install Aurora by running:
```
$ pip install aurora-mvc
```
# Usage
## Get Started
To get started with Aurora simply do the following steps:
1. Create the root app (project) directory:
```
$ mkdir my_app
```
> Here *my_app* is a variable name. Change it to anything of your choice at any time you want.
2. Create a python virtual environment in the same path the project directory exists:
**Linux / Mac:**
```
$ python3 -m venv venv
```
**Windows:**
```
$ py -m venv venv
```
3. Activate the virtual environment:
**Linux / Mac:**
```
$ source venv/bin/activate
```
**Windows:**
```
$ venv\scripts\activate
```
4. Navigate to the project directory:
```
(venv) cd my_app
```
> Notice that the project directory must be empty, otherwise you will get an error on the next step.
5. Initialize the root app with Aurora via python shell:
**Linux / Mac:**
```
(venv) python3
>>> from aurora import init
>>> init.start()
```
**Windows:**
```
(venv) py
>>> from aurora import init
>>> init.start()
```
> Congratulations! You successfully initialized the root app. Now you are ready to get started with Aurora.
6. To start the root app run the following command:
**Linux / Mac:**
```
(venv) python3 -m app
```
**Windows:**
```
(venv) py -m app
```
## Next Steps
Documentation: [Aurora Docs](https://github.com/heminsatya/aurora/tree/main/docs)
Changelog: [Aurora Changes](https://github.com/heminsatya/aurora/tree/main/changes)
Issues: [Aurora Bug Tracker](https://github.com/heminsatya/aurora/issues)
Source: [Aurora GitHub Repo](https://github.com/heminsatya/aurora)
PyPI: [Aurora PyPI Page](https://pypi.org/project/aurora-mvc/)
# Dependencies
## Packages:
- [Flask](https://pypi.org/project/Flask/)
- [WTForms](https://pypi.org/project/WTForms/) -- For WTForms & CSRF tokens.
## Database APIs:
- [sqlite3](https://docs.python.org/3/library/sqlite3.html) -- If you are using SQLite Database. *Included in the standard python library*
- [mysql.connector](https://pypi.org/project/mysql-connector-python/) -- If you are using MySQL Database.
- [psycopg2](https://pypi.org/project/psycopg2/) -- If you are using Postgres Database.
# About The Author
Hello Everyone!
I'm Hemin Satya, a freelance programmer.
Aurora framework is currently in beta version, and I'm trying my best to make it something magnificent. I hope you like it.
If you saw any bugs or mistakes, please let me know. I'll do my best to solve them asap.
Please let me know your precious comments, observations, and suggestions.
([GitHub](https://github.com/heminsatya))
([Twitter](https://twitter.com/heminsatya))
Thank you all.
Raw data
{
"_id": null,
"home_page": "https://github.com/heminsatya/aurora",
"name": "aurora-mvc",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "aurora,mvc,web,framework",
"author": "Hemin Satya",
"author_email": "heminsatya@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4a/68/be55e8e7e4c96a8b7e0fa2f95bfffef18454e5ae21d7b1fa8e2cd71f98e7/aurora-mvc-0.9.3.tar.gz",
"platform": null,
"description": "# Aurora Framework (v0.9.3 beta)\r\n\r\nAurora is an MVC web framework for creating CRUD applications quickly and simply.\r\n\r\nIt is based on REST architecture. In another word it is a RESTFUL web framework.\r\n\r\nAurora is written in [Python](https://www.python.org/), and partially used [Flask](https://flask.palletsprojects.com/).\r\n\r\n\r\n# Installation\r\n\r\nYou can install Aurora by running:\r\n\r\n```\r\n$ pip install aurora-mvc\r\n```\r\n\r\n\r\n# Usage\r\n\r\n## Get Started\r\n\r\nTo get started with Aurora simply do the following steps:\r\n\r\n1. Create the root app (project) directory:\r\n\r\n```\r\n$ mkdir my_app\r\n```\r\n\r\n> Here *my_app* is a variable name. Change it to anything of your choice at any time you want.\r\n\r\n2. Create a python virtual environment in the same path the project directory exists:\r\n\r\n**Linux / Mac:**\r\n\r\n```\r\n$ python3 -m venv venv\r\n```\r\n\r\n**Windows:**\r\n\r\n```\r\n$ py -m venv venv\r\n```\r\n\r\n3. Activate the virtual environment:\r\n\r\n**Linux / Mac:**\r\n\r\n```\r\n$ source venv/bin/activate\r\n```\r\n\r\n**Windows:**\r\n\r\n```\r\n$ venv\\scripts\\activate\r\n```\r\n\r\n4. Navigate to the project directory:\r\n\r\n```\r\n(venv) cd my_app\r\n```\r\n\r\n> Notice that the project directory must be empty, otherwise you will get an error on the next step.\r\n\r\n5. Initialize the root app with Aurora via python shell:\r\n\r\n**Linux / Mac:**\r\n\r\n```\r\n(venv) python3\r\n>>> from aurora import init\r\n>>> init.start()\r\n```\r\n\r\n**Windows:**\r\n\r\n```\r\n(venv) py\r\n>>> from aurora import init\r\n>>> init.start()\r\n```\r\n\r\n> Congratulations! You successfully initialized the root app. Now you are ready to get started with Aurora.\r\n\r\n6. To start the root app run the following command:\r\n\r\n**Linux / Mac:**\r\n\r\n```\r\n(venv) python3 -m app\r\n```\r\n\r\n**Windows:**\r\n\r\n```\r\n(venv) py -m app\r\n```\r\n\r\n\r\n## Next Steps\r\n\r\nDocumentation: [Aurora Docs](https://github.com/heminsatya/aurora/tree/main/docs)\r\n\r\nChangelog: [Aurora Changes](https://github.com/heminsatya/aurora/tree/main/changes)\r\n\r\nIssues: [Aurora Bug Tracker](https://github.com/heminsatya/aurora/issues)\r\n\r\nSource: [Aurora GitHub Repo](https://github.com/heminsatya/aurora)\r\n\r\nPyPI: [Aurora PyPI Page](https://pypi.org/project/aurora-mvc/)\r\n\r\n\r\n# Dependencies\r\n\r\n## Packages:\r\n \r\n- [Flask](https://pypi.org/project/Flask/)\r\n- [WTForms](https://pypi.org/project/WTForms/) -- For WTForms & CSRF tokens.\r\n\r\n## Database APIs:\r\n- [sqlite3](https://docs.python.org/3/library/sqlite3.html) -- If you are using SQLite Database. *Included in the standard python library*\r\n- [mysql.connector](https://pypi.org/project/mysql-connector-python/) -- If you are using MySQL Database.\r\n- [psycopg2](https://pypi.org/project/psycopg2/) -- If you are using Postgres Database.\r\n\r\n\r\n# About The Author\r\n\r\nHello Everyone!\r\n\r\nI'm Hemin Satya, a freelance programmer.\r\nAurora framework is currently in beta version, and I'm trying my best to make it something magnificent. I hope you like it.\r\n\r\nIf you saw any bugs or mistakes, please let me know. I'll do my best to solve them asap.\r\n\r\nPlease let me know your precious comments, observations, and suggestions.\r\n([GitHub](https://github.com/heminsatya))\r\n([Twitter](https://twitter.com/heminsatya))\r\n\r\nThank you all.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Aurora is an MVC web framework for creating RESTFUL CRUD applications quickly and simply",
"version": "0.9.3",
"project_urls": {
"Changelog": "https://github.com/heminsatya/aurora/tree/main/changes",
"Documentation": "https://github.com/heminsatya/aurora/tree/main/docs",
"Homepage": "https://github.com/heminsatya/aurora",
"Issues": "https://github.com/heminsatya/aurora/issues",
"source": "https://github.com/heminsatya/aurora"
},
"split_keywords": [
"aurora",
"mvc",
"web",
"framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cc84dbe567b4bf5da7dfbbc77321856d57c32cb3c122da0c19cd214d335ceccb",
"md5": "668efa4d9605687f30340548c848c018",
"sha256": "715420af75161e56b54626603f600ccee599f286c46a11051976af321ef2891e"
},
"downloads": -1,
"filename": "aurora_mvc-0.9.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "668efa4d9605687f30340548c848c018",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 172150,
"upload_time": "2023-06-11T17:43:14",
"upload_time_iso_8601": "2023-06-11T17:43:14.076395Z",
"url": "https://files.pythonhosted.org/packages/cc/84/dbe567b4bf5da7dfbbc77321856d57c32cb3c122da0c19cd214d335ceccb/aurora_mvc-0.9.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4a68be55e8e7e4c96a8b7e0fa2f95bfffef18454e5ae21d7b1fa8e2cd71f98e7",
"md5": "c6dd3cc1e34865e1d38ee53a4dd45367",
"sha256": "b7e4092cf9058a84253cda6641f249a860360e4f894d0f5e4917bf6cdcbf76c2"
},
"downloads": -1,
"filename": "aurora-mvc-0.9.3.tar.gz",
"has_sig": false,
"md5_digest": "c6dd3cc1e34865e1d38ee53a4dd45367",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 169638,
"upload_time": "2023-06-11T17:43:33",
"upload_time_iso_8601": "2023-06-11T17:43:33.037790Z",
"url": "https://files.pythonhosted.org/packages/4a/68/be55e8e7e4c96a8b7e0fa2f95bfffef18454e5ae21d7b1fa8e2cd71f98e7/aurora-mvc-0.9.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-11 17:43:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "heminsatya",
"github_project": "aurora",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "aurora-mvc"
}
JSON
