Metadata-Version: 2.2
Name: liberty-framework
Version: 6.0.51
Summary: Liberty Framework
Author: Franck Blettner
Author-email: franck.blettner@nomana-it.fr
Classifier: Programming Language :: Python :: 3
Classifier: Framework :: FastAPI
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: alembic==1.14.1
Requires-Dist: allure-pytest==2.13.5
Requires-Dist: allure-python-commons==2.13.5
Requires-Dist: annotated-types==0.7.0
Requires-Dist: anyio==4.8.0
Requires-Dist: asyncpg==0.30.0
Requires-Dist: attrs==25.1.0
Requires-Dist: bidict==0.23.1
Requires-Dist: certifi==2024.12.14
Requires-Dist: cffi==1.17.1
Requires-Dist: click==8.1.8
Requires-Dist: cryptography==44.0.0
Requires-Dist: dnspython==2.7.0
Requires-Dist: email_validator==2.2.0
Requires-Dist: fastapi==0.115.7
Requires-Dist: fastapi-cli==0.0.7
Requires-Dist: fastapi-socketio==0.0.10
Requires-Dist: greenlet==3.1.1
Requires-Dist: h11==0.14.0
Requires-Dist: httpcore==1.0.7
Requires-Dist: httptools==0.6.4
Requires-Dist: httpx==0.28.1
Requires-Dist: idna==3.10
Requires-Dist: inflect==7.5.0
Requires-Dist: iniconfig==2.0.0
Requires-Dist: Jinja2==3.1.5
Requires-Dist: Mako==1.3.8
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: MarkupSafe==3.0.2
Requires-Dist: mdurl==0.1.2
Requires-Dist: more-itertools==10.6.0
Requires-Dist: oracledb==2.4.1
Requires-Dist: packaging==24.2
Requires-Dist: pluggy==1.5.0
Requires-Dist: psycopg2-binary==2.9.10
Requires-Dist: pycparser==2.22
Requires-Dist: pydantic==2.10.6
Requires-Dist: pydantic_core==2.27.2
Requires-Dist: Pygments==2.19.1
Requires-Dist: PyJWT==2.10.1
Requires-Dist: pytest==8.3.4
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: python-engineio==4.11.2
Requires-Dist: python-multipart==0.0.20
Requires-Dist: python-socketio==5.12.1
Requires-Dist: PyYAML==6.0.2
Requires-Dist: rich==13.9.4
Requires-Dist: rich-toolkit==0.13.2
Requires-Dist: setuptools==75.8.0
Requires-Dist: shellingham==1.5.4
Requires-Dist: simple-websocket==1.1.0
Requires-Dist: sniffio==1.3.1
Requires-Dist: SQLAlchemy==2.0.37
Requires-Dist: starlette==0.45.3
Requires-Dist: typeguard==4.4.1
Requires-Dist: typer==0.15.1
Requires-Dist: typing_extensions==4.12.2
Requires-Dist: uvicorn==0.34.0
Requires-Dist: uvloop==0.21.0
Requires-Dist: watchfiles==1.0.4
Requires-Dist: websockets==14.2
Requires-Dist: wsproto==1.2.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 📖 Liberty Framework  
### A Scalable and Extensible FastAPI and React Framework for Business Applications  

## Announcements
- **Release 6.0.51**: Add a delay before building the docker image
- **Release 6.0.50**: Build docker image after publishing to PyPi
- **Release 6.0.49**: Sync with github release
- **Release 6.0.48**: Sync with github release
- **Release 6.0.47**: Issue with focus on input lookup when opening search dialog
- **Release 6.0.46**: Implement call for custom rest api, add drop and create database for framework

🚀 **Liberty Framework** is a powerful, modular, and extensible **FastAPI-based and React-based framework** designed to streamline backend development for business applications. It provides **database management, authentication, real-time socket communication, and more**, making it easy to deploy and scale enterprise solutions.  

