{"id":28028840,"url":"https://github.com/m-taghizadeh/pygram","last_synced_at":"2026-04-28T16:08:04.971Z","repository":{"id":39840007,"uuid":"261694233","full_name":"M-Taghizadeh/PyGram","owner":"M-Taghizadeh","description":"PyGram is a social network that developed with python.","archived":false,"fork":false,"pushed_at":"2022-05-25T02:54:57.000Z","size":15908,"stargazers_count":7,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-11T07:33:47.696Z","etag":null,"topics":["flask","flask-migrations","mysql-database","python","redis","sqlalchemy"],"latest_commit_sha":null,"homepage":"http://m-taghizadeh.ir","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/M-Taghizadeh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-06T08:15:28.000Z","updated_at":"2023-12-19T19:45:58.000Z","dependencies_parsed_at":"2022-08-27T20:10:50.279Z","dependency_job_id":null,"html_url":"https://github.com/M-Taghizadeh/PyGram","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/M-Taghizadeh/PyGram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Taghizadeh%2FPyGram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Taghizadeh%2FPyGram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Taghizadeh%2FPyGram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Taghizadeh%2FPyGram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/M-Taghizadeh","download_url":"https://codeload.github.com/M-Taghizadeh/PyGram/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/M-Taghizadeh%2FPyGram/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32387977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["flask","flask-migrations","mysql-database","python","redis","sqlalchemy"],"created_at":"2025-05-11T07:31:52.414Z","updated_at":"2026-04-28T16:08:04.955Z","avatar_url":"https://github.com/M-Taghizadeh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **PyGram** Social Network\n\n\u003cp\u003ePyGram is a social network that developed with python.\nhere are the main features of this project:\n\u003c/p\u003e\n\n1. Home Page\n2. Sign Up and Login (and account verification)\n3. User Profile (dashboard)\n4. Direct messages\n5. Chat with others\n6. Search users and pages\n7. Users single page\n8. Sharing new post and delete post\n9. Followers and Following pages\n10. Like and Comment on posts\n\n\n# Getting Started\n\n- [Project Structure](#Project-Structure)\n- [Dependencies](#Dependencies)\n- [Requirements](#Requirements)\n- [Site Routes](#Site-Routes)\n- [Project Modules](#BluePrints)\n- [Data Base Diagram](#Database-Diagram)\n- [About redis](#Redis)\n- [About sqlalchemy](#SqlAlchemy)\n- [About flask-migration](#Flask-Migration)\n- [View site pages](#Site-Pages)\n\n\n# Project-Structure\n```bash\nPyGram\n├───app.py\n├───requirements.txt\n├───dependencies.txt\n├───routes.txt\n├───README.md\n├───.env\n├───.gitignore\n├───Documentation\n├───migrations\n└───PyGram\n    ├───__init__.py\n    ├───controller.py\n    ├───models.py\n    ├───config.py\n    ├───mod_direct_message\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_follow\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_post\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_profile\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_search\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_setting\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───mod_user_page\n    │   ├───__init__.py\n    │   └───controller.py\n    ├───static\n    │   ├───Site-Screen\n    │   ├───img\n    │   ├───styles\n    │   │    └───all of css files..\n    │   └───upload\n    │       ├───dir_of_user1\n    │       ├───dir_of_user2\n    │       └───dir_of_user3\n    ├───Templates\n    │   └───all of html files..\n    └───utils\n        ├───check_auth.py\n        ├───registration.py\n        └───upload.py\n```\n\n\n# Dependencies\n\n|   Modules                 | Description                                                     \n|---------------------------|-----------------------------------------------\n| flask                     | web framework\n| python-dotenv             | for read dotenv files\n| flask-sqlalchemy          | ORM\n| mysqlclient or pymysql    | mysql connector\n| flask-migrate             | database migration \n| flask-jwt-extended        | for Authorization (access and refreshh token)\n| flask-mail                | for sending email\n| redis                     | we use this nosql database for saving users registration token\n| flask_whooshalchemy       | search engine\n\n\n# Requirements\n\n```python\n\u003e\u003e pip freeze\nalembic==1.4.2\nblinker==1.4\nclick==7.1.2\nFlask==1.1.2\nFlask-Autodoc==0.1.2\nFlask-JWT-Extended==3.24.1\nFlask-Mail==0.9.1\nFlask-Migrate==2.5.3\nFlask-Selfdoc==1.2.3\nFlask-SQLAlchemy==2.4.1\nitsdangerous==1.1.0\nJinja2==2.11.2\nMako==1.1.2\nMarkupSafe==1.1.1\nPyJWT==1.7.1\nPyMySQL==0.9.3\npython-dateutil==2.8.1\npython-dotenv==0.13.0\npython-editor==1.0.4\nredis==3.4.1\nsix==1.14.0\nSQLAlchemy==1.3.16\nWerkzeug==1.0.1\nWhoosh==2.7.4\n```\n\n\n# Site-Routes\n| Endpoint                  | Methods   |  Rule                                       \n|---------------------------|-----------|---------------------------------------------\n|direct.chat                | GET       | /direct/chat/\u003cstring:username\u003e               \n|direct.direct_index        | GET       | /direct/\u003cstring:username\u003e                       \n|direct.send_message        | POST      | /direct/send_message/\u003cstring:username\u003e        \n|follow.follow_index        | GET       | /follow/\u003cstring:username\u003e\n|index                      | GET       | /\n|login                      | GET, POST | /login/\n|post.comment               | POST      | /post/comment/\u003cstring:username\u003e/\u003cstring:date\u003e\n|post.delete_post           | GET       | /post/delete/\u003cstring:username\u003e/\u003cstring:date\u003e\n|post.like                  | GET       | /post/like/\u003cstring:username\u003e/\u003cstring:date\u003e\n|post.new_post              | GET, POST | /post/new/\u003cstring:username\u003e\n|post.post_index            | GET       | /post/\u003cstring:username\u003e\n|post.single_post           | GET       | /post/single/\u003cstring:username\u003e/\u003cstring:date\u003e\n|profile.logout             | GET       | /profile/logout/\n|profile.profile_index      | GET       | /profile/\u003cstring:username\u003e\n|search.search              | GET       | /search/search/\n|setting.setting_index      | GET, POST | /setting/\u003cstring:username\u003e\n|signup                     | GET, POST | /signup/\n|signup_process             | GET       | /signup-process/\n|static                     | GET       | /static/\u003cpath:filename\u003e\n|user_page.follow_process   | GET       | /user_page/follow-process/\u003cstring:username\u003e/\n|user_page.unfollow_process | GET       | /user_page/unfollow-process/\u003cstring:username\u003e/\n|user_page.user_page_index  | GET       | /user_page/\u003cstring:username\u003e\n\n\n# BluePrints\n- mod_direct_message\n- mod_follow\n- mod_post\n- mod_profile\n- mod_search\n- mod_setting\n- mod_user_page\n\n\n# Database-Diagram\n![Database Models Diagram](Documentation/PyGramDB.png)\n\n\n# Redis\n\nRedis =\u003e [Key Value DataBse] your data have a key for example =\u003e mtaghizadeh_register : 12345 [mtaghizadeh_register is username and mode is register and token is 12345]\n\n- download redis :\nhttps://github.com/antirez/redis/issues/6276\n\n- Check Redis Connection:\n1. in cmd(admin) \n```python \n\u003e\u003e\u003e redis-cli\n\u003e\u003e\u003e ping\n\u003e\u003e\u003e pong\n```\n2. in services\n\n- install redis in python or venv\n```python\n\u003e\u003e\u003e pip install redis\n```\n\n- add redis key in flask config (.env)\n```python\n\u003e\u003e REDIS_SERVER_URL=redis://127.0.0.1:6379 # redis default port\n```\n\n- import redis in app.py:\n```python\n\u003e\u003e from redis import Redis\n\u003e\u003e redis = Redis.from_url(app.config['REDIS_SERVER_URL'])\n```\n\n- test in flask sell:\n```python\n\u003e\u003e\u003e from app import redis \n\u003e\u003e\u003e redis.ping()\n\u003e\u003e\u003e True # if connection is ok.\n```\n\n- redis add:\n```python\n\u003e\u003e redis.set(key, value, expiry_date(s))\n```\n\n- redis get value by key:\n```python\n\u003e\u003e redis.get(name=key)\n\u003e\u003e\u003e GET mtaghizadeh_register # (in redis-cli)\n```\n\n- redis delete:\n```python\n\u003e\u003e redis.delete(key)\n```\n\n\n# SQLAlchemy\nSQLAlchemy is the Python SQL toolkit and Object Relational Mapper that gives application developers the full power and flexibility of SQL.\n\nIt provides a full suite of well known enterprise-level persistence patterns, designed for efficient and high-performing database access, adapted into a simple and Pythonic domain language.\n\nDocumentation: https://www.sqlalchemy.org/\n\n- for using SqlAlchemy ORM in flask we should install extension of \"flask-sqlalchemy\"\n```python\n\u003e\u003e\u003e pip install flask-sqlalchemy\n```\n\n- mysql-connector:\n```python\n\u003e\u003e\u003e pip install pymysql\nor\n\u003e\u003e\u003e pip install mysql-client\n```\n\n- create models in flask shell:\n```python\n\u003e\u003e\u003e from app import db\n\u003e\u003e\u003e create_all()\n```\n\n- create models with flask-migration\n```python\n\u003e\u003e\u003e flask db init\n\u003e\u003e\u003e flask db migrate\n\u003e\u003e\u003e flask db upgrade or downgrade\n```\n\n- create class as a entity(table) of database\n```python\nclass User(db.Model):\n    __tablename__ = \"users\"\n\n    name = Column(String(32), nullable = False)\n    lastname = Column(String(32), nullable = False)\n    email = Column(String(256), nullable = False)\n    username = Column(String(64), primary_key = True)\n    country = Column(String(32), nullable = False)\n    password = Column(String(128), nullable = False)\n    avatar = Column(String(256), nullable = False, default = \"/static/upload/avatar.png\")\n    active = Column(Boolean, nullable = False, default = False)\n\n    # One To Many:\n    # list of posts for create a foreign key we use backreference to list of this mode(Parent) from another model \n    posts = relationship(\"Post\", backref=\"user\")\n    \n    # and other list for anothers classes\nclass Post(db.Model):\n    __tablename__ = \"posts\"\n    username = Column(String(64), ForeignKey('users.username'), primary_key = True) # Foreign Key is primary key of parent table\n    caption = Column(Text(), nullable = True)\n    picture = Column(String(256), nullable = False)\n    post_date = Column(DateTime(), default = dt.datetime.utcnow, primary_key = True)\n```\n\n\n- select * from table\n```python\nuser = User.query.all()\n```\n\n- select from table where \n```python\nuser = User.query.filter_by(username=\"mtaghizadeh\").first()\nor\nuser = User.query.filter(User.username=\"mtaghizadeh\").first()\n```\n\n- delete from table where \n```python\npost = Post.query.filter_by(username=username, post_date=date).first()\ndb.session.delete(post)\ndb.session.commit()\n```\n\n- add or update table\n```python\n# add user to database:\nuser = User()\nuser.name = name\nuser.lastname = lastname\nuser.email = email\nuser.username = username\nuser.country = country\nuser.password = password\ndb.session.add(user)\ndb.session.commit()\n```\n\n- Pagination in sql alchemy and sql or command \n```python\nfrom sqlalchemy import or_ ### by default is and\nq = request.args.get(\"q\")\nname_cnd = User.name.ilike(f'%{q}%')\nlastname_cnd = User.lastname.ilike(f'%{q}%')\nusername_cnd = User.username.ilike(f'%{q}%')\n### using or_ SQLAlchemy : by default is and\n# before pagination\n# found_users = User.query.filter(or_(\n#     name_cnd,\n#     lastname_cnd,\n#     username_cnd\n# )).all()\n# pagination\np = request.args.get(\"p\", default=1, type=int)\nfound_users = User.query.filter(or_(\n    name_cnd,\n    lastname_cnd,\n    username_cnd\n)).paginate(p, 5)\n```\n\n- join in tables\n```python \n# Join Follow and post for get post of followers of this user \nfollowing_cnd = Follow.query.filter_by(follower_username = username).all()\nquery = db.session.query(\n    Follow,\n    Post\n).filter(\n    Follow.follower_username == user.username\n).filter(\n    Follow.following_username == Post.username\n).order_by(Post.post_date.desc()).all()\n```\n\n\n# Flask-Migration\n\nfor simple altering in database (tracking all of database changes) :)))\n```python \n\u003e\u003e pip install flask-migrate \n\u003e\u003e flask db init ---\u003e create migration folder (just in starting project)\n# then by default create migration directory of your project and create alembic table in your database\n```\n\n### if you have any change in your model:\n\n```python\n\u003e\u003e\u003e flask db migrate # alter your db if you change it...\n\u003e\u003e flask db upgrade  # commit the changes(upgrade)\n\u003e\u003e flask db downgrade\n```\n\n\n# Site-Pages\n\n### Index Page \nhome page of site that contains login and signup functionality\n![Database Models Diagram](Documentation/Site-Pages/1-index.png)\n\n\n### Signup Page \nUser can register in this page \n![Database Models Diagram](Documentation/Site-Pages/2-signup.png)\n\n- signup process completed\n\n![Database Models Diagram](Documentation/Site-Pages/3-signup.png)\n\n- user active filed in database is Flase(0) before activation\n\n![Database Models Diagram](Documentation/Site-Pages/4-signup.png)\n\n- we create random token between [00000 , 99999] and save that in redis database \n\n![Database Models Diagram](Documentation/Site-Pages/5-signup.png)\n\n- after registeration we send an email to user email account with **flask-mail** \nthat contains a link like this: \nhttp://127.0.0.1:5000/signup-process/?username=mtaghizadeh\u0026token=266781\n\n![Database Models Diagram](Documentation/Site-Pages/6-signup.png)\n\n- after activtivation we delete token from redis database\n\n![Database Models Diagram](Documentation/Site-Pages/7-signup.png)\n\n- after activtivation we create directory(with user.username) for upload user avatr and post.pictures\n\n![Database Models Diagram](Documentation/Site-Pages/8-signup.png)\n\n\n### Login\nuser can login to pygram \n- user should be activate\n\n![Database Models Diagram](Documentation/Site-Pages/9-login.png)\n\n\n### Setting Page \nuser can change profile picture in this page\n- user can **upload** any image for changing profile avatar \n\n![Database Models Diagram](Documentation/Site-Pages/10-setting.png)\n\n\n### User Posts Page \n\nuser can share new post in this page and see all of posts published nad manage that (delete or modify)\n- in first time this page like this \n\n![Database Models Diagram](Documentation/Site-Pages/11-post.png)\n\n- after sharing posts \n\n![Database Models Diagram](Documentation/Site-Pages/12-post.png)\n\n- user can sharing post with picture and caption\n\n![Database Models Diagram](Documentation/Site-Pages/13-new-post.png)\n\n- user can choose any image from his computeer\n\n![Database Models Diagram](Documentation/Site-Pages/14-new-post.png)\n\n- after sharing post, upload post picture in user directory in server and path of file save in database (Post Table)\n- any file upload in sever with random name from uuid library\n![Database Models Diagram](Documentation/Site-Pages/15-new-post.png)\n\n\n### Search Page \nuser can search any user in this page \n- we paginate all result with **SQLAlchemy paginate() method**\n\n![Database Models Diagram](Documentation/Site-Pages/16-search.png)\n\n\n### Single User Page \n- after searching user or click on user page link user can see page of single user\n\n![Database Models Diagram](Documentation/Site-Pages/17-single_user_page.png)\n\n- user can follow or unfollow and send direct message to single user\n\n![Database Models Diagram](Documentation/Site-Pages/18-single_user_page.png)\n\n\n### Single User Post\n- all of information of this single post \n- user can **like and comment** this post\n\n![Database Models Diagram](Documentation/Site-Pages/19-single-post.png)\n\n\n### Follower and Following Page\n- in this page user can see all of his followers and following  \n- user can click any user and redirect to single user page\n\n![Database Models Diagram](Documentation/Site-Pages/20-follower-following.png)\n\n\n# Single Direct Message Page(Chat Page)\n- user can send message to another user and see message order by sending date\n\n![Database Models Diagram](Documentation/Site-Pages/21-single-direct-message.png)\n\n\n### User Profile Page\n- in this page user can see all of posts that sharing with his following \n- user can like that and can send comment to this post\n\n![Database Models Diagram](Documentation/Site-Pages/22-profile.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-taghizadeh%2Fpygram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm-taghizadeh%2Fpygram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm-taghizadeh%2Fpygram/lists"}