nepdate-cli

Crates.ionepdate-cli
lib.rsnepdate-cli
version0.1.4
created_at2024-10-19 06:29:55.622002+00
updated_at2025-07-15 07:01:26.692391+00
descriptionA library for converting between Gregorian and Bikram Sambat (Nepali) dates.
homepage
repositoryhttps://github.com/khumnath/nepdate-cli
max_upload_size
id1415115
size40,461
(khumnath)

documentation

README

nepdate-cli

nepdate-cli is a simple command-line program built using the bikram library to convert dates between Bikram Sambat (Nepali calendar) and Gregorian dates.

Features

  • Convert Gregorian dates to Bikram Sambat.
  • Convert Bikram Sambat dates to Gregorian.

Installation and Setup

Prerequisites

  • Rust programming language
  • Cargo (Rust package manager). install instruction for rust HERE.

Clone the Repository

First, clone the repository:

git clone --branch rust https://github.com/khumnath/nepdate-cli.git
cd nepdate-cli

Build the Program

  1. Make sure to give execution permissions to the build.sh script:

    chmod +x build.sh

  2. Run the build.sh script to build the program and set up the build folder:

    ./build.sh

This script will:

  • Compile the program in release mode and store the output in the target directory.
  • Display the path to the executable.
  • Test the program by running it.

The executable path should be printed in the terminal, and after 2 seconds, the program will be test run automatically.

Install using cargo

cargo install nepdate-cli Running the above command will globally install the nepdate-cli binary.

using library in other applications

Run the following Cargo command in your project directory:

cargo add nepdate-cli

Or add the following line to your Cargo.toml:

nepdate-cli = "0.1.3" nepdate-test-app folder has example of an application. use bikram::bikram::Bikram; should import bikram library after adding nepdate-cli dependency in application.

Usage

After building the program, you can use it to convert dates between the two calendar systems.

Convert to Nepali Date (Bikram Sambat):

./target/release/nepdate-cli --conv --tobs <year> <month> <day>

Example:

./target/release/nepdate-cli --conv --tobs 2024 10 18

Convert to Gregorian Date:

./target/release/nepdate-cli --conv --toad <year> <month> <day>

Example:

./target/release/nepdate-cli --conv --toad 2081 6 1

License

nepdate-cli is released under the GNU General Public License v3.0. See the LICENSE file for more details.

Contact

For any inquiries, you can reach out to khumnath cg.

Commit count: 21

cargo fmt