JCalConvert is a command-line tool that allows you to convert between the Western calendar and the Japanese Imperial calendar. It can also be used to provide information about the different Japanese eras and their corresponding dates in the Gregorian calendar.
- Convert a Western calendar year to the corresponding Japanese Imperial calendar year
- Convert a Japanese Imperial calendar year to the corresponding Western calendar year
- Look up information about Japanese eras, including the era name, start and end dates, and other details
- Clone the repository:
git clone https://github.com/cuspofcreation/jcc.git
- Change to the project directory:
cd jcc
- Install the required dependencies:
pip install -r requirements.txt
- Run the application:
python -m jcc
- Use the available commands:
era: Convert a Japanese era name to its romaji equivalent and display the era details. Do not include spaces
python -m jcc era Heisei
python -m jcc era 平成
python -m jcc era -v Heisei21
python -m jcc era -v 平成21
convert: Convert a Western calendar year to the corresponding Japanese Imperial calendar year, or vice versa. Do not include spaces
python -m jcc convert 2023
python -m jcc convert 平成21
python -m jcc convert Heisei21
-
Fork, clone, install dependencies. All set!
-
Run tests using:
pytest
- Allow for the use of spaces, e.g., jcc convert "Heisei 21"
- Implement batch conversion feature to handle multiple dates simultaneously
- Expand unit tests to include testing of Rich tableout
Contributions are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request.
This project is licensed under the MIT License.