Skip to content

JiraTablify turns Excel tables into Jira format. It makes adding tables to Jira easy.

License

Notifications You must be signed in to change notification settings

PKHarsimran/JiraTablify

Repository files navigation

Table to Jira Converter 🔄

Python Badge Docker Badge Docker Hub

This project simplifies the process of converting Excel tables to Jira markup language. Instead of manually adjusting each row and column, you can now copy your table data, convert it instantly, and paste it right into Jira!

Features 🌟

  • Simple Interface: Just paste and convert! No unnecessary complexities.
  • Instant Conversion: Get your Jira format in seconds without any hassles.
  • Docker Support: Easily run the converter using Docker for consistency and portability.

Getting Started 🚀

Prerequisites

  1. Ensure you have Python 3.9 or later installed.
  2. Docker installed if you intend to use the Docker setup.

To set up and run this project locally python setup, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/PKHarsimran/JiraTablify.git
    cd JiraTablify
  2. Create a Virtual Environment (Optional but Recommended): It's a good practice to use a virtual environment to isolate your project dependencies.

    python -m venv venv  # Create a virtual environment
    source venv/bin/activate  # Activate the virtual environment (Linux/Mac)
    # or
    .\venv\Scripts\activate  # Activate the virtual environment (Windows)
  3. Install Dependencies: Use pip to install the required Python packages from the requirements.txt file.

    pip install -r requirements.txt
  4. Run the Application: Start the Flask application.

    python convert_to_jira.py
  5. Access the Application: Open a web browser and navigate to http://localhost:8081 to use the application locally.

Using Docker:

  1. Clone the repository:
    git clone https://github.com/PKHarsimran/JiraTablify.git
  2. Navigate to the project directory:
    cd JiraTableMaster
  3. Build the Docker image:
    docker build -t jiratablemaster .
  4. Run the Docker container:
    docker run -p 8081:8081 jiratablemaster

Visit http://localhost:8081 in your browser to access the converter!

Docker Hub

You can find the Docker image for this project on Docker Hub:

Docker Hub

Contribution 🤝

Your contributions are always welcome! To contribute:

  1. Fork the project.
  2. Create a new branch.
  3. Make your changes and write tests when practical.
  4. Commit your changes to the new branch.
  5. Push your changes, and submit a pull request to the main branch.

For major changes, please open an issue first to discuss what you'd like to change or add.