# joatmon (jack of all trades, master of none)
[![Documentation Status](https://readthedocs.org/projects/joatmon/badge/?version=latest)](https://joatmon.readthedocs.io/en/latest/?badge=latest)
[![PyPI version](https://badge.fury.io/py/joatmon.svg)](https://badge.fury.io/py/joatmon)
[![codecov](https://codecov.io/gh/malkoch/joatmon/branch/master/graph/badge.svg?token=LLMWHT1CN1)](https://codecov.io/gh/malkoch/joatmon)
![GitHub](https://img.shields.io/github/license/malkoch/joatmon)
[![Pylint](https://github.com/malkoch/joatmon/actions/workflows/pylint.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/pylint.yml)
[![Build](https://github.com/malkoch/joatmon/actions/workflows/build.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/build.yml)
[![Release](https://github.com/malkoch/joatmon/actions/workflows/release.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/release.yml)
Welcome to the Joatmon repository! Here you'll find a collection of codes and scripts I've written over the past 6 years, spanning a wide range of topics and applications. This repository truly lives up to its name – a jack of all trades.
The Joatmon repository is a testament to my journey and exploration in the world of programming and technology. As such, it might not represent best practices, and some parts might be outdated. Use the resources here as a reference or a starting point for your projects, but always exercise due diligence and consider best practices for your specific use case.
## Disclaimer
Please exercise caution when using the scripts and modules in this repository. While I've put in a lot of effort to create these resources, they might contain bugs, glitches, or unforeseen issues. It's essential to thoroughly review and test any code you intend to use in your projects. I strongly recommend not using these scripts in production environments without proper testing and validation.
## Table of Contents
About the Repository
Usage
Contributing
Installation
Examples
How to run the tests
License
Disclaimer
## About the Repository
This repository is a testament to my journey over the years as I've dabbled in various domains of programming and technology. You'll find scripts, modules, and projects covering a wide spectrum, including:
Automation: Collection of scripts for automating repetitive tasks.
Neural Networks: Implementations of neural network architectures and training procedures.
OpenAI Gym: Code for interacting with and developing agents for the OpenAI Gym environment.
ORM (Object-Relational Mapping): Tools for simplifying database interactions using an ORM.
Databases: Scripts demonstrating connectivity and operations with different databases.
Cache: Implementations of caching mechanisms for optimizing data retrieval.
Logger: Utilities for logging and error tracking.
Message Queue: Code related to message queuing systems for asynchronous processing.
OTP (One-Time Password): Implementations of OTP generation and validation.
Authorization: Modules for implementing user authentication and authorization.
Intelligent Virtual Assistant: Code for creating an AI-powered virtual assistant.
Algorithms & Data Structures: Implementations of various algorithms and data structures.
Machine Learning: Supervised, unsupervised, and reinforcement learning algorithm examples.
And much more!
While the repository is a reflection of my curiosity and eagerness to explore different fields, please be aware that the quality and stability of the scripts may vary. Some of the codes might be outdated due to evolving technologies and practices, and others might not be thoroughly tested.
You can find more information in the [doc](https://joatmon.readthedocs.io/en/latest/).
## Usage
To make the best use of this repository:
Review Code Thoroughly: Carefully review the code and scripts you're interested in before integrating them into your projects. This will help you understand their functionality and potential pitfalls.
Test Rigorously: Before deploying any code to production or critical systems, conduct thorough testing in controlled environments to identify and rectify any issues.
Contribute: If you find a bug, want to improve existing code, or have a new script to add, contributions are welcome! Please follow the Contributing guidelines below.
## Contributing
While contributions to this repository are welcome, please ensure that any additions align with the repository's theme of versatility. Bug fixes, optimizations, and improvements are appreciated.
If you'd like to contribute to Joatmon, follow these steps:
Fork the repository.
Create a new branch for your changes: git checkout -b feature/your-feature-name.
Make your modifications and improvements.
Test your changes rigorously.
Commit your changes: git commit -m "Add your meaningful commit message here".
Push to the branch: git push origin feature/your-feature-name.
Open a Pull Request in this repository, detailing your changes and the motivation behind them.
## Installation
- Install joatmon from Pypi (recommended):
```
pip install joatmon
```
Install from Github source:
```
git clone https://github.com/malkoch/joatmon.git
cd joatmon
python setup.py install
```
## Examples
If you want to run the examples, you'll also have to install:
- **gym** by OpenAI: [Installation instruction](https://github.com/openai/gym#installation)
Once you have installed everything, you can try out a simple example:
```bash
python examples/sokoban_dqn.py
python examples/sokoban_ddpg.py
```
## How to run the tests
To run the tests locally, you'll first have to install the following dependencies:
```bash
pip install pytest pytest-xdist pep8 pytest-pep8 pytest-cov python-coveralls
```
You can then run all tests using this command:
```bash
py.test tests/.
```
If you want to check if the files conform to the PEP8 style guidelines, run the following command:
```bash
py.test --pep8
```
If you want to check the code coverage, run the following command:
```bash
py.test --cov=joatmon tests/
```
## License
This repository is available under the MIT License. However, please be aware that the license applies to the codebase as it exists at the time of your usage. Some portions of the code might have their own licenses or restrictions. Make sure to review and respect the licensing terms of any third-party libraries or assets used in the scripts.
Thank you for exploring Joatmon! Your caution, curiosity, and contributions are highly appreciated.
## Disclaimer
Use these scripts at your own risk. I am not responsible for any damages, losses, or inconveniences caused by the use of these resources. Always prioritize proper testing and validation in your projects.
Happy coding!
**Hamitcan Malkoç**
For more information or inquiries, please contact me at info@hamitcanmalkoc.com.
Raw data
{
"_id": null,
"home_page": "https://github.com/malkoch/joatmon",
"name": "joatmon",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9.1",
"maintainer_email": null,
"keywords": "joatmon ml idm automation iva",
"author": "Hamitcan Malko\u00e7",
"author_email": "hamitcanmalkoc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a8/f7/5cda31e423a4d5c8279f7a9b22d29deca7241022374666777e01dfc02bba/joatmon-3.2.0.tar.gz",
"platform": null,
"description": "# joatmon (jack of all trades, master of none)\n\n[![Documentation Status](https://readthedocs.org/projects/joatmon/badge/?version=latest)](https://joatmon.readthedocs.io/en/latest/?badge=latest)\n[![PyPI version](https://badge.fury.io/py/joatmon.svg)](https://badge.fury.io/py/joatmon)\n[![codecov](https://codecov.io/gh/malkoch/joatmon/branch/master/graph/badge.svg?token=LLMWHT1CN1)](https://codecov.io/gh/malkoch/joatmon)\n![GitHub](https://img.shields.io/github/license/malkoch/joatmon)\n[![Pylint](https://github.com/malkoch/joatmon/actions/workflows/pylint.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/pylint.yml)\n[![Build](https://github.com/malkoch/joatmon/actions/workflows/build.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/build.yml)\n[![Release](https://github.com/malkoch/joatmon/actions/workflows/release.yml/badge.svg)](https://github.com/malkoch/joatmon/actions/workflows/release.yml)\n\nWelcome to the Joatmon repository! Here you'll find a collection of codes and scripts I've written over the past 6 years, spanning a wide range of topics and applications. This repository truly lives up to its name \u2013 a jack of all trades.\n\nThe Joatmon repository is a testament to my journey and exploration in the world of programming and technology. As such, it might not represent best practices, and some parts might be outdated. Use the resources here as a reference or a starting point for your projects, but always exercise due diligence and consider best practices for your specific use case.\n\n## Disclaimer\n\nPlease exercise caution when using the scripts and modules in this repository. While I've put in a lot of effort to create these resources, they might contain bugs, glitches, or unforeseen issues. It's essential to thoroughly review and test any code you intend to use in your projects. I strongly recommend not using these scripts in production environments without proper testing and validation.\n\n## Table of Contents\n About the Repository\n Usage\n Contributing\n Installation\n Examples\n How to run the tests\n License\n Disclaimer\n\n## About the Repository\n\nThis repository is a testament to my journey over the years as I've dabbled in various domains of programming and technology. You'll find scripts, modules, and projects covering a wide spectrum, including:\n\n Automation: Collection of scripts for automating repetitive tasks.\n Neural Networks: Implementations of neural network architectures and training procedures.\n OpenAI Gym: Code for interacting with and developing agents for the OpenAI Gym environment.\n ORM (Object-Relational Mapping): Tools for simplifying database interactions using an ORM.\n Databases: Scripts demonstrating connectivity and operations with different databases.\n Cache: Implementations of caching mechanisms for optimizing data retrieval.\n Logger: Utilities for logging and error tracking.\n Message Queue: Code related to message queuing systems for asynchronous processing.\n OTP (One-Time Password): Implementations of OTP generation and validation.\n Authorization: Modules for implementing user authentication and authorization.\n Intelligent Virtual Assistant: Code for creating an AI-powered virtual assistant.\n Algorithms & Data Structures: Implementations of various algorithms and data structures.\n Machine Learning: Supervised, unsupervised, and reinforcement learning algorithm examples.\n And much more!\n\nWhile the repository is a reflection of my curiosity and eagerness to explore different fields, please be aware that the quality and stability of the scripts may vary. Some of the codes might be outdated due to evolving technologies and practices, and others might not be thoroughly tested.\n\nYou can find more information in the [doc](https://joatmon.readthedocs.io/en/latest/).\n\n## Usage\n\nTo make the best use of this repository:\n\n Review Code Thoroughly: Carefully review the code and scripts you're interested in before integrating them into your projects. This will help you understand their functionality and potential pitfalls.\n Test Rigorously: Before deploying any code to production or critical systems, conduct thorough testing in controlled environments to identify and rectify any issues.\n Contribute: If you find a bug, want to improve existing code, or have a new script to add, contributions are welcome! Please follow the Contributing guidelines below.\n\n## Contributing\nWhile contributions to this repository are welcome, please ensure that any additions align with the repository's theme of versatility. Bug fixes, optimizations, and improvements are appreciated.\n\nIf you'd like to contribute to Joatmon, follow these steps:\n\n Fork the repository.\n Create a new branch for your changes: git checkout -b feature/your-feature-name.\n Make your modifications and improvements.\n Test your changes rigorously.\n Commit your changes: git commit -m \"Add your meaningful commit message here\".\n Push to the branch: git push origin feature/your-feature-name.\n Open a Pull Request in this repository, detailing your changes and the motivation behind them.\n\n## Installation\n\n- Install joatmon from Pypi (recommended):\n\n```\npip install joatmon\n```\n\nInstall from Github source:\n\n```\ngit clone https://github.com/malkoch/joatmon.git\ncd joatmon\npython setup.py install\n```\n\n## Examples\n\nIf you want to run the examples, you'll also have to install:\n\n- **gym** by OpenAI: [Installation instruction](https://github.com/openai/gym#installation)\n\nOnce you have installed everything, you can try out a simple example:\n\n```bash\npython examples/sokoban_dqn.py\npython examples/sokoban_ddpg.py\n```\n\n## How to run the tests\n\nTo run the tests locally, you'll first have to install the following dependencies:\n\n```bash\npip install pytest pytest-xdist pep8 pytest-pep8 pytest-cov python-coveralls\n```\n\nYou can then run all tests using this command:\n\n```bash\npy.test tests/.\n```\n\nIf you want to check if the files conform to the PEP8 style guidelines, run the following command:\n\n```bash\npy.test --pep8\n```\n\nIf you want to check the code coverage, run the following command:\n\n```bash\npy.test --cov=joatmon tests/\n```\n\n## License\n\nThis repository is available under the MIT License. However, please be aware that the license applies to the codebase as it exists at the time of your usage. Some portions of the code might have their own licenses or restrictions. Make sure to review and respect the licensing terms of any third-party libraries or assets used in the scripts.\n\nThank you for exploring Joatmon! Your caution, curiosity, and contributions are highly appreciated.\n\n## Disclaimer\nUse these scripts at your own risk. I am not responsible for any damages, losses, or inconveniences caused by the use of these resources. Always prioritize proper testing and validation in your projects.\n\nHappy coding!\n\n**Hamitcan Malko\u00e7**\n\nFor more information or inquiries, please contact me at info@hamitcanmalkoc.com.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "General Purpose Python Library",
"version": "3.2.0",
"project_urls": {
"Download": "https://github.com/malkoch/joatmon/tags",
"Homepage": "https://github.com/malkoch/joatmon"
},
"split_keywords": [
"joatmon",
"ml",
"idm",
"automation",
"iva"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c51e72db29ff99cf256a50bc7205e5b480a83199de3cf6b7edcd57eb6a740df2",
"md5": "0c3f3ad318dbd9ba0a5f01aaa9223378",
"sha256": "864184838ddcb93b2d86ab444bc8c9f0edabe953ded8af726bbb7c230f2c233a"
},
"downloads": -1,
"filename": "joatmon-3.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0c3f3ad318dbd9ba0a5f01aaa9223378",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.1",
"size": 219798,
"upload_time": "2024-03-24T09:38:07",
"upload_time_iso_8601": "2024-03-24T09:38:07.713940Z",
"url": "https://files.pythonhosted.org/packages/c5/1e/72db29ff99cf256a50bc7205e5b480a83199de3cf6b7edcd57eb6a740df2/joatmon-3.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a8f75cda31e423a4d5c8279f7a9b22d29deca7241022374666777e01dfc02bba",
"md5": "73f4a437f33c764eaac81a2009505d4a",
"sha256": "8dce21e8d3c1db9572f8c05c072f6bd0c7890c6a006c5f5ab7e9db3579667277"
},
"downloads": -1,
"filename": "joatmon-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "73f4a437f33c764eaac81a2009505d4a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.1",
"size": 166843,
"upload_time": "2024-03-24T09:38:09",
"upload_time_iso_8601": "2024-03-24T09:38:09.731724Z",
"url": "https://files.pythonhosted.org/packages/a8/f7/5cda31e423a4d5c8279f7a9b22d29deca7241022374666777e01dfc02bba/joatmon-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-24 09:38:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "malkoch",
"github_project": "joatmon",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "joatmon"
}