shopcube
4.6.1
ShopCube ist eine E-Commerce-Lösung für Geschäfte. Komplett mit
Wenn Sie einen Beitrag leisten möchten, machen wir es uns. Wir folgen einem? % Erst-Timer-freundliche Politik. Treten Sie #Shopcube bei, wenn Sie stecken bleiben oder einfach nur chatten möchten und Hallo sagen möchten.
Angetrieben von Shopyo, einem Python -Web -Framework, das auf Flask erstellt wurde.
Quelle
Dies war mein erstes Mal, dass ich zu einem Open-Source-Projekt beigetragen habe, und ich hatte einiges zu kämpfen, aber Abdur-Rahmaan und Shams sind reaktionsschnell, hilfsbereit und einladend !! Ich war in der Lage, einen kleinen Beitrag zu leisten, obwohl ich wenig Erfahrung mit Flächen hatte. Wann immer ich Fragen hatte, wurden sie auf Zwietracht gut beantwortet. Ich empfehle, mit Abdur-Rahmaan und Shams zusammenzuarbeiten! Wenn Sie nervös sind, um einen Beitrag zu leisten, machen sie die Erfahrung weniger einschüchternd als ich erwartet hatte. -@Taanguyen
Ich möchte bei @Abdur-Rahmaanj für die Erstellung dieses Projekts danken! Obwohl ich nur begrenzte Erfahrung mit Flask habe und den Code und seine Funktionsweise zunächst nicht verstehen konnte, erklärte Abdur-Rahmaanj alles sehr geduldig und half mir, alle Zweifel zu klären! Ich konnte neue Konzepte lernen und es war insgesamt eine erstaunliche Erfahrung. Ich würde OpenSource -Neulinge wie mich und sogar erfahrene Mitwirkende empfehlen, um Beiträge zu diesem Projekt zu leisten. ? -@geeeythree
$ python -m pip install shopcube
$ shopcube initialise
$ shopcube rundebug
Gehen Sie zu http://127.0.0.1:5000
Maildev installieren
Führen Sie maildev aus, gehen Sie zur gezeigten WebApp -URL
Laden Sie die neueste Version von Git herunter und installieren Sie sie.
Konfigurieren Sie Git mit Ihrem Benutzernamen und Ihrer E -Mail.
$ git config --global user.name 'your name'
$ git config --global user.email 'your email'
Stellen Sie sicher, dass Sie ein Github -Konto haben.
Fork ShopCube zu Ihrem GitHub -Konto, indem Sie auf die Schaltfläche Gabel klicken.
Klonen Sie das Haupt -Repository lokal (achten Sie darauf, dass Ihr SSH -Authentifizierungs -Setup!). Ersetzen Sie {username} durch Ihren Benutzernamen.
$ git clone [email protected]:{username}/shopcube.git
$ cd shopcube
Erstellen Sie ein virtuellenv mit dem Namen Env und aktivieren Sie die virtuelle Umgebung:
Linux/macos
$ python3 -m venv env
$ . env/bin/activate
Fenster
> py -3 -m venv env
> envScriptsactivate
Upgrade PIP und Setuptools:
$ python -m pip install --upgrade pip setuptools
Installieren Sie die Entwicklungsabhängigkeiten und die ShopCube -Anforderungen:
$ python -m pip install -r reqs/dev.txt
$ pre-commit install
Initialisieren Sie nun die App, indem Sie ausführen:
$ python -m pip install -e .
$ cd src/shopcube
$ shopyo initialise
Run ShopCube:
$ flask run
Gehen Sie zum Link http://127.0.0.1:5000/ und Sie sollten die ShopCube -App ausgeführt sehen.
Melden Sie sich als Administrator an, indem Sie auf das Anmeldesymbol oben rechts auf dem Bildschirm klicken.
Geben Sie [email protected] als Benutzername ein und "Pass" als Pasword.
Nach dem Anmeldung sollten Sie auf http://0.0.0.0:5000/dashboard/ gerichtet sein.
# see config.json
"admin_user": {
"email": "[email protected]",
"password": "pass"
}
ShopCube hat zwei Modi:
Der Paketmodus verfügt über mehrere Befehle, um die JSON -Einstellungsdatei zu verwalten
$ shopcube showjson # show settings
$ shopcube copyjson # copy json file from site-packages in current directory
$ shopcube applyjson # apply json file in current directory
$ shopcube restorejson # restore original json file in site-packages
$ shopcube create # create new project named shopcube in current directory
$ shopcube packageinfo # path of project
Mit dem Steuerungsmodus können Sie Shopyo -Befehle wie in jedem Projekt verwenden
$ shopcube create
$ ls shopcube/
├── app.py
├── config.example.json
├── config.json
├── config.py
├── conftest.py
├── file.log
├── __init__.py
├── init.py
├── instance
├── __main__.py
├── modules
├── __pycache__
├── pyproject.toml
├── requirements.txt
├── setup.cfg
├── static
├── tests
├── utils
└── wsgi.py
$ cd shopcube
$ shopyo initialise
$ shopyo rundebug # or flask run
-> Fügen Sie Flag zum Readme hinzu
Stellen Sie sicher, dass Sie das Repo wie im ersten Setup erläutert haben, bevor Sie Pull Request (PR) erstellen.
Erstellen Sie eine Filiale für das Problem, an dem Sie arbeiten möchten:
$ git fetch origin
$ git checkout -b <your-branch-name> origin/dev
Notiz
Als Vernunftprüfung können Sie git branch ausführen, um die aktuelle Filiale zu sehen, in der Sie sich befinden, falls Ihr Terminal nicht eingerichtet ist, um die aktuelle Filiale anzuzeigen.
Nehmen Sie mit Ihrem bevorzugten Editor Ihre Änderungen vor und verpflichten Sie sich, während Sie gehen.
$ git add <filenames to commit>
$ git commit -m "<put commit message here>"
Schieben Sie Ihre Commits auf Ihre Gabel auf GitHub. Mit der Option -U kann Ihr lokaler Zweig in Ihr Github -Repo geschoben werden.
$ git push -u origin your-branch-name
Erstellen Sie eine Pull -Anfrage. Sie sollten den PR -Link im Terminal sehen, nachdem Sie Ihre Commits erfolgreich gedrückt haben. Link zum Problem wird mit fixes #123 in der Pull -Anfrage behandelt. Siehe Beispiel PR.
Wenn Sie weitere Hilfe benötigen, ping @Contributor auf Discord.
Wenn ich die App initialisiert, erhalte ich einen Fehler in Bezug auf MySQL (dh ein Verbindungsfehler).
Stellen Sie in instance/config.py sicher, dass Sie über eine Datenbank -URI verfügen
SQLALCHEMY_DATABASE_URI = "mysql+pymysql://{username}:{password}@{server_name}/{db_name}".format(
username='shopcube',
password='pass1234-A',
server_name='localhost',
db_name='shopcube'
)
oder fügen Sie Folgendes in config.py in der class DevelopmentConfig(Config) :
SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(base_path, 'app.db')
Ich habe die App gestartet, aber nichts zeigt sich in /Dashboard.
Zusätzliche Entwicklungseinsichten?
$ flask flight-info
Python version: 3.10.7 (main, Sep 7 2022, 15:22:19) [GCC 9.4.0]
Shopyo version: 4.5.8
Shopcube version : 4.2.0
SQLALCHEMY_DATABASE_URI: sqlite:///shopcube.db
In Venv
cd src/shopcube
python -m pytest ./
