{"id":19522805,"url":"https://github.com/ahmnouira/flask-simple-form","last_synced_at":"2025-04-26T09:32:18.463Z","repository":{"id":46586182,"uuid":"201537154","full_name":"ahmnouira/flask-simple-form","owner":"ahmnouira","description":"A simple flask register-form application designed to run in multiple ways: #locally #doker container #doker hub ","archived":false,"fork":false,"pushed_at":"2023-12-15T05:13:42.000Z","size":492,"stargazers_count":2,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T10:40:13.572Z","etag":null,"topics":["ajax","eventlet","flask","flask-mail","flask-mongoalchemy","flask-mongodb","flask-socketio","flask-tutorial","flask-wtf","gunicorn","mongodb","send-email","socket-io"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmnouira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-09T20:37:37.000Z","updated_at":"2024-05-15T15:14:00.000Z","dependencies_parsed_at":"2024-11-11T00:51:06.039Z","dependency_job_id":null,"html_url":"https://github.com/ahmnouira/flask-simple-form","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmnouira%2Fflask-simple-form","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmnouira%2Fflask-simple-form/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmnouira%2Fflask-simple-form/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmnouira%2Fflask-simple-form/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmnouira","download_url":"https://codeload.github.com/ahmnouira/flask-simple-form/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250967348,"owners_count":21515582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ajax","eventlet","flask","flask-mail","flask-mongoalchemy","flask-mongodb","flask-socketio","flask-tutorial","flask-wtf","gunicorn","mongodb","send-email","socket-io"],"created_at":"2024-11-11T00:40:56.607Z","updated_at":"2025-04-26T09:32:17.896Z","avatar_url":"https://github.com/ahmnouira.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flask-simple-form\nThis is a simple flask register-form application designed to run in multiple ways\n\n# Notes\n* This app use _[MongoDB](https://www.mongodb.com/)_ as database supported by _[Flask-MongoAlchemy](https://pythonhosted.org/Flask-MongoAlchemy/)_ extension\n=\u003e So you have to install **MongoDB** database to run this locally \n \n* uses _[Flask-SocketIO](https://github.com/miguelgrinberg/Flask-SocketIO)_ along with _[Ajax](https://en.wikipedia.org/wiki/Ajax_(programming))_ for real time update\n\n* you will get an email if you have registered \n\n# Overview\n![index](/img/index.png)\n![registered](/img/registered.png)\n![email](/img/email.png)\n\n# Running this app\n\n\nThis app is designed to run in different ways:\n1. As a standalone app running on your machine\n\n## 1. As a standalone app\n\n1. install [python](https://www.python.org/) \n2. `git clone` the project then `cd` into the directory\n3. run `virtualenv -p /usr/bin/python3 venv`or `python -m venv venv` to create a virtual environment\n4. activate it using `source venv/bin/activate`\n5. `pip install -r requirements/prod_local.txt` to install the app libaries and it dependencies\n6. install MongoDB database `sudo apt-get install mongodb`\n7. check your database is installed and print its version using `mongo --version`\n\n### running the app\n\n* After installing, you need to set your application _environment variable_ by running `export FLASK_APP=app.py`\n* run `export MAIL_PASSWORD=\u003cyour-email-password\u003e` to set your email password _environment variable_ \n* run the server using the script file `run.sh` by typing `./run`\n* Access the running app in a browser at the URL written to the console (most likely http://0.0.0.0:5000)\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmnouira%2Fflask-simple-form","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmnouira%2Fflask-simple-form","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmnouira%2Fflask-simple-form/lists"}