Metadata-Version: 2.4
Name: echallan
Version: 1.0.1
Summary: Python SDK for the eChallan platform.
Author-email: eChallan Team <developer@echallan.app>
License: 											Apache License
        									Version 2.0, January 2004
        								http://www.apache.org/licenses/
        
        	TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
        
        	1. Definitions.
        
        		"License" shall mean the terms and conditions for use, reproduction,
        		and distribution as defined by Sections 1 through 9 of this document.
        
        		"Licensor" shall mean Vahanfin Solutions Private Limited ("vahanfin").
        
        	2. Grant of Copyright License. Subject to the terms and conditions of
        		this License, each contributor hereby grants to You a perpetual,
        		worldwide, non-exclusive, no-charge, royalty-free, irrevocable
        		copyright license to reproduce, prepare derivative works of,
        		publicly display, publicly perform, sublicense, and distribute the
        		Work and such derivative works in Source or Object form.
        
        	3. Redistribution. You may reproduce and distribute copies of the
        		Work or Derivative Works thereof in any medium, with or without
        		modifications, and in Source or Object form, provided that You
        		meet the following conditions:
        
        		(a) You must give any other recipients of the Work or
        			 Derivative Works a copy of this License; and
        
        		(b) You must cause any modified files to carry prominent notices
        			 stating that You changed the files; and
        
        		(c) You must retain, in the Source form of any Derivative Works
        			 that You distribute, all copyright, patent, trademark, and
        			 attribution notices from the Source form of the Work,
        			 excluding those notices that do not pertain to any part of
        			 the Derivative Works; and
        
        		(d) If the Work includes a "NOTICE" text file as part of its
        			 distribution, then any Derivative Works that You distribute must
        			 include a readable copy of the attribution notices contained
        			 within such NOTICE file, in at least one of the following
        			 places: within a NOTICE text file distributed as part of the
        			 Derivative Works; within the Source form or documentation, if
        			 provided along with the Derivative Works; or, within a display
        			 generated by the Derivative Works, if and wherever such
        			 third-party notices normally appear. The contents of the
        			 NOTICE file are for informational purposes only and do not
        			 modify the License. You may add Your own attribution notices
        			 within Derivative Works that You distribute, alongside or as an
        			 addendum to the NOTICE text from the Work, provided Your
        			 additional attribution notices cannot be construed as being
        			 required by the License.
        
        	4. Submission of Contributions. Unless You explicitly state otherwise,
        		any Contribution intentionally submitted for inclusion in the Work
        		by You to the Licensor shall be under the terms and conditions of
        		this License, without any additional terms or conditions.
        
        	5. Trademarks. This License does not grant permission to use the trade
        		names, trademarks, service marks, or product names of the Licensor,
        		except as required for reasonable and customary use in describing the
        		origin of the Work and reproducing the content of the NOTICE file.
        
        	6. Disclaimer of Warranty. Unless required by applicable law or agreed
        		to in writing, Licensor provides the Work (and each Contributor
        		provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
        		OR CONDITIONS OF ANY KIND, either express or implied, including,
        		without limitation, any warranties or conditions of TITLE, NON-
        		INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
        
        	7. Limitation of Liability. In no event and under no legal theory,
        		whether in tort (including negligence), contract, or otherwise,
        		unless required by applicable law (such as deliberate and grossly
        		negligent acts) or agreed to in writing, shall any Contributor be
        		liable to You for damages, including any direct, indirect, special,
        		incidental, or consequential damages of any character arising as a
        		result of this License or out of the use or inability to use the
        		Work (including but not limited to damages for loss of goodwill,
        		work stoppage, computer failure or malfunction, or any and all
        		other commercial damages or losses), even if such Contributor
        		has been advised of the possibility of such damages.
        
        	8. Accepting Warranty or Additional Liability. While redistributing the
        		Work or Derivative Works thereof, You may choose to offer, and
        		charge a fee for, acceptance of support, warranty, indemnity, or
        		other liability obligations and/or rights consistent with this
        		License. However, in accepting such obligations, You may act only
        		on Your own behalf and on Your sole responsibility, not on behalf
        		of any other Contributor, and only if You agree to indemnify,
        		defend, and hold each Contributor harmless for any liability You
        		assume.
        
        	9. Miscellaneous. This License constitutes the entire agreement between
        		the parties with respect to the Work licensed here. If any
        		provision of this License is held to be unenforceable, that
        		provision shall be enforced to the maximum extent permissible so as
        		to affect the intent of the parties, and the remainder of this
        		License shall continue in full force and effect.
        
        END OF TERMS AND CONDITIONS
        
        APPENDIX: How to apply the Apache License to your work.
        
        	To apply the Apache License to your work, attach the following
        	boilerplate notice, with the fields enclosed by brackets "[]" replaced
        	with your own identifying information. (Don't include the brackets!)
        
        	Copyright [yyyy] [name of copyright owner]
        
        	Licensed under the Apache License, Version 2.0 (the "License");
        	you may not use this file except in compliance with the License.
        	You may obtain a copy of the License at
        
        		 http://www.apache.org/licenses/LICENSE-2.0
        
        	Unless required by applicable law or agreed to in writing, software
        	distributed under the License is distributed on an "AS IS" BASIS,
        	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        	See the License for the specific language governing permissions and
        	limitations under the License.
        
        Copyright 2025 Vahanfin Solutions Private Limited
        
Project-URL: Homepage, https://github.com/vahanfin/eChallan-Api
Project-URL: Repository, https://github.com/vahanfin/eChallan-Api
Project-URL: Issues, https://github.com/vahanfin/eChallan-Api/issues
Keywords: echallan,api,sdk,fleet,challan
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: requests>=2.31.0
Dynamic: license-file

# eChallan Python SDK Docs

Tech-Driven Fleet Compliance & Challan Management Platform  
Experience compliance as easy as buying from Flipkart or Amazon — whether it’s settling a challan or renewing vehicle documents, it’s all just a click away.

## Overview
- Endpoints base: `https://app.echallan.app`
- Auth: `x-api-key`
- Endpoint catalog: embedded in `echallan_api/endpoints.py` (`ENDPOINTS` list + helper functions per route).

## Quick Start (code)

```python
from echallan_api.client import EChallanApiClient
from echallan_api import endpoints

client = EChallanApiClient(api_key="YOUR_KEY", base_url="https://app.echallan.app")

# Health check
print(client.get_health())

# Call a specific endpoint helper
resp = endpoints.vehicle_lookup(client, registration_number="MH01AB1234")
print(resp)

# List all documented endpoints
print([e["id"] for e in client.list_endpoints()])
```

## Notes
- Helper functions in `echallan/endpoints.py` map 1:1 to the documented routes; each supports `query`, `body`, and `dry_run` to preview the request payload/URL without sending it.
- Replace sample values with production keys and parameters from your contract.

## License & Usage
This SDK is Copyright 2025 Vahanfin Solutions Private Limited and
is licensed under the Apache License, Version 2.0. See the top-level
`LICENSE` file for full license text and the `NOTICE` file for important
usage and trademark restrictions. Using SDK code for commercial or
production services without an explicit agreement with Vahanfin may result
in suspension of service or legal action.
