ayapingping-py generates standard project structure to build applications in Python that follow Clean Architecture and Feature-Driven Design concept
Project description
ayapingping-py
ayapingping-py generates standard project structure to build applications in Python that follow Clean Architecture and Feature-Driven Design concept.
Golang variant: ayapingping-go
TypeScript variant: ayapingping-ts
Requirements
- Python>=3.10.12
- Operating systems supporting
/bin/sh
with POSIX standards (WHY?). Linux and macOS should have no issues here as they support it by default. For Windows users, consider using WSL instead
Getting started
Installation
You can use the pip install
method:
pip install ayapingping-py
Possible issue
If you're facing a warning or an issue like this, for example:
WARNING: The script ayapingping-py is installed in '/your/path/.local/bin' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
Then you can install it using the --user
option, for example:
pip install --user --force-reinstall ayapingping-py
Or if it doesn't work, you can add the directory containing the scripts to your PATH manually.
Open your shell configuration file (e.g., .bashrc
, .zshrc
, .profile
, or similar) and add the following line:
export PATH=$PATH:/your/path/.local/bin
Then, restart your shell or run:
source ~/.bashrc # or source ~/.zshrc, ~/.profile or similar
This will make the changes take effect immediately.
Usage
To generate a new project, simply run the ayapingping-py
command:
ayapingping-py
Then enter your project name, the ayapingping-py generator will set up the project for you.
The animated example uses the Golang version, but it essentially follows the same approach
What's next?
Simply start working on your project and make changes.
Project Structure
To implement the concept of Clean Architecture and Domain-Driven Design Feature-Driven Design, and to keep them understandable, we structure the project like this:
main.py
- In this file, you initialize dependencies, injections, and anything required to start and run your application
- You can use the command
venv/bin/python main.py
,python main.py
ormake start
to run your application
domain
- The Domain represents your primary business model or entity
- Define your main object models or properties for your business here, including database models, DTOs (Data Transfer Objects), etc
- Keep this package as straightforward as possible. Avoid including any code that is not directly related to the model itself
- If a Feature imports anything from this location, and you want the Feature to be accessible through the
importFeature
orexportFeature
command without the risk of missing package errors, DON'T FORGET to include them in thefeatures/yourFeature/dependency.json
file
features
- A Feature encapsulates your main business feature, logic, or service
- Here, you include everything necessary to ensure the proper functioning of the feature
- Please prioritize Feature-Driven Design, ensuring that features can be easily adapted and seamlessly integrated and imported into different projects
- If another Feature imports anything from this location (the current Feature), and you want the current Feature to be
accessible through the
importFeature
orexportFeature
command without the risk of missing package errors, DON'T FORGET to include them in thedependency.json
file - The
dependency.json
is OPTIONAL, and ONLY USEFUL WHEN you use theimportFeature
orexportFeature
command. It serves to define the Feature dependencies and avoids possible missing package errors - A standard Feature comprises the following parts:
delivery
,repositories
,usecases
andutility
- delivery
- Hosts feature handlers like HTTP handlers, gRPC handlers, cron jobs, or anything serving between the client and your application or feature
- For config variables, external clients, or use cases, pass or inject them as dependencies
- repositories
- Handles communication with external data resources like databases, cloud services, or external services
- Keep your repositories as simple as possible; avoid adding excessive logic
- If necessary, separate operations into smaller methods
- Changes outside the
repositories
should not affect them (except changes for business domain/model/entity) - For config variables, database frameworks, or external clients, pass or inject them as dependencies
- usecases
- Contains the main feature logic
- Changes outside the
usecases
should not impact them (except changes for business domain/model/entity and repositories) - For config variables, external clients, or repositories, pass or inject them as dependencies
- utility
- Accommodates functions tailored to help with common tasks specifically for the Feature—treat them as helpers
- delivery
- Feel free to adopt your own style as long as it aligns with the core concept
common
- In this place, you can implement various functions to assist you in performing common tasks—consider them as helpers
- Common functions can be directly called from any location
- If a Domain or Feature imports anything from this location, and you want the Feature to be accessible through
the
importFeature
orexportFeature
command without the risk of missing package errors, DON'T FORGET to include them in thefeatures/yourFeature/dependency.json
file
infra
- This is the location to house infrastructure configurations or scripts to facilitate the deployment of your project on a server or VM
Make It Your Own
Feel free to create your own style to suit your requirements, as long as you still follow the main architecture concept.
You can create folders such as migration
to store your database migrations, tmp
for temporary files, etc.
Importing Features from Another Project
To seamlessly incorporate or import features from another project, use the importFeature
command:
ayapingping-py importFeature [feature_1,feature_2,...] from [/local/project or https://example.com/user/project.git or git@example.com:user/project.git]
For example:
ayapingping-py importFeature example_feature from /path/to/your/project
ayapingping-py importFeature example_feature_1,example_feature_2 from git@github.com:username/project.git
Feature dependency
If your feature relies on external packages, it's crucial to address dependencies properly during the import process.
Failure to import necessary dependencies may result in missing packages. To prevent this, please document your feature
dependencies in the dependency.json
file. Supported dependencies are limited to the following directories: domain
, common
, and features
.
Ensure that your feature dependencies strictly adhere to these directories, avoiding reliance on other locations.
You can also include any external packages to externals
param to install them automatically using the venv/bin/pip install
or pip install
method.
Example dependency.json
file:
{
"domains": [
"domain_1.py",
"domain_2.py"
],
"features": [
"feature1",
"feature2"
],
"commons": [
"common_function_1.py",
"common_function_2.py"
],
"externals": [
"python-dotenv==1.0.1",
"mysql-connector-python==8.3.0",
"Flask==3.0.2"
]
}
Other Commands
There are several commands similar to importFeature
above, such as importDomain
, importCommon
, exportFeature
, exportDomain
, etc.
They function in the same way, for example:
ayapingping-py importDomain example.py from /path/to/your/project
ayapingping-py importCommon common_function_1.py from https://example.com/user/project.git
For export
command, the behavior is similar to the import
command, but now uses export
as the prefix and to
instead of
from
when pointing to the source, for example:
ayapingping-py exportFeature example_feature to /path/to/your/project
For more detail and explanation, please visit ayapingping-sh
Release
Changelog
Read at CHANGELOG.md
Credits
Copyright © 2024 Dali Kewara
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ayapingping_py-4.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3daf7e30df0134591adf16c8ad18c20611fed32f4ac15ec244ff063431cd68ef |
|
MD5 | cae0bdb01f12cdf31c44821ef6b886e5 |
|
BLAKE2b-256 | cc808e47bfffb2882bc29f550b6d1e92fa262fc404a3a956c902a52fb60a75af |