Purplship

Major change

Versioning will follow the [`CalVer`](https://calver.org/) convention with the format `YYYY.MM.DD_MICRO`

What is new?

- Integration of Australia Post [Postage Assessment Calculator](https://developers.auspost.com.au/apis)

- Introduce PurplShip custom errors `(MethodNotSupportedError, OriginNotServicedError, MultiItemShipmentSupportError)`

- Introduction of multi-mapper per proxy configurable by the client. `(will be used to decouple Freight from package shipping API)`

python
import purplship

australia_post = purplship.gateway["aups"].create(
{
"api_key": "username",
"password": "password",
"account_number": "1234567",
"api": "Postage",
}
)


Changes

- Update Fluent API to offer `Typed` or `Dict` (JSON) as parameters

python
Typed
import purplship
from purplship.domain.Types import TrackingRequest

purplship.tracking.fetch(
TrackingRequest(tracking_numbers=["1Z12345E6205277936"])
).from_(ups).parse()


python
Dict (JSON)
purplship.tracking.fetch(
{"tracking_numbers": ["1Z12345E6205277936"]}
).from_(ups).parse()

What's new

- Integrate basic Sendle shipping services (Tracking, Rating)
- Introduce date format standard
- add countries to currencies pairs


Notes:

All Purplship micro-libs wheels are published on [purplship-packages](https://github.com/PurplShip/purplship-packages/releases)

Introduce fluent Interface

python
import purplship
proxy = purplship.gateway['aups'].create({
"server_url": "https://digitalapi.auspost.com.au/test",
"username": "username",
"password": "password",
"account_number": "1234567"
})

rates = purplship.rating.fetch(
shipper={"postal_code": "H3N1S4", "country_code": "CA"},
recipient = {"city": "Lome", "country_code": "TG"},
shipment = {
"items": [
{"id": "1", "height": 3, "length": 10, "width": 3, "weight": 4.0}
]
}
).from_(aups).parse()


Integrate Basic Australia post service
- Quotes (ShippingPriceRequest)
- Tracking

Changes

- added 'suburb' to Party (address)
- introduce jstruct
- use attrs for dataclasses

Fixes

- Fix FedEx missing default server_url
- Separate UPS freight request creation from packages

Changes

- Remove 'pickup_date' and 'pickup_time' from QuoteDetails
- Collect estimated delivery date from carriers where possible
- Remove carriers account numbers from client settings where possible
- use carriers production service address as default value for 'sever_url'

New

- Introduce attrs for cleaner unified datatypes definitions

Changes

- clean up and prepare FedEx freight mapping
- update datatypes
- clean up datatypes factories
- Fix the wrong typing

What's new

- Introduce mypy for type validation and enforcement
- Introduce shell script shortcuts file for development on Unix systems