- Online demo is available at [https://liberty.nomana-it.fr](https://liberty.nomana-it.fr)
- Web page at: [https://nomana-it.fr](https://nomana-it.fr)

```ini
Login = demo
Password = demo
Appplication = LIBERTY, NOMASX-1 and NOMAJDE
```

![liberty](https://github.com/user-attachments/assets/74479874-d7ba-469a-b525-b468529c4432)

---

## ✨ Features  
✅ **FastAPI-based** – High-performance backend with asynchronous capabilities.  
✅ **React-based** – Beautiful and responsive frontend without any dependencies to components.  
✅ **Database Management** – SQLAlchemy, Alembic for migrations, and PostgreSQL support.  
✅ **Real-Time Communication** – Integrated WebSocket (Socket.IO) for live updates.  
✅ **Authentication & Security** – JWT authentication, encryption, and role-based access.  
✅ **Automated Database Migrations** – Alembic versioning for multiple databases.  
✅ **Easy Installation & Deployment** – Available as a **Python package** and **Docker image**.  
✅ **Extensible** – Plugin-based architecture to support future enhancements.  

## ✨ Enterprise additional features
  - 🌐 **Traefik**: A powerful reverse proxy for routing and load balancing.
  - ⚙️ **AirFlow**: Automate and manage workflows effortlessly.
  - 🐘 **pgAdmin**: Manage your PostgreSQL database visually with ease.
  - 🔐 **KeyCloak**: OIDC Service for authentication
  - 📂 **Gitea**: Git Repository to manage dags, plugins, backup

---

## 📦 Installation  

### Requirements
A PostgreSQL 16 database is required. You can either:
  - Create a Docker image based on postgres:16, or
  - Install PostgreSQL 16 directly on your host system.

For easier setup and to ensure compatibility with future enterprise features, it is recommended to create a database with a user named liberty.

### **Option 1: Install via `pip`**
```bash
pip install liberty-framework
```


---

## 🚀 Quick Start  
After installation, you can **start the framework** with:  
```bash
liberty-start
```

---

## ⚙️ URL

### Installation URL
- Setup: `http://<your_host>:<your_port>/setup`
- Application: `http://<your_host>:<your_port>`
- API Documentation: `http://<your_host>:<your_port>/api`
- Swagger: `http://<your_host>:<your_port>/api/test`

### Demo URL
- Setup: [https://liberty.nomana-it.fr/setup](https://liberty.nomana-it.fr/setup)
- Application: [https://liberty.nomana-it.fr](https://liberty.nomana-it.fr)
- API Documentation: [https://liberty.nomana-it.fr/api](https://liberty.nomana-it.fr/api)
- Swagger: [https://liberty.nomana-it.fr/api/test](https://liberty.nomana-it.fr/api/test)

---

## 📖 Documentation  
- **Reference**: [https://docs.nomana-it.fr/liberty](https://docs.nomana-it.fr/liberty)

---

## 🤝 Contributing  
We welcome contributions! Here’s how you can help:  
1. **Fork** this repository.  
2. **Clone** your fork:  
   ```bash
   git clone https://github.com/fblettner/liberty-framework.git
   ```
3. **Create a new branch** for your feature:  
   ```bash
   git checkout -b feature-name
   ```
4. **Commit your changes**:  
   ```bash
   git commit -m "Add new feature"
   ```
5. **Push to your fork** and **submit a Pull Request**:  
   ```bash
   git push origin feature-name
   ```
6. **Join discussions** and help improve the framework!  

---

## 💖 Sponsorship  
If you find **Liberty Framework** useful and would like to support its development, consider sponsoring us. Your contributions help maintain the project, add new features, and improve the documentation. Every contribution, big or small, is greatly appreciated!  

To sponsor, visit: **[GitHub Sponsors](https://github.com/sponsors/fblettner)** or reach out to us directly.  

---

## 📜 License  
Liberty Framework is **open-source software** licensed under the **AGPL License**.  
Enterprise features require a license:
  - **NOMASX-1**: Security management, Segregation of duties and licenses compliancy
  - **NOMAJDE** JD-Edwards integration
  - **Airflow Plugins**: Automatic database backup, database synchronisation...
  - **Liberty AI**: Currently, OpenAI is set into the configuration, you have to use your own account without enterprise features license

---

## 📧 Contact & Support  
If you have questions or need support:  
- **Email**: [franck.blettner@nomana-it.fr](mailto:franck.blettner@nomana-it.fr)  
- **GitHub Issues**: [Report an issue](https://github.com/fblettner/liberty-framework/issues)  
- **Discussions**: Join the conversation in the **GitHub Discussions** section.  

---

### ⭐ If you find Liberty Framework useful, consider giving it a star on GitHub!  
```bash
git clone https://github.com/fblettner/liberty-framework.git
cd liberty-framework
```

🚀 **Let's build the future of business applications together!** 🚀  
