nepdate-cli 0.1.4

A library for converting between Gregorian and Bikram Sambat (Nepali) dates.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# 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](https://www.rust-lang.org/) programming language
- Cargo (Rust package manager). install instruction for rust [HERE](https://www.rust-lang.org/tools/install).

### Clone the Repository

First, clone the repository:

```bash
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:
    ```bash
    chmod +x build.sh
    ```

2. Run the `build.sh` script to build the program and set up the build folder:
    ```bash
    ./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](https://www.gnu.org/licenses/gpl-3.0.en.html). See the LICENSE file for more details.

### Contact

For any inquiries, you can reach out to [khumnath](https://khumnath.com.np) cg.