npdatetime 0.1.1__tar.gz

npdatetime-0.1.1/.github/workflows/FUNDING.yml

@@ -0,0 +1,13 @@
+# These are supported funding model platforms
+
+github: [4mritGiri] # Your GitHub Sponsors username
+patreon: 4mritGiri  # Your Patreon username
+open_collective:    # Add your Open Collective username if applicable
+ko_fi: 4mritGiri    # Your Ko-fi username
+tidelift:           # Add your Tidelift package information
+community_bridge:   # Add your Community Bridge project name
+liberapay:          # Add your Liberapay username
+issuehunt:          # Add your IssueHunt username
+otechie:            # Add your Otechie username
+lfx_crowdfunding:   # Add your LFX Crowdfunding project name
+custom: ['https://your-custom-sponsorship-link.com'] # Replace with your custom funding links

npdatetime-0.1.1/.gitignore

@@ -0,0 +1,22 @@
+**/__pycache__/**
+
+
+**/.pytest_cache/**
+
+**/.idea/**
+**/.vscode/**
+*.swp
+*.env
+*.log
+*.pyc
+*.pyo
+*.pyd
+*.venv
+
+docs/source/_*
+
+/build
+
+/*.egg-info/
+
+dist/

npdatetime-0.1.1/.travis.yml

@@ -0,0 +1,37 @@
+language: python
+python:
+  - "3.5"
+  - "3.6"
+  - "3.7"
+  - "3.8"
+os:
+  - linux
+  - osx  # Adds macOS for cross-platform testing
+
+env:
+  global:
+    - MAX_LINE_LENGTH=120  # Linting line length
+
+cache:
+  pip: true  # Caches pip packages to speed up builds
+
+install:
+  - pip install flake8 pytest  # Install necessary tools and testing framework
+  - pip install -r requirements.txt || true  # Install project dependencies if `requirements.txt` exists
+
+before_script:
+  - flake8 npdatetime --max-line-length=$MAX_LINE_LENGTH  # Linting with dynamic line length configuration
+
+script:
+  - pytest -v  # Run tests with verbose output
+
+jobs:
+  include:
+    - stage: "Linting Only"
+      python: "3.8"
+      script:
+        - flake8 npdatetime --max-line-length=$MAX_LINE_LENGTH
+
+stages:
+  - "Test"
+  - "Linting Only"

npdatetime-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# CONTRIBUTING
+
+## Guidelines
+- fork the project
+- clone the forked project
+- pip install the npdatetime in editable mode. On the root directory of project do `$ pip install -e .`
+- install `pytest` for running tests. ```$ pip install pytest```
+- install `flake8` for code formatting check. ```$ pip install flake8```
+- check if all tests are passed by ```$ pytest```
+- start contributing
+- before pushing the changes check again if the tests are passed ```$ pytest```
+- also check code formatting has any issues `$ flake8 npdatetime --max-line-length=120`
+- push your code and raise the PR to `develop` branch
+
+**Note: If you're confused on what to contribute in for, you can search for *TODO's* in the code & pick up which ever
+you're comfortable with.**
+
+
+## Preparing a new release
+- Checkout out from the `master` branch with the name of branch of the version like `v1.0.8.3`.
+- Update the release version in the `npdatetime/__init__.py` file name by updating the variable `__version__`.
+- Update the documentation to reflect the release version by rebuilding the documentation inside `docs/` using the command `make html`. Make sure you install all the documentation dependencies before rebuilding it, which is in `docs/requirements.txt`.
+
+
+#### *** HAPPY CONTRIBUTING ! ***

npdatetime-0.1.1/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright © 2020 AMRIT GIRI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

npdatetime-0.1.1/MANIFEST.in

@@ -0,0 +1,2 @@
+include npdatetime/data/*
+recursive-include npdatetime/data *

npdatetime-0.1.1/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: npdatetime
+Version: 0.1.1
+Summary: A Python package that provides advanced functionality for handling Nepali dates and times, including support for the Bikram Sambat calendar system and Nepal Time (NPT). Ideal for developers working with Nepali date-related applications, offering seamless conversion, manipulation, and formatting of dates and times in the Nepali calendar.
+Home-page: https://github.com/4mritGiri/npdatetime
+Author: Amrit Giri
+Author-email: Amrit Giri <amritgiri02595@gmail.com>
+License: The MIT License (MIT)
+        Copyright © 2020 AMRIT GIRI
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the “Software”), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in
+        all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+        THE SOFTWARE.
+Project-URL: Homepage, https://github.com/4mritGiri/npdatetime#readme
+Project-URL: Issues, https://github.com/4mritGiri/npdatetime/issues
+Keywords: Nepali Date,Date Conversion,Datetime,Bikram Sambat,Bikram Samvat,nepali,B.S.,BS,bs,b.s,date,NpDateTime,datetime,time,timezone,nepal,bikram,sambat,samvat,nepali-date,nepali-datetime,nepal-time,npt,nepal-timezone,npdatetime,npdt
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# **Nepali Datetime (Bikram Sambat Date & Nepal Time)**
+
+A Python library inspired by the core `datetime` module, designed for operations based on the **Bikram Sambat (B.S.)** calendar and **Nepal Time (NPT)** timezone (`UTC+05:45`).
+
+### **Key Features**
+- Supports Bikram Sambat (B.S.) date operations.
+- Handles Nepal Time (NPT) timezone.
+- Compatible with Python 3.5+.
+- Seamless integration with Python's native `datetime` functionalities.
+- Support for date formatting with Nepali Unicode.
+
+---
+
+## **Installation**
+
+Install the package using `pip`:
+
+```bash
+pip install npdatetime
+```
+
+---
+
+## **Basic Usage**
+
+Here's how you can use `npdatetime` alongside Python's `datetime`:
+
+### **Importing**
+```python
+import datetime
+import npdatetime
+```
+
+### **Getting Today's Date**
+```python
+# Gregorian date
+datetime.date.today()
+
+# Bikram Sambat date
+npdatetime.date.today()
+```
+
+### **Current Date and Time**
+```python
+# Gregorian datetime
+datetime.datetime.now()
+
+# Bikram Sambat datetime
+npdatetime.datetime.now()
+```
+
+### **Creating Date and Datetime Objects**
+```python
+# Gregorian date
+datetime.date(2020, 9, 4)
+
+# Bikram Sambat date
+npdatetime.date(2077, 5, 19)
+
+# Gregorian datetime
+datetime.datetime(2020, 9, 4, 8, 26, 10, 123456)
+
+# Bikram Sambat datetime
+npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456)
+```
+
+### **Date/Datetime Formatting**
+```python
+# Formatting Bikram Sambat date
+npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456).strftime("%d %B %Y")
+# Output: 19 Bhadau 2077
+
+# Formatting with Nepali Unicode
+npdatetime.date(1977, 10, 25).strftime('%K-%n-%D (%k %N %G)')
+# Output: १९७७-१०-२५ (७७ माघ आइतबार)
+```
+
+### **Parsing from String**
+```python
+npdatetime.datetime.strptime('2077-09-12', '%Y-%m-%d')
+# Output: npdatetime.datetime(2077, 9, 12, 0, 0)
+```
+
+### **Timedelta Operations**
+```python
+# Adding days to a date
+npdatetime.date(1990, 5, 10) + datetime.timedelta(days=350)
+# Output: npdatetime.date(1991, 4, 26)
+
+# Adding hours and minutes to a datetime
+npdatetime.datetime(1990, 5, 10, 5, 10, 20) + datetime.timedelta(hours=3, minutes=15)
+# Output: npdatetime.datetime(1990, 5, 10, 8, 25, 20)
+```
+
+### **Bikram Sambat <-> Gregorian Conversion**
+```python
+# Convert Bikram Sambat to Gregorian
+npdatetime.date(1999, 7, 25).to_datetime_date()
+# Output: datetime.date(1942, 11, 10)
+
+# Convert Gregorian to Bikram Sambat
+npdatetime.date.from_datetime_date(datetime.date(1942, 11, 10))
+# Output: npdatetime.date(1999, 7, 25)
+```
+
+### **Bikram Sambat Monthly Calendar**
+```python
+npdatetime.date(2078, 1, 1).calendar()
+
+# Output:
+          Baishakh 2078
+Sun  Mon  Tue  Wed  Thu  Fri  Sat
+                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
+```
+
+---
+
+## **Documentation**
+
+Comprehensive usage and examples can be found in the [official documentation](https://4mritGiri.github.io/npdatetime/).
+
+---
+
+## **Contribution**
+
+Contributions are highly encouraged!  
+Refer to the [CONTRIBUTING.md](https://github.com/4mritGiri/npdatetime/blob/master/CONTRIBUTING.md) guide for details on how to get started.
+
+---
+
+## **License**
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
+
+---
+
+## **Feedback & Support**
+
+For feature requests, bugs, or feedback, please raise an issue on [GitHub](https://github.com/4mritGiri/npdatetime/issues).

npdatetime-0.1.1/README.md

@@ -0,0 +1,143 @@
+# **Nepali Datetime (Bikram Sambat Date & Nepal Time)**
+
+A Python library inspired by the core `datetime` module, designed for operations based on the **Bikram Sambat (B.S.)** calendar and **Nepal Time (NPT)** timezone (`UTC+05:45`).
+
+### **Key Features**
+- Supports Bikram Sambat (B.S.) date operations.
+- Handles Nepal Time (NPT) timezone.
+- Compatible with Python 3.5+.
+- Seamless integration with Python's native `datetime` functionalities.
+- Support for date formatting with Nepali Unicode.
+
+---
+
+## **Installation**
+
+Install the package using `pip`:
+
+```bash
+pip install npdatetime
+```
+
+---
+
+## **Basic Usage**
+
+Here's how you can use `npdatetime` alongside Python's `datetime`:
+
+### **Importing**
+```python
+import datetime
+import npdatetime
+```
+
+### **Getting Today's Date**
+```python
+# Gregorian date
+datetime.date.today()
+
+# Bikram Sambat date
+npdatetime.date.today()
+```
+
+### **Current Date and Time**
+```python
+# Gregorian datetime
+datetime.datetime.now()
+
+# Bikram Sambat datetime
+npdatetime.datetime.now()
+```
+
+### **Creating Date and Datetime Objects**
+```python
+# Gregorian date
+datetime.date(2020, 9, 4)
+
+# Bikram Sambat date
+npdatetime.date(2077, 5, 19)
+
+# Gregorian datetime
+datetime.datetime(2020, 9, 4, 8, 26, 10, 123456)
+
+# Bikram Sambat datetime
+npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456)
+```
+
+### **Date/Datetime Formatting**
+```python
+# Formatting Bikram Sambat date
+npdatetime.datetime(2077, 5, 19, 8, 26, 10, 123456).strftime("%d %B %Y")
+# Output: 19 Bhadau 2077
+
+# Formatting with Nepali Unicode
+npdatetime.date(1977, 10, 25).strftime('%K-%n-%D (%k %N %G)')
+# Output: १९७७-१०-२५ (७७ माघ आइतबार)
+```
+
+### **Parsing from String**
+```python
+npdatetime.datetime.strptime('2077-09-12', '%Y-%m-%d')
+# Output: npdatetime.datetime(2077, 9, 12, 0, 0)
+```
+
+### **Timedelta Operations**
+```python
+# Adding days to a date
+npdatetime.date(1990, 5, 10) + datetime.timedelta(days=350)
+# Output: npdatetime.date(1991, 4, 26)
+
+# Adding hours and minutes to a datetime
+npdatetime.datetime(1990, 5, 10, 5, 10, 20) + datetime.timedelta(hours=3, minutes=15)
+# Output: npdatetime.datetime(1990, 5, 10, 8, 25, 20)
+```
+
+### **Bikram Sambat <-> Gregorian Conversion**
+```python
+# Convert Bikram Sambat to Gregorian
+npdatetime.date(1999, 7, 25).to_datetime_date()
+# Output: datetime.date(1942, 11, 10)
+
+# Convert Gregorian to Bikram Sambat
+npdatetime.date.from_datetime_date(datetime.date(1942, 11, 10))
+# Output: npdatetime.date(1999, 7, 25)
+```
+
+### **Bikram Sambat Monthly Calendar**
+```python
+npdatetime.date(2078, 1, 1).calendar()
+
+# Output:
+          Baishakh 2078
+Sun  Mon  Tue  Wed  Thu  Fri  Sat
+                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
+```
+
+---
+
+## **Documentation**
+
+Comprehensive usage and examples can be found in the [official documentation](https://4mritGiri.github.io/npdatetime/).
+
+---
+
+## **Contribution**
+
+Contributions are highly encouraged!  
+Refer to the [CONTRIBUTING.md](https://github.com/4mritGiri/npdatetime/blob/master/CONTRIBUTING.md) guide for details on how to get started.
+
+---
+
+## **License**
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
+
+---
+
+## **Feedback & Support**
+
+For feature requests, bugs, or feedback, please raise an issue on [GitHub](https://github.com/4mritGiri/npdatetime/issues